Aria2 + AriaNg 部署

发布于 2026年09月20日

Ubuntu Server 26.04 | Aria2 1.37.0 | AriaNg 1.3.7

简介

Aria2

Aria2 是一款开源、轻量级的多协议命令行下载工具,支持 HTTP/HTTPS、FTP、SFTP、BitTorrent 和 Metalink 等多种协议。它的核心优势在于:

  • 多线程下载:单文件可分 16 个分片并行下载,大幅提升速度

  • 协议全能:一个工具覆盖直链、BT、磁力链接等所有常见下载场景

  • 资源占用极低:内存占用约 30MB,适合服务器长期运行

  • 断点续传:支持会话保持,中断后可从断点继续

  • RPC 接口:提供 JSON-RPC 接口,支持远程管理和第三方前端对接

AriaNg

AriaNg 是一个用 HTML/JS 编写的纯前端 Web 界面,用于管理和监控 Aria2 的下载任务。它的特点:

  • 纯静态部署:无需后端服务,放到 Nginx/Apache 即可运行

  • 功能完善:支持新建任务、查看进度、管理队列、限速设置等

  • 界面美观:提供直观的图形化操作界面,替代命令行交互

  • 多语言支持:内置简体中文

典型应用场景

场景

说明

服务器批量下载

在 VPS/服务器上批量拉取文件,利用服务器带宽

BT/磁力下载

下载 Linux 镜像、开源资源等种子文件

远程管理

通过 Web 界面远程操控服务器上的下载任务

NAS/PT 保种

长期挂机做种,配合 PT 站点使用

一、环境信息

项目

值

系统

Ubuntu 26.04 LTS

Aria2 版本

1.37.0

AriaNg 版本

1.3.7

Web 服务

Nginx

下载目录

/data/downloads

RPC 端口

6800

WebUI 端口

80

二、安装依赖

sudo apt update && sudo apt install aria2 nginx wget unzip -y

验证 Aria2 版本(需 ≥1.36.0 且包含 ENABLE_RPC):

aria2c --version

三、创建目录与配置文件

3.1 创建必要目录

sudo mkdir -p /etc/aria2 /data/downloads
sudo touch /etc/aria2/aria2.session

3.2 生成 RPC 密钥

RPC_SECRET=$(openssl rand -hex 16)
echo $RPC_SECRET

记下输出的密钥,后续连接 WebUI 时需要填写。

3.3 创建 Aria2 配置文件

sudo tee /etc/aria2/aria2.conf << 'EOF'
dir=/data/downloads
enable-rpc=true
rpc-listen-all=true
rpc-allow-origin-all=true
rpc-listen-port=6800
rpc-secret=YOUR_RPC_SECRET_HERE
continue=true
max-concurrent-downloads=10
split=16
min-split-size=10M
max-connection-per-server=16
input-file=/etc/aria2/aria2.session
save-session=/etc/aria2/aria2.session
save-session-interval=60
daemon=true
bt-enable-lpd=true
enable-dht=true
enable-peer-exchange=true
EOF

将 YOUR_RPC_SECRET_HERE 替换为上一步生成的密钥。

3.4 配置文件参数说明

参数

说明

dir

下载文件存储路径

enable-rpc

启用 RPC 接口

rpc-listen-all

监听所有网络接口

rpc-allow-origin-all

允许跨域请求

rpc-listen-port

RPC 监听端口

rpc-secret

RPC 认证密钥

continue

断点续传

max-concurrent-downloads

最大同时下载数

split

单文件分片数

min-split-size

最小分片大小

max-connection-per-server

单服务器最大连接数

input-file

会话文件路径

save-session

保存会话路径

save-session-interval

会话保存间隔(秒)

daemon

后台运行

bt-enable-lpd

启用本地 peer 发现

enable-dht

启用 DHT

enable-peer-exchange

启用 peer 交换

四、注册 systemd 服务

4.1 创建服务文件

sudo tee /etc/systemd/system/aria2.service << 'EOF'
[Unit]
Description=Aria2 Download Manager
After=network.target
​
[Service]
Type=forking
ExecStart=/usr/bin/aria2c --conf-path=/etc/aria2/aria2.conf
Restart=on-failure
RestartSec=5
​
[Install]
WantedBy=multi-user.target
EOF

4.2 启动服务

sudo systemctl daemon-reload
sudo systemctl enable --now aria2

4.3 验证服务状态

sudo systemctl status aria2

预期输出:

Active: active (running)

五、部署 AriaNg Web 界面

5.1 下载并解压 AriaNg

sudo mkdir -p /var/www/ariang
cd /var/www/ariang
sudo wget https://github.com/mayswind/AriaNg/releases/download/1.3.7/AriaNg-1.3.7.zip -O AriaNg.zip
sudo unzip AriaNg.zip
sudo rm AriaNg.zip
sudo chown -R www-data:www-data /var/www/ariang

5.2 验证文件

ls /var/www/ariang

预期输出应包含 index.html、css/、js/ 等文件。

六、配置 Nginx

6.1 创建站点配置

sudo tee /etc/nginx/sites-available/ariang << 'EOF'
server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;
    root /var/www/ariang;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}
EOF

6.2 启用站点

sudo rm -f /etc/nginx/sites-enabled/default
sudo ln -sf /etc/nginx/sites-available/ariang /etc/nginx/sites-enabled/

6.3 测试并重载 Nginx

sudo nginx -t
sudo systemctl reload nginx

七、防火墙配置

sudo ufw allow 80/tcp    # AriaNg WebUI
sudo ufw allow 6800/tcp  # Aria2 RPC

如果使用云服务器,还需在云控制台安全组中放行 80 和 6800 端口。

八、访问验证

8.1 获取服务器 IP

curl -4 -s ifconfig.me

8.2 访问 WebUI

浏览器打开 http://服务器IP

8.3 配置 RPC 连接

  1. 点击左侧「AriaNg 设置」→「RPC」

  2. 填写以下信息:

    • RPC 地址:服务器IP

    • RPC 端口:6800

    • RPC 协议:HTTP

    • RPC 密钥:你生成的rpc-secret

  3. 点击保存,状态显示「Connected」即为成功

九、常用运维命令

# 查看服务状态
sudo systemctl status aria2
​
# 重启服务
sudo systemctl restart aria2
​
# 查看日志
sudo journalctl -u aria2 -f
​
# 停止服务
sudo systemctl stop aria2

十、目录结构

/etc/aria2/
├── aria2.conf          # 主配置文件
└── aria2.session       # 会话文件(断点续传用)
​
/var/www/ariang/        # AriaNg Web 静态文件
├── index.html
├── css/
├── js/
└── ...
​
/data/downloads/        # 下载文件存储目录

十一、安全建议

  1. 修改 RPC 密钥:使用强随机密钥,不要使用默认或简单密码

  2. 限制 RPC 访问:如仅本机使用,可将 rpc-listen-all 改为 false

  3. 启用 HTTPS:生产环境建议配置 SSL 证书

  4. 定期备份:备份 /etc/aria2/aria2.conf 和 aria2.session



评论