Docker Hub:https://hub.docker.com/r/superng6/aria2
GitHub:https://www.github.com/SuperNG6/docker-aria2
博客:https://sleele.com/2019/09/27/docker-aria2的最佳实践/
PS:docker hub的用户是无法看到GitHub中的图片,会显示为框框,具体图文详情可以在我的博客上浏览
在茫茫多的docker aria2镜像中,一直找不到符合我需求的镜像
当前的镜像或多或少都有以下几点不符合的我的需求
- 没有配置UID和GID
这关系到你下载的文件的权限问题,默认是root权限,很难管理
- 掺杂了不必要的东西
大量aria2 images都包含了webui,我觉得根本没有必要 随便找一个在线的aria2控制台即可 一个容器最好只跑一个服务
- 端口不全
绝大多数的aria2 images 都只开放了6800端口 下载速度息息相关的BT下载DTH监听端口、BT下载监听端口,需要expose出来
- 没有自动删除.aria2文件的自动执行脚本
aria2建立下载任务后会自动生成.aria2文件,aria2自身提供了api可以触发执行脚本
- 全平台架构
x86-64
、arm64
、armhf
- 做了usermapping,使用你自己的账户权限来运行,这点对于群辉来说尤其重要
- 纯aria2,没有包含多于的服务
- 超小镜像体积 10.77 MB
- 开放了BT下载DTH监听端口、BT下载监听端口(TCP/UDP 6881),加快下载速度
- 默认开启DHT并且创建了DHT文件,加速下载
- 包含了下载完成后自动删除.aria2文件脚本
- 包含了执行删除正在下载任务事时自动执行删除文件(删除已完成的任务不会删除文件,请放心)和aria2文件的脚本
- 内置最优的aria2配置文件(来自P3TERX/aria2.conf,感谢)
- 内置400多条最新trackers(来自XIU2 / TrackersListCollection,感谢)
- 默认上海时区 Asia/Shanghai
- 直接设置token,不需要在配置文件里修改
- 最新静态编译版的aria2c1.3.5
- 支持自动更新tracker,每次启动容器时会自动更新tracker
- 手动设置磁盘缓存,默认参数
x86-64:512M
、arm64:256M
、armhf:128M
Architecture | Tag |
---|---|
x86-64 | amd64-latest |
arm64 | arm64v8-latest |
armhf | arm32v7-latest |
1、使用jsdelivr cdn加速下载trackers,但是会出现缓存导致的不是最新版本
1、更新base image lsiobase/alpine:3.10
2、增加了静默下载功能,默认下载不输出到console --quiet[=true|false]
1、update delete.sh & delete.aria2.sh 现在可以删除自定义目录的`.aria2`文件和文件夹了
至此,`.aria2`删除和`文件/目录`删除功能已完善
2、增加了`downloads1`、`downloads2`、`downloads3`、`downloads4`、`downloads5`目录
方便多磁盘用户的多磁盘下载,权限修复
1、update delete.sh & delete.aria2.sh
1、增加arm64v8、arm32v7平台镜像
2、针对arm平台设备ram小的情况,增加配置下载缓存大小设置
3、进一步压缩镜像体积,现在只有10.77 MB
1、新增自动更新tracker,默认开启,每次启动容器时会自动检查并更新tracker列表
1、回退脚本,新版脚本会在删除已完成任务时会删除下载任务指定的二级目录
1、更新了P3TERX/P3TERX/aria2.conf及触发脚本
2、更新trackers(XIU2 / TrackersListCollection )
3、梳理、优化了文件结构
4、本次更新请手动删除你的Aria2配置文件(可以直接删除配置目录)
5、改善 delete.sh、delete.aria2.sh 路径判断逻辑,增加删除空目录功能
6、重启Aria2后不会重复下载已完成的任务
我在Gitee上构建了基于ariang主线稳定版的在线webui:
仅https https://sleele.gitee.io/#!/downloading
http http://sleele.gitee.io/ariang/#!/downloading
/config
/downloads
之所以默认关闭SSL(建议开启),是因为如果开启,又没有配置证书,会导致aria2启动失败,所以如果需要开启请手动编辑aria2.conf
证书请放在/config/ssl
目录下
删掉24,26,28行的#
号
2019.10.11更新日志及用户须知
PS:为什么不在ENV里加入直接修改token?
因为我发现直接运行命令aria2c --rpc-secret=$SECRET
会报很多(在conf文件里写也会报,但是少很多)[WARN] aria2c had to connect to the other side using an unknown T…
原因在于
aria2c 1.3.4
不支持TLS1.3,在你的证书是TLS1.3的情况,下会报错,好消息是10.6号会发布1.3.5
解决这个问题,国庆结束后我会更新aria2c 1.3.5
解决这个问题
群晖用户请使用你当前的用户SSH进系统,输入 id 你的用户id
获取到你的UID和GID并输入进去
对你的docker配置文件夹的根目录
进行如图操作,你的下载文件夹的根目录
进行相似操作,去掉管理
这个权限,只给写入
,读取
权限
我个人是不喜欢这个功能的,Aria2的一些机制,导致Aria2重启带来的问题会很多,比如,已移除的文件他会再下一次等等,所以没事还是不要重启Aria2,而且trackerlist大部分tracker是不会变动的,只有极少数会变动,频繁的自动更新tracker带来的收益极其有限,甚至是负收益
今后可能会添加这个功能作为可选项,但是默认一定会是关闭,之所以打脸,默认开启是因为,我想到一个更巧妙的法子,Aria2需要重启才能够读取到conf文件改变的内容,所以就意味着,为了更新tracker而去重启Aria2,其所带来负面影响,比如导致dht文件失效从新收集信息,任务重新下载等,是不值当的。如果放弃使用定时更新这种形式,改为每次启动容器时更新tracker,那么就一举两得的解决了这个问题,不重启不更新,重启时在Aria2启动前自动更新tracker,做到完全无感知,并且没有任何负面效果,如果能做到这种效果,添加默认自动更新tracker则是值得的
输入 id 你的用户id
获取到你的UID和GID,替换命令中的PUID、PGID
执行命令
docker create \
--name=aria2 \
-e PUID=1026 \
-e PGID=100 \
-e TZ=Asia/Shanghai \
-e SECRET=yourtoken \
-e CACHE=512M \
-e UpdateTracker=true \
-e QUIET=true \
-p 6881:6881 \
-p 6881:6881/udp \
-p 6800:6800 \
-v /path/to/appdata/config:/config \
-v /path/to/downloads:/downloads \
--restart unless-stopped \
superng6/aria2
docker-compose
version: "2"
services:
aria2:
image: superng6/aria2
container_name: aria2
environment:
- PUID=1026
- PGID=100
- TZ=Asia/Shanghai
- SECRET=yourtoken
- CACHE=512M
- UpdateTracker=true
- QUIET=true
volumes:
- /path/to/appdata/config:/config
- /path/to/downloads:/downloads
ports:
- 6881:6881
- 6881:6881/udp
- 6800:6800
restart: unless-stopped