Aria2 Pro - 更好用的 Aria2 Docker 容器镜像

• --name aria2-pro - 容器名称，可自定义以示区分。
• --restart unless-stopped - 设置容器重启策略，详情参见 Docker 官方文档。
• --log-driver json-file - 设置日志记录格式为 json 格式。这是 Docker 的默认值，某些特殊情况可能需要设置。
• --log-opt max-size=1m - 日志大小限制为1MB，防止 Aria2 持续下载产生大量的日志占用磁盘空间。某些 GUI 可能没有相关选项。所以说有什么理由不用 CLI 一把梭？

• --network host - 使用 host 网络模式。直接使用宿主机网络，免去端口映射导致的部分性能损失，且灵活性更高，可更方便的配置使用 IPv6 网络。host 网络模式仅适用于 Docker 17.06+ ，如果你的 Docker 版本低于此，请先升级。

  ⚠️ macOS 和 Windows 上的 Docker 目前暂时无法使用 host 网络模式，依然需要进行端口映射。方法参见后面的 bridge 网络模式章节。

• -v $PWD/aria2-config:/config - 配置目录映射，配置文件持久化。左边为宿主机路径供自定义，不要有中文、不要混用配置文件，首次使用请确保目录为空。
• -v $PWD/aria2-downloads:/downloads - 下载目录映射。左边为宿主机路径供自定义，不要有中文。

TIPS: 注意确认目录是否存在、权限是否正确。

对以上映射的目录进行用户权限设置，aria2c核心进程会以所设定的用户运行。当使用非 root 用户进行管理时非常重要，这关乎到安全性和文件是否能正常访问。你不应该错过这个细节，否则可能导致不必要的麻烦。

• -e PUID=$UID - 用户映射。设置文件管理账户的UID(用户 ID)。忽略则默认为nobady用户，并权限最大化。
• -e PGID=$GID - 用户组映射。设置文件管理账户的GID(用户组 ID)。忽略则默认为nogroup用户组，并权限最大化。

科普： 在常规的 Linux 发行版中$UID与$GID这两个环境变量分别为当前登录账户的UID与GID值，所以通过 CLI 启动容器可以直接使用这两个变量。但需要注意可能有部分系统$GID没有被定义。

如果管理文件的账户不是当前登录的账户或者使用 GUI 创建容器请务必执行id命令手动获取并填写。比如我的账户为p3terx，那么就执行id p3terx：

$ id p3terx
uid=1000(p3terx) gid=100(users) ...

设置后容器会自动去配置文件权限，配置目录权限为755，配置文件为600，附加功能脚本为700，下载目录为设定用户rwx权限，以提升安全性，且每次重启容器会进行修正，防止权限问题。

在不进行任何设置的情况下，即PUID或PGID其中任意一个变量留空。容器默认会定义用户为nobady、用户组为nogroup，并且设置权限最大化（777），这样理论上任何用户都可以读写配置文件、附加功能脚本等文件和访问下载目录。如果你对文件权限不敏感可以这么做，但并不推荐。

用于设置一些可能需要自定义的 Aria2 配置选项，方便一键部署。

TIPS: 以下环境变量定义后将直接写入配置文件(aria2.conf)，通过变量定义后无法通过配置文件修改，因为每次容器重启会自动修正为环境变量定义的值。你也可以选择忽略它们，直接在容器创建后修改配置文件。

• -e RPC_SECRET=<TOKEN> - RPC 密钥设置，即 WebUI 连接时需要填写的密码，只建议使用字母和数字。如果没有设置，配置文件中的默认密码为P3TERX。
• -e RPC_PORT=6800 - RPC 端口设置。
• -e LISTEN_PORT=6888 - BT 监听端口（TCP）、DHT 监听端口（UDP）设置，即 Aria2 配置中listen-port与dht-listen-port选项定义的端口。如果没有设置，配置文件中的默认值为6888。
• -e DISK_CACHE=<SIZE> - 磁盘缓存设置，默认值64M。建议在有足够的内存空闲情况下设置为适当增加大小，以减少磁盘 I/O ，提升读写性能，延长硬盘寿命。比如128M、256M等。此项值仅决定上限，实际对内存的占用取决于网速(带宽)和设备性能等其它因素。当下载文件超过这个大小且网速足够快时最多会占用所设置大小的内存，所以不宜过大，设置不当轻则进程终结、重则宕机。
• -e IPV6_MODE=true - 开启 IPv6 模式。此变量等同于设定配置文件中的选项disable-ipv6=false与enable-dht6=true。可间接提升 BT 下载速率，但需要网络完整支持 IPv6 ，否则会导致部分功能异常，甚至无法下载。

