Aira2 pro配置

发布于 2021-10-16  462 次阅读


文章目录[隐藏]

基础使用

最基本的启动命令如下,你只需要完整替换字段(RPC密钥)即可启动。更强大的功能请阅读后文。

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 $PWD/aria2-config:/config \
    -v $PWD/aria2-downloads:/downloads \
    p3terx/aria2-pro

配置本机防火墙开放必要的入站端口,内网机器在路由器设置端口转发到相同端口。
使用你喜欢的 WebUI 或 App 进行连接,强烈推荐 AriaNg。
体验高速远程离线下载的乐趣。
TIPS:

如果你习惯使用 Docker Compose 进行部署,这里提供了一个模版。
群晖用户如果对以上文字描述看得一脸懵逼,那么可参考这篇教程。
unRaid 用户可直接添加这个模版仓库。

基本参数

--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 网络模式章节。

注意事项

作者不会对使用此项目造成的损失承担任何责任,使用前请务必详细阅读整个文档再考虑是否使用。
容器启动命令有关路径与端口参数中:(冒号)右边的值为容器内部的固定值(常识),不要去修改,否则可能导致无法正常工作。
Aria2 配置文件中某些没必要修改的选项参数和已通过环境变量设定的选项参数默认情况下修改无效,重启后会自动修复为正确的值。(为了防止错误修改后导致容器工作异常所做的自我修复功能,比如可以防止把容器内的路径改成容器外的路径之类的迷惑行为)
由于 Aria2 暂时没有 UPnP 功能,所以必须配置防火墙开放监听端口,内网设备在路由器设置端口转发到相同端口,这对 BT 下载尤为重要,否则 Aria2 将无法与外界进行数据交换,影响下载率和速度。方法可参考内网端口转发设置章节。有关原理参见《Aria2 无法下载磁力链接、BT种子和速度慢的解决方案》。
某些 NAS 系统比如 OpenMediaVault 由于挂载盘默认使用了noexec特征,如果配置文件目录映射到了挂载盘下可能会导致附加功能脚本没有执行权限,解决方法可参考《OpenMediaVault 使用中遇到的问题和解决方案 #1 - permission denied》。
在中国大陆地区使用可能需要处理网络问题。已做针对性优化,但国情都懂的。
其它有关使用的注意事项因为精力有限暂未做整理,可查看本博客其它 Aria2 文章(不完全适用于本项目,仅供参考)。


擦肩而过的概率