README.CN.md

Aria2 + AriaNg

English | 简体中文

本镜像包含 Aria2、AriaNg 和File Manager，主要方便那些用户期望只运行一个镜像就能实现图形化下载文件和在线播放文件。（类似离线下载的功能），只使用一个 Docker 镜像也方便用户在群晖NAS 中运行本程序。

• 功能特性
• 推荐使用的docker image tag
• 安装于运行
  • 快速运行
  • 开启所有功能
  • 使用docker-compose 运行
  • 支持的 Docker 环境变量
  • 支持的 Docker volume 属性
• 自动 SSL
• 自行构建镜像
• Docker Hub
• 使用 Docker compose 来运行
• 常见问题

AriaNG

File Browser

功能特性

• Aria2 (SSL 支持)
• AriaNg 通过 UI 来操作，下载文件
• 自动 HTTPS （Let's Encrypt）
• 支持绑定自定义用户ID，可以主机上的非root用户，也可以管理下载的文件
• Basic Auth 用户认证
• 文件管理和视频播放 (File Browser，注意默认情况下，只能访问和管理 /data 目录下的文件)
• 支持ARM CPU 架构，因此可以在树莓派中运行，请下载对应的ARM TAG 版本, arm32或arm64

推荐使用的docker image tag

• wahyd4/aria2-ui:latest
• wahyd4/aria2-ui:arm32
• wahyd4/aria2-ui:arm64

安装于运行

快速运行

  docker run -d --name aria2-ui -p 80:80 wahyd4/aria2-ui

• Aria2: http://yourip/ui/
• FileManger: http://yourip
• 请使用 admin/admin 进行登录

开启所有功能

  docker run -d --name ariang \
  -p 80:80 \
  -p 443:443 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e ENABLE_AUTH=true \
  -e RPC_SECRET=Hello \
  -e DOMAIN=https://example.com \
  -e ARIA2_SSL=false \
  -e ARIA2_USER=user \
  -e ARIA2_PWD=pwd \
  -v /yourdata:/data \
  -v /app/a.db:/app/filebrowser.db \
  -v /yoursslkeys/:/app/conf/key \
  -v <the folder of aria2.conf and aria2.session>:/app/conf \
  wahyd4/aria2-ui

使用docker-compose 运行

如果你不想记住那些命令行，你也可以使用docker-compose来将配置放在docker-compose.yaml文件中

version: "3.5"
services:
  aria2-ui:
    restart: unless-stopped
    image: wahyd4/aria2-ui:latest
    environment:
      - ENABLE_AUTH=true
      - ARIA2_USER=hello
      - ARIA2_PWD=world
      - DOMAIN=http://toozhao.com
    volumes:
      - ./data:/data

然后使用 docker-compose up -d 运行即可

支持的 Docker 环境变量

• ENABLE_AUTH 启用 Basic auth(网页简单认证) 用户认证
• ARIA2_USER Basic Auth 用户认证用户名
• ARIA2_PWD Basic Auth 密码
• PUID 需要绑定主机的Linux用户ID，可以通过cat /etc/passwd 查看用户列表， 默认UID 是1000
• PGID 需要绑定的主机的Linux 用户组ID，默认GID 是1000
• RPC_SECRET Aria2 RPC 加密 token
• DOMAIN 绑定的域名, 当绑定的域名为HTTPS时，即为启用HTTPS， 例： DOMAIN=https://toozhao.com

支持的 Docker volume 属性

• /data 用来放置所有下载的文件的目录
• /app/conf/key 用户来放置 Aria2 SSL certificate证书和 key 文件. 注意: 证书的名字必须是 aria2.crt， Key 文件的名字必须是 aria2.key
• /app/conf 该目录下可以放置你的自定义aria2.conf配置文件，aria2.session，且必须包含这两个文件。第一次使用aria2.session时，创建一个空文件即可，该文件会包含aria2当前的下载列表，这样即使容器被销毁也不用担心文件列表丢失了。你也可以直接拷贝当前项目下conf目录中的两个文件并使用。
• /app/filebrowser.db File Browser 的内嵌数据库，升级Docker 镜像也不用担心之前的设置丢失。请确保在宿主机先创建一个空文件再使用。

自动 SSL

请在绑定域名前，设置DNS的一条A记录，将运行docker的主机IP绑定到该域名。然后你仅仅需要在运行时添加e设置即可。

docker run -d --name aria2-ui -p 80:80 -p 443:443 -e DOMAIN=https://toozhao.com wahyd4/aria2-ui

自行构建镜像

docker build -t aria2-ui .

Docker Hub

https://hub.docker.com/r/wahyd4/aria2-ui/

使用 Docker compose 来运行

请参考 https://github.com/wahyd4/aria2-ariang-x-docker-compose

常见问题

1. 当你以非其他80 端口或以启用了HTTPS443端口运行程序时，会出现Aria2 状态 未连接的错误，这是因为在最新版本里面，我们去掉aria2的独立6800端口，转而使用和网站同一个端口。因为你需要渠道 AriaNg设置 -> 页面顶端的 RPC页面，将你的Aria2 RPC 地址中的端口从80改成你使用的正确端口。因为 AriaNg 仅仅将设置保存在浏览器中，因为当你使用不同的浏览器，或者将浏览器清除缓存后，你都需要重新设置一次。
2. 下载的BT或者磁力完全没有速度怎么办？ 建议先下载一个热门的BT种子文件，而不是磁力链接。这样可以帮助缓存DHT文件，渐渐地，速度就会起来了。比如试试下载树莓派操作系统的BT种子？前往下载
3. 如果你遇到了和 setcap 相关的错误，很大程度说明你说运行的Linux不支持使用非root用户来运行本Docker 镜像，因此请显式地设置环境变量PUID PGID 为 0 ，也就是使用root 来运行