• -e SPECIAL_MODE=move - 开启文件自动归档/分类功能，即在文件下载完成后把文件移动到指定目录。默认移动到下载目录下的completed子目录。有关详情在后面的进阶玩法章节。
• -e SPECIAL_MODE=rclone - 开启 RCLONE 联动功能。首次启动容器会在容器内自动安装 RCLONE，且每次重启会自动更新。有关详情在后面的进阶玩法章节。

• -e UPDATE_TRACKERS=false - 禁用自动更新 BT tracker 。PT 下载和想手动填写设置 BT tracker 需求必须禁用。
• -e CUSTOM_TRACKER_URL=<URL>：自定义 BT tracker 列表获取链接，多个链接可以用半角逗号(,)进行分隔。如果没有指定则默认从https://trackerslist.com/all_aria2.txt进行获取。
• -e UMASK_SET=022 - umask 设置，默认值022。决定你下载下来的文件的权限，对权限不敏感或不理解直接填写000。
• -e TZ=<TIME_ZONE> - 时区设置，默认时区为Asia/Shanghai，若无特殊需求无需自定义。

bridge 网络模式下需要把容器内部的端口映射到宿主机，它是 Docker 默认的网络模式，所以很多 Docker 镜像的默认使用说明都包含端口映射的参数，也包括在2020年3月28日之前的本项目。bridge 网络模式主要是用于网络隔离，对于一般用户几乎无用，而且多了一层 NAT ，会有一定的网络性能损失。如果要使用 IPv6 网络还需要进行一些列复杂的设置。对于全新部署且没有特殊需求不会用到下面这些参数。

• -p 6800:6800 - RPC 通讯端口映射。
• -p 6888:6888 - BT 监听端口（TCP）映射，即 Aria2 配置中listen-port选项定义的端口。
• -p 6888:6888/udp - DHT 监听端口（UDP）映射，即 Aria2 配置中dht-listen-port选项定义的端口。

bridge 网络模式启动命令示例：

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

TIPS: bridge 网络模式下如果需要自定义端口，建议映射到宿主机相同的端口，避免混淆和功能异常。

• Aria2 Pro 镜像中没有内置配置文件和脚本，而是在容器启动时从 P3TERX/aria2.conf 项目进行下载（配置目录没有相应文件的情况下）并进行转换。目的是方便维护与更新，在不更新镜像的情况下可对配置与脚本中的问题进行快速修复。更新最新配置方案或者想恢复初始配置文件只需删除配置文件目录中的所有文件并重启容器即可。
• 默认开启 BT 强制加密，理论上有一定的防版权投诉和防迅雷吸血的效果，在测试使用中没有发现对下载速度有影响，但是否具有普适性还有待观察和研究。如果你在使用中遇到了问题，可以手动修改配置文件去关闭。
• 出于安全性的考虑，配置目录中配置文件的权限为600、脚本为700，如需编辑需要使用设定的账户（没有设置用户 ID 除外）。
• 配置文件和脚本无法下载一般是容器的网络没有通导致的，这个问题一般出现在 OpenWrt 系统中。

容器完成初始化后配置目录下有个script.conf文件，通过它可以自定义文件删除功能、文件清理功能、文件过滤功能。文件上传设置和文件移动设置为特殊模式选项，有关详情请参见进阶玩法章节。

重启后下载进度不会丢失，不会重复下载，但这个功能的目的是为了防止意外，并不是为了没事瞎重启而做的。目前经过成百上千次测试，有极小概率会导致部分正在进行的任务在重启后会下载失败，这与所下载文件的服务器的某些策略有关，所以不管是重启设备还是 Aria2 Pro 本身都建议先暂停任务再重启。

Aria2 官方对单服务器线程数进行限制必然是有他们自己的考虑，但我个人认为自由软件就是要自由，所以解除了这个限制，让所有人可以自由选择。不过无脑的增加线程数并不会让下载速度飞起来，有时会起到反作用，甚至导致无限重启。合理的设置才是正道。

此外 Aria2 Pro 还有特殊的防掉线程优化以及增强配置选项，这是其他项目所不具备的，有关详情配置文件中有注释说明。

