lukasmrtvy/lsiobase-aria2-webui

Aria2 WebUI Docker镜像文档

镜像概述

本镜像为非官方Linuxserver.io镜像，基于https://aria2.github.io/构建。Aria2是一款轻量级多协议、多源命令行下载工具，支持HTTP/HTTPS、FTP、SFTP、BitTorrent和Metalink协议，并可通过内置的JSON-RPC和XML-RPC接口进行管理。镜像内置WebUI，提供便捷的可视化操作界面。

核心功能与特性

• 多协议支持：兼容HTTP/HTTPS、FTP、SFTP、BitTorrent和Metalink协议
• 内置WebUI：提供两种Web界面选择
  • aria：基于https://github.com/ziahamza/webui-aria2
  • ariang：基于https://github.com/mayswind/AriaNg/（默认）
• 多架构支持：适配x86-64等多种架构
• 灵活配置：支持自定义RPC令牌、Aria2参数及SSL设置

支持的架构

本镜像支持多种架构，通过Docker manifest实现多平台识别。拉取lukasmrtvy/lsiobase-aria2-webui镜像时会自动获取适合当前架构的版本，也可通过标签指定特定架构。

使用方法

Docker命令行部署

bash
docker create \
  --name=aria2 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 4040:4040 \
  -v </path/to/appdata/config>:/data/config \
  -v </path/to/downloads>:/data/downloads \
  -e WEBUI=aria \
  --restart unless-stopped \
  lukasmrtvy/lsiobase-aria2-webui

Docker Compose部署

兼容docker-compose v2架构：

yaml
---
version: "2"
services:
  aria2:
    image: docker.xuanyuan.run/lukasmrtvy/lsiobase-aria2-webui
    container_name: aria2
    environment:
      - PUID=1000
      - PGID=1000
      - WEBUI=aria
      - TZ=Europe/London
    volumes:
      - </path/to/appdata/config>:/data/config
      - </path/to/downloads>:/data/downloads
    ports:
      - 4040:4040
    restart: unless-stopped

参数说明

容器通过运行时参数进行配置，格式为<外部>:<内部>。以下是主要参数说明：

用户/组标识符

使用卷（-v参数）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机卷目录的所有者与指定的PUID/PGID一致。

获取当前用户的PUID和PGID：

bash
id username

示例输出：

uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

应用设置

通过<your-ip>:443访问WebUI，配置Aria2 RPC连接。更多信息请参考https://github.com/ziahamza/webui-aria2。也可使用自定义客户端通过相同连接字符串连接。

支持信息

• 容器运行时Shell访问：docker exec -it aria2 /bin/bash
• 实时查看容器日志：docker logs -f aria2
• 获取容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' aria2
• 获取镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/aria2

更新说明

大多数镜像为静态版本，需更新镜像并重建容器以更新应用（部分应用如nextcloud、plex除外）。更新步骤如下：

Docker Run/Create方式

1. 更新镜像：docker pull docker.xuanyuan.run/lukasmrtvy/lsiobase-aria2-webui
2. 停止容器：docker stop aria2
3. 删除容器：docker rm aria2
4. 使用原参数重建容器（配置文件通过卷映射保留）
5. 启动新容器：docker start aria2
6. 清理旧镜像：docker image prune

Docker Compose方式

1. 更新所有镜像：docker-compose pull（或单个镜像：docker-compose pull aria2）
2. 更新容器：docker-compose up -d（或单个容器：docker-compose up -d aria2）
3. 清理旧镜像：docker image prune

版本历史

• 23.02.19：初始版本

TODO

• 非高峰时段功能：https://github.com/ziahamza/webui-aria2/issues/126