aria2のよくある問題をすべて1か所にまとめました：インストール、SSL、HTTP/FTP、BitTorrent、RPC/WebUI、ネットワークとプロキシ、ディスクとI/O、レジュームとセッション、パフォーマンス、設定とセキュリティ。各項目で症状、原因、具体的な修正手順、期待される結果を説明します。aria2.orgは独立したコミュニティリソースです。
症状: シェルに aria2c: command not found、'aria2c' is not recognized と表示される、またはyt-dlpが “aria2c is not installed. please install it first.” と報告する。
原因: aria2がインストールされていないか、フォルダが PATH に登録されていない。
解決法: インストールしてからターミナルを開き直し、PATHを更新する。
期待される結果: aria2c --version で1.37.0のようなバージョンが表示される。
症状: aria2を展開したのに、新しいターミナルでもコマンドが不明と言われる。
原因: aria2c.exe のあるフォルダを Path 環境変数に追加していない。
解決法: フォルダをPathに追加し、新しいターミナルを開く（既存のターミナルは古い環境を引き継ぐ）。
期待される結果: 開き直したCMD/PowerShellで aria2c が見つかる。
症状: aria2c が共有ライブラリ不足ですぐに終了する。
原因: 必要なライブラリがないか、バイナリがシステムに合っていない。
解決法: ディストリビューション提供の依存パッケージをインストールする。
期待される結果: aria2c --version がライブラリエラーなしで実行できる。
症状: aria2c.exe を開くとDLL不足のエラーが出る。
原因: aria2c.exe をZIPフォルダから移動し、同梱のDLLから切り離した。
解決法: 展開したフォルダ全体をまとめたままにし、そのフォルダをPathに追加する。
期待される結果: aria2cが起動してバージョンを表示する。
症状: macOS（Gatekeeper）がダウンロードしたバイナリの実行を拒否する。
原因: 署名・公証されていないためバイナリが検疫されている。
解決法: Homebrewを使うか、検疫属性を解除する。
期待される結果: Gatekeeperがバイナリの実行を許可する。
症状: 「WindowsによってPCが保護されました」と表示されるか、ダウンロード直後にファイルが削除される。
原因: 署名のないCLIバイナリがヒューリスティックに誤検知されることがある。
解決法: 公式GitHubリリースからのみ入手し、チェックサムを確認して許可する。または winget/scoop/choco でインストールする。
期待される結果: aria2cが実行でき、削除されなくなる。
症状: コンテナが再起動を繰り返すか、ポート6800に応答がない。
原因: エントリーポイントやコマンドの誤り、設定不足、またはコンテナ内でRPCがlocalhostにのみバインドされている。
解決法: ログを確認し、--enable-rpc と rpc-listen-all=true、ポート公開を確認する。
期待される結果: curl http://localhost:6800/jsonrpc がJSON-RPC応答を返す。
症状: HTTPSダウンロードが証明書検証エラーで失敗する。
原因: ルートCA証明書が古いか、自己署名や社内の証明書を使っている。
解決法: CAバンドルを更新するか、aria2に指定する。社内サイトではCAを追加する。
期待される結果: 証明書警告なしにダウンロードが始まる。
症状: TLSハンドシェイク中に接続が切れ、データが転送されない。
原因: 古いTLSスタック、プロキシやウイルス対策による割り込み、未対応のプロトコルバージョン。
解決法: aria2とOSを更新する。プロキシなしで試し、別のネットワークでも確認する。
期待される結果: ハンドシェイクが完了してダウンロードが進む。
症状: --ca-certificate を指定しても効果がない。
原因: Windows（WinTLS）とmacOS（AppleTLS）のバックエンドはこのオプションに対応しておらず、OSのトラストストアを使う。
解決法: 証明書をOSのトラストストアにインポートする。
期待される結果: OSで信頼された証明書でHTTPSが成功する。
症状: サーバーが403を返し、ダウンロードが止まる。
原因: セッションCookie、Referer、ブラウザのUser-Agentが必要（ホットリンク防止）。
解決法: Cookieやヘッダーを渡す。
期待される結果: サーバーが200を返して転送が始まる。
症状: aria2がコード3で終了し「resource not found」を繰り返す。
原因: URLが間違っている、期限切れ、またはファイルが削除された（署名付きリンクに多い）。
解決法: 新しいURLを取得し、リトライ上限を設定して早く失敗させる。
期待される結果: 無限に繰り返さず速やかに停止する。または新しいURLで成功する。
症状: 短時間に大量のリクエストを送ってサーバーに制限される。
原因: 並列接続数や同時ファイル数が多すぎる。
解決法: 接続数や同時実行数を減らし、間隔を空ける。
期待される結果: 制限内に収まり、ダウンロードが完了する。
症状: サーバーが一時的に過負荷またはメンテナンス中。
原因: 一時的なサーバー側の負荷やスロットリング。
解決法: 待って再試行する。--retry-wait を付けると503を自動で再試行する。
期待される結果: aria2が待機して再試行し、サーバー復旧後に成功する。
症状: aria2が認証失敗を報告する。
原因: 認証情報の誤りや不足（Basic/Bearer認証を含む）。
解決法: ユーザー名・パスワードまたはAuthorizationヘッダーで認証情報を渡す。
期待される結果: サーバーが認証してデータ送信を始める。
症状: aria2が「too many redirects」で中断する。
原因: リダイレクトループ、またはCookieやヘッダーを要求するCDN。
解決法: 最終URLを直接使うか、CookieとRefererを付けて試す。
期待される結果: aria2が最終的な200応答に到達する。
症状: 応答をaria2が解析できない。
原因: 不良な透過プロキシ、ウイルス対策のTLSフィルタ、またはポート上の非HTTPサーバー。
解決法: 割り込んでいるプロキシやTLSフィルタを外して再試行し、URLがHTTP/HTTPSであることを確認する。
期待される結果: 正常な200応答が解析されてダウンロードできる。
症状: -c を付けてもaria2が続行を拒否する。
原因: サーバーがバイトレンジ要求を無視する、またはファイルが変わった（サイズやETagの相違）。
解決法: -c なしで最初から取得するか、レンジ対応ミラーから取得する。
期待される結果: フルダウンロードが完了する。
症状: aria2がタイムアウトで処理をやめる。
原因: 遅い・不安定なサーバー、またはタイムアウト設定が短すぎる。
解決法: タイムアウトと再試行を増やし、停滞した接続を切り捨てる。
期待される結果: 中断せず再試行・レジュームする。
症状: FTP転送が認証やコマンドエラーで失敗する。
原因: 認証情報の誤り、またはファイアウォールによるパッシブ/アクティブFTPのブロック。
解決法: 認証情報を設定し、パッシブモード（既定）で試す。
期待される結果: FTPセッションがログインして転送される。
症状: .meta4/.metalink のダウンロードに失敗する。
原因: XMLの破損、またはURLがMetalinkではなくHTMLエラーページを返している。
解決法: Metalink自体を先に取得して開き、URLがXMLを返すことを確認する。
期待される結果: aria2がMetalinkを解析して中のファイルを取得する。
症状: 小さな .html ファイルや「Access denied」ページが保存される。
原因: ログイン、トークン、確認ページが必要なリンク。
解決法: 実際のファイルURLを使う（またはブラウザのCookieを使う）。
期待される結果: 応答が実際のバイナリやファイル内容になる。
症状: torrentを開始してもピアが見つからない。
原因: トラッカーが停止、DHT/LPDなし、インバウンド用ポートなし。
解決法: 新しいトラッカーを追加し、DHT/LPDを有効化してポートを開放する。
期待される結果: ピアに接続して速度が0を上回る。
症状: ダウンロードは動くが遅く、相手から接続されない。
原因: インバウンド用ポートがない（開放なし、CGNAT/VPN下）。
解決法: TCP+UDPの1ポートを開放してaria2に設定する。CGNAT下ではポート開放付きVPNを使う。
期待される結果: クライアントがconnectableになり速度が改善する。
症状: torrentにトラッカーが載っているのに応答がない。
原因: トラッカーが停止しているか、ネットワークでUDPがブロックされている。
解決法: 新しいトラッカーに置き換え、予備にHTTP(S)も追加する。トラッカーリストを参照。
期待される結果: 少なくとも1つのトラッカーがアナウンスに成功し、ピアが現れる。
症状: マグネットURIを貼るとコマンドが壊れる。
原因: URI中の & や ? をシェルが解釈してしまう。
解決法: マグネットリンクは必ずダブルクォートで囲む。
期待される結果: aria2がメタデータを取得してtorrentを開始する。
症状: マグネットが実際のダウンロードに進まない。
原因: torrentのメタデータを取得できるピアやDHTソースがない（過疎スウォーム）。
解決法: トラッカーを追加してメタデータを取得できるようにするか、.torrent ファイルを直接使う。
期待される結果: メタデータが届き、.torrent が保存されてダウンロードが始まる。
症状: PTのtorrentに接続できないか、アカウントの比率が悪化する。
原因: PTではサイトのトラッカー専用、DHT/PEX禁止、シード必須などの独自ルールがある。
解決法: DHT/PEXを無効化し、要求比率までシードする。
期待される結果: PTがクライアントを受け入れ、シードが継続する。
症状: 100%後もタスクがずっと有効なまま。
原因: seed-ratio=0（無期限シード）や高い比率目標の設定。
解決法: 比率または時間の上限を設定する。
期待される結果: 条件を満たすとシードが停止する。
症状: aria2がtorrentやマグネットを開けない。
原因: .torrent の欠損や破損、または不正なマグネットURI。
解決法: .torrent を入手元から取り直すか、完全なマグネット文字列をコピーする。-S で確認する。
期待される結果: aria2がtorrent内容を一覧表示してダウンロードを完了する。
症状: 同じtorrentがaria2では明らかに遅い。
原因: 控えめな既定値（ピア数、ピア速度報酬、アップロード）とポート未開放。
解決法: スウォーム設定を調整し、ポートを開放する（高速化ガイド参照）。
期待される結果: 速度が他のクライアント並みに近づく。
症状: ダッシュボードがデーモンに接続しない。
原因: aria2がRPC付きで動いていない、ホストやポートの誤り、シークレット不一致。
解決法: トークン付きでRPCを起動し、WebUIに同じ値を入力する。
期待される結果: WebUIが「Connected」と表示する。
症状: RPC有効でaria2が起動しない。
原因: 別のaria2やアプリがポート6800を使っている。
解決法: 他のプロセスを止めるか、別のRPCポートを使う。
期待される結果: aria2が起動し、新しいポートでRPCが応答する。
症状: クライアントは接続するが、呼び出しが毎回エラーになる。
原因: クライアント側の rpc-secret がデーモンと一致していない。
解決法: WebUI/AriaNgとデーモンでまったく同じトークンを使う。
期待される結果: 呼び出しが成功し、ダウンロード一覧が表示される。
症状: HTTPSページから自前のRPCを呼ぶとブラウザコンソールがブロックする。
原因: HTTPSページからは素の http:///ws:// エンドポイントを呼べない。
解決法: リバースプロキシ経由でRPCをHTTPS/WSS化する（またはVPNを使う）し、そのURLを使う。
期待される結果: HTTPSのWebUIがブロックなしに接続できる。
症状: コンソールにCORSポリシーエラーが出る。
原因: デーモンがページのオリジンを許可していない。
解決法: rpc-allow-origin-all=true を有効にする（ポートが公開されていない場合のみ）。
期待される結果: ブラウザからRPCエンドポイントを呼べるようになる。
症状: シェルを閉じるとaria2が終了し、WebUIが切断する。
原因: aria2をフォアグラウンドで起動している（デーモン化していない）。
解決法: デーモンまたはサービスとして実行する。
期待される結果: シェル終了後もaria2が動き続ける。
症状: localhostでは動くが、LANのIPではつながらない。
原因: デーモンがlocalhostにのみバインドしているか、ファイアウォールがポートを塞いでいる。
解決法: 全インターフェースで待ち受け、ファイアウォールでポートを許可する（信頼できるネットワークでのみ）。
期待される結果: リモートクライアントがLANのIPでRPCに届く。
症状: aria2を呼ぶ連携側が自身のリクエスト解析に失敗する。
原因: JSON-RPCボディの形式誤り、またはメソッドやパラメータ形状の誤り。
解決法: リクエストボディを検証する。params は先頭にトークンを含める必要がある。
期待される結果: RPCがリクエストを受け付けて結果を返す。
症状: すべてのダウンロードが Exception: [AbstractCommand.cc:...] errorCode=1 で失敗する。
原因: 設定済みだが動いていないシステムプロキシ、ファイアウォールやウイルス対策、IPv6問題が多い。
解決法: 停止したプロキシを外すかIPv6を無効化する。hostsファイルも確認する。
期待される結果: aria2が接続して通常通りダウンロードする。
症状: aria2がホスト名を解決できない。
原因: DNSの故障、到達できないリゾルバ、不正なhostsエントリ。
解決法: DNSをテストし、特定のリゾルバを試すか非同期DNSを無効化する。
期待される結果: ホスト名が解決して接続できる。
症状: プロキシの誤り・停止・認証拒否でダウンロードが失敗する。
原因: 全体に設定したプロキシが動いていないか、認証情報が違う。
解決法: 正しいプロキシを認証情報付きで指定するか、クリアする。aria2 は HTTP プロキシのみ対応で、socks5:// を指定すると「unrecognized proxy format」で失敗します。
期待される結果: トラフィックがプロキシ経由になり、ダウンロードが進む。
症状: 特定のサイトだけ失敗し、他は成功する。ネットワークエラーが多い。
原因: IPv6接続の不具合。aria2がブラックホール化したIPv6経路を優先している。
解決法: aria2でIPv6を無効化する。
期待される結果: aria2がIPv4を使い、ダウンロードが成功する。
症状: ドメインは解決するが、どこにもつながらない（または127.0.0.1につながる）。
原因: デブロートやテレメトリーブロッカー、ウイルス対策がヌルルートを追加した。
解決法: hostsファイルとファイアウォールを確認し、ブロック項目を除去する。
期待される結果: ドメインが正規IPにつながり、ダウンロードできる。
症状: ディスク容量エラーでダウンロードが中断する。
原因: 保存先ドライブが満杯か、事前確保に空き以上の容量が必要。
解決法: 空きを作るか、別の --dir を選ぶか、事前確保を弱める。
期待される結果: 容量エラーなしにファイルが書き込まれる。
症状: aria2が保存先フォルダに書き込めない。
原因: ユーザー（またはコンテナ）に書き込み権限がない。
解決法: 自分が所有するフォルダに書くか、権限や所有者を修正する。
期待される結果: ファイルが作成・書き込みできる。
症状: ファイルやディレクトリの作成・書き込みでaria2が失敗する。
原因: パスの誤り、無効な文字、読み取り専用や外れたドライブ、ディスク故障。
解決法: 短く正当で書き込み可能なパスを使い、ドライブを確認する。
期待される結果: ディレクトリとファイルがI/Oエラーなしに作られる。
症状: FAT32/exFATのUSBメモリで大きなファイルが失敗・破損する。
原因: FAT32は1ファイル4GBの上限がある。一部のexFATドライバは巨大なスパースファイルに不安定。
解決法: NTFS/ext4を使うか、先に内蔵ディスクに保存する。
期待される結果: 適切なファイルシステムで大きなファイルが正しく書ける。
症状: ネットワーク共有への書き込みが遅い、固まる、失敗する。
原因: falloc/prealloc やスパースファイルが共有上で十分に対応されていない。
解決法: 共有上では none 確保を使い、ディスクキャッシュを小さくする。
期待される結果: 共有への書き込みが安定して完了する。
症状: ピース長不一致でレジュームに失敗する。
原因: .aria2 ファイルが別ファイルのもの（またはサーバー設定違い）。
解決法: 不一致の管理ファイルを消してやり直すか、変更を許可する。
期待される結果: ダウンロードが進み、管理ファイルが一致する。
症状: 同名ファイルがあるためaria2が書き込みを拒否する。
原因: 上書き保護が有効、または自動リネームが無効な名前に当たった。
解決法: 上書きまたは自動リネームを許可する。
期待される結果: aria2が上書きまたは改名して続行する。
症状: 大きなダウンロード中にシステム全体が重くなる。
原因: HDDや低速ディスクでの事前確保と多数の小さな書き込み。
解決法: falloc（または trunc）を使い、ディスクキャッシュを増やし、接続数を減らす。
期待される結果: ディスク負荷が滑らかになり、システムが応答する。
症状: 長いtorrent名やファイル名がWindowsで失敗する。
原因: 従来の260文字MAX_PATH制限。
解決法: --dir を短くするか、Windowsで長いパスを有効にする。
期待される結果: パス制限内にファイルが作られる。
症状: 再実行すると最初から始まる。
原因: -c なし、ファイルの改名や移動、管理ファイルの欠落。
解決法: file.ext と file.ext.aria2 を揃えて -c 付きで実行する。
期待される結果: 既存のピースから続行する。
症状: 完了後も file.ext.aria2 が残る。
原因: BitTorrentのシードが継続中か、整合性チェックを通っていない。
解決法: シードを止めてタスクを除去するか、ファイルを検証する。
期待される結果: ファイルが確定するとaria2が管理ファイルを削除する。.aria2ガイド参照。
症状: メディアプレイヤーやアーカイバが未完成ファイルを拒否する。
原因: 単に未完成（.aria2 ファイルが残っている）。
解決法: ダウンロードを続行する。管理ファイルは消さない。
期待される結果: 完了後はファイルが正常になる。
症状: aria2を再起動するとキューや進捗を失う。
原因: セッションの永続化が設定されていない。
解決法: セッションファイルと保存間隔を設定する。
期待される結果: 起動時にキューを読み込んで続行する。
症状: 起動直後に errorCode=1 Failed to open the file …/aria2.session で終了する。Docker コンテナが再起動を繰り返す。
原因: input-file がまだ存在しないセッションファイルを指している。aria2 は save-session 時にしか作成しないが、ファイルが無いと起動しない。このパスでは ${HOME} は展開されるが ~ は展開されない。
解決法: 空のファイルを一度作成し、aria2.conf では絶対パスか ${HOME} を使う。
期待される結果: aria2 が空のキューで起動し、以後は自動で保存・復元される。
症状: 重複タスクの追加をaria2が拒否する。
原因: 同じURIやtorrentが既にキューにある。
解決法: 既存タスクを管理する（または出力名を変える）。
期待される結果: タスクは1件だけ存在する。
症状: 帯域よりはるかに遅い速度しか出ない。
原因: aria2のHTTP既定はサーバーあたり1接続。
解決法: 接続数と分割数を増やす。
期待される結果: 回線速度に近づく。高速化ガイド参照。
症状: きりの良い数字（例：ちょうど5 MB/s）で張り付く。
原因: 制限オプションが設定されている（0 は無制限）。
解決法: ダウンロードやアップロードの制限を解除する。
期待される結果: ネットワークやディスクだけが上限になる。
症状: ダウンロード中にRAMやCPUを多く使う。
原因: 過大な disk-cache、数百の接続、巨大なピア数。
解決法: キャッシュと接続・ピア上限を下げる。
期待される結果: 許容できる速度を保ちつつリソース使用が下がる。
症状: 遅い配信元をaria2が見捨てる。
原因: このサーバーには lowest-speed-limit が高すぎる。
解決法: 下限を下げるか外す。
期待される結果: 遅い配信元でも続行する。
症状: オプションエラーでaria2が起動しない。
原因: タイポ、キーの綴り誤り、またはそのオプションを持たない古いビルド。
解決法: キーを オプションリファレンス で確認し、aria2を更新する。
期待される結果: aria2が設定を解析して起動する。
症状: ファイル内の設定が効かない。
原因: 場所や名前の誤り、またはコマンドラインフラグが上書きしている。
解決法: 正しいパスを使い、コマンドラインが優先されることを覚えておく。
期待される結果: 設定したオプションが起動時に反映される。
症状: yt-dlp経由のaria2フラグが適用されない。
原因: シェルの引用符で aria2c: の値が分割された。
解決法: 全体をダブルクォートで囲み、引用符を混ぜない。
期待される結果: フラグがaria2に届き、速度が上がる。
症状: RPCポートがインターネットから到達できる。
原因: rpc-listen-all=true に加え、ルーターのポート転送や公開IP。
解決法: 6800を公開しない。localhost/LANに留め、VPNまたは認証付きHTTPSリバースプロキシを使う。
期待される結果: 信頼できるネットワークだけがRPCに届く。
症状: WebUI用にCORSを有効にしたが露出が心配。
原因: CORSを開けると、ポートに届く限り訪問した任意のページがRPCを呼べる。
解決法: ポートは非公開にし、強いシークレットを使い、公開よりローカルページやプロキシを優先する。
期待される結果: WebUIは動きつつ、信頼できないサイトはRPCに届かない。
症状: 信頼できない出所から取得しようとしている。
原因: torrentやMetalinkは悪性コンテンツを指すことがある。他人の .aria2 ファイルは信頼できない。
解決法: 公式の出所を優先し、チェックサムや署名を確認し、.aria2 ファイルを別ファイルに流用しない。
期待される結果: ファイルのハッシュが公開ダイジェストと一致する。
該当する問題がありません。別のキーワードで試すか、ドキュメントを参照してください。
aria2は最後に発生したエラーのコードを返します。一目で失敗の種類を判別するために使います。echo $?（Linux/macOS）またはecho %ERRORLEVEL%（Windows）で直前のコードを確認できます。
| Code | 意味 | 関連 |
|---|---|---|
| 0 | すべてのダウンロードが成功しました。 | |
| 1 | 不明なエラー。 | |
| 2 | タイムアウトが発生しました。 | --timeout |
| 3 | リソースが見つかりませんでした。 | |
| 4 | 「resource not found」エラーが多すぎます。 | --max-file-not-found |
| 5 | 速度が遅すぎるためダウンロードを中止しました。 | --lowest-speed-limit |
| 6 | ネットワーク問題が発生しました。 | |
| 7 | aria2終了時に未完了のダウンロードがありました。 | |
| 8 | リモートサーバーがレジュームに対応していません。 | --continue |
| 9 | ディスク容量が不足しています。 | |
| 10 | ピース長が.aria2コントロールファイルと異なります。 | --allow-piece-length-change |
| 11 | 同じファイルが既にダウンロード中です。 | |
| 12 | 同じinfo hashのtorrentが既にダウンロード中です。 | |
| 13 | ファイルが既に存在します。 | --allow-overwrite |
| 14 | ファイルの名前変更に失敗しました。 | --auto-file-renaming |
| 15 | 既存のファイルを開けませんでした。 | |
| 16 | 新規ファイルを作成／既存ファイルを切り詰めできませんでした。 | |
| 17 | ファイルI/Oエラー。 | |
| 18 | ディレクトリを作成できませんでした。 | |
| 19 | 名前解決に失敗しました。 | |
| 20 | Metalinkドキュメントを解析できませんでした。 | |
| 21 | FTPコマンドが失敗しました。 | |
| 22 | HTTP応答ヘッダーが不正または予期しないものでした。 | |
| 23 | リダイレクトが多すぎます。 | |
| 24 | HTTP認証に失敗しました。 | |
| 25 | bencodedファイル（.torrent）を解析できませんでした。 | |
| 26 | .torrentファイルが破損しているかinfoがありません。 | |
| 27 | Magnet URIが不正です。 | |
| 28 | 不正または不明なオプション／引数です。 | |
| 29 | リモートサーバーが一時的にリクエストを処理できません。 | --retry-wait |
| 30 | JSON-RPCリクエストを解析できませんでした。 | |
| 31 | 予約済み（未使用）。 | |
| 32 | チェックサム検証に失敗しました。 | --check-integrity |
出典：aria2公式マニュアル。コードは診断の目安であり、排他的な原因特定ではありません — 詳細はログ（--log-level=debug）で確認してください。
デバッグログを有効にして1回再現し、関連する行を共有してください。
aria2c --log-level=debug --log=aria2-debug.log URL # or to stdout: aria2c --log-level=debug URL
aria2c --version）、OS、使用した正確なコマンドを含めてください。