在开启 IPv6 后 BT 下载有一定的资源搜寻能力提升，能连接到更多的用户，间接可提升 BT 下载速率，这对于没有公网 IPv4 的小伙伴是一个福音。由于需要网络完整支持 IPv6，否则会导致部分功能异常，所以目前默认是关闭的。

• 使用 host 网络模式只需在宿主机 IPv6 网络正常的情况下在容器启动命令中添加IPV6_MODE=true环境变量或者后续修改配置文件中有关 IPv6 的选项并重启容器即可。
• 使用 briage 、 macvlan 等网络模式则还需要配置 Docker 使容器获得 全球单拨 IPv6 地址并且容器网络正常。由于配置过程太过复杂，所以一般来说并不推荐。

以下为 OpenWrt 系统中的端口转发设置示例：

《Aria2 前端面板 ( GUI、WebUI ) AriaNg 使用教程》

• 使用 web server 反代 RPC 端口（推荐）。
• 复制证书到配置目录下，修改配置文件中的相关参数。注意路径前缀为容器内的路径，即/config/。

NOTICE: 部分 PT 站对 Aria2 有特殊检测机制，可能存在封号风险，使用前需要注意 PT 站的相关规则与条款。

• PT 下载需要加入-e UPDATE_TRACKERS=false参数禁用自动更新 BT tracker ，然后设定 BT 端口为任意五位数端口，比如25236。启动命令示例：

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=P3TERX \
    -e RPC_PORT=6800 \
    -e LISTEN_PORT=25236 \
    -v ~/aria2-config:/config \
    -v ~/aria2-downloads:/downloads \
    -e UPDATE_TRACKERS=disable \
    p3terx/aria2-pro

• 修改配置文件中的客户端伪装设置。

• 使用 Aria2 Pro 镜像创建名为aria2-bt的容器 RPC 端口设置为6801，BT 端口设置为6999，配置目录设置为~/aria2-bt-config，下载目录设置为~/bt-downloads。启动命令示例：

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

• 使用 Aria2 Pro 镜像创建名为aria2-pt的容器 RPC 端口设置为6802，BT 监听端口设置为25236，PT 下载不需要设置 DHT 端口所以忽略，配置目录设置为~/aria2-pt-config，下载目录设置为~/pt-downloads，加入-e UPDATE_TRACKERS=disable参数禁用自动获取 BT tracker 。启动命令示例：

docker run -d \
    --name aria2-pt \
    --restart unless-stopped \
    --log-opt max-size=1m \
    --network host \
    -e PUID=$UID \
    -e PGID=$GID \
    -e RPC_SECRET=P3TERX \
    -e RPC_PORT=6802 \
    -e LISTEN_PORT=25236 \
    -v ~/aria2-pt-config:/config \
    -v ~/pt-downloads:/downloads \
    -e UPDATE_TRACKERS=disable \
    p3terx/aria2-pro

• 修改~/aria2-pt-config/aria2.conf中关于 PT 的必要的配置，重启容器。
• 使用 AriaNg 分别通过6801和6802端口连接到这两个容器中的 Aria2 。
• Enjoy !

• 启动命令加入-e SPECIAL_MODE=rclone参数设定特殊模式环境变量后开启 RCLONE 自动上传功能，容器初次启动会安装 RCLONE ，且每次重启会自动更新 RCLONE。启动命令示例：

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=P3TERX \
    -e RPC_PORT=6800 \
    -e LISTEN_PORT=6888 \
    -v ~/aria2-config:/config \
    -v ~/rclone-downloads:/downloads \
    -e SPECIAL_MODE=rclone \
    p3terx/aria2-pro

• 之前若使用过 RCLONE 直接把配置文件（rclone.conf）复制到 Aria2 Pro 配置目录下即可。 RCLONE 配置文件可以在宿主机的默认位置找到：~/.config/rclone/rclone.conf
• 初次使用或者想要配置 RCLONE 可使用docker exec -it aria2-pro rclone config命令进入容器内的 RCLONE 交互菜单选项，配置方法可参考：《Rclone 安装配置教程》。
• 最后根据实际情况修改 Aria2 Pro 配置文件目录下script.conf文件中的网盘名称(drive-name)和网盘路径(drive-dir)这两个选项的值。

有些小伙伴可能有特殊需求，比如使用世纪互联的 OneDrive ，或者想突破 Google Drive 的 750G 上传限制，这就需要用到相应的 RCLONE 魔改版，比如 gclone、fclone 等。这些魔改版由于没有完善安装升级方式和技术支持，所以并不好做整合，但可以使用一些特殊的方法让 Aria2 Pro 支持。

