aria2 オプションリファレンス
実際に使うオプションだけを厳選。各項目で aria2c のフラグを aria2.conf のキーに対応づけ、例を示します。これは公式マニュアル(完全な一覧)を補う厳選リファレンスです。
| フラグ | aria2.conf キー | 説明 | 例 |
|---|---|---|---|
-d | dir | ダウンロードしたファイルを保存するディレクトリ。 | aria2c -d /downloads URL |
-o | out | 出力ファイル名を指定します。 | aria2c -o file.iso URL |
-c | continue | 途中までダウンロードしたファイルを再開します。 | aria2c -c URL |
-i | input-file | テキストファイルに列挙したすべての URI をダウンロードします。 | aria2c -i urls.txt |
-j | max-concurrent-downloads | 同時に実行するダウンロードの最大数。 | aria2c -j 5 URL |
-Z | | すべての URI を 1 回の操作で取得します(バッチモード)。 | aria2c -Z URL1 URL2 |
--save-session | save-session | 現在のダウンロードをセッションファイルに書き出し、後で再開できるようにします。 | aria2c --save-session=aria.session URL |
--save-session-interval | save-session-interval | セッションファイルを自動保存する間隔(秒)。 | --save-session-interval=60 |
--allow-overwrite | allow-overwrite | 既存ファイルを失敗させずに上書きします。 | --allow-overwrite=true |
-x | max-connection-per-server | サーバーごとの接続数(1〜16)。大きいほど大容量ファイルが高速化します。 | aria2c -x 16 URL |
-s | split | ファイルを N 分割し、並列でダウンロードします。 | aria2c -s 16 URL |
-k | min-split-size | 分割ピースの最小サイズ。 | aria2c -k 1M URL |
-m | max-tries | 中断するまでの再試行回数。 | aria2c -m 5 URL |
--retry-wait | retry-wait | 再試行の間隔(秒)。 | --retry-wait=5 |
-t | timeout | 接続タイムアウト(秒)。 | aria2c -t 60 URL |
--connect-timeout | connect-timeout | 接続確立のタイムアウト。 | --connect-timeout=30 |
--lowest-speed-limit | lowest-speed-limit | 速度がこの値を下回ったら中断します。 | --lowest-speed-limit=10K |
-U | user-agent | HTTP User-Agent を上書きします。 | aria2c -U "Mozilla/5.0" URL |
--referer | referer | Referer ヘッダーを送信します。 | --referer="https://example.com" |
--header | header | カスタム HTTP ヘッダーを追加します。 | --header="Authorization: Bearer X" |
--load-cookies | load-cookies | Netscape 形式のファイルから Cookie を読み込みます。 | --load-cookies=cookies.txt |
--check-certificate | check-certificate | TLS 証明書を検証します(信頼できる配信元以外では無効化しないでください)。 | --check-certificate=false |
--ca-certificate | ca-certificate | CA 証明書バンドルのパス。 | --ca-certificate=/etc/ssl/certs/ca-certificates.crt |
-V | check-integrity | チャンクのチェックサムを検証します(Metalink/BitTorrent)。 | aria2c -V URL |
--bt-tracker | bt-tracker | トレント用のカンマ区切りトラッカーリスト。 | --bt-tracker="udp://tracker.opentrackr.org:1337/announce" |
--bt-max-peers | bt-max-peers | トレントごとの最大ピア数(0 = 無制限)。 | --bt-max-peers=128 |
--enable-dht | enable-dht | トラッカーなしトレント用に DHT ネットワークを有効にします。 | --enable-dht=true |
--bt-enable-lpd | bt-enable-lpd | ローカルピア探索を有効にします。 | --bt-enable-lpd=true |
--seed-ratio | seed-ratio | このアップロード/ダウンロード比でシードを終了します(0 = 永続シード)。 | --seed-ratio=1.0 |
--seed-time | seed-time | 完了後のシード時間(分)。 | --seed-time=60 |
--bt-save-metadata | bt-save-metadata | マグネットリンクからトレントメタデータを保存します。 | --bt-save-metadata=true |
--bt-seed-unverified | bt-seed-unverified | 既存ピースの検証なしでシードします。 | --bt-seed-unverified=true |
--enable-rpc | enable-rpc | JSON-RPC/XML-RPC サーバーを起動します。 | --enable-rpc=true |
--rpc-listen-all | rpc-listen-all | すべてのインターフェースで待ち受けます(安全な場合のみ)。 | --rpc-listen-all=true |
--rpc-listen-port | rpc-listen-port | RPC ポート(既定 6800)。 | --rpc-listen-port=6800 |
--rpc-secret | rpc-secret | RPC インターフェースに必要なシークレットトークン。 | --rpc-secret=YOUR_SECRET |
--rpc-allow-origin-all | rpc-allow-origin-all | クロスオリジンのブラウザクライアント(Web UI)を許可します。 | --rpc-allow-origin-all=true |
-D | daemon | バックグラウンドのデーモンとして実行します。 | aria2c -D --enable-rpc |
-l | log | ログをファイルに書き出します。 | aria2c -l aria2.log URL |
--on-download-complete | on-download-complete | ダウンロード完了時に実行するコマンド。 | --on-download-complete=/path/hook.sh |
--on-download-error | on-download-error | ダウンロード失敗時に実行するコマンド。 | --on-download-error=/path/err.sh |
--all-proxy | all-proxy | すべてのプロトコル (HTTP/HTTPS/FTP) 用の HTTP プロキシ。SOCKS には非対応。 | --all-proxy="http://127.0.0.1:8080" |
--http-proxy | http-proxy | HTTP のみのプロキシ。 | --http-proxy="http://127.0.0.1:8080" |
--all-proxy-user | all-proxy-user | プロキシ認証のユーザー名。 | --all-proxy-user=user |
--all-proxy-passwd | all-proxy-passwd | プロキシ認証のパスワード。 | --all-proxy-passwd=pass |
--no-proxy | no-proxy | プロキシを経由しないホスト(カンマ区切り)。 | --no-proxy=localhost,127.0.0.1 |
--disable-ipv6 | disable-ipv6 | IPv6 を無効化します。 | --disable-ipv6=true |
--file-allocation | file-allocation | 事前割り当てモード: none、prealloc、trunc、falloc。 | --file-allocation=falloc |
--disk-cache | disk-cache | ディスクキャッシュを有効にし、サイズを設定します。 | --disk-cache=64M |
--max-download-limit | max-download-limit | ダウンロードごとの速度制限。 | --max-download-limit=1M |
--max-overall-download-limit | max-overall-download-limit | 全体のダウンロード速度制限。 | --max-overall-download-limit=5M |
--max-overall-upload-limit | max-overall-upload-limit | 全体のアップロード速度制限。 | --max-overall-upload-limit=1M |
--remote-time | remote-time | サーバーのタイムスタンプをファイルに適用します。 | --remote-time=true |
--auto-file-renaming | auto-file-renaming | 既存ファイルを上書きせず名前を変更します。 | --auto-file-renaming=true |
該当するオプションがありません。「split」「proxy」「seed」などを試すか、公式マニュアルをご覧ください。
これらのオプションから設定を作成
設定ジェネレーターでこれらの設定をそのまま使える aria2.conf に変換するか、aria2 の完全ガイドをお読みください。エラーが出た場合はトラブルシューティングを参照してください。