Docker Aria2的最佳实践

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

Architecture	Tag
x86-64	amd64-latest
arm64	arm64v8-latest
armhf	arm32v7-latest

Changelogs

2020/04/17

  1、使用jsdelivr cdn加速下载trackers，但是会出现缓存导致的不是最新版本

2020/03/02

  1、更新base image lsiobase/alpine:3.10
  2、增加了静默下载功能，默认下载不输出到console --quiet[=true|false]

2020/02/22

  1、update delete.sh & delete.aria2.sh 现在可以删除自定义目录的`.aria2`文件和文件夹了
     至此，`.aria2`删除和`文件/目录`删除功能已完善
  2、增加了`downloads1`、`downloads2`、`downloads3`、`downloads4`、`downloads5`目录
     方便多磁盘用户的多磁盘下载，权限修复

2020/01/15

  1、update delete.sh & delete.aria2.sh

2020/01/10

  1、增加arm64v8、arm32v7平台镜像
  2、针对arm平台设备ram小的情况，增加配置下载缓存大小设置
  3、进一步压缩镜像体积，现在只有10.77 MB

2019/12/27

  1、新增自动更新tracker，默认开启，每次启动容器时会自动检查并更新tracker列表

2019/12/19

  1、回退脚本，新版脚本会在删除已完成任务时会删除下载任务指定的二级目录

2019/12/04

  1、更新了P3TERX/P3TERX/aria2.conf及触发脚本
  2、更新trackers(XIU2 / TrackersListCollection )
  3、梳理、优化了文件结构
  4、本次更新请手动删除你的Aria2配置文件（可以直接删除配置目录）
  5、改善 delete.sh、delete.aria2.sh 路径判断逻辑，增加删除空目录功能
  6、重启Aria2后不会重复下载已完成的任务

Document

在线webui

我在Gitee上构建了基于ariang主线稳定版的在线webui:
仅https https://sleele.gitee.io/#!/downloading
http http://sleele.gitee.io/ariang/#!/downloading

挂载路径

/config /downloads

默认关闭SSL，如需需要请手动开启

之所以默认关闭SSL(建议开启)，是因为如果开启，又没有配置证书，会导致aria2启动失败，所以如果需要开启请手动编辑aria2.conf 证书请放在/config/ssl目录下删掉24,26,28行的#号

修改RPC token

填写你自己的token,越长越好，建议使用生成的UUID

2019.10.11更新日志及用户须知

2019.10.11日更新静态编译aria2c1.3.5解决报错[WARN] aria2c had to connect to the other side using an unknown T…

~~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解决这个问题

aria2/aria2#1464

aria2/aria2#1468

使用2019.10.11日前版本的用户，更新时请删除conf文件的第十七行

token现在不用写在配置文件里了，使用2019.10.11日前版本的用户，请删除第十七行，否则会报错，无法启动

关于群晖

群晖用户请使用你当前的用户SSH进系统，输入 id 你的用户id 获取到你的UID和GID并输入进去

权限管理设置

对你的docker配置文件夹的根目录进行如图操作，你的下载文件夹的根目录进行相似操作，去掉管理这个权限，只给写入,读取权限

关于自动更新trackers

我个人是不喜欢这个功能的，Aria2的一些机制，导致Aria2重启带来的问题会很多，比如，已移除的文件他会再下一次等等，所以没事还是不要重启Aria2，而且trackerlist大部分tracker是不会变动的，只有极少数会变动，频繁的自动更新tracker带来的收益极其有限，甚至是负收益

~~今后可能会添加这个功能作为可选项，但是默认一定会是关闭~~，之所以打脸，默认开启是因为，我想到一个更巧妙的法子，Aria2需要重启才能够读取到conf文件改变的内容，所以就意味着，为了更新tracker而去重启Aria2，其所带来负面影响，比如导致dht文件失效从新收集信息，任务重新下载等，是不值当的。如果放弃使用定时更新这种形式，改为每次启动容器时更新tracker，那么就一举两得的解决了这个问题，不重启不更新，重启时在Aria2启动前自动更新tracker，做到完全无感知，并且没有任何负面效果，如果能做到这种效果，添加默认自动更新tracker则是值得的

Linux

输入 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

planktonzp / docker-aria2