aria2c 官方手册中文翻译版

说明：文章是根据官方文档直接翻译过来，并经过了修正，方便大家使用，如有翻译不到位的地方，也请大家帮忙指出，后续会把不准确的地方更新过来。

 

aria2c（1）

 

概要

aria2c [<OPTIONS>] [<URI> | <MAGNET> | <TORRENT_FILE> | <METALINK_FILE>] ...

 

描述

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=<DIR>

存储下载文件的目录。

-i, --input-file=<FILE>

下载中列出的URI FILE。您可以通过将多个URI放在由TAB字符分隔的一行上来为单个实体指定多个来源 。此外，可以在每个URI行之后指定选项。选项行必须以一个或多个空格字符（SPACE或TAB）开头，并且每行只能包含一个选项。输入文件可以使用gzip压缩。当FILE指定-为时，aria2将从中读取输入stdin。有关详细信息，请参见“输入文件”小节。另请参阅--deferred-input选项。另请参阅--save-session选项。

-l, --log=<LOG>

日志文件的文件名。如果-指定，则将日志写入 stdout。如果指定了空字符串（“”），或者省略了此选项，则根本不会将任何日志写入磁盘。

-j, --max-concurrent-downloads=<N>

设置每个队列项目的最大并行下载数。另请参阅--split选项。默认：5

注意

--max-concurrent-downloads限制同时下载的项目数。 --split并 --min-split-size影响每个项目内部的连接数。假设您有一个输入文件（请参阅 --input-file选项），如下所示：

http://example.com/foo

http://example.com/bar

这是2个下载项目。如果给aria2值大于或等于2，则aria2可以同时下载这些项目 --max-concurrent-downloads。在每个下载项目中，您可以使用--split和/或--min-split-size等配置连接数。

-V, --check-integrity [true|false]

通过验证散列或整个文件的哈希来检查文件的完整性。该选项仅在BitTorrent，带有校验和的Metalink下载或带有--checksum选项的HTTP（S）/ FTP下载中有效 。如果提供了散列哈希，此选项可以检测文件的损坏部分并重新下载它们。如果提供了整个文件的哈希，则仅在文件已下载后才进行哈希检查。这由文件长度决定。如果哈希检查失败，则从头开始重新下载文件。如果同时提供了散列散列和整个文件的哈希，则仅使用散列散列。默认： false

-c, --continue [true|false]

继续下载部分下载的文件。使用此选项可以恢复由网络浏览器或另一个从头开始顺序下载文件的程序启动的下载。当前，此选项仅适用于HTTP（S）/ FTP下载。

-h, --help[=<TAG>|<KEYWORD>]

帮助消息按标签分类。标签以开头 #。例如，键入--help=#http以获取带有标记的选项的用法#http。如果给出了非标记词，则打印名称包括该词的选项的用法。可选项：#basic，#advanced，#http，#https，#ftp， #metalink，#bittorrent，#cookie，#hook，#file，#rpc， #checksum，#experimental，#deprecated，#help，#all 默认：#basic

 

HTTP / FTP / SFTP选项

--all-proxy=<PROXY>

