转自:http://sydi.org/posts/linux/aria2c-usage-sample-cns.html

声明

本文是对aria2c官方文档1的一个翻译,文档本身的内容是包含在 aria2项目 中的。本文的翻译不包括metalink的部分,因为国内貌似很少用到metalink作为下载协议的。

语粗词穷,若有不易理解之处,请参考原文1,或 与我联系 。

基本使用

下载一个文件(Download a file):

aria2c http://host/image.iso

说明:1.10.0以后的版本默认对每个 host 使用 1 个连接,你可以使用 -max-connection-per-server或者 -x 选项进行改变。

用每个 host 两个连接从一个 host 下载一个文件(To download a file using 2 connections from single host):

aria2c -x2 http://host/image.iso

说明:想要停止下载,可以按Ctrl-C。想要恢复下载,可以在同一个文件夹中执行相同的下载命令。只要URI指向同一个文件,URIs是可以被改变的。

同时使用两个连接下载同一文件(Download a file using 2 connections):

aria2c -s2 http://host/image.iso http://mirror1/image.iso http://mirror2/image.iso

说明:你可以指定URIs的数量多余 -s 选项设定的数。在这个例子中,前两个URL会被用于下载,而第三个URL作为备用(如果前面两个有个挂了,第三个顶上)。

同时从FTP和HTTP源下载一个文件(Download a file from HTTP and FTP servers):

aria2c http://host1/file.zip ftp://host2/file.zip

并行下载任意数目的URI, metalink, torrent(Parallel downloads of arbitrary number of URI, metalink, torrent):

aria2c -Z http://host/file1 file2.torrent file3.metalink

说明:如果你只是下载 torrent 和 metalink 的文件,那么选项 -Z 将不是必须的。所以你可以使用以下这个命令同时下载bt文件。

aria2c file1.torrent file2.torrent

并发下载一个文件中的URI(Download files listed in a file concurrently):

aria2c -ifiles.txt -j5

说明:选项 -j 用于指定同时下载的文件的数量。你可以在文件中指定本地的 torrent 和 metalink 文件。

说明:你可以指定一些 选项 在下载文件(input list file)中。

在退出时保存错误/未完成的下载(Save error/unfinished downloads on exit):

aria2c -ifiles.txt --save-session=out.txt

当你按下Ctrl-C或者 aria2 退出时,所有的错误(error)/未完成(unfinished)下载将会保存到out.txt 文件中。注意通过 XML-RPC 方式(aria2.addTorrent and aria2.addMetalink)添加的下载不会被保存!你可以使用这个文件作为一个输入文件列表(input file list)来重新开始下载。

aria2c -iout.txt

Metalink Download(不翻译)

BT下载(BitTorrent Download)

通过网上的种子文件下载(Download files from remote BitTorrent file)

aria2c http://site/file.torrent

通过网上的种子文件下载,种子保存在内存(Download files from remote BitTorrent file; torrent file itself is processed in memory)

aria2c --follow-torrent=mem http://site/file.torrent

通过本地的种子文件下载(Download using a local torrent file)

aria2c -u40K /path/to/file.torrent

说明: -u, -max-upload-limit 指定最大的上传速度

说明:想要停止下载,可以按Ctrl-C。想要恢复下载,可以在同一个文件夹中执行相同的下载命令。只要URI指向同一个文件,URIs是可以被改变的。

你可以同时进行多个 bt 的下载:

aria2c /path/to/file1.torrent /path/to/file2.torrent

通过 bt magnet uri 下载(Download using BitTorrent Magnet URI)

aria2c "magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2"

说明:在 bt magnet uri 包含"&"的时候记住要加单引号或者双引号。强烈推荐打开 DHT 选项。 -enable-dht

保存元数据到 .torrent 文件中(Save metadata as .torrent file)

aria2c --bt-save-metadata "magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2"

上面那个命令会保存元数据到一个名为"248d0a1cd08284299de78d5c1ed359bb46717d8c.torrent"的种子文件。

自动调节连接数(Adjust the number of peers adaptively)