简单来讲就是在宿主机下载或安装相应的魔改版，把二进制文件的路径映射到容器的/usr/local/bin/rclone。

这里以 gclone 为例子，安装后其二进制文件路径在/usr/bin/gclone，把它映射到容器/usr/local/bin/rclone。假设 service account 文件保存目录在~/service-account，那么把它映射到容器中的/service-account目录。启动命令示例：

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=P3TERX \
    -e RPC_PORT=6800 \
    -e LISTEN_PORT=6888 \
    -v ~/aria2-config:/config \
    -v ~/rclone-downloads:/downloads \
    -v /usr/bin/gclone:/usr/local/bin/rclone \
    -v ~/service-account:/service-account \
    -e SPECIAL_MODE=rclone \
    p3terx/aria2-pro

其他操作和官方版一致，详见上一章节，这里不再赘述。需要注意的是配置文件可能需要做相应的调整，比如 gclone 的 service account 文件路径。

• 使用 Aria2 Pro 镜像创建名为aria2-onedrive的容器 RPC 端口设置为6803，BT 端口设置33333，配置目录为~/aria2-onedrive-config，下载目录为~/onedrive-downloads。启动命令示例：

docker run -d \
    --name aria2-onedrive \
    --restart unless-stopped \
    --log-opt max-size=1m \
    --network host \
    -e PUID=$UID \
    -e PGID=$GID \
    -e RPC_SECRET=P3TERX \
    -e RPC_PORT=6803 \
    -e LISTEN_PORT=33333 \
    -v ~/aria2-onedrive-config:/config \
    -v ~/onedrive-downloads:/downloads \
    -e SPECIAL_MODE=rclone \
    p3terx/aria2-pro

• 使用 Aria2 Pro 镜像创建名为aria2-gdrive的容器 RPC 端口设置为6804，BT 端口设置44444，配置目录为~/aria2-gdrive-config，下载目录为~/gdrive-downloads。启动命令示例：

docker run -d \
    --name aria2-gdrive \
    --restart unless-stopped \
    --log-opt max-size=1m \
    --network host \
    -e PUID=$UID \
    -e PGID=$GID \
    -e RPC_SECRET=P3TERX \
    -e RPC_PORT=6804 \
    -e LISTEN_PORT=44444 \
    -v ~/aria2-gdrive-config:/config \
    -v ~/gdrive-downloads:/downloads \
    -e SPECIAL_MODE=rclone \
    p3terx/aria2-pro

• 参考上个章节分别配置这两个容器的 RCLONE 。
• 使用 AriaNg 分别通过6803和6804端口连接到这两个容器中的 Aria2 。
• Enjoy !

启动命令中增加-e SPECIAL_MODE=move参数添加环境变量即可，默认情况下文件下载完成后将移动到下载目录下的completed子目录。通过 WebUI （或其它 RPC 方式）指定临时下载目录为/downloads/movie则下载完成后文件会移动到下载目录下的completed/movie子目录中，指定临时下载目录为/downloads/tv则下载完成后文件会移动到下载目录下的completed/tv子目录中，依次类推，实现自动分类。

TIPS: 这里的movie、tv子目录只是举例，并不是固定的，可以根据自己的喜好和实际情况来填写。

若要移动到下载目录以外的某个目录，除了添加必须的环境变量以外，还需要额外对一个目录进行映射，但不能是下载目录下的子目录（目录映射套娃的后果自行体会）。考虑到此目录可能用于共享，故容器不会对这个目录进行权限更改，宿主机端的目录需提前创建并设置好相应的权限。比如将容器内的/completed映射到宿主机的~/aria2-completed目录：

docker run -d \
    --name aria2-pro \
    --restart unless-stopped \
    --network host \
    --log-opt max-size=1m \
    -e PUID=$UID \
    -e PGID=$GID \
    -e RPC_SECRET=P3TERX \
    -e SPECIAL_MODE=move \
    -v ~/aria2-config:/config \
    -v ~/aria2-downloads:/downloads \
    -v ~/aria2-completed:/completed \
    p3terx/aria2-pro

最后还需要编辑配置目录下的script.conf文件，将dest-dir的值设置为容器内的路径，即上面例子中的/completed。

TIPS: 由于容器技术的局限性，不同的映射目录被定义为不同的磁盘，即使它们在宿主机中处于同一个磁盘上，在移动文件时也将会以全新写入的方式进行。就像是在 PC 上同一硬盘不同分区之间的文件移动。