Docker 部署 Aria2 Pro 下载器 📥

📋 目录导航

🎯 项目简介

Aria2 Pro 是一个强大的命令行下载工具，支持多协议下载，包括 HTTP/HTTPS、FTP、SFTP、BitTorrent 和 Metalink。通过 Docker 部署，可以轻松搭建高性能的下载服务器，配合 AriaNg Web 界面提供直观的管理体验。

✨ 核心特性

特性类别 功能描述 优势
⚡ 多协议支持 支持 HTTP/HTTPS、FTP、SFTP、BitTorrent 和 Metalink 一站式下载解决方案
🚀 高速下载 多连接并发下载，最大化利用带宽 提升下载速度，节省时间
💾 轻量高效 资源占用低，性能优异 节省系统资源，稳定运行
🔄 断点续传 支持下载任务断点续传 网络中断后无需重新下载
🌐 远程控制 可通过 JSON-RPC 和 XML-RPC 接口远程控制 方便远程管理下载任务
📊 管理界面 配合 AriaNg 提供美观的 Web 管理界面 直观易用，无需命令行操作
🔧 高度可定制 丰富的配置选项满足各种需求 适应不同下载场景和需求

🐳 一、Docker 部署 Aria2 Pro

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
mkdir -p /mnt/mydisk/home/aria2-pro && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  aria2-pro:
    container_name: aria2-pro
    image: p3terx/aria2-pro:latest
    restart: unless-stopped
    network_mode: bridge
    ports:
      - "6800:6800"                     # RPC 端口
      - "6888:6888"                     # BT 监听端口
      - "6888:6888/udp"                 # BT UDP 端口
    volumes:
      - ./config:/config
      - /mnt/ARS2-NFS/downloads/aria2-pro:/downloads
    environment:
      - PUID=0
      - PGID=0
      - RPC_SECRET=haoyong              # RPC 连接密钥
      - RPC_PORT=6800
      - LISTEN_PORT=6888
      - IPV6_MODE=true
      - TZ=Asia/Shanghai

  ariang:
    container_name: ariang
    image: p3terx/ariang:latest
    restart: unless-stopped
    network_mode: bridge
    ports:
      - "6880:6880"                     # Web界面端口
    environment:
      - TZ=Asia/Shanghai
    depends_on:
      - aria2-pro
EOF

🔑 RPC 连接密钥: haoyong
📁 下载路径: /mnt/ARS2-NFS/downloads/aria2-pro

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Aria2 Pro

1. 访问 Web 界面 💻

  • 本地访问: http://localhost:6880
  • 域名访问: https://aria2.example.com（配置反向代理后）

2. 配置连接 ⚙️

  1. 打开浏览器访问上述地址
  2. 点击左侧菜单 “Aria2 设置”
  3. 配置连接信息：
    • RPC 地址: http://服务器IP:6800/jsonrpc
    • RPC 协议: HTTP
    • RPC 密钥: haoyong
  4. 点击 “重新连接” 测试连接

🌐 三、Nginx 反向代理配置

访问地址示例：https://aria2.example.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/aria2.conf <<'EOF'
server {
    listen 443 ssl;
    server_name aria2.example.com;
    
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/private.key;
    
    # 提高上传大小限制
    client_max_body_size 20G;
    
    location / {
        proxy_pass http://localhost:6880;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 增加超时时间
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }
    
    # 静态资源缓存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
        proxy_pass http://localhost:6880;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 进入项目目录
cd /mnt/mydisk/home/aria2-pro

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop aria2-pro ariang      # 停止容器
docker start aria2-pro ariang     # 启动容器  
docker restart aria2-pro ariang   # 重启容器

# 删除容器
docker rm aria2-pro ariang        # 删除已停止容器
docker rm -f aria2-pro ariang     # 强制删除运行中容器

# 进入容器Shell
docker exec -it aria2-pro bash    # 使用bash进入aria2-pro容器
docker exec -it aria2-pro sh      # 使用sh进入aria2-pro容器

# 查看容器详情和资源使用
docker inspect aria2-pro     # 查看详细配置
docker stats aria2-pro       # 实时资源监控

## 容器日志管理
docker logs aria2-pro           # 查看日志
docker logs -f aria2-pro        # 实时跟踪日志
docker logs --tail 100 aria2-pro  # 查看最后100行
docker logs -t aria2-pro        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🚀 启航下载，极速无限

通过本文档，你已经成功使用 Docker 部署了 Aria2 Pro 下载器，并通过 Nginx 反向代理实现了安全便捷的远程访问。现在，你可以：

⚡ 极速下载 享受多协议并发下载带来的极致速度体验，最大化利用网络带宽
🌐 远程管理 随时随地通过 Web 界面添加和管理下载任务，打破时空限制
💾 稳定可靠 依托容器化部署确保下载环境稳定，支持断点续传不丢进度
🔒 安全加密 通过 HTTPS 加密连接保护你的下载隐私和传输安全

下载不仅是获取资源的方式，更是数字生活的高效助手。愿 Aria2 Pro 成为你可靠的下载伙伴，让你的每一次资源获取都变得简单、快速、稳定。

从现在开始，释放你的网络潜能，体验极速下载的畅快感受！💨

📌 持续迭代：建议关注 Aria2 Pro 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你下载愉快，资源满载！🎉