如果每个种子的下载速度都低于 200K 的话, aria2 会临时增加连接数来试着提高下载速度。

aria2c --bt-request-peer-speed-limit=200K file.torrent

说明:配置 -bt-request-peer-speed-limit 选项为合适的值可以在某些情况下提高你的下载速度。

打开 DHT (Enable DHT)

aria2c --enable-dht http://site/file.torrent

说明:从 1.7.2 版本开始, DHT 默认是打开的。当通过 HTTP/FTP 下载的时候 DHT 不会启用。当首个种子下载开始, aria2 初始化 DHT 功能,之后, DHT 会一直运行知道 aria2 退出为止。

打开 IPv6 的 DHT (Enable IPv6 DHT)

aria2c --enable-dht6 --dht-listen-port=6881 --dht-listen-addr6=YOUR_GLOBAL_UNICAST_IPV6_ADDR --enable-async-dns6

说明:如果 aria2c 编译的时候没有加入 c-ares , -enable-async-dns6 不是必须的。 aria2 会在IPv4 和 IPv6 之间对 DHT 共享一些端口。

Add and remove tracker URI

接下来的例子指示 aria2 移除 file.torrent 文件中所有的 tracker announce URIs ,并用"http://tracker1/announce" 和 "http://tracker2/announce" 代替。

aria2c --bt-exclude-tracker="*" --bt-tracker="http://tracker1/announce,http://tracker2/announce" file.torrent

加密(Encryption)

默认情况下, aria2 能够同时支持加密和非加密连接。它会先尝试使用加密连接,如果失败则尝试非加密连接。

强制只使用加密连接:

aria2c --bt-require-crypto=true http://site/file.torrent

一共有两种加密类型:只加密头或者全部加密。默认下,如果对方支持两种加密类型, aria2 会选择只加密头。如果想让 aria2 总是使用全加密连接:

aria2c --bt-min-crypto-level=arc4 http://site/file.torrent

打印一个种子文件中的内容(Print the contents of the torrent file)

aria2c -S file.torrent

选择性下载文件(Download only selected files using index (usually called "selectable download"))

aria2c --select-file=1-4,8 -Tfile.torrent

说明:序号(index)可以通过 -S 选项输出

改变监听端口(Change the listening port for incoming peer)

aria2c --listen-port=6881-6883 file.torrent

说明:确认该 TCP 端口是可用的

指定 BT 下载停止的条件(Specify the condition to stop program after torrent download finished)

aria2c --seed-time=120 --seed-ratio=1.0 file.torrent

说明:在上面的这个例子中, 当做种 120分钟 或者种子率大于1以后, aria2 会退出。

调节上传速度(Throttle upload speed)

aria2c --max-upload-limit=100K file.torrent

为已经下载完成的文件做种(Seeding already downloaded file)

你可以使用 -V 选项给已经下载好的文件做种。它会先校验文件的完整性。

aria2c -V -d/path/to/dir file.torrent

如果你肯定文件是正确的,你可以使用 -bt-seed-unverified 选项跳过做种前的文件校验。

aria2c --bt-seed-unverified -d/path/to/dir file.torrent

你可以给多个文件做种:

aria2c --bt-seed-unverified -d/path/to/dir file1.torrent file2.torrent

用序号指定文件名(Specify file name with index)

为 BitTorrent 下载下来的文件指定文件名,你首先需要通过 -S 选项知道该文件的序号。比如一个种子文件 -S 选项输出如下:

idx|path/length
===+======================
1|dist/base-2.6.18.iso
|99.9MiB
---+----------------------
2|dist/driver-2.6.18.iso
|169.0MiB
---+----------------------

把 dist/base-2.6.18.iso 保存为 tmp/mydir/base.iso , /dist/driver-2.6.18.iso 保存为 /tmp/dir/driver.iso ,可以使用一下的命令:

aria2c --dir=/tmp --index-out=1=mydir/base.iso --index-out=2=dir/driver.iso file.torrent

