aria2c - 云端在线

程序：

您的姓名

aria2c - 超快速下载实用程序

概要

咏叹调2c [ ] [ | | | ] ...

商品描述

aria2 是一个用于下载文件的实用程序。 支持的协议有 HTTP(S)、FTP、SFTP、
BitTorrent 和 Metalink。 aria2 可以从多个来源/协议下载文件和
尝试利用您的最大下载带宽。 它支持从
HTTP(S)/FTP /SFTP 和 BitTorrent 同时下载，同时从
HTTP(S)/FTP/SFTP 上传到 BitTorrent 群。 使用 Metalink 块校验和，
aria2 在下载文件时自动验证数据块。

配置

注意:
大多数 FTP 相关选项也适用于 SFTP。 有些选项不是
有效对抗 SFTP（例如， --ftp-pasv)

基础 附加选项
-d, --dir=
存储下载文件的目录。

-一世， --输入文件=
下载 URI 中列出的 文件. 您可以为单个指定多个源
通过将多个 URI 放在由 TAB 字符。
此外，可以在每个 URI 行之后指定选项。 选项行必须开始
带有一个或多个空格字符 (空间 or TAB) 并且必须只包含一个
每行选项。 输入文件可以使用 gzip 压缩。 什么时候 文件 被指定为
-, aria2 将从中读取输入 标准输入。 请参阅 输入 文件 小节
细节。 另见 --延迟输入 选项。 另见 --保存会话文件
选项。

-l, --日志=
日志文件的文件名。 如果 - 指定，日志写入 标准输出。 如果
指定空字符串("")，或省略该选项，不写入日志
在所有。

-j, --max-concurrent-downloads=
为每个队列项设置最大并行下载数。 另见
- 分裂 选项。 默认： 5

-V, --检查完整性[=真|假]
通过验证片段散列或整个文件的散列来检查文件完整性。 这
选项仅在 BitTorrent、带有校验和的 Metalink 下载或
HTTP(S)/FTP 下载 --校验和 选项。 如果提供了片散列，这
选项可以检测文件的损坏部分并重新下载它们。 如果一个哈希
提供整个文件，只有在文件已经存在时才进行哈希检查
下载。 这是由文件长度决定的。 如果哈希检查失败，文件是
从头重新下载。 如果片散列和整个文件的散列都是
提供，仅使用散列。 默认： false

-C， --继续[=真|假]
继续下载部分下载的文件。 使用此选项可恢复
由网络浏览器或其他下载文件的程序启动的下载
从头开始依次。 目前此选项仅适用于
HTTP(S)/FTP 下载。

-H， --帮助[= | ]
帮助信息按标签分类。 标签以 #. 例如，键入
--帮助=#http 获取标记为选项的用法 #http. 如果非标记词是
给定，打印名称包含该词的选项的用法。 可用的
价值观： ＃基本的, ＃高级, #http, #https, #ftp, #金属链接, #比特流, ＃曲奇饼,
＃钩, ＃文件, #rpc, #校验和, #实验性的, #已弃用, ＃帮助, ＃所有 默认：
＃基本的

