以下是基于Armbian系统手动本地安装Aria2的完整流程（无需Docker），综合多个可靠来源整理：
🔧 安装步骤
1. 安装Aria2
sudo apt update
sudo apt install aria2 -y # 通过apt直接安装核心程序 :ml-citation{ref="2,5" data="citationList"}若apt安装失败（如版本不兼容），可尝试编译安装：(1行1个命令)
wget https://github.com/aria2/aria2/releases/download/release-1.34.0/aria2-1.34.0.tar.bz2
tar -jxvf aria2-1.34.0.tar.bz2
cd aria2-1.34.0
./configure
make
sudo make install # 手动编译安装替代方案 :ml-citation{ref="6" data="citationList"}2. 创建配置文件与目录
mkdir -p ~/.config/aria2 # 创建配置目录
touch ~/.config/aria2/aria2.session # 会话文件
touch ~/.config/aria2/aria2.conf # 配置文件 :ml-citation{ref="2,5" data="citationList"}3. 编辑配置文件
nano ~/.config/aria2/aria2.conf
粘贴以下配置（按需修改关键参数）：ini
dir=/home/你的用户名/downloads # 下载保存路径（必改！）
input-file=~/.config/aria2/aria2.session
save-session=~/.config/aria2/aria2.session
rpc-listen-port=6800
rpc-secret=你的自定义密码 # RPC密钥（必改！）
continue=true
max-concurrent-downloads=3
split=10
min-split-size=10M
max-connection-per-server=16
enable-rpc=true
rpc-allow-origin-all=true
rpc-listen-all=true
disable-ipv6=true # 若IPv6不稳定建议启用 :ml-citation{ref="2,5" data="citationList"}按 Ctrl+O 保存 → Enter → Ctrl+X 退出编辑器。
4. 启动Aria2
临时启动（调试用）：
aria2c --conf-path=~/.config/aria2/aria2.conf
后台常驻启动：
nohup aria2c --conf-path=~/.config/aria2/aria2.conf > /dev/null 2>&1 &
开机自启（systemd）
创建服务文件：
sudo nano /etc/systemd/system/aria2.service
内容如下：ini
[Unit] Description=Aria2 Download Service After=network.target [Service] User=你的用户名 ExecStart=/usr/bin/aria2c --conf-path=/home/你的用户名/.config/aria2/aria2.conf [Install] WantedBy=multi-user.target
启用服务：
sudo systemctl daemon-reload
sudo systemctl start aria2
sudo systemctl enable aria2 # 开机自启 :ml-citation{ref="4,8" data="citationList"}🌐 连接Web管理界面
推荐使用 AriaNg 作为Web前端：
浏览器访问 http://ariang.mayswind.net/latest
进入 AriaNg设置 → RPC：
Aria2 RPC 地址：http://[你的Armbian IP]:6800/jsonrpc
RPC 密钥：填写配置中的 rpc-secret 值
⚠️ 注意事项
端口与防火墙
确保 6800 端口开放：sudo ufw allow 6800/tcp
若使用路由转发，需在路由器设置端口映射
下载目录权限
sudo chown -R $USER:$USER /home/你的用户名/downloads # 避免写入权限问题 :ml-citation{ref="8" data="citationList"}服务状态检查
systemctl status aria2 # 检查运行状态
netstat -tunlp | grep 6800 # 确认端口监听 :ml-citation{ref="4" data="citationList"}🔍 附：快速验证RPC连通性
curl http://localhost:6800/jsonrpc -d '{"jsonrpc":"2.0","method":"aria2.getVersion","id":1}' -H 'Content-Type: application/json'
# 返回含 "version" 字段即成功 :ml-citation{ref="9" data="citationList"}此方案完全基于本地安装，无Docker依赖，适配主流Armbian设备（玩客云/斐讯N1等均实测可用）。若需更复杂配置（如BT优化），可参考配置文件中的扩展参数注释 。
=====================
以下是重置 Aria2 RPC 密钥的完整操作指南（基于配置文件修改）：
🔑 重置步骤
修改配置文件
打开 Aria2 配置文件（默认路径 ~/.config/aria2/aria2.conf）：
nano ~/.config/aria2/aria2.conf
定位 rpc-secret= 参数
修改等号后的值为新密钥（示例：rpc-secret=NewPassword123!）23
ini
rpc-secret=NewPassword123! # 替换为自定义高强度密钥
重启 Aria2 服务
systemctl restart aria2 # 使用 Systemd 管理时:ml-citation{ref="4" data="citationList"}或手动重启：
killall aria2c && aria2c --conf-path=/path/to/aria2.conf -D
更新 Web 管理端配置
在 AriaNg 等前端界面中：
设置 → RPC → 密钥 填入新密钥28
连接地址示例：
http://服务器IP:6800/jsonrpc
⚠️ 注意事项
密钥复杂度
建议组合大小写字母 + 数字 + 符号（如 X7gT!9qP@2）
避免使用默认值或简单密码38
服务状态验证
curl http://localhost:6800/jsonrpc -d '{
"jsonrpc":"2.0",
"method":"aria2.getVersion",
"id":1,
"params":["token:NewPassword123!"]
}' -H 'Content-Type: application/json'✅ 成功返回将包含 "version" 字段8
防火墙规则
若远程访问失败：
sudo ufw allow 6800/tcp # 开放 RPC 端口:ml-citation{ref="7" data="citationList"}密钥修改后需同步更新所有连接客户端（桌面客户端/手机APP等）的配置24。若使用 Docker 部署，需在环境变量 RPC_SECRET 中同步更新密钥并重建容器3。
返回顶部