说明: -index-out 选项针对通过 HTTP 方式获取种子文件的方式无效。它只能针对本地种子文件的下载。 aria2 不会记住 -index-out 选项中指定的地址,你必须在每次开始该任务的时候重新指定 -index-out 的值。如果你忘了再次指定输出文件的地址, aria2 不会提醒你,所以你必须谨慎地使用这个选项。

为预览的文件指定优先块(Prioritize piece for previewing files)

优先下载每个文件开头的 1MiB 的内容。

aria2c --bt-prioritize-piece=head file.torrent

使用代理下载(Use With Proxy)

为所有的连接设置代理服务器(Set proxy server to use all protocols(HTTP(S)/FTP))

aria2c --all-proxy='http://proxy:8080' http://host/file

说明: -all-proxy 选项会被具体的代理选项重载: -http-proxy, -https-proxy, -ftp-proxy.

只为 HTTP 设置代理服务器(Set proxy server to be in HTTP only)

aria2c --http-proxy='http://proxy:8080' http://host/file

设置需要验证的代理服务器(Use proxy that requires authentication)

aria2c --http-proxy='http://proxy:8080' --http-proxy-user='username' --http-proxy-passwd='password' http://host/file
aria2c --http-proxy='http://username:password@proxy:8080' http://host/file

说明:用户名和密码需要是 percent-encoded 格式。比如,如果用户名是 myid@domain, 那么percent-encoded 格式就是 myid%40domain.

高级HTTP功能(Advanced HTTP Features)

载入 cookies (Load cookies)

载入 Mozilla/Firefox(1.x/2.x) 和 Netscape 格式:

aria2c --load-cookies=cookies.txt http://host/file

载入 Firefox3 格式:

aria2c --load-cookies=cookies.sqlite http://host/file

说明:你可以不加任何修改直接读取 Firefox/Mozilla's 的 cookie 内容。

继续浏览器或者其它程序开始的下载任务(Resume download started by web browsers or another programs)

aria2c -c -s2 http://host/partiallydownloadedfile.zip

其它高级功能(Other Advanced Features)

调节下载速度(Throttle download speed)

aria2c --max-download-limit=100K http://host/file

用 -V 选项修复一个被破坏的下载文件(Repair a damaged download using -V option)

aria2c -V file.metalink

说明:这个选项只能对支持校验码的 BitTorrent 或者 metalink 使用。

如果下载速度低于某个特定值就丢弃连接(Drop connection if download speed is lower than specified value)

aria2c --lowest-speed-limit=10K file.metalink

支持参数的 URI (Parameterized URI support)

你可以这样使用 URI :

aria2c -P http://{host1,host2,host3}/file.iso

你可以指定数字序号(You can specify numeric sequence using [])

aria2c -Z -P http://host/image[000-100].png

说明: -Z 选项是必须的,如果所有的 URL 都是指向不同的文件的话。

可以指定步长(You can specify step counter)

aria2c -Z -P http://host/image[A-Z:2].png

Time-stamping

aria2 会在下载完成的时候从服务器拿到该文件的 timestamp 并设置到本地文件

aria2c -R http://host/file.iso

当下载完成后执行一条命令(Execute command when download finishes)

aria2c --on-download-complete=COMMAND http://example.org/file.iso

参见 -on-download-error, -on-download-start 和 -on-download-stop 选项, 或者执行:

aria2c -h #hook

写入到 /dev/null (Writing to /dev/null)

aria2c -d /dev -o null --allow-overwrite=true http://example.org/file

需要 -allow-overwrite=true 是为了避免 aria2 重命名已经存在的 /dev/null。

输入文件(Input File)

http://server/file.iso http://mirror/file.iso
dir=/iso_images
out=file.img
http://foo/bar

脚注:

1

原文地址: http://sourceforge.net/apps/trac/aria2/wiki/UsageExample