HTTP/FTP/SFTP 附加选项
--all-proxy=
为所有协议使用代理服务器。 要覆盖先前定义的代理，请使用
“”。 您还可以覆盖此设置并为特定的服务器指定代理服务器
协议使用 --http-代理, --https-代理 和 --ftp-代理 选项。 这会影响
所有下载。 PROXY 的格式是 [http://][用户:密码@]主机[:端口]。 看
还 环境 部分。

注意:
如果用户和密码嵌入在代理 URI 中并且它们也由
--{http,https,ftp,all}-proxy-{用户,passwd} 选项，稍后指定的那些
覆盖先前的选项。 例如，如果您指定 http-proxy-user=我的名字,
http-proxy-passwd=mypass 在 aria2.conf 中，您指定
--http-proxy="http://proxy" 在命令行上，然后你会得到 HTTP 代理
http://proxy 与用户 MYNAME 和密码 为mypass.

另一个例子：如果你在命令行中指定
--http-proxy="http://user:pass@proxy" --http-proxy-user="我的名字"
--http-proxy-passwd="mypass"，然后你会得到 HTTP 代理 http://proxy 与用户
MYNAME 和密码 为mypass.

再举一个例子：如果你在命令行中指定 --http-proxy-user="我的名字"
--http-proxy-passwd="mypass" --http-proxy="http://user:pass@proxy"，那么你会
获取 HTTP 代理 http://proxy 与用户 用户 和密码 通过.

--all-proxy-passwd=
设置密码 --全代理 选项。

--all-proxy-user=
设置用户 --全代理 选项。

--校验和= =
设置校验和。 TYPE 是哈希类型。 支持的哈希类型列在 哈希
算法 in 咏叹调2c -v. DIGEST 是十六进制摘要。 例如，设置 sha-1 摘要
看起来像这样： sha-1=0192ba11326fe2298c8cb4de616f4d4140213838 此选项适用
仅适用于 HTTP(S)/FTP 下载。

--连接超时=
以秒为单位设置连接超时以建立到 HTTP/FTP/代理的连接
服务器。 建立连接后，此选项无效，并且
- 暂停 改为使用选项。 默认： 60

--试运行[=true|false]
If true 给定，aria2 只检查远程文件是否可用，并且
不下载数据。 此选项对 HTTP/FTP 下载有影响。 比特流
下载被取消，如果 true 被指定。 默认： false

--lowest-speed-limit=
如果下载速度低于或等于此值（每字节字节数），则关闭连接
秒）。 0 意味着 aria2 没有最低速度限制。 你可以附加 K or M （1K
= 1024，1M = 1024K）。 此选项不影响 BitTorrent 下载。 默认： 0

-X， --max-connection-per-server=
每次下载到一台服务器的最大连接数。 默认： 1

--max-file-not-found=
如果 aria2 从远程 HTTP/FTP 服务器收到“找不到文件”状态 NUM
次没有得到一个字节，然后强制下载失败。 指定 0 至
禁用此选项。 此选项仅在使用 HTTP/FTP 服务器时有效。
默认： 0

-米， --最大尝试=
设置尝试次数。 0 意味着无限。 也可以看看 --重试等待. 默认： 5

-k, --min-split-size=
aria2 不会拆分小于 2*SIZE 的字节范围。 例如，让我们考虑
下载 20MiB 文件。 如果 SIZE 为 10M，aria2 可以将文件分成 2 个范围 [0-10MiB)
和 [10MiB-20MiB) 并使用 2 个来源下载它（如果 - 分裂 >= 2，当然）。 如果
SIZE 为 15M，因为 2*15M > 20MiB，aria2 不拆分文件并使用 1 下载
来源。 你可以附加 K or M （1K = 1024，1M = 1024K）。 可能的值： 1M -1024M
默认： 20M

--netrc-path=
指定 netrc 文件的路径。 默认： $(主页)/.netrc

注意:
.netrc 文件的权限必须是 600。否则，该文件将被忽略。

-n, --no-netrc[=true|false]
禁用 netrc 支持。 默认情况下启用 netrc 支持。

注意:
netrc 文件仅在启动时读取，如果 --无netrc is false。 因此，如果 --无netrc
is true 在启动时，整个会话期间没有可用的 netrc。 你
即使您发送，也无法启用 netrc --no-netrc=false 运用
aria2.changeGlobalOption().

--无代理=
使用或指定一个逗号分隔的主机名、域和网络地址列表
没有子网掩码，不应该使用代理。

注意:
对于带有子网掩码的网络地址，IPv4 和 IPv6 地址均可使用。
当前实现未解析 URI 中的主机名以进行比较
指定的网络地址 --无代理. 所以只有当 URI 有时它才有效
数字 IP 地址。

-o， --out=
下载文件的文件名。 当。。。的时候 --力顺序 使用选项，
此选项被忽略。

注意:
您不能为 Metalink 或 BitTorrent 下载指定文件名。 文件
此处指定的名称仅在提供给 aria2 的 URI 在
命令行直接，但不是在使用时 - 输入文件, --力顺序
选项。

示例：

$ aria2c -o myfile.zip"http://mirror1/file.zip“”http://mirror2/file.zip"

--代理方法=
设置在代理请求中使用的方法。 方法是 得到 or 隧道。 HTTPS
下载总是使用 隧道 不管这个选项。 默认： 得到

-R, --远程时间[=真|假]
从远程 HTTP/FTP 服务器检索远程文件的时间戳，如果它是
可用，将其应用到本地文件。 默认： false

--reuse-uri[=true|false]
如果没有未使用的 URI，则重用已使用的 URI。 默认： true

--重试等待=
设置重试之间等待的秒数。 什么时候 证券交易委员会 > 0, aria2 将重试下载
当 HTTP 服务器返回 503 响应时。 默认： 0

--server-stat-o​​f=
指定保存服务器性能配置文件的文件名。 你可以
使用加载保存的数据 --服务器统计-如果 选项。 看 服务器 性能 本人简介
下面的小节是关于文件格式的。

--server-stat-if=
指定文件名以加载服务器的性能配置文件。 加载的数据
将在某些 URI 选择器中使用，例如 反馈。 另请参见 --uri-选择器
选项。 看 服务器 性能 本人简介 下面的小节是关于文件格式的。

--server-stat-timeout=
以秒为单位指定超时以使服务器的性能配置文件无效，因为
最后联系他们。 默认： 86400 （24小时）

-是的， --拆分=
使用 N 个连接下载文件。 如果给出的 URI 多于 N 个，则前 N 个 URI
使用，剩余的 URI 用于备份。 如果给定的 URI 少于 N 个，
这些 URI 被多次使用，以便总共建立 N 个连接
同时。 同一个主机的连接数受限制
--每台服务器的最大连接数 选项。 另见 --最小分割大小 选项。
默认： 5

注意:
一些 Metalinks 规定要连接的服务器数量。 aria2 严格
尊重他们。 这意味着如果 Metalink 定义了 最大连接数 属性
低于 N，则 aria2 使用这个较低值的值而不是 N。

--stream-piece-selector=
指定用于 HTTP/FTP 下载的片段选择算法。 件意味着固定
在分段下载中并行下载的长度段。 如果 默认 is
给定，aria2 选择了一块，以减少建立的次数
联系。 这是合理的默认行为，因为建立连接是
昂贵的手术。 如果 为了 给定，aria2 选择具有最小值的片段
指数。 Index=0 表示文件的第一个。 这对于在观看电影时很有用
下载它。 --启用-http-管道 选项可能有助于减少
重新连接开销。 请注意 aria2 荣誉 --最小分割大小 选项，所以
有必要指定一个合理的值 --最小分割大小 选项。 如果
几何 给出，在开始时 aria2 选择具有最小索引的片段，例如
为了，但它以指数方式越来越多地保留先前选择的空间
片。 这将减少建立连接的次数，同时
它将首先下载文件的开头部分。 这将有助于查看
下载电影时。 默认： 默认

-t, --超时=
以秒为单位设置超时。 默认： 60

--uri-选择器=
指定 URI 选择算法。 可能的值为 为了, 反馈 和
自适应。 如果 为了 给定，URI 将按照出现在 URI 列表中的顺序进行尝试。
If 反馈 给出，aria2 使用在之前的下载中观察到的下载速度
并在 URI 列表中选择最快的服务器。 这也有效地跳过死
镜子。 观察到的下载速度是服务器性能配置文件的一部分
在...中提到 --server-stat-o​​f 和 --服务器统计-如果 选项。 如果 自适应 给出，
为第一个和保留的连接选择最好的镜像之一。 为了
补充的，它返回尚未测试的镜像，如果每个镜像
其中一些已经过测试，返回必须再次测试的镜子。
否则，它不再选择镜像。 喜欢 反馈，它使用性能
服务器的配置文件。 默认： 反馈

HTTP 具体 附加选项
--ca-证书=
使用 FILE 中的证书颁发机构来验证对等方。 证书文件
必须是 PEM 格式并且可以包含多个 CA 证书。 用
--检查证书 选项以启用验证。

注意:
如果您使用 OpenSSL 或最新版本的 GnuTLS 构建
gnutls_certificate_set_x509_system_trust() 功能和图书馆是正确的
配置为定位系统范围的 CA 证书存储，aria2 将
在启动时自动加载这些证书。

注意:
WinTLS 和 苹果TLS 不支持此选项。 相反，您将不得不导入
证书进入操作系统信任库。

--证书=
使用 FILE 中的客户端证书。 证书必须是 PKCS12 (.p12,
.pfx) 或 PEM 格式。

PKCS12 文件必须包含证书、密钥和可选的链
附加证书。 只能导入具有空白导入密码的 PKCS12 文件
开了！

使用 PEM 时，您必须通过以下方式指定私钥 --私钥 以及。

注意:
WinTLS 目前不支持 PEM 文件。 用户必须使用 PKCS12 文件。

注意:
苹果TLS 用户应使用 KeyChain Access 实用程序导入客户端
证书并从信息对话框中获取 SHA-1 指纹
对应那个证书。 要启动 aria2c 使用 --证书=.
或者，也支持 PKCS12 文件。 但是，PEM 文件不是
支持的。

--检查证书[=true|false]
使用中指定的证书验证对等方 --ca-证书 选项。 默认：
true

--http-accept-gzip[=true|false]
提交 接受： 放气， GZIP 如果远程服务器请求标头和膨胀响应
回应 内容编码： GZIP or 内容编码： 放气. 默认： false

注意:
一些服务器响应 内容编码： GZIP 对于本身是的文件
gzip 压缩文件。 由于响应标头，aria2 无论如何都会使它们膨胀。

--http-auth-challenge[=true|false]
仅在服务器请求时发送 HTTP 授权头。 如果 false is
设置，那么授权头总是被发送到服务器。 有一个
例外：如果用户名和密码嵌入在 URI 中，则授权标头为
无论此选项如何，始终发送到服务器。 默认： false

--http-无缓存[=true|false]
提交 缓存控制： 无缓存 和 编译指示： 无缓存 标题以避免缓存内容。
If false 给出，这些标头不会发送，您可以添加 Cache-Control 标头
使用您喜欢使用的指令 --标题 选项。 默认： false

--http-user=
设置 HTTP 用户。 这会影响所有 URI。

--http-passwd=
设置 HTTP 密码。 这会影响所有 URI。

--http-proxy=
为 HTTP 使用代理服务器。 要覆盖先前定义的代理，请使用“”。 看
还有 --全代理 选项。 这会影响所有 http 下载。 PROXY的格式
is [http://][用户:密码@]主机[:端口]

--http-proxy-passwd=
设置密码 --http-代理.

--http-proxy-user=
设置用户 --http-代理.

--https-代理=
为 HTTPS 使用代理服务器。 要覆盖先前定义的代理，请使用“”。 看
还有 --全代理 选项。 这会影响所有 https 下载。 PROXY的格式
is [http://][用户:密码@]主机[:端口]

--https-proxy-passwd=
设置密码 --https-代理.

--https-proxy-user=
设置用户 --https-代理.

--私钥=
使用 FILE 中的私钥。 私钥必须解密并采用 PEM 格式。
给出加密时的行为是未定义的。 也可以看看 - 证书
选项。

--推荐人=
设置一个 http 引荐来源网址（Referer）。 这会影响所有 http/https 下载。 如果 * is
给定，下载 URI 也用作引用。 这在使用时可能很有用
连同 --参数化-uri 选项。

--enable-http-keep-alive[=true|false]
启用 HTTP/1.1 持久连接。 默认： true

--enable-http-pipelined[=true|false]
启用 HTTP/1.1 流水线。 默认： false

注意:
从性能角度来看，启用此选项通常没有优势。

--header=
将 HEADER 附加到 HTTP 请求标头。 您可以重复使用此选项来
指定多个标题：

$ aria2c --header="XA: b78" --header="XB: 9J1" "http://host/file"

--load-cookies=
使用 Firefox3 格式 (SQLite3)、Chromium/Google Chrome 从 FILE 加载 Cookie
(SQLite3) 和 Mozilla/Firefox(1.x/2.x)/Netscape 格式。

注意:
如果 aria2 是在没有 libsqlite3 的情况下构建的，那么它不支持 Firefox3 和
Chromium/Google Chrome cookie 格式。

--save-cookies=
将 Cookie 以 Mozilla/Firefox(1.x/2.x)/Netscape 格式保存到 FILE。 如果 FILE 已经
存在，它被覆盖。 会话 Cookie 也被保存，它们的到期值
被视为 0。可能的值： /路径/到/文件

--use-head[=true|false]
对 HTTP 服务器的第一个请求使用 HEAD 方法。 默认： false

-U， --用户代理=
为 HTTP(S) 下载设置用户代理。 默认： 咏叹调2/$版本, $VERSION 是
替换为包版本。

FTP / SFTP 具体 附加选项
--ftp-用户=
设置FTP用户。 这会影响所有 URI。 默认： 匿名

--ftp-passwd=
设置FTP密码。 这会影响所有 URI。 如果嵌入了用户名但密码是
URI 中缺失，aria2 尝试使用 .netrc 解析密码。 如果找到密码
在 .netrc 中，然后将其用作密码。 如果没有，请使用这里指定的密码
选项。 默认： 咏叹调2用户@

-p, --ftp-pasv[=真|假]
在 FTP 中使用被动模式。 如果 false 给出，将使用主动模式。
默认： true

注意:
SFTP 传输忽略此选项。

--ftp-代理=
使用代理服务器进行 FTP。 要覆盖先前定义的代理，请使用“”。 看
还有 --全代理 选项。 这会影响所有 ftp 下载。 PROXY的格式
is [http://][用户:密码@]主机[:端口]

--ftp-proxy-passwd=
设置密码 --ftp-代理 选项。

--ftp-proxy-user=
设置用户 --ftp-代理 选项。

--ftp-type=
设置 FTP 传输类型。 TYPE 是 二进制 or ASCII. 默认： 二进制

注意:
SFTP 传输忽略此选项。

--ftp-重用连接[=true|false]
在 FTP 中重用连接。 默认： true

--ssh-host-key-md= =
设置 SSH 主机公钥的校验和。 TYPE 是哈希类型。 支持的哈希类型是
SHA-1 or md5. DIGEST 是十六进制摘要。 例如：
sha-1=b030503d4de4539dc7885e6f0f5e256704edf4c3. 此选项可用于
使用 SFTP 时验证服务器的公钥。 如果未设置此选项，则
默认情况下，不进行验证。

BitTorrent/Metalink 附加选项
--选择文件= ...
通过指定其索引来设置要下载的文件。 您可以使用找到文件索引
此 --显示文件 选项。 可以通过使用指定多个索引 ,，为
例： 3,6。 你也可以使用 - 指定范围： 1-5. , 和 - 可以使用
一起： 1-5,8,9. 与 -M 选项一起使用时，索引可能会因
查询（见 --元链接-* 选项）。

注意:
在多文件 torrent 中，此选项指定的相邻文件也可能是
下载。 这是设计使然，而不是错误。 单件可能包括几个
文件或文件的一部分，aria2 将这部分写入适当的文件。

-S， --显示文件[=true|false]
打印“.torrent”、“.meta4”和“.metalink”文件的文件列表并退出。 如果
“.torrent”文件的附加信息（信息哈希、片段长度等）也是
打印。

BitTorrent的 具体 附加选项
--bt-detach-seed-only[=true|false]
在计算并发活动下载时排除仅种子下载（请参阅 -j
选项）。 这意味着如果 -j3 给出并且这个选项被打开并且 3
下载处于活动状态，其中之一进入种子模式，然后从
活动下载计数（因此变为 2），并且下一个下载在队列中等待
开始。 但请注意，播种项目仍被识别为活动下载
在 RPC 方法中。 默认： false

--bt-enable-lpd[=true|false]
启用本地对等发现。 如果在 torrent 中设置了私有标志，则 aria2 不会
使用此功能进行下载，即使 true 给出。 默认： false

--bt-exclude-tracker= [，...]
逗号分隔的 BitTorrent 跟踪器的要删除的公告 URI 列表。 您可以使用
特殊价值 * 它匹配所有 URI，从而删除所有公告 URI。 什么时候
指定 * 在 shell 命令行中，不要忘记转义或引用它。 也可以看看
--bt-跟踪器 选项。

--bt-external-ip=
指定要报告给 BitTorrent 跟踪器的外部 IP 地址。 虽然这
函数被命名 外部，它可以接受任何类型的 IP 地址。 IPADDRESS 必须
是一个数字 IP 地址。

--bt-force-加密[=true|false]
需要使用 arc4 对 BitTorrent 消息负载加密。 这是一个简写
--bt-需要加密 --bt-最小加密级别=弧4。 此选项不会更改
这些选项的选项值。 如果 true 给出，拒绝旧版 BitTorrent 握手
并且只使用混淆握手并始终加密消息有效负载。 默认：
false

--bt-hash-check-seed[=true|false]
If true 给出，在使用哈希检查后 --检查完整性 选项和文件是
完成，继续种子文件。 如果您只想检查文件并下载它
当它损坏或不完整时，将此选项设置为 false. 这个选项有效果
仅适用于 BitTorrent 下载。 默认： true

--bt-lpd-接口=
使用给定的接口进行本地对等发现。 如果未指定此选项，则
选择默认接口。 您可以指定接口名称和 IP 地址。
可能的值：接口、IP 地址

--bt-max-open-files=
指定在多文件 BitTorrent/Metalink 下载中打开的最大文件数
全球。 默认： 100

--bt-max-peers=
指定每个 torrent 的最大对等点数。 0 意味着无限。 也可以看看
--bt-请求对等速度限制 选项。 默认： 55

--bt-元数据-only[=true|false]
仅下载元数据。 元数据中描述的文件将不会被下载。
此选项仅在使用 BitTorrent Magnet URI 时有效。 也可以看看
--bt-save-元数据 选项。 默认： false

--bt-min-crypto-level=plain|arc4
设置加密方法的最低级别。 如果提供了几种加密方法
通过对等方，aria2 选择满足给定级别的最低级别。 默认：
平原

--bt-prioritize-piece=head[= ],尾[= ]
尝试首先下载每个文件的第一个和最后一个部分。 这对
预览文件。 参数可以包含 2 个关键字： 头 和 尾巴. 包括
两个关键字，它们必须用逗号分隔。 这些关键字可能需要一个
参数，大小。 例如，如果 头= 被指定，件在范围内
每个文件的第一个 SIZE 字节获得更高的优先级。 尾巴= 表示范围
每个文件的最后 SIZE 字节。 SIZE 可以包括 K or M （1K = 1024，1M = 1024K）。 如果
省略 SIZE，使用 SIZE=1M。

--bt-remove-unselected-file[=true|false]
在 BitTorrent 中完成下载后删除未选择的文件。 选择
文件，使用 - 选择文件 选项。 如果不使用，则假定所有文件都是
被选中。 请谨慎使用此选项，因为它实际上会删除文件
从你的磁盘。 默认： false

--bt-require-crypto[=true|false]
If true 已给出，aria2 不接受并与旧版建立连接
BitTorrent 握手（\19BitTorrent 协议）。 因此 aria2 总是使用混淆
握手。 默认： false

--bt-request-peer-speed-limit=
如果每个torrent的整体下载速度都低于SPEED，则暂时使用aria2
增加对等点的数量以尝试提高下载速度。 配置这个
带有您首选下载速度的选项可以在某些情况下提高您的下载速度
案件。 你可以附加 K or M （1K = 1024，1M = 1024K）。 默认： 50

--bt-save-metadata[=true|false]
将元数据另存为“.torrent”文件。 此选项仅在 BitTorrent 时有效
使用磁铁 URI。 文件名是带有后缀“.torrent”的十六进制编码信息哈希。
保存目录与保存下载文件的目录相同。 如果
相同的文件已经存在，元数据不会被保存。 也可以看看 --bt-元数据-only
选项。 默认： false

--bt-seed-未验证[=true|false]
在不验证片段哈希的情况下为先前下载的文件播种。 默认： false

--bt-stop-timeout=
如果下载速度在连续 SEC 秒内为 0，则停止 BitTorrent 下载。 如果 0 is
给定，此功能已禁用。 默认： 0

--bt-tracker= [，...]
附加 BitTorrent 跟踪器的公告 URI 的逗号分隔列表。 这些 URI
不受 --bt-排除跟踪器 选项，因为它们是在 URI 之后添加的
in --bt-排除跟踪器 选项被删除。

--bt-tracker-connect-timeout=
以秒为单位设置连接超时以建立与跟踪器的连接。 之后
连接已建立，此选项无效且 --bt-跟踪器超时
改为使用选项。 默认： 60

--bt-tracker-interval=
设置跟踪器请求之间的间隔（以秒为单位）。 这完全覆盖
间隔值和 aria2 只使用这个值并忽略最小间隔和
跟踪器响应中的间隔值。 如果 0 已设置，aria2 确定间隔
基于跟踪器的响应和下载进度。 默认： 0

--bt-tracker-timeout=
以秒为单位设置超时。 默认： 60

--dht-入口点= ：
将主机和端口设置为 IPv4 DHT 网络的入口点。

--dht-入口点6= ：
将主机和端口设置为 IPv6 DHT 网络的入口点。

--dht-文件-路径=
将 IPv4 DHT 路由表文件更改为 PATH。 默认： $HOME/.aria2/dht.dat

--dht-file-path6=
将 IPv6 DHT 路由表文件更改为 PATH。 默认： $HOME/.aria2/dht6.dat

--dht-listen-addr6=
指定地址以绑定 IPv6 DHT 的套接字。 应该是全球单播IPv6
主机地址。

--dht-listen-port= ...
设置 DHT（IPv4、IPv6）和 UDP 跟踪器使用的 UDP 侦听端口。 多个端口可以
通过使用指定 ,， 例如： 6881,6885。 你也可以使用 - 指定一个
范围： 6881-6999. , 和 - 可以一起使用。 默认： 6881-6999

注意:
确保为传入的 UDP 流量打开指定的端口。

--dht-message-timeout=
以秒为单位设置超时。 默认： 10

--enable-dht[=true|false]
启用 IPv4 DHT 功能。 它还启用 UDP 跟踪器支持。 如果一个私人
标志设置在 torrent 中，aria2 不使用 DHT 进行该下载，即使 true is
给。 默认： true

--enable-dht6[=true|false]
启用 IPv6 DHT 功能。 如果在 torrent 中设置了私有标志，则 aria2 不会
使用 DHT 进行该下载，即使 true 给出。 用 --dht-监听端口 选项
指定要侦听的端口号。 也可以看看 --dht-监听-addr6 选项。

--enable-peer-exchange[=true|false]
启用对等交换扩展。 如果在 torrent 中设置了私有标志，则此功能
该下载被禁用，即使 true 给出。 默认： true

--follow-torrent=true|false|mem
If true or 成员 指定，当文件后缀为 。激流 或内容类型
is 应用程序/x-bittorrent 下载后，aria2 将其解析为 Torrent 文件并
下载其中提到的文件。 如果 成员 指定，torrent 文件不是
写入磁盘，但只是保存在内存中。 如果 false 被指定，
。激流 文件被下载到磁盘，但没有被解析为一个 torrent 和它的
内容未下载。 默认： true

-O, --index-out= =
为 index=INDEX 的文件设置文件路径。 您可以使用以下命令找到文件索引
--显示文件 选项。 PATH 是指定路径的相对路径 --目录
选项。 您可以多次使用此选项。 使用此选项，您可以指定
BitTorrent 下载的输出文件名。

--listen-port= ...
为 BitTorrent 下载设置 TCP 端口号。 可以指定多个端口
运用 ,， 例如： 6881,6885。 你也可以使用 - 指定范围：
6881-6999. , 和 - 可以一起使用： 6881-6889,6999. 默认： 6881-6999

注意:
确保为传入 TCP 流量打开指定的端口。

--max-overall-upload-limit=
以字节/秒为单位设置最大整体上传速度。 0 意味着不受限制。 你可以附加 K
or M （1K = 1024，1M = 1024K）。 要限制每个 torrent 的上传速度，请使用
--最大上传限制 选项。 默认： 0

-你， --max-upload-limit=
以字节/秒为单位设置每个种子的最大上传速度。 0 意味着不受限制。 你可以
附加 K or M （1K = 1024，1M = 1024K）。 要限制整体上传速度，请使用
--最大总体上传限制 选项。 默认： 0

--peer-id-prefix=
指定peer ID的前缀。 BitTorrent 中的对等 ID 为 20 字节长度。 如果更多
指定的字节数超过 20 个字节，则仅使用前 20 个字节。 如果少于 20 个字节
指定时，添加随机字节数据使其长度为 20 个字节。

默认： A2-$MAJOR-$Minor-$PATCH-, $MAJOR, $MINOR 和 $PATCH 被替换为主要，
分别是次要和补丁版本号。 例如，aria2 版本 1.18.8
有前缀 ID A2-1-18-8-.

--种子比率=
指定份额比率。 种子完成种子直到共享比率达到 RATIO。 你
强烈鼓励指定等于或大于 1.0 这里。 指定 0.0 if
无论份额比例如何，您都打算进行播种。 如果 --播种时间 选项是
与此选项一起指定，当至少满足其中一个条件时，播种结束
很满意。 默认： 1.0

--种子时间=
以分钟为单位指定播种时间。 另见 --种子比率 选项。

注意:
指定 --种子时间=0 下载完成后禁用种子。

-T, --torrent-文件=
“.torrent”文件的路径。 您不需要使用此选项，因为
您可以不指定“.torrent”文件 --torrent 文件.

金属油墨 具体 附加选项
--follow-metalink=true|false|mem
If true or 成员 指定，当文件后缀为 .meta4 or .metallink or
内容类型 应用程序/metalink4+xml or 应用程序/metalink+xml is
下载后，aria2 将其解析为 metalink 文件并下载其中提到的文件。
If 成员 指定，Metalink 文件不会写入磁盘，而只是保留
在记忆中。 如果 false 被指定， .metallink 文件下载到磁盘，
但不会被解析为 metalink 文件，并且不会下载其内容。 默认：
true

--metalink-base-uri=
指定基本 URI 以解析 metalink:url 和 metalink:metaurl 中的相对 URI
存储在本地磁盘中的 metalink 文件中的元素。 如果 URI 指向目录，则 URI
必须以 /.

-M, --metalink-文件=
“.meta4”和“.metalink”文件的文件路径。 读取输入 标准输入 ，尤其是 - is
指定的。 您不需要使用此选项，因为您可以指定
“.metalink”文件没有 --metalink-文件.

--metalink-语言=
要下载的文件的语言。

--metalink-location= [，...]
首选服务器的位置。 以逗号分隔的位置列表是
可接受的，例如， 日本，美国.

--metalink-os=
要下载的文件的操作系统。

--metalink-version=
要下载的文件的版本。

--metalink-首选协议=
指定首选协议。 可能的值为 HTTP, HTTPS, FTP 和 没有.
指定 没有 禁用此功能。 默认： 没有

--metalink-enable-unique-protocol[=true|false]
If true 给出了几种协议可用于 metalink 中的镜像
文件，aria2 使用其中之一。 用 --metalink-首选协议 指定选项
协议的偏好。 默认： true

RPC的 附加选项
--enable-rpc[=true|false]
启用 JSON-RPC/XML-RPC 服务器。 强烈建议设置secret
授权令牌使用 --rpc-秘密 选项。 也可以看看 --rpc-监听端口 选项。
默认： false

--暂停[=真|假]
添加后暂停下载。 此选项仅在以下情况下有效 --enable-rpc=true is
给。 默认： false

--暂停元数据[=true|false]
暂停因元数据下载而创建的下载。 有3种类型
aria2 中的元数据下载： (1) 下载 .torrent 文件。 (2)下载torrent
使用磁力链接的元数据。 (3)下载metalink文件。 这些元数据
downloads 将使用其元数据生成下载。 此选项暂停这些
后续下载。 此选项仅在以下情况下有效 --enable-rpc=true is
给。 默认： false

--rpc-allow-origin-all[=true|false]
添加带有值的 Access-Control-Allow-Origin 标头字段 * 到 RPC 响应。
默认： false

--rpc-证书=
将 FILE 中的证书用于 RPC 服务器。 证书必须在
PKCS12（.p12、.pfx）或 PEM 格式。

PKCS12 文件必须包含证书、密钥和可选的链
附加证书。 只能导入具有空白导入密码的 PKCS12 文件
开了！

使用 PEM 时，您必须通过以下方式指定私钥 --rpc-私钥 以及。
使用 --rpc-安全 启用加密的选项。

注意:
WinTLS 目前不支持 PEM 文件。 用户必须使用 PKCS12 文件。

注意:
苹果TLS 用户应使用 KeyChain Access 实用程序首先生成一个
自签名 SSL-Server 证书，例如使用向导，并获取 SHA-1
来自与该新证书对应的信息对话框的指纹。
使用 aria2c 启动 --rpc-安全 使用 --rpc-证书=. 或者
PKCS12 文件也受支持。 但是，不支持 PEM 文件。

--rpc-listen-all[=true|false]
在所有网络接口上侦听传入的 JSON-RPC/XML-RPC 请求。 如果假是
给定，仅在本地环回接口上侦听。 默认： false

--rpc-listen-port=
指定要侦听的 JSON-RPC/XML-RPC 服务器的端口号。 可能的值：
1024 -65535 默认： 6800

--rpc-max-request-size=
设置 JSON-RPC/XML-RPC 请求的最大大小。 如果 aria2 检测到请求超过
SIZE 字节，它会断开连接。 默认： 2M

--rpc-passwd=
设置 JSON-RPC/XML-RPC 密码。

警告：
--rpc-密码 选项将在未来版本中弃用。 迁移到
--rpc-秘密 尽快选择。

--rpc-private-key=
将 FILE 中的私钥用于 RPC 服务器。 私钥必须被解密和
PEM 格式。 用 --rpc-安全 启用加密的选项。 也可以看看
--rpc-证书 选项。

--rpc-save-upload-metadata[=true|false]
将上传的 torrent 或 metalink 元数据保存在指定的目录中 --目录
选项。 文件名由元数据的 SHA-1 哈希十六进制字符串加上
延期。 对于 torrent，扩展名为“.torrent”。 对于 metalink，它是“.meta4”。
如果此选项设置为 false，则下载添加的 aria2.addTorrent() or
aria2.addMetalink() 不会被拯救 - 保存会议 选项。 默认： false

--rpc-秘密=
设置 RPC 秘密授权令牌。 读 RPC的 授权 秘密 象征 知道如何
使用此选项值。

--rpc-安全[=真|假]
RPC 传输将由 SSL/TLS 加密。 RPC 客户端必须使用 https 方案
访问服务器。 对于 WebSocket 客户端，使用 wss 方案。 用 --rpc-证书
和 --rpc-私钥 选项来指定服务器证书和私钥。

--rpc-用户=
设置 JSON-RPC/XML-RPC 用户。

警告：
--rpc-用户 选项将在未来版本中弃用。 迁移到
--rpc-秘密 尽快选择。

高级 附加选项
--允许覆盖[=true|false]
如果相应的控制文件不存在，则从头开始重新下载。 看
还 --自动文件重命名 选项。 默认： false

--allow-piece-length-change[=true|false]
如果给出 false，则 aria2 在片段长度与长度不同时中止下载
在控制文件中。 如果给出 true，您可以继续，但有一些下载进度
会迷路。 默认： false

--总是恢复[=true|false]
始终恢复下载。 如果 true 给出，aria2 总是尝试恢复下载和
如果无法恢复，则中止下载。 如果 false 是给定的，当所有给定的 URIs
不支持简历或 aria2 遭遇 N 不支持简历的 URI (N
是使用指定的值 --最大恢复失败尝试次数 选项），aria2 下载
从头开始文件。 看 --最大恢复失败尝试次数 选项。 默认： true

--async-dns[=true|false]
启用异步 DNS。 默认： true

--async-dns-server= [，...]
异步 DNS 解析器中使用的 DNS 服务器地址的逗号分隔列表。
通常异步 DNS 解析器从中读取 DNS 服务器地址 / etc / resolv.conf中.
使用此选项时，它使用此选项中指定的 DNS 服务器而不是
那些在 / etc / resolv.conf中. 您可以同时指定 IPv4 和 IPv6 地址。 这个选项
当系统没有时很有用 / etc / resolv.conf中 并且用户没有
创建它的权限。

--自动文件重命名[=true|false]
如果相同的文件已存在，则重命名文件名。 此选项仅适用于
HTTP(S)/FTP 下载。 新文件名附加了一个点和一个数字 (1..9999)。
默认： true

--自动保存间隔=
每 SEC 秒保存一个控制文件 (*.aria2)。 如果 0 给定，控制文件是
下载时不保存。 aria2 在停止时保存控制文件，不管
价值。 可能的值介于 0 至 600. 默认： 60

--条件获取[=true|false]
仅当本地文件比远程文件旧时才下载文件。 这个功能
仅适用于 HTTP(S) 下载。 如果指定文件大小则不起作用
在 Metalink 中。 它还忽略 Content-Disposition 标头。 如果存在控制文件，
此选项将被忽略。 此函数使用 If-Modified-Since 头来获取
有条件地只有较新的文件。 当获取本地文件的修改时间时，它
使用用户提供的文件名（参见 - 出去 选项）或 URI 中的文件名部分，如果 - 出去
未指定。 要覆盖现有文件， --允许覆盖 是必须的。
默认： false

--conf-path=
将配置文件路径更改为PATH。 默认： $HOME/.aria2/aria2.conf

--console-log-level=
将日志级别设置为输出到控制台。 LEVEL 是 调试, info, 注意, 警告 or
错误. 默认： 注意

-D, --守护进程[=真|假]
作为守护进程运行。 当前工作目录将更改为 / 和标准
输入、标准输出和标准错误将被重定向到 的/ dev / null的. 默认：
false

--延迟输入[=true|false]
If true 给定，aria2 不会从指定的文件中读取所有 URI 和选项
- 输入文件 启动时的选项，但稍后需要时会一一读取。 这个
如果输入文件包含大量要下载的 URI，则可能会减少内存使用。 如果 false
给定后，aria2 会在启动时读取所有 URI 和选项。 默认： false

--disable-ipv6[=true|false]
禁用 IPv6。 如果您必须使用损坏的 DNS 并希望避免
AAAA 记录查找非常慢。 默认： false

--磁盘缓存=
启用磁盘缓存。 如果 SIZE 是 0，磁盘缓存被禁用。 此功能缓存
内存中下载的数据，最多增长到 SIZE 字节。 缓存存储
为 aria2 实例创建并由所有下载共享。 的优势之一
磁盘缓存是减少磁盘 I/O 因为数据是以更大的单位写入的
它按文件的偏移量重新排序。 如果涉及哈希检查并且
数据缓存在内存中，我们不需要从磁盘中读取它们。 大小可以
包括 K or M （1K = 1024，1M = 1024K）。 默认： 16M

--下载结果=
这个选项改变了方式 下载 成果 已格式化。 如果 OPT 是 默认， 打印
GID、状态、平均下载速度和路径/URI。 如果涉及多个文件，
打印第一个请求文件的路径/URI 并省略其余文件。 如果OPT
is ，, 打印 GID、状态、平均下载速度、进度百分比和
路径/URI。 为每个请求打印进度百分比和路径/URI
文件中的每一行。 默认： 默认

--dscp=
为 QoS 在 BitTorrent 流量的传出 IP 数据包中设置 DSCP 值。 这个参数
仅在 IP 数据包的 TOS 字段中设置 DSCP 位，而不是整个字段。 如果你拿
值来自 /usr/include/netinet/ip.h 将它们除以 4（否则值将是
不正确，例如您的 CS1 班级会变成 CS4）。 如果你把常用的
来自 RFC、网络供应商文档、维基百科或任何其他来源的值，使用
他们原样。

--rlimit-nofile=
设置打开文件描述符的软限制。 此打开仅在以下情况下有效：

一种。 系统支持它（posix）

湾限制不超过硬限制。

C。 指定的限制大于当前的软限制。

这相当于通过ulimit设置nofile，只不过它永远不会减少
极限。

此选项仅在支持 rlimit API 的系统上可用。

--启用颜色[=真|假]
为终端启用颜色输出。 默认： true

--enable-mmap[=true|false]
将文件映射到内存中。 如果文件空间不可用，此选项可能不起作用
预先分配。 看 --文件分配.

默认： false

--事件轮询=
指定轮询事件的方法。 可能的值为 民意调查, 队列,
端口, 英寸 和 选择。 对于每个 民意调查, 队列, 端口 和 英寸，如果
系统支持。 民意调查 在最近的 Linux 上可用。 队列 可以用
各种 *BSD 系统，包括 Mac OS X。 端口 在 Open Solaris 上可用。 这
默认值可能因您使用的系统而异。

--文件分配=
指定文件分配方法。 没有 不预先分配文件空间。 预分配
在下载开始之前预先分配文件空间。 这可能需要一些时间，具体取决于
关于文件的大小。 如果您使用的是较新的文件系统，例如 ext4（带有
范围支持）、btrfs、xfs 或 NTFS（仅限 MinGW 构建）， 法洛克 是你最好的选择。
它几乎立即分配大（很少 GiB）文件。 不要使用 法洛克 与遗产
ext3 和 FAT32 等文件系统，因为它几乎与 预分配
它完全阻塞 aria2 直到分配完成。 法洛克 可能不可用
如果您的系统没有 posix_fallocate(3) 功能。 截断 使用 截断(2)
系统调用或特定于平台的对应物将文件截断为指定的
长度。

可能的值： 没有, 预分配, 截断, 法洛克 默认： 预分配

--强制保存[=true|false]
保存下载 - 保存会议 即使下载完成或
移除。 在这种情况下，此选项还会保存控制文件。 这可能有用
保存被识别为完成状态的 BitTorrent 种子。 默认： false

--gid=
手动设置 GID。 aria2 通过称为 GID 的 ID 标识每个下载。 GID 必须
是 16 个字符的十六进制字符串，因此 [0-9a-zA-Z] 是允许的，前导零必须
不被剥夺。 GID 全 0 是保留的，不得使用。 GID 必须是
唯一，否则报错，不添加下载。 这个选项是
恢复使用保存的会话时很有用 - 保存会议 选项。 如果这
选项未使用，新的 GID 由 aria2 生成。

--hash-check-only[=true|false]
If true 给出，在使用哈希检查后 --检查完整性 选项，中止下载
下载是否完成。 默认： false

--人类可读[=true|false]
在控制台中以人类可读格式（例如，1.2Ki、3.4Mi）打印尺寸和速度
读出。 默认： true

--接口=
将套接字绑定到给定的接口。 您可以指定接口名称、IP 地址和
主机名。 可能的值：接口、IP 地址、主机名

注意:
如果一个接口有多个地址，强烈建议指定IP
明确地址。 也可以看看 --禁用-ipv6. 如果您的系统没有
获取地址(3), 此选项不接受接口名称。

--max-download-result=
设置保存在内存中的最大下载结果数。 下载结果是
已完成/错误/已删除的下载。 下载结果存储在FIFO队列中
最多可存储 NUM 个下载结果。 当队列已满和新下载时
结果被创建，最旧的下载结果从队列的前面移除
新的被推到后面。 在此选项中设置大数字可能会导致
数千次下载后内存消耗高。 指定 0 表示没有
下载结果被保留。 默认： 1000

--max-resume-failure-tries=
当与 --总是恢复=假， aria2 在 aria2 时从头开始下载文件
检测 N 个不支持恢复的 URI。 如果 N 是 0, aria2 下载
当所有给定的 URI 不支持恢复时，从头开始创建文件。 看 --永远-简历
选项。 默认： 0

--min-tls-version=
指定要启用的最低 SSL/TLS 版本。 可能的值： SSLv3, TLSv1, TLSv1.1,
TLSv1.2 默认： TLSv1

--多个接口=
将套接字绑定到的以逗号分隔的接口列表。 请求将被拆分
接口之间实现链路聚合。 您可以指定接口名称，
IP 地址和主机名。 如果 - 界面 使用时，此选项将被忽略。
可能的值：接口、IP 地址、主机名

--日志级别=
将日志级别设置为输出。 LEVEL 是 调试, info, 注意, 警告 or 错误.
默认： 调试

--on-bt-download-complete=
对于 BitTorrent，在中指定的命令 --下载完成 之后被调用
下载完成，播种结束。 另一方面，此选项设置
命令在下载完成后但在播种之前执行。 看 活动 钩
有关 COMMAND 的更多详细信息。 可能的值： /路径/到/命令

--on-download-complete=
设置下载完成后执行的命令。 见见 活动 钩
有关 COMMAND 的更多详细信息。 也可以看看 --下载时停止 选项。 可能的值：
/路径/到/命令

--on-download-error=
设置下载因错误中止后执行的命令。 看 活动 钩
有关 COMMAND 的更多详细信息。 也可以看看 --下载时停止 选项。 可能的
价值观： /路径/到/命令

--on-download-pause=
设置下载暂停后执行的命令。 看 活动 钩 更多
COMMAND 的详细信息。 可能的值： /路径/到/命令

--on-download-start=
设置下载开始后要执行的命令。 看 活动 钩 更多
COMMAND 的详细信息。 可能的值： /路径/到/命令

--on-download-stop=
设置下载停止后执行的命令。 您可以覆盖命令
使用 --下载完成 和
--下载错误. 如果指定了它们，则此选项中指定的命令不是
执行。 看 活动 钩 有关 COMMAND 的更多详细信息。 可能的值：
/路径/到/命令

--片长=
设置 HTTP/FTP 下载的片段长度。 这是 aria2 分裂时的边界
文件。 所有分裂都发生在这个长度的倍数处。 此选项将被忽略
BitTorrent 下载。 如果 Metalink 文件包含一块，它也会被忽略
哈希值。 默认： 1M

注意:
可能的用例 --片长 选项是更改请求范围
一个 HTTP 流水线请求。 启用 HTTP 流水线使用
--启用-http-管道.

--show-console-readout[=true|false]
显示控制台读数。 默认： true

--summary-interval=
以秒为单位设置间隔以输出下载进度摘要。 环境 0 禁止显示
输出。 默认： 60

注意:
在多文件 torrent 下载中，与指定的文件相邻的文件
如果文件共享同一块，也会分配文件。

-Z --force-sequential[=true|false]
在命令行中按顺序获取 URI，并在单独的文件中下载每个 URI
session，就像通常的命令行下载实用程序一样。 默认： false

--max-overall-download-limit=
以字节/秒为单位设置最大整体下载速度。 0 意味着不受限制。 你可以附加
K or M （1K = 1024，1M = 1024K）。 要限制每次下载的下载速度，请使用
--最大下载限制 选项。 默认： 0

--最大下载限制=
以字节/秒为单位设置每次下载的最大下载速度。 0 意味着不受限制。 你
可以追加 K or M （1K = 1024，1M = 1024K）。 要限制整体下载速度，
使用 --最大总体下载限制 选项。 默认： 0

--no-conf[=真|假]
禁止加载 aria2.conf 文件。

--no-file-allocation-limit=
不会为大小小于 SIZE 的文件分配文件。 你可以
附加 K or M （1K = 1024，1M = 1024K）。 默认： 5M

-P, --参数化-uri[=true|false]
启用参数化 URI 支持。 您可以指定一组零件：
http://{sv1,sv2,sv3}/foo.iso. 您也可以使用 step 指定数字序列
计数器： http://host/image[000-100:2].img. 可以省略计步器。 我摔倒
URI 不指向同一个文件，例如上面的第二个示例，-Z 选项是
必需的。 默认： false

-q, --安静[=真|假]
使 aria2 安静（无控制台输出）。 默认： false

--realtime-chunk-checksum[=true|false]
通过在下载文件时计算校验和来验证数据块如果块
提供校验和。 默认： true

--删除控制文件[=true|false]
下载前删除控制文件。 使用 --允许覆盖=真， 下载
总是从头开始。 这对于代理服务器后面的用户很有用
禁用简历。

--保存会话=
退出时将错误/未完成的下载保存到 FILE。 您可以将此输出文件传递给
aria2c 与 - 输入文件 重启选项。 如果你喜欢 gzip 输出
将 .gz 扩展名附加到文件名。 请注意，下载添加的
aria2.addTorrent() 和 aria2.addMetalink() RPC 方法及其元数据不能
被保存为文件不会被保存。 使用删除的下载 aria2.remove() 和
aria2.forceRemove() 不会被保存。 GID 也保存在 GID， 但是这里有
一些限制，见下文。

注意:
通常，会保存下载本身的 GID。 但有些下载使用元数据
（例如，BitTorrent 和 Metalink）。 在这种情况下，有一些限制。

1.

磁铁 网址， 和 其次 by 激流 下载
保存了 BitTorrent 元数据下载的 GID。

2.

的URI 至 激流 文件， 和 其次 by 激流 下载
Torrent 文件下载的 GID 已保存。

3.

的URI 至 金属链接 文件， 和 其次 by 文件 下载 描述 in 金属链接
文件
保存metalink文件下载的GID。

4.

本地 激流 文件
Torrent 下载的 GID 已保存。

5.

本地 金属链接 文件
不会保存任何有意义的 GID。

--save-session-interval=
将错误/未完成的下载保存到指定的文件 - 保存会议 选项每
秒。 如果 0 给定，文件只有在 aria2 退出时才会保存。 默认： 0

--停止=
在经过 SEC 秒后停止应用程序。 如果 0 给出，这个特征是
禁用。 默认： 0

--stop-with-process=
当进程 PID 未运行时停止应用程序。 如果 aria2 进程，这很有用
是从父进程派生出来的。 父进程可以使用自己的 pid fork aria2
当父进程因某种原因退出时，aria2 可以检测到它并关闭
本身。

--truncate-console-readout[=true|false]
截断控制台读数以适合单行。 默认： true

-v， - 版
打印版本号、版权和配置信息并退出。

附加选项
可选 参数
参数被方括号 ([]) 括起来的选项采用一个可选的
争论。 通常省略参数被评估为 true. 如果你使用简短的形式
这些选项（例如 -V) 并给出一个参数，然后是选项名称及其参数
应该连接（例如 -V假）。 如果在选项名称之间插入任何空格
和参数，参数将被视为 URI，通常这不是你
期望。

Units (K 和 M)
一些选项需要 K 和 M 分别方便地表示 1024 和 1048576。 咏叹调2
以不区分大小写的方式检测这些字符。 换句话说， k 和 m 可以用作
以及 K 和 M 。

网址， 磁铁， TORRENT_FILE， METALINK_FILE
您可以在命令行中指定多个 URI。 除非你指定 --力顺序
选项，所有 URI 必须指向同一个文件，否则下载将失败。

您可以指定任意数量的 BitTorrent Magnet URI。 请注意，它们是
始终被视为单独的下载。 十六进制编码的 40 个字符信息哈希和
支持 Base32 编码的 32 个字符信息哈希。 倍数 tr 参数是
支持的。 因为 BitTorrent Magnet URI 很可能包含 & 性格，是高度
建议总是用 single(') 或双 ("） 引述。 它是强烈
建议启用 DHT，尤其是在 tr 缺少参数。 看
http://www.bittorrent.org/beps/bep_0009.html 有关 BitTorrent Magnet URI 的更多详细信息。

您还可以指定任意数量的 torrent 文件和 Metalink 文档存储在一个
本地驱动器。 请注意，它们始终被视为单独的下载。 两个都
支持 Metalink4 和 Metalink 3.0 版。

您可以使用 -T 选项和 URI 指定 Torrent 文件。 通过这样做，您可以下载
一个同时来自 torrent swarm 和 HTTP(S)/FTP/SFTP 服务器的文件，而
来自 HTTP(S)/FTP/SFTP 的数据上传到 torrent swarm。 对于单个文件种子，
URI 可以是指向资源的完整 URI，或者如果 URI 以 / 结尾，则 torrent 中的名称
添加了 torrent 中的文件。 对于多文件种子，添加名称和路径以形成 URI
对于每个文件。

注意:
确保 URI 用 single(') 或双 (") 引用，如果它包含 & or
任何在 shell 中具有特殊含义的字符。

恢复 下载
通常，您可以通过发出相同的命令（aria2c URI）来恢复传输，如果前一个
传输是由 aria2 进行的。

如果之前的传输是通过浏览器或 wget 之类的顺序下载管理器进行的，
然后用 - 继续 继续传输的选项。

活动 钩
aria2 提供了在特定事件发生后指定任意命令的选项。
目前有以下选项可用： --on-bt-下载完成, --下载暂停,
--下载完成. --on-download-开始, --下载错误, --下载时停止.

aria2 在执行时将 3 个参数传递给指定的命令。 这些论点是：
GID，文件数和文件路径。 对于 HTTP、FTP 和 SFTP 下载，通常
文件数为 1。BitTorrent 下载可以包含多个文件。 如果文件数
不止一个，文件路径是第一个。 换句话说，这是路径键的值
在响应 aria2.getFiles() RPC方法。
如果要获取所有文件路径，请考虑使用 JSON-RPC/XML-RPC。 请注意
由于重定向或内容处置，文件路径可能会在 HTTP 下载期间更改
标头。

让我们看一个如何将参数传递给命令的示例：

$猫钩子.sh
#!/ bin / sh的
echo "用 [$1] [$2] [$3] 调用"
$ aria2c --on-download-complete hook.sh http://example.org/file.iso
用 [1] [1] [/path/to/file.iso] 调用

退出 状态

因为 aria2 可以同时处理多个下载，所以在一次下载中会遇到很多错误
会议。 aria2 根据上次遇到的错误返回以下退出状态。

0 如果所有下载都成功。

1 如果发生未知错误。

2 如果发生超时。

3 如果没有找到资源。

4 如果 aria2 看到指定数量的“资源未找到”错误。 看
--最大文件未找到 选项。

5 如果下载因下载速度太慢而中止。 看
--最低限速 选项。

6 如果出现网络问题。

7 如果有未完成的下载。 只有全部完成才会报这个错误
下载成功并且在 aria2 时队列中有未完成的下载
按退出 Ctrl-C 由用户或发送 TERM 或 INT 信号。

8 如果需要完成恢复时远程服务器不支持恢复
下载。

9 如果没有足够的可用磁盘空间。

10 如果片段长度与 .aria2 控制文件中的长度不同。 看
--允许改变长度 选项。

11 如果 aria2 在那一刻正在下载相同的文件。

12 如果 aria2 在那一刻正在下载相同的信息散列种子。

13 如果文件已经存在。 看 --允许覆盖 选项。

14 如果重命名文件失败。 看 --自动文件重命名 选项。

15 如果 aria2 无法打开现有文件。

16 如果 aria2 无法创建新文件或截断现有文件。

17 如果发生文件 I/O 错误。

18 如果 aria2 无法创建目录。

19 如果名称解析失败。

20 如果 aria2 无法解析 Metalink 文档。

21 如果 FTP 命令失败。

22 如果 HTTP 响应标头错误或意外。

23 如果发生太多重定向。

24 如果 HTTP 授权失败。

25 如果 aria2 无法解析编码文件（通常是“.torrent”文件）。

26 如果“.torrent”文件已损坏或缺少 aria2 所需的信息。

27 如果 Magnet URI 不好。

28 如果给出了错误/无法识别的选项或给出了意外的选项参数。

29 如果远程服务器由于临时原因无法处理请求
超载或维修。

30 如果 aria2 无法解析 JSON-RPC 请求。

31 预订的。 不曾用过。

32 如果校验和验证失败。

注意:
完成下载时发生的错误不会报告为退出状态。

环境

aria2 识别以下环境变量。

HTTP_PROXY [http://][用户:密码@]主机[:端口]
指定用于 HTTP 的代理服务器。 覆盖配置中的 http-proxy 值
文件。 命令行选项 --http-代理 覆盖此值。

https_proxy [http://][用户:密码@]主机[:端口]
指定用于 HTTPS 的代理服务器。 覆盖 https-proxy 值
配置文件。 命令行选项 --https-代理 覆盖此值。

ftp_代理 [http://][用户:密码@]主机[:端口]
指定用于 FTP 的代理服务器。 覆盖配置中的 ftp-proxy 值
文件。 命令行选项 --ftp-代理 覆盖此值。

所有_代理 [http://][用户:密码@]主机[:端口]
如果未指定特定于协议的代理，请指定要使用的代理服务器。 覆盖
配置文件中的所有代理值。 命令行选项 --全代理
覆盖此值。

注意:
虽然 aria2 接受 ftp:// 和 https:// 代理 URI 中的方案，它只是假设
http:// 被指定并且不会根据指定的方案改变其行为。

无代理 [领域，...]
使用或指定一个逗号分隔的主机名、域和网络地址列表
没有子网掩码，不应该使用代理。 覆盖 无代理 折扣值
在配置文件中。 命令行选项 --无代理 覆盖此值。

使用 onworks.net 服务在线使用 aria2c