对所有协议使用代理服务器。要覆盖以前定义的代理，请使用“”。您还可以覆盖此设置--http-proxy， --https-proxy并使用和--ftp-proxy选项为特定协议指定代理服务器。这会影响所有下载。PROXY的格式为[http://][USER:PASSWORD@]HOST[:PORT]。另请参阅环境部分。

注意

如果用户和密码嵌入在代理URI中，并且它们也由-{http，https，ftp，all} -proxy- {user，passwd}选项指定，则稍后指定的那些将覆盖先前的选项。例如，如果您在aria2.conf中指定 http-proxy-user=myname，http-proxy-passwd=mypass并--http-proxy="http://proxy"在命令行上指定，那么您将获得http://proxy具有usermyname和password的 HTTP代理mypass。

另一个示例：如果您在命令行上指定 ，那么您将获得具有user和password的HTTP代理 。--http-proxy="http://user:pass@proxy" --http-proxy-user="myname" --http-proxy-passwd="mypass"http://proxymynamemypass

再举一个例子：如果您在命令行中指定，那么您将获得具有user和password的 HTTP代理。--http-proxy-user="myname" --http-proxy-passwd="mypass" --http-proxy="http://user:pass@proxy"http://proxyuserpass

--all-proxy-passwd=<PASSWD>

为--all-proxy选项设置密码。

--all-proxy-user=<USER>

设置用户--all-proxy选项。

--checksum=<TYPE>=<DIGEST>

设置校验和。TYPE是哈希类型。支持的哈希类型在中列出。DIGEST是十六进制摘要。例如，设置sha-1摘要如下所示： 此选项仅适用于HTTP（S）/ FTP下载。Hash Algorithmsaria2c -vsha-1=0192ba11326fe2298c8cb4de616f4d4140213838

--connect-timeout=<SEC>

设置连接超时（以秒为单位）以建立与HTTP / FTP /代理服务器的连接。建立连接后，此选项无效，--timeout而使用该选项。默认：60

--dry-run [true|false]

如果true给出，则aria2仅检查远程文件是否可用并且不下载数据。此选项对HTTP / FTP下载有效。如果true指定，将取消BitTorrent下载。默认：false

--lowest-speed-limit=<SPEED>

如果下载速度小于或等于此值（字节/秒），则关闭连接。 0表示aria2没有最低速度限制。您可以附加K或M（1K = 1024，1M = 1024K）。此选项不影响BitTorrent下载。默认：0

-x, --max-connection-per-server=<NUM>

每次下载与一台服务器的最大连接数。默认：1

--max-file-not-found=<NUM>

如果aria2从远程HTTP / FTP服务器收到NUM次“未找到文件”状态而没有得到一个字节，则强制下载失败。指定0禁用此选项。此选项仅在使用HTTP / FTP服务器时有效。重试次数计入--max-tries，因此也应进行配置。

默认： 0

-m, --max-tries=<N>

设置尝试次数。0意味着无限。另请参阅--retry-wait。默认：5

-k, --min-split-size=<SIZE>

aria2的分割长度不小于2 * SIZE个字节范围。例如，让我们考虑下载20MiB文件。如果SIZE为10M，则aria2可以将文件分为2个范围[0-10MiB）和[10MiB-20MiB），并使用2个来源（--split当然，如果> = 2 ）下载它。如果SIZE为15M，则由于2 * 15M> 20MiB，aria2不会拆分文件并使用1个源下载它。您可以附加K或M（1K = 1024，1M = 1024K）。可能的值：1M-1024M默认值：20M

--netrc-path=<FILE>

指定netrc文件的路径。默认：$(HOME)/.netrc

注意

.netrc文件的权限必须为600。否则，该文件将被忽略。

-n, --no-netrc [true|false]

禁用netrc支持。默认情况下启用netrc支持。

注意

如果--no-netrc是，则仅在启动时读取netrc文件 false。因此，如果--no-netrc是true在启动时，则整个会话期间都没有netrc可用。即使--no-netrc=false使用 发送，也无法启用netrc aria2.changeGlobalOption()。

--no-proxy=<DOMAINS>

用逗号分隔的主机名，域和网络地址列表，带或不带子网掩码，不使用代理。

注意

对于带有子网掩码的网络地址，IPv4和IPv6地址均起作用。当前实现无法解析URI中的主机名来比较中指定的网络地址--no-proxy。因此，仅当URI具有数字IP地址时才有效。

-o, --out=<FILE>

下载文件的文件名。它始终相对于--diroption中给定的目录。当 --force-sequential使用选项，这个选项被忽略。

注意

您不能为Metalink或BitTorrent下载指定文件名。仅在直接在命令行上提供给aria2的URI时才使用此处指定的文件名，而在使用--input-file，--force-sequential选项时则不使用 。

例子：

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

--proxy-method=<METHOD>

设置代理请求中使用的方法。METHOD是get或 tunnel。tunnel无论此选项如何，始终使用HTTPS下载。默认：get

-R, --remote-time [true|false]

从远程HTTP / FTP服务器检索远程文件的时间戳，如果可用，请将其应用于本地文件。默认：false

--reuse-uri [true|false]

如果没有剩余的未使用URI，请重用已使用的URI。默认：true

--retry-wait=<SEC>

设置重试之间等待的秒数。如果为，则aria2将在HTTP服务器返回503响应时重试下载。默认： SEC > 00

--server-stat-of=<FILE>

指定将服务器性能概要文件保存到的文件名。您可以使用--server-stat-if选项加载保存的数据。有关 文件格式，请参见 下面的“服务器性能配置文件”小节。

--server-stat-if=<FILE>

指定文件名以加载服务器的性能概要文件。加载的数据将在URI选择器中使用，例如feedback。另请参阅--uri-selector选项。有关 文件格式，请参见 下面的“服务器性能配置文件”小节。

--server-stat-timeout=<SEC>

指定超时（以秒为单位），以使服务器自上次联系以来的性能配置文件失效。默认值：86400（24小时）

-s, --split=<N>

使用N个连接下载文件。如果给定的URI多于N个，则使用前N个URI，其余URI用于备份。如果给定的URI少于N个，则这些URI会使用不止一次，以便同时进行N个连接。到同一主机的连接数受该--max-connection-per-server选项限制 。另请参阅--min-split-size选项。默认：5

注意

一些Metalinks规定要连接的服务器数量。aria2严格尊重他们。这意味着，如果Metalink定义的 maxconnections属性小于N，则aria2使用此较低值的值代替N。

--stream-piece-selector=<SELECTOR>

指定HTTP / FTP下载中使用的片段选择算法。片段是指固定长度的片段，该片段在分段下载中并行下载。如果default给定，aria2选择块以使其减少建立连接的次数。这是合理的默认行为，因为建立连接是一项昂贵的操作。如果inorder给定，aria2选择具有最小索引的片段。Index = 0表示文件的第一位。这对于在下载电影时观看电影很有用。 --enable-http-pipelining选项可能有助于减少重新连接的开销。请注意，aria2荣誉--min-split-size选项，因此有必要为该 选项指定一个合理的值 --min-split-size。如果random给定，aria2将随机选择一块。像一样 inorder，--min-split-size选项很受好评。如果geom给定后，aria2开始选择具有最小索引的片段，例如inorder，但是它与以前选择的片段成指数增长。这将减少建立连接的次数，同时它将首先下载文件的开始部分。这对于在下载电影时观看电影很有用。默认：default

-t, --timeout=<SEC>

设置超时（以秒为单位）。默认：60

--uri-selector=<SELECTOR>

指定URI选择算法。可能的值是inorder， feedback和adaptive。如果inorder给出，则按URI列表中出现的顺序尝试URI。如果feedback给出，aria2将使用先前下载中观察到的下载速度，并在URI列表中选择最快的服务器。这也有效地跳过了死角镜。观察到的下载速度是--server-stat-of和 --server-stat-if选项中提到的服务器性能的一部分。如果adaptive给出，则为第一个和保留的连接选择最佳的镜像之一。对于补充的镜像，它返回尚未测试的镜像，如果每个镜像都已经被测试，则返回必须再次测试的镜像。否则，它将不再选择镜像。喜欢feedback，它使用服务器的性能配置文件。默认：feedback

 

HTTP特定选项

--ca-certificate=<FILE>

使用FILE中的证书颁发机构来验证对等方。证书文件必须为PEM格式，并且可以包含多个CA证书。使用--check-certificate选项启用验证。

注意

如果您使用OpenSSL或具有gnutls_certificate_set_x509_system_trust()功能的最新版本的GnuTLS进行构建，并且已正确配置该库以定位系统范围内的CA证书存储，则aria2将在启动时自动加载这些证书。

注意

WinTLS和AppleTLS不支持此选项。相反，您将必须将证书导入OS信任库。

--certificate=<FILE>

在FILE中使用客户端证书。证书必须为PKCS12（.p12，.pfx）或PEM格式。

PKCS12文件必须包含证书，密钥以及可选的其他证书链。只能打开导入密码为空的PKCS12文件！

使用PEM时，还必须通过指定私钥--private-key 。

注意

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

注意

AppleTLS用户应使用KeyChain Access实用程序导入客户端证书，并从与该证书相对应的“信息”对话框中获取SHA-1指纹。要启动aria2c，请使用--certificate = <SHA-1>。另外，也支持PKCS12文件。但是，不支持PEM文件。

--check-certificate [true|false]

使用--ca-certificateoption中指定的证书验证对等方。默认：true

--http-accept-gzip [true|false]

如果远程服务器使用或 响应，则发送请求标头并增加响应。默认：Accept: deflate, gzipContent-Encoding: gzipContent-Encoding: deflatefalse

注意

某些服务器对本身是压缩文件的文件进行响应。aria2仍然会因响应标头而使它们膨胀。Content-Encoding: gzip

--http-auth-challenge [true|false]

仅在服务器请求时发送HTTP授权标头。如果false设置，则授权标头始终发送到服务器。有一个例外：如果用户名和密码嵌入在URI中，则无论此选项如何，授权标头始终发送到服务器。默认：false

--http-no-cache [true|false]

发送和标头可避免缓存内容。如果给出，则不发送这些标头，您可以使用喜欢的选项添加Cache-Control标头。默认：Cache-Control: no-cachePragma: no-cachefalse--headerfalse

--http-user=<USER>

 

设置HTTP用户。这会影响所有URI。

--http-passwd=<PASSWD>

设置HTTP密码 这会影响所有URI。

--http-proxy=<PROXY>

对HTTP使用代理服务器。要覆盖以前定义的代理，请使用“”。另请参阅--all-proxy选项。这会影响所有http下载。PROXY的格式是[http://][USER:PASSWORD@]HOST[:PORT]

--http-proxy-passwd=<PASSWD>

为设置密码--http-proxy。

--http-proxy-user=<USER>

将用户设置为--http-proxy。

--https-proxy=<PROXY>

对HTTPS使用代理服务器。要覆盖以前定义的代理，请使用“”。另请参阅--all-proxy选项。这会影响所有https下载。PROXY的格式是[http://][USER:PASSWORD@]HOST[:PORT]

--https-proxy-passwd=<PASSWD>

为设置密码--https-proxy。

--https-proxy-user=<USER>

将用户设置为--https-proxy。

--private-key=<FILE>

使用FILE中的私钥。私钥必须解密并采用PEM格式。给定加密后的行为是不确定的。另请参阅--certificate选项。

--referer=<REFERER>

设置一个http Referrer（Referer）。这会影响所有http / https下载。如果*给出，则下载URI也用作引荐来源网址。与--parameterized-uri选件一起使用时，这可能很有用 。

--enable-http-keep-alive [true|false]

启用HTTP / 1.1持久连接。默认：true

--enable-http-pipelining [true|false]

启用HTTP / 1.1流水线。默认：false

笔记

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

--header=<HEADER>

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

$ aria2c --header="X-A: b78" --header="X-B: 9J1" "http://host/file"

--load-cookies=<FILE>

使用Firefox3格式（SQLite3），Chromium / Google Chrome（SQLite3）和Mozilla / Firefox（1.x / 2.x）/ Netscape格式从FILE加载Cookie。

笔记

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

--save-cookies=<FILE>

以Mozilla / Firefox（1.x / 2.x）/ Netscape格式将Cookies保存到FILE。如果FILE已经存在，它将被覆盖。会话Cookie也将被保存，其有效期值将被视为0。可能的值：/path/to/file

--use-head [true|false]

对HTTP服务器的第一个请求使用HEAD方法。默认：false

-U, --user-agent=<USER_AGENT>

设置用于HTTP（S）下载的用户代理。默认值：aria2/$VERSION$ VERSION替换为软件包版本。

 

FTP / SFTP特定选项

--ftp-user=<USER>

设置FTP用户。这会影响所有URI。默认：anonymous

--ftp-passwd=<PASSWD>

设置FTP密码。这会影响所有URI。如果嵌入了用户名，但URI中缺少密码，则aria2尝试使用.netrc解析密码。如果在.netrc中找到密码，则将其用作密码。如果不是，请使用此选项中指定的密码。默认：ARIA2USER@

-p, --ftp-pasv [true|false]

在FTP中使用被动模式。如果false给出，将使用主动模式。默认：true

笔记

对于SFTP传输，将忽略此选项。

 

 

 

--ftp-proxy=<PROXY>

对FTP使用代理服务器。要覆盖以前定义的代理，请使用“”。另请参阅--all-proxy选项。这会影响所有ftp下载。PROXY的格式是[http://][USER:PASSWORD@]HOST[:PORT]

--ftp-proxy-passwd=<PASSWD>

为--ftp-proxy选项设置密码。

--ftp-proxy-user=<USER>

设置用户--ftp-proxy选项。

--ftp-type=<TYPE>

设置FTP传输类型。TYPE是binary或ascii。默认：binary

注意

对于SFTP传输，将忽略此选项。

--ftp-reuse-connection [true|false]

重用FTP中的连接。默认：true

--ssh-host-key-md=<TYPE>=<DIGEST>

设置SSH主机公钥的校验和。TYPE是哈希类型。支持的哈希类型为sha-1或md5。DIGEST是十六进制摘要。例如： sha-1=b030503d4de4539dc7885e6f0f5e256704edf4c3。使用SFTP时，此选项可用于验证服务器的公钥。如果未设置此选项（默认设置），则不会进行任何验证。

 

BitTorrent /元链接选项

--select-file=<INDEX>...

通过指定文件索引来设置要下载的文件。您可以使用--show-files选项找到文件索引。可以使用来指定多个索引,，例如：3,6。您也可以使用-指定范围：1-5。 ,并-可以一起使用：1-5,8,9。与-M选项一起使用时，索引可能会因查询而异（请参阅--metalink- *选项）。

注意

在多文件洪流中，也可以下载此选项指定的相邻文件。这是设计使然，而非错误。单个文件可能包含多个文件或文件的一部分，aria2将文件写入适当的文件。

-S, --show-files [true|false]

打印“ .torrent”，“。meta4”和“ .metalink”文件的文件列表，然后退出。如果是“ .torrent”文件，还将打印其他信息（信息哈希，片段长度等）。

 

BitTorrent特定选项

--bt-detach-seed-only [true|false]

计算并发活动下载时，仅排除种子下载（请参阅-j选项）。这意味着如果-j3给出并且打开了此选项，并且有3个下载处于活动状态，并且其中一个进入种子模式，则将其从活动下载计数中排除（因此变为2），并且开始等待队列中的下一个下载。但是请注意，在RPC方法中，种子项仍被视为活动下载。默认：false

--bt-enable-hook-after-hash-check [true|false]

-V 在BitTorrent下载中进行哈希检查（请参阅选项）之后，允许挂钩命令调用。默认情况下，当哈希检查成功时，将执行by给定的命令--on-bt-download-complete 。要禁用此操作，请赋予false此选项。默认：true

--bt-enable-lpd [true|false]

启用本地对等发现。如果在torrent中设置了私有标志，则即使true已指定aria2，该下载也不使用此功能。默认：false

--bt-exclude-tracker=<URI>[,...]

以逗号分隔的要删除的BitTorrent跟踪器的公告URI列表。您可以使用*匹配所有URI的特殊值，从而删除所有声明的URI。*在shell命令行中指定时，不要忘记对其进行转义或引用。另请参阅 --bt-tracker选项。

--bt-external-ip=<IPADDRESS>

指定要在BitTorrent下载和DHT中使用的外部IP地址。它可能会发送到BitTorrent跟踪器。对于DHT，应设置此选项以报告本地节点正在下载特定的torrent。这对于在专用网络中使用DHT至关重要。尽管此函数名为external，但它可以接受任何类型的IP地址。

--bt-force-encryption [true|false]

需要使用arc4加密BitTorrent消息有效负载。这是= arc4的简写。此选项不会更改这些选项的选项值。如果给出，则拒绝旧式BitTorrent握手，仅使用混淆处理握手，并始终加密消息有效负载。默认：--bt-require-crypto --bt-min-crypto-leveltruefalse

--bt-hash-check-seed [true|false]

如果true给出，则在使用--check-integrity选项和文件进行哈希检查之后，继续为文件添加种子。如果要检查文件并仅在文件损坏或不完整时下载文件，请将此选项设置为false。此选项仅对BitTorrent下载有效。默认：true

--bt-load-saved-metadata [true|false]

使用磁力链接下载时从DHT获取种子数据时，首先尝试读取--bt-save-metadataoption保存的文件 。如果成功，则跳过从DHT下载元数据。默认：false

--bt-lpd-interface=<INTERFACE>

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

--bt-max-open-files=<NUM>

在全局多文件BitTorrent / Metalink下载中指定要打开的最大文件数。默认：100

--bt-max-peers=<NUM>

Specify the maximum number of peers per torrent. 0 means unlimited. See also --bt-request-peer-speed-limit option. Default: 55

--bt-metadata-only [true|false]

Download meta data only. The file(s) described in meta data will not be downloaded. This option has effect only when BitTorrent Magnet URI is used. See also --bt-save-metadata option. Default: false

--bt-min-crypto-level=plain|arc4

Set minimum level of encryption method. If several encryption methods are provided by a peer, aria2 chooses the lowest one which satisfies the given level. Default: plain

--bt-prioritize-piece=head[=<SIZE>],tail[=<SIZE>]

尝试先下载每个文件的第一部分和最后部分。这对于预览文件很有用。该参数可以包含2个关键字： head和tail。要同时包含两个关键字，它们必须用逗号分隔。这些关键字可以采用一个参数SIZE。例如，如果head=<SIZE>指定，则每个文件的前SIZE个字节范围内的片段将具有更高的优先级。 tail=<SIZE>表示每个文件的最后SIZE个字节的范围。SIZE可以包含K或M（1K = 1024，1M = 1024K）。如果省略SIZE，则使用SIZE = 1M。

--bt-remove-unselected-file [true|false]

在BitTorrent中完成下载后，删除未选择的文件。要选择文件，请使用 --select-file选项。如果未使用，则假定所有文件都已选中。请谨慎使用此选项，因为它实际上会从磁盘上删除文件。默认：false

--bt-require-crypto [true|false]

如果true给出，aria2将不接受旧的BitTorrent握手（\ 19BitTorrent协议）并与其建立连接。因此，aria2始终使用混淆处理握手。默认：false

--bt-request-peer-speed-limit=<SPEED>

如果每个种子的整体下载速度都低于SPEED，则aria2会暂时增加对等节点的数量，以尝试提高下载速度。在某些情况下，使用首选的下载速度配置此选项可以提高下载速度。您可以附加K或M（1K = 1024，1M = 1024K）。默认：50K

--bt-save-metadata [true|false]

将元数据另存为“ .torrent”文件。仅当使用BitTorrent磁铁URI时此选项才有效。文件名是带有后缀“ .torrent”的十六进制编码信息哈希。要保存的目录与保存下载文件的目录相同。如果已经存在相同文件，则不保存元数据。另请参阅--bt-metadata-only 选项。默认：false

--bt-seed-unverified [true|false]

在不验证散列的情况下播种先前下载的文件。默认：false

--bt-stop-timeout=<SEC>

如果连续SEC秒内下载速度为0，则停止BitTorrent下载。如果0给出，则禁用此功能。默认：0

--bt-tracker=<URI>[,...]

以逗号分隔的其他BitTorrent跟踪器的公告URI列表。这些URI不受--bt-exclude-tracker选项影响，因为它们是在--bt-exclude-tracker删除选项中的URI之后添加的。

--bt-tracker-connect-timeout=<SEC>

设置连接超时（以秒为单位）以建立与跟踪器的连接。建立连接后，此选项无效，--bt-tracker-timeout而使用该选项。默认： 60

--bt-tracker-interval=<SEC>

设置跟踪器请求之间的时间间隔（以秒为单位）。这将完全覆盖间隔值，而aria2仅使用此值，而忽略跟踪器响应中的最小间隔和间隔值。如果0设置为，aria2将根据跟踪器的响应和下载进度确定间隔。默认：0

--bt-tracker-timeout=<SEC>

设置超时（以秒为单位）。默认：60

--dht-entry-point=<HOST>:<PORT>

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

--dht-entry-point6=<HOST>:<PORT>

将主机和端口设置为IPv6 DHT网络的入口点。

--dht-file-path=<PATH>

将IPv4 DHT路由表文件更改为PATH。默认值：$HOME/.aria2/dht.dat如果存在，否则 $XDG_CACHE_HOME/aria2/dht.dat。

--dht-file-path6=<PATH>

启用IPv6 DHT功能。如果在torrent中设置了私有标志，则即使true已指定aria2，该下载也不使用DHT 。使用--dht-listen-port选项指定要监听的端口号。另请参阅--dht-listen-addr6选项。

--enable-peer-exchange [true|false]

启用对等交换扩展。如果在洪流中设置了私人标志，则即使true已下载，也将禁用该功能。默认：true

--follow-torrent=true|false|mem

如果指定true或mem，.torrent则application/x-bittorrent在下载后缀为或内容类型的文件时，aria2将其解析为torrent文件并下载其中提到的文件。如果mem指定，则种子文件不会写入磁盘，而是仅保留在内存中。如果false指定，则将.torrent文件下载到磁盘，但不会解析为种子文件，也不会下载其内容。默认：true

-O, --index-out=<INDEX>=<PATH>

设置索引为INDEX的文件的文件路径。您可以使用--show-files选项找到文件索引。PATH是--diroption中指定的路径的相对路径。您可以多次使用此选项。使用此选项，您可以指定BitTorrent下载的输出文件名。

--listen-port=<PORT>...

设置BitTorrent下载的TCP端口号。可以使用来指定多个端口,，例如：6881,6885。您也可以使用-指定范围：6881-6999。 ,并-可以一起使用：6881-6889,6999。默认：6881-6999

注意

确保打开指定的端口以用于传入TCP通信。

--max-overall-upload-limit=<SPEED>

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

-u, --max-upload-limit=<SPEED>

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

--peer-id-prefix=<PEER_ID_PREFIX>

指定对等体ID的前缀。BitTorrent中的对等ID为20字节长。如果指定的字节数超过20个，则仅使用前20个字节。如果指定的字节数少于20个，则添加随机字节数据以使其长度为20个字节。

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

--peer-agent=<PEER_AGENT>

指定在对等客户端版本的bitorrent扩展握手期间使用的字符串。

默认值：aria2/$MAJOR.$MINOR.$PATCH，$ MAJOR，$ MINOR和$ PATCH分别替换为主要版本，次要版本和补丁程序版本号。例如，aria2版本1.18.8具有对等代理aria2/1.18.8。

--seed-ratio=<RATIO>

指定股份比例。种子完成洪流，直到占有率达到RATIO。强烈建议您指定等于或大于1.0此处。指定0.0是否打算不管种子比例如何进行播种。如果--seed-time与该选项一起指定了选项，则当至少满足一个条件时播种结束。默认：1.0

--seed-time=<MINUTES>

指定播种时间（分数）。另请参阅 --seed-ratio选项。

注意

--seed-time=0完成下载后，指定将禁用播种。

-T, --torrent-file=<TORRENT_FILE>

“ .torrent”文件的路径。您无需使用此选项，因为您可以指定不带的“ .torrent”文件--torrent-file。

 

Metalink特定选项

--follow-metalink=true|false|mem

如果true或mem指定，当一个文件，其后缀.meta4或.metalink或内容类型application/metalink4+xml或application/metalink+xml下载，aria2解析它在它提到的Metalink文件，下载文件。如果mem指定，则不会将metalink文件写入磁盘，而是仅保留在内存中。如果false指定，则将.metalink文件下载到磁盘，但不解析为metalink文件，并且不下载其内容。默认：true

--metalink-base-uri=<URI>

指定基本URI来解析存储在本地磁盘中的metalink文件中的metalink：url和metalink：metaurl元素中的相对URI。如果URI指向目录，则URI必须以结尾/。

-M, --metalink-file=<METALINK_FILE>

“ .meta4”和“ .metalink”文件的文件路径。从stdinwhen读取输入-。您不需要使用此选项，因为您可以指定不带的“ .metalink”文件--metalink-file。

--metalink-language=<LANGUAGE>

要下载文件的语言。

--metalink-location=<LOCATION>[,...]

首选服务器的位置。可以使用逗号分隔的位置列表，例如jp,us。