Aria2 Pro配置和使用

• --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 版本低于此，请先升级。
  

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

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

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

• -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) ...

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，若无特殊需求无需自定义。

• -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 网络模式下如果需要自定义端口，建议映射到宿主机相同的端口，避免混淆和功能异常。