aria2 使用详解

aria2 使用详解

一、基本介绍

aria2 是一个轻量级多协议多源命令行下载工具,支持 HTTP/HTTPS, FTP,BitTorrent 和 Metalink。用户还可以通过内置的 JSON-RPC 和 XML-RPC 接口来操作 aria2。

特点:

多节点链接:下载一个文件可以同时链接多个源来提速轻量级:占用系统资源极少,一般下载任务内存占用 10mb 以内全功能的 BitTorrent 客户端:支持 DHT, PEX, Encryption, Magnet URI, Web-Seeding, Selective Downloads, Local Peer Discovery and UDP tracker支持 metalink 链接支持远程控制:支持 RPC 界面控制 aria2 进程

参考资源:

官网 aria2 手册:https://aria2.github.io/manual/en/html/index.htmlaria2 用户配置说明:http://aria2c.com/usage.html

二、配置文件

aria2 默认会首先从 ~/.aria2/aria2.conf 中寻找全局配置,其次从 ~/aria2/aria2.conf 寻找配置。

下面是一份基础的 aria2.conf 配置文件样式,来源于aria2 用户配置说明:

## '#'开头为注释内容, 选项都有相应的注释说明, 根据需要修改 ##

## 被注释的选项填写的是默认值, 建议在需要修改时再取消注释 ##

## 文件保存相关 ##

# 文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置

dir=${HOME}/downloads

# 启用磁盘缓存, 0为禁用缓存, 需1.16以上版本, 默认:16M

#disk-cache=32M

# 文件预分配方式, 能有效降低磁盘碎片, 默认:prealloc

# 预分配所需时间: none < falloc ? trunc < prealloc

# falloc和trunc则需要文件系统和内核支持

# NTFS建议使用falloc, EXT3/4建议trunc, MAC 下需要注释此项

#file-allocation=none

# 断点续传

continue=true

## 下载连接相关 ##

# 最大同时下载任务数, 运行时可修改, 默认:5

#max-concurrent-downloads=5

# 同一服务器连接数, 添加时可指定, 默认:1

max-connection-per-server=5

# 最小文件分片大小, 添加时可指定, 取值范围1M -1024M, 默认:20M

# 假定size=10M, 文件为20MiB 则使用两个来源下载; 文件为15MiB 则使用一个来源下载

min-split-size=10M

# 单个任务最大线程数, 添加时可指定, 默认:5

#split=5

# 整体下载速度限制, 运行时可修改, 默认:0

#max-overall-download-limit=0

# 单个任务下载速度限制, 默认:0

#max-download-limit=0

# 整体上传速度限制, 运行时可修改, 默认:0

#max-overall-upload-limit=0

# 单个任务上传速度限制, 默认:0

#max-upload-limit=0

# 禁用IPv6, 默认:false

#disable-ipv6=true

# 连接超时时间, 默认:60

#timeout=60

# 最大重试次数, 设置为0表示不限制重试次数, 默认:5

#max-tries=5

# 设置重试等待的秒数, 默认:0

#retry-wait=0

## 进度保存相关 ##

# 从会话文件中读取下载任务

input-file=${HOME}/.aria2/aria2.session

# 在Aria2退出时保存`错误/未完成`的下载任务到会话文件

save-session=${HOME}/.aria2/aria2.session

# 定时保存会话, 0为退出时才保存, 需1.16.1以上版本, 默认:0

#save-session-interval=60

## RPC相关设置 ##

# 启用RPC, 默认:false

enable-rpc=true

# 允许所有来源, 默认:false

rpc-allow-origin-all=true

# 允许非外部访问, 默认:false

rpc-listen-all=true

# 事件轮询方式, 取值:[epoll, kqueue, port, poll, select], 不同系统默认值不同

#event-poll=select

# RPC监听端口, 端口被占用时可以修改, 默认:6800

#rpc-listen-port=6800

# 设置的RPC授权令牌, v1.18.4新增功能, 取代 --rpc-user 和 --rpc-passwd 选项

# rpc-secret=123456

# 设置的RPC访问用户名, 此选项新版已废弃, 建议改用 --rpc-secret 选项

#rpc-user=

# 设置的RPC访问密码, 此选项新版已废弃, 建议改用 --rpc-secret 选项

#rpc-passwd=

# 是否启用 RPC 服务的 SSL/TLS 加密,

# 启用加密后 RPC 服务需要使用 https 或者 wss 协议连接

#rpc-secure=true

# 在 RPC 服务中启用 SSL/TLS 加密时的证书文件,

# 使用 PEM 格式时,您必须通过 --rpc-private-key 指定私钥

#rpc-certificate=/path/to/certificate.pem

# 在 RPC 服务中启用 SSL/TLS 加密时的私钥文件

#rpc-private-key=/path/to/certificate.key

## BT/PT下载相关 ##

# 当下载的是一个种子(以.torrent结尾)时, 自动开始BT任务, 默认:true

#follow-torrent=true

# BT监听端口, 当端口被屏蔽时使用, 默认:6881-6999

listen-port=51413

# 单个种子最大连接数, 默认:55

#bt-max-peers=55

# 打开DHT功能, PT需要禁用, 默认:true

