📥 Aria2-Pro + AriaNg 完整部署文档

Aria2-Pro 是一个优化版的 Aria2 下载核心，支持自动更新 BT Trackers、防迅雷吸血、任务持久化等功能。 AriaNg 是一个现代化的 Web 前端，可以通过浏览器管理 Aria2。 两者结合，可以实现稳定高效的远程下载服务。

📂 目录结构规划

建议将服务放在 /opt/docker-stack/aria2/ 下：

代码

/opt/docker-stack/aria2/
├─ compose.yaml
└─ data/
   ├─ .env
   └─ README.md

⚙️ 环境变量配置（data/.env）

代码

ARIA2_RPC_SECRET=yourpassword
ARIA2_DOWNLOAD_DIR=/opt/docker-stack/aria2/downloads
ARIA2_PORT=6800
ARIANG_PORT=6880

🐳 Docker Compose 配置（compose.yaml）

代码

name: aria2-stack

networks:
  web_net:
    external: true   # 需提前创建：docker network create web_net

services:
  aria2:
    image: p3terx/aria2-pro
    container_name: aria2
    restart: unless-stopped
    env_file:
      - ./data/.env
    environment:
      - RPC_SECRET=${ARIA2_RPC_SECRET}
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/config
      - ${ARIA2_DOWNLOAD_DIR}:/downloads
    ports:
      - "${ARIA2_PORT}:6800"
      - "6881:6881"
      - "6881:6881/udp"
    networks:
      - web_net

  ariang:
    image: p3terx/ariang
    container_name: ariang
    restart: unless-stopped
    ports:
      - "${ARIANG_PORT}:6880"
    networks:
      - web_net

🔑 Service Name vs Container Name

• service name (aria2, ariang)
  • 在同一个网络中，其他容器可以通过 aria2:6800 或 ariang:6880 访问。
  • 推荐在反向代理配置中使用 service name。
• container name (aria2, ariang)
  • 宿主机上唯一标识，便于 docker ps、docker logs 管理。
  • 不建议在跨容器访问时使用。

📑 README.md（保存到 data 目录）

代码

# Aria2-Pro + AriaNg 部署文档

## 目录结构
/opt/docker-stack/aria2/
├─ compose.yaml
└─ data/
   ├─ .env
   └─ README.md

## 环境变量 (.env)
- ARIA2_RPC_SECRET：Aria2 RPC 密钥
- ARIA2_DOWNLOAD_DIR：下载文件保存目录
- ARIA2_PORT：Aria2 RPC 端口（默认 6800）
- ARIANG_PORT：AriaNg WebUI 端口（默认 6880）

## 网络配置
- 使用自定义网络 web_net，需提前创建：
  docker network create web_net

- 反向代理示例（Caddyfile）：
  aria2.example.xyz {
    reverse_proxy ariang:6880
  }

## 启动与停止
cd /opt/docker-stack/aria2
docker compose up -d      # 启动
docker compose down       # 停止并删除容器
docker compose restart    # 重启

## 升级与回滚
- 升级：
  docker compose pull && docker compose up -d

- 回滚：
  修改 compose.yaml 中镜像标签为上一个版本或 digest，然后：
  docker compose up -d

## 验证
- 浏览器访问 http://服务器IP:6880 → 打开 AriaNg WebUI
- 在 AriaNg 设置里填入 RPC 地址：
  ws://服务器IP:6800/jsonrpc
- 输入 RPC_SECRET 完成连接

## 注意事项
- Aria2-Pro 不包含 WebUI，必须搭配 AriaNg 使用。
- 建议通过反代启用 HTTPS，保证 WebUI 的安全性。
- service name 用于容器间互通，推荐在反代配置里使用。
- container name 用于宿主机管理，便于查看日志和状态。

🚀 总结

• Aria2-Pro 提供稳定的下载核心，优化 BT/PT 下载体验。
• AriaNg 提供现代化 WebUI，方便在浏览器中管理任务。
• 两者结合，通过 Docker Compose 部署，可以快速搭建远程下载服务。
• 配合反向代理（Caddy/Nginx），可实现统一的 HTTPS 管理。

感谢大佬的镜像

来源：https://p3terx.com/archives/docker-aria2-pro.html