Aria2 - venusir/wiki GitHub Wiki

🤖 Assistant

以下是 Debian 系统安装 aria2 + AriaNg 的步骤指南，基于参考资料整理：

1. 安装 aria2

# 更新软件源并安装 aria2
sudo apt-get update
sudo apt-get install aria2 -y

2. 配置 aria2

步骤说明：

创建配置与日志文件

# 创建配置目录及文件（系统级配置示范）
sudo mkdir /etc/aria2
sudo touch /etc/aria2/aria2.conf /etc/aria2/aria2.session
sudo chmod 777 /etc/aria2/aria2.session  # 确保 session 文件可写

编辑配置文件
执行 sudo nano /etc/aria2/aria2.conf，填入以下基础配置（需自行调整参数）：

# Trackers
bt-tracker=udp://tracker.opentrackr.org:1337/announce,udp://tracker.leechers-paradise.org:6969/announce,udp://p4p.arenabg.com:1337/announce,udp://9.rarbg.to:2710/announce,udp://9.rarbg.me:2710/announce,udp://exodus.desync.com:6969/announce,udp://tracker.sbsub.com:2710/announce,udp://retracker.lanta-net.ru:2710/announce,udp://open.stealth.si:80/announce,udp://tracker.tiny-vps.com:6969/announce,udp://tracker.cyberia.is:6969/announce,udp://tracker.torrent.eu.org:451/announce,udp://tracker.moeking.me:6969/announce,udp://tracker3.itzmx.com:6961/announce,udp://ipv4.tracker.harry.lu:80/announce,udp://bt2.archive.org:6969/announce,udp://bt1.archive.org:6969/announce,http://tracker1.itzmx.com:8080/announce,udp://valakas.rollo.dnsabr.com:2710/announce,udp://tracker.zerobytes.xyz:1337/announce

# 文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置
dir=/home/zk/Downloads
# 启用磁盘缓存, 0为禁用缓存, 需1.16以上版本, 默认:16M
disk-cache=5M
# 文件预分配方式, 能有效降低磁盘碎片, 默认:prealloc
# 预分配所需时间: none < falloc ? trunc < prealloc
# falloc和trunc则需要文件系统和内核支持, NTFS建议使用falloc, EXT3/4建议trunc
file-allocation=none
# 断点续传
continue=true

## 下载连接相关 ##

# 最大同时下载任务数, 运行时可修改, 默认:5
max-concurrent-downloads=20
# 同一服务器连接数, 添加时可指定, 默认:1
max-connection-per-server=15
# 最小文件分片大小, 添加时可指定, 取值范围1M -1024M, 默认:20M
# 假定size=10M, 文件为20MiB 则使用两个来源下载; 文件为15MiB 则使用一个来源下载
min-split-size=10M
# 单个任务最大线程数, 添加时可指定, 默认:5
split=16
# 整体下载速度限制, 运行时可修改, 默认:0
#max-overall-download-limit=0
# 单个任务下载速度限制, 默认:0
#max-download-limit=0
# 整体上传速度限制, 运行时可修改, 默认:0
max-overall-upload-limit=20kb
# 单个任务上传速度限制, 默认:0
max-upload-limit=5kb
# 禁用IPv6, 默认:false
disable-ipv6=true
# 禁用https证书检查
check-certificate=false
#运行覆盖已存在文件
allow-overwrite=true
#自动重命名
auto-file-renaming

## 进度保存相关 ##

# 从会话文件中读取下载任务
input-file=/etc/aria2/aria2.session
# 在Aria2退出时保存`错误/未完成`的下载任务到会话文件
save-session=/etc/aria2/aria2.session
# 定时保存会话, 0为退出时才保存, 需1.16.1以上版本, 默认:0
save-session-interval=120

## 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-save-upload-metadata=false

## BT/PT下载相关 ##

# 当下载的是一个种子(以.torrent结尾)时, 自动开始BT任务, 默认:true
#follow-torrent=true
# BT监听端口, 当端口被屏蔽时使用, 默认:6881-6999
listen-port=51413
# 单个种子最大连接数, 默认:55
#bt-max-peers=55
# 打开DHT功能, PT需要禁用, 默认:true
enable-dht=true
# 打开IPv6 DHT功能, PT需要禁用
enable-dht6=false
# DHT网络监听端口, 默认:6881-6999
#dht-listen-port=6881-6999
# 本地节点查找, PT需要禁用, 默认:false
bt-enable-lpd=true
# 种子交换, PT需要禁用, 默认:true
enable-peer-exchange=true
# 每个种子限速, 对少种的PT很有用, 默认:50K
#bt-request-peer-speed-limit=50K
# 客户端伪装, PT需要
peer-id-prefix=-UT341-
user-agent=uTorrent/341(109279400)(30888)
# 当种子的分享率达到这个数时, 自动停止做种, 0为一直做种, 默认:1.0
seed-ratio=1.0
# 强制保存会话, 话即使任务已经完成, 默认:false
# 较新的版本开启后会在任务完成后依然保留.aria2文件
#force-save=false
# BT校验相关, 默认:true
#bt-hash-check-seed=true
# 继续之前的BT任务时, 无需再次校验, 默认:false
bt-seed-unverified=true
# 保存磁力链接元数据为种子文件(.torrent文件), 默认:false
#bt-save-metadata=false
#仅下载种子文件
bt-metadata-only=true
#通过网上的种子文件下载，种子保存在内存
follow-torrent=mem

3. 安装 AriaNg（Web 管理界面）

步骤说明：

安装 Nginx（Web 服务器）

sudo apt-get install nginx -y  # 用于托管 AriaNg 前端页面[5]

下载并部署 AriaNg

# 下载最新版 AriaNg（假设版本为 1.3.1）
wget https://github.com/mayswind/AriaNg/releases/download/1.3.1/AriaNg-1.3.1.zip
sudo unzip AriaNg-1.3.1.zip -d /var/www/html/ariang  # 解压到 Web 目录

# 设置目录权限
sudo chown -R www-data:www-data /var/www/html/ariang

验证部署
访问 http://服务器IP或域名/ariang，确认 AriaNg 页面加载成功。

4. 启动服务与连接配置

启动 aria2 后台服务

aria2c --conf-path=/etc/aria2/aria2.conf -D  # 以守护进程方式运行

配置 AriaNg 连接 aria2
- 进入 AriaNg 页面 （http://IP/ariang）
- 顶部菜单选择 「AriaNg 设置」 → 「RPC」
- 输入以下信息：
  - RPC 地址：http://localhost:6800/jsonrpc
  - RPC 密钥：与配置文件中的 rpc-secret 一致

5. 可选优化

开机自启动 aria2
创建 Systemd 服务文件（路径：/etc/systemd/system/aria2.service），添加如下内容：

[Unit]
Description=Aria2 Download Service
After=network.target

[Service]
ExecStart=/usr/bin/aria2c --conf-path=/etc/aria2/aria2.conf

[Install]
WantedBy=multi-user.target

简化操作
可通过 uGet 等下载工具集成 aria2，需在工具中配置 RPC 地址和密钥。

6.自动更新tracker

在 Aria2 配置文件 (aria2.conf) 所在目录执行以下命令即可获取最新 tracker 列表并自动添加到配置文件中更新tracker后需重启aria2服务

bash <(curl -fsSL git.io/tracker.sh)

总结

核心步骤：安装 aria2 → 配置 RPC → 部署 AriaNg → 连接验证。
推荐使用场景：服务器托管（需结合 Nginx）或本地桌面环境。
常见问题：确保防火墙开放 6800（RPC）和 80/443（Web）端口，若使用密钥需与 AriaNg 同步。