enable-dht=false

# 打开IPv6 DHT功能, PT需要禁用

#enable-dht6=false

# DHT网络监听端口, 默认:6881-6999

#dht-listen-port=6881-6999

# 本地节点查找, PT需要禁用, 默认:false

#bt-enable-lpd=false

# 种子交换, PT需要禁用, 默认:true

enable-peer-exchange=false

# 每个种子限速, 对少种的PT很有用, 默认:50K

#bt-request-peer-speed-limit=50K

# 客户端伪装, PT需要

peer-id-prefix=-TR2770-

user-agent=Transmission/2.77

peer-agent=Transmission/2.77

# 当种子的分享率达到这个数时, 自动停止做种, 0为一直做种, 默认:1.0

seed-ratio=0

# 强制保存会话, 即使任务已经完成, 默认:false

# 较新的版本开启后会在任务完成后依然保留.aria2文件

#force-save=false

# BT校验相关, 默认:true

#bt-hash-check-seed=true

# 继续之前的BT任务时, 无需再次校验, 默认:false

bt-seed-unverified=true

# 保存磁力链接元数据为种子文件(.torrent文件), 默认:false

bt-save-metadata=true

aria2 不会自动创建配置文件中的目录及文件,如果目录不存在,aria2 会报错。因此,需要根据配置文件创建如下 2 个目录/文件:${HOME}/downloads 和 ${HOME}/.aria2/aria2.session

三、如何使用

1. 命令操作

## 下载一个文件

aria2c "http://host//file.zip"

## 从两个不同的 HTTP 服务器下载一个文件

aria2c "http://host//file.zip" "http://mirror/file.zip"

## 同时从 HTTP 和 FTP 服务器下载文件

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

## 使用多个连接从一个主机下载文件,x 指定允许的连接数,k 指定块大小

aria2c -x2 -k1M "http://host/file.zip"

详细使用,请参考 aria2(1) 的 man 手册

2. RPC 工具

Aria2 在服务器和嵌入式系统中广泛使用。然而,Aria2 本身是一个命令行工具,使用起来不够直观,因此需要一个图形用户界面(GUI)来简化操作。

Aria2 可以被配置为在后台运行,通过 RPC 接口接受来自其他程序的命令。这使得开发者可以创建一个用户界面,用于远程管理下载任务,而无需直接与 Aria2 进行交互。

1) YAAW

YAAW 是一个完全用纯 HTML/CSS/JavaScript 编写的一个基于 Aria2 的远程控制功能(RPC 接口)的 Web 前端,它不需要任何 HTTP 服务器、后端或服务器端程序的支持。这意味着它可以直接在浏览器中运行,用户可以通过浏览器直接管理下载任务 ‌,从而简化 Aria2 的使用。

YAAW 的特点:作为 Web 界面,YAAW 提供了一个用户友好的方式来管理 Aria2 下载器。它能够展示当前的下载任务,允许用户开始新的下载,暂停或恢复,以及删除任务等。

YAAW 的使用方法:用户只需确保 Aria2 已经按照上述设置启动,并监听一个 RPC 接口,然后通过任何现代 Web 浏览器访问 YAAW 的前端页面即可。前端会调用 Aria2 的 RPC 接口来获取和控制下载任务。

YAAW 源码下载地址:https://github.com/binux/yaaw 页面汉化的 YAAW 源码地址:https://gitee.com/ymz316/yaaw

首先,启动带有 RPC 功能的 Aria2:可以通过指定参数来启动 Aria2,例如使用 --enable-rpc 开启 RPC 服务,--rpc-listen-all=true 允许所有接口监听 RPC 服务,--rpc-allow-origin-all 允许所有域的跨域请求。

# 如果有 aria2.conf 文件,且开启了 RPC 服务(如上面的样例配置文件那样),则使用以下命令启动:

aria2c -D

## 如果没有 aria2.conf 文件,或者不想使用 aria2.conf 文件的配置,则使用以下命令启动:

aria2c --enable-rpc --rpc-listen-all=true --rpc-allow-origin-all --no-conf=true -D

然后,打开浏览器,输入 YAAW 前端页面地址(可以是 web 服务,甚至可以不用 web 服务直接用浏览器打开 index.html 文件),前端会调用 Aria2 的 RPC 接口来获取和控制下载任务。

如果自己没有源码,也可以输入别人搭建的 web 页面来下载,如:www.aria2c.com

2) uget

uget 是一个 GUI 工具,可以方便的管理 aria2 的任务。

## 下载uget

sudo apt-get install uget

开启 aria2 下载方法:打开 uget,点击编辑-设置,插件选择 aria2。下面的参数,如果有启用了 RPC 的 aria2.conf 文件,则只需用 -D 参数即可,否则,使用 --enable-rpc --rpc-listen-all=true --rpc-allow-origin-all -D。


相关推荐

做人流要休息多久
尾巴像把大剪刀,这个虫子你家里有吗?
率土之滨队伍称号加成 全称号属性介绍
曾经风行一时的“越南鼓”在2019至2020年实现了复兴
韩媒:韩德战改变了中国对韩国足球的看法了吗?
开户是什么意思?详细解释新手必看