Aria2 是支持 BT、磁力、HTTP、FTP 等下载协议的下载工具，常用做离线下载的服务端。

项目地址

GitHub: P3TERX/docker-aria2-pro
Docker Hub: p3terx/aria2-pro
请随手点个 star 支持项目

镜像特点

使用 Aria2 完美配置方案

BT 下载率高、速度快
重启后不丢失任务进度、不重复下载
下载错误或取消下载自动删除未完成的文件防止磁盘空间占用
下载完成自动清除.aria2后缀名文件
自动获取 BT tracker 列表，进一步提升 BT 下载速度
更好的 PT 下载支持
防版权投诉、防迅雷吸血
使用 aria2-builder 项目最新静态编译二进制文件

多平台：amd64, i386, arm64, armhf
全功能：Async DNS, BitTorrent, Firefox3 Cookie, GZip, HTTPS, Message Digest, Metalink, XML-RPC, SFTP
最新依赖库，提供更安全、稳定、快速的下载体验
通过 CI 服务持续更新最新版本
支持与 RCLONE 联动

自动上传 OneDrive 、Google Drive 等网盘
百度网盘加速下载并转存到其它网盘
自由选择上传网盘
支持新一代互联网协议 IPv6
定时自动更新 BT tracker 列表（无需重启）
用户文件权限设置功能
配置文件持久化，支持使用 watchtower 自动更新容器。
极简设计，专注下载，简单易用，少即是多。

Docker安装

我的系统为Debian ，使用这里只讲Debian Docker 安装，其他系统可参考Docker教程

卸载旧版本

Docker 的旧版本被称为 docker，docker.io 或 docker-engine，如果已安装，请卸载它们：

sudo apt-get remove docker docker-engine docker.io containerd runc

安装 Docker Engine-Community

使用 Docker 仓库进行安装

在新主机上首次安装 Docker Engine-Community 之前，需要设置 Docker 仓库。之后，您可以从仓库安装和更新 Docker。

Raspbian 用户不能使用此方法！

对于 Raspbian，尚不支持使用仓库进行安装。您必须改为使用 shell 脚本方式。

设置仓库

更新 apt 包索引。

$ sudo apt-get update

安装 apt 依赖包，用于通过 HTTPS 来获取仓库。

$ sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg2 \
    software-properties-common

添加 Docker 的官方 GPG 密钥：

$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 通过搜索指纹的后8个字符，验证您现在是否拥有带有指纹的密钥。

$ sudo apt-key fingerprint 0EBFCD88

pub   4096R/0EBFCD88 2017-02-22
      Key fingerprint = 9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid                  Docker Release (CE deb) <docker@docker.com>
sub   4096R/F273FCD8 2017-02-22

使用以下指令设置稳定版仓库

$ sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/debian \
  $(lsb_release -cs) \
  stable"

安装 Docker Engine-Community

更新 apt 包索引：

$ sudo apt-get update

安装最新版本的 Docker Engine-Community 和 containerd 

$ sudo apt-get install docker-ce docker-ce-cli containerd.io

测试 Docker

是否安装成功，输入以下指令，打印出以下信息则安装成功：

$ sudo docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
1b930d010525: Pull complete                                                                                                                                  Digest: sha256:c3b4ada4687bbaa170745b3e4dd8ac3f194ca95b2d0518b417fb47e5879d9b5f
Status: Downloaded newer image for hello-world:latest


Hello from Docker!
This message shows that your installation appears to be working correctly.


To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.


To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash


Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/


For more examples and ideas, visit:
 https://docs.docker.com/get-started/

aria2镜像安装

基础使用

安装命令示例。（不要无脑复制粘贴，请详细阅读选项参数说明）

docker run -d \
    --name aria2-pro \
    --restart unless-stopped \
    --log-opt max-size=1m \
    --network host \
    -e PUID=$UID \
    -e PGID=$GID \
    -e RPC_SECRET=<TOKEN> \
    -e RPC_PORT=6800 \
    -e LISTEN_PORT=6888 \
    -v ~/aria2-config:/config \
    -v ~/aria2-downloads:/downloads \
    p3terx/aria2-pro

选项参数说明

  • Docker 基本选项

–name aria2-pro - 容器名称，可自定义以示区分。

–restart unless-stopped - 设置容器重启策略，详情参见 Docker 官方文档。

–log-opt max-size=1m - 日志大小限制为 1MB，防止 Aria2 持续下载产生大量的日志占用磁盘空间。

–network host - 使用 host 网络模式。

  • 文件权限设置

-e PUID=$UID, -e PGID=$GID - 设置容器内账户 UID 与 GID。
非 root 账户文件权限问题。执行 id 命令手动获取。

id
  • Aria2 配置选项环境变量

-e RPC_SECRET= - RPC 密钥设置。默认密码：P3TERX。

-e RPC_PORT=6800 - RPC 端口设置，忽略则可通过配置文件修改。

-e LISTEN_PORT=6888 - BT 监听端口（TCP）、DHT 监听端口（UDP）设置。

-e DISK_CACHE= - 磁盘缓存设置，默认值 64M。

  • 目录映射

-v ~/aria2-config:/config - 配置目录映射，配置文件持久化。左边为宿主机路径供自定义，不要有中文、不要混用配置文件。

-v ~/aria2-downloads:/downloads - 下载目录映射。左边为宿主机路径供自定义，不要有中文。

注意事项

GID与UID设置对于非 root 账户非常重要，你不应该错过这个细节，否则可能导致不必要的麻烦。
容器启动命令有关路径与端口参数中:(冒号)右边的值为容器内部固定值，无需修改也不能修改，否则无法正常工作。

常用命令

  • 重启

    docker restart aria2-pro

  • 重装

    docker rm -f aria2-pro
docker rmi p3terx/aria2-pro
rm -rf ~/aria2-config
docker pull p3terx/aria2-pro
docker run <...>

  • 更新

    docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower -cR \
  aria2-pro

  • 查看日志

  • 查看实时日志

    docker logs -f --tail 30 aria2-pro

  • 导出日志

    docker logs aria2-pro > ~/aria2-pro.log

开始使用

配置防火墙开放端口或端口转发设置。
使用 WebUI 或 App 进行连接，推荐 AriaNg 。本站有建好的AriaNg可用
体验高速远程离线下载的乐趣。

参考

如果出现了什么问题可以到以下寻找，或者下发留言。
Docker 教程
Debian Docker 安装
Aria2 Pro - 更好用的 Aria2 Docker 容器镜像