跳到主要内容

aria2 选项参考

只收录真正会用到的选项。每一条都把 aria2c 参数对应到 aria2.conf 键，并给出示例。这是对官方手册（完整列表）的精选补充。

参数 aria2.conf 键 说明 示例
-ddir保存下载文件的目录。aria2c -d /downloads URL
-oout指定输出文件名。aria2c -o file.iso URL
-ccontinue继续下载部分完成的文件。aria2c -c URL
-iinput-file下载文本文件中列出的所有 URI。aria2c -i urls.txt
-jmax-concurrent-downloads同时进行的最大下载数量。aria2c -j 5 URL
-Z一次性获取所有 URI（批量模式）。aria2c -Z URL1 URL2
--save-sessionsave-session将当前下载写入会话文件，以便日后继续。aria2c --save-session=aria.session URL
--save-session-intervalsave-session-interval自动保存会话文件的间隔（秒）。--save-session-interval=60
--allow-overwriteallow-overwrite覆盖已存在文件，而不是失败退出。--allow-overwrite=true
-xmax-connection-per-server每个服务器的连接数（1–16）。数值越大，大文件越快。aria2c -x 16 URL
-ssplit将文件拆分为 N 个分片并行下载。aria2c -s 16 URL
-kmin-split-size分片的最小大小。aria2c -k 1M URL
-mmax-tries放弃前的重试次数。aria2c -m 5 URL
--retry-waitretry-wait两次重试之间的等待秒数。--retry-wait=5
-ttimeout连接超时（秒）。aria2c -t 60 URL
--connect-timeoutconnect-timeout建立连接的超时时间。--connect-timeout=30
--lowest-speed-limitlowest-speed-limit速度低于该值时中止下载。--lowest-speed-limit=10K
-Uuser-agent覆盖 HTTP User-Agent。aria2c -U "Mozilla/5.0" URL
--refererreferer发送 Referer 请求头。--referer="https://example.com"
--headerheader添加自定义 HTTP 请求头。--header="Authorization: Bearer X"
--load-cookiesload-cookies从 Netscape 格式文件读取 Cookie。--load-cookies=cookies.txt
--check-certificatecheck-certificate验证 TLS 证书（仅在信任来源时禁用）。--check-certificate=false
--ca-certificateca-certificateCA 证书包的路径。--ca-certificate=/etc/ssl/certs/ca-certificates.crt
-Vcheck-integrity校验分片校验和（Metalink/BitTorrent）。aria2c -V URL
--bt-trackerbt-tracker用于种子的逗号分隔 Tracker 列表。--bt-tracker="udp://tracker.opentrackr.org:1337/announce"
--bt-max-peersbt-max-peers每个种子的最大 Peer 数（0 = 不限）。--bt-max-peers=128
--enable-dhtenable-dht为无 Tracker 种子启用 DHT 网络。--enable-dht=true
--bt-enable-lpdbt-enable-lpd启用本地 Peer 发现。--bt-enable-lpd=true
--seed-ratioseed-ratio达到该上传/下载比后停止做种（0 = 一直做种）。--seed-ratio=1.0
--seed-timeseed-time完成后的做种分钟数。--seed-time=60
--bt-save-metadatabt-save-metadata从磁力链接保存种子元数据。--bt-save-metadata=true
--bt-seed-unverifiedbt-seed-unverified不校验已有分片直接做种。--bt-seed-unverified=true
--enable-rpcenable-rpc启动 JSON-RPC/XML-RPC 服务器。--enable-rpc=true
--rpc-listen-allrpc-listen-all监听所有网卡（仅在安全环境下使用）。--rpc-listen-all=true
--rpc-listen-portrpc-listen-portRPC 端口（默认 6800）。--rpc-listen-port=6800
--rpc-secretrpc-secret使用 RPC 接口所需的密钥令牌。--rpc-secret=YOUR_SECRET
--rpc-allow-origin-allrpc-allow-origin-all允许跨域浏览器客户端（Web UI）。--rpc-allow-origin-all=true
-Ddaemon作为后台守护进程运行。aria2c -D --enable-rpc
-llog将日志写入文件。aria2c -l aria2.log URL
--on-download-completeon-download-complete下载完成时执行的命令。--on-download-complete=/path/hook.sh
--on-download-erroron-download-error下载失败时执行的命令。--on-download-error=/path/err.sh
--all-proxyall-proxy适用于所有协议（HTTP/HTTPS/FTP）的 HTTP 代理。不支持 SOCKS。--all-proxy="http://127.0.0.1:8080"
--http-proxyhttp-proxy仅用于 HTTP 的代理。--http-proxy="http://127.0.0.1:8080"
--all-proxy-userall-proxy-user代理认证的用户名。--all-proxy-user=user
--all-proxy-passwdall-proxy-passwd代理认证的密码。--all-proxy-passwd=pass
--no-proxyno-proxy不使用代理的主机（逗号分隔）。--no-proxy=localhost,127.0.0.1
--disable-ipv6disable-ipv6禁用 IPv6。--disable-ipv6=true
--file-allocationfile-allocation预分配模式：none、prealloc、trunc、falloc。--file-allocation=falloc
--disk-cachedisk-cache启用磁盘缓存并设置其大小。--disk-cache=64M
--max-download-limitmax-download-limit单个下载的速度上限。--max-download-limit=1M
--max-overall-download-limitmax-overall-download-limit全局下载速度上限。--max-overall-download-limit=5M
--max-overall-upload-limitmax-overall-upload-limit全局上传速度上限。--max-overall-upload-limit=1M
--remote-timeremote-time将服务器时间戳应用到文件。--remote-time=true
--auto-file-renamingauto-file-renaming重命名而不是覆盖已存在文件。--auto-file-renaming=true

用这些选项生成配置

使用配置生成器把这些设置变成可直接使用的 aria2.conf，或阅读完整的 aria2 指南。遇到错误时可参考故障排查。