Aria2c 使用举例相关推荐

  1. linux代码动态分析软件,举例分析Linux动态库和静态库

    函数库分为静态库和动态库两种.创建Linux静态库和Linux动态库和使用它们在这里将以举例的形式详述一下.静态库在程序编译时会被连接到目标代码中,程序运行时将不再需要该静态库.动态库在程序编译时并不 ...

  2. TCP/IP基础概念及通信过程举例

    TCP/IP基础概念及通信过程举例 出现 上个世纪60年代,由于中央集中式网络的容灾性较弱,以美国国防部为中心的一家组织研究出分组交换网络.后来为了验证分组交换技术的实用性,ARPANET出现了,并且 ...

  3. Tesseract-OCR 3.04简单使用举例(读入图像输出识别结果)

    下面code是对Tesseract-OCR 3.04版本进行简单使用的举例:包括两段,一个是读入带有中文字符的图像,一个是读入仅有英文字符的图像: #include "funset.hpp& ...

  4. Android.mk和Application.mk文件语法规范说明及举例

    以下英文内容摘自:http://www.kandroid.org/ndk/docs/OVERVIEW.html The Android NDK is a set of tools that allow ...

  5. iptables 基本命令使用举例

    原文地址:http://www.linuxsky.org/doc/admin/200803/262.html 一.链的基本操作 1.清除所有的规则. 1)清除预设表filter中所有规则链中的规则. ...

  6. Linux-find命令应用举例-按时间筛选和删除文件

    find参数说明: find有很多参数是以动作首字母+时间的方式用于按访问.改变.更新时间来筛选文件. 动作表达: a(last accessed) 最近一次访问时间 c(last changed) ...

  7. 设计模式之命令模式、举例分析、通俗易懂

    1. 定义 命令模式(Command):将一个请求封装为一个对象,从而使你可用不同的请求对客户进行参数化;对请求排队或记录请求日志,以及支持可撤销的操作 简单来说,就是类似于消费者-服务员-厨师,消费 ...

  8. linux ip -o,linux IP 命令使用举例

    linux IP 命令使用举例 ip 1.作用 ip是iproute2软件包里面的一个强大的网络配置工具,它能够替代一些传统的网络管理工具,例如ifconfig.route等,使用权限为超级用户.几乎 ...

  9. sequence.pad_sequences 的用法举例

    sequence.pad_sequences 的用法举例_power的专栏-CSDN博客

最新文章

  1. golang字符串处理
  2. java split函数报错
  3. 简明Python教程学习笔记_8_异常
  4. Python学习中出现的一些问题
  5. Python使用pyinstaller打包几个小技巧
  6. 没想到Sharding-Jdbc竟然这么牛逼!一键实现读写分离、分库分表~
  7. 《如何让你爱的人爱上你》第一部分:第一印象
  8. 有关笔记本电脑安装触控板驱动程序,对触控板进行相应的设置步骤
  9. Java实现简易图形编辑系统
  10. Incompatible magic value xxxxxx in class file
  11. 通过USB设置手机连接电脑上网
  12. vue解决mintui中使用MessageBox弹窗拦截,移动端多次点击手机的物理返回键,选择确定后页面返回不正确问题
  13. Git 使用 stash暂存代码
  14. requests和xml的结合应用
  15. 文本框直接粘贴添加图片构想
  16. 对Dilated Convolution理解
  17. 计算机编程知识竞赛,程序设计竞赛
  18. Cadence Other格式网表导出与导入ortelesis.dll
  19. 蒋涛对话王成录:哪怕退休了我都想在中国把 HarmonyOS 做成
  20. 校园网服务器系统需求分析,校园网建设需求分析.doc

热门文章

  1. Python爬虫+可视化实例:网易云音乐歌单
  2. Uncaught ReferenceError: xxx is not defined 解决办法
  3. WSL无法访问网络的解决办法
  4. Java求两个数组的交集、差集、并集
  5. MQTT - 消息队列遥测传输协议
  6. 在Linux下测试SD卡的读写速度
  7. 拆解USB无线网卡,电路方案非常经典(附高清美图)
  8. CentOS 7 安装配置 k8s 1.25.3
  9. 开发H5游戏练手, 黑暗堡垒-炼狱传奇H5 (一) 登陆界面开发
  10. HTTP status Code 412 未满足前提条件的解决方法之一