getnas/aria2

Aria2 轻量下载机镜像

镜像概述

本镜像基于Linuxserver维护的Alpine基础镜像构建，集成Aria2下载器、AriaNg Web管理界面及lighthttpd轻量网页服务器。提供直观的Web管理界面和文件索引功能，预置IPv4/IPv6环境的DHT网络优化数据包（dht.dat和dht6.dat），默认未启用IPv6支持，可通过配置文件手动开启。

核心功能与特性

• 轻量级架构：基于Alpine Linux，资源占用低，运行高效
• 完整下载功能：集成Aria2下载器，支持HTTP/HTTPS、FTP、BT、磁力链接等多种协议
• Web管理界面：通过AriaNg提供直观的图形化管理界面，支持任务管理、进度监控
• 文件浏览：内置lighthttpd服务器，可通过网页浏览下载目录
• DHT优化：预置dht.dat（IPv4）和dht6.dat（IPv6）数据包，提升P2P网络连接效率
• 权限控制：支持通过PUID/PGID环境变量指定用户权限映射
• 安全认证：通过SECRET环境变量设置管理密码，防止未授权访问

使用场景

• 个人/家庭下载服务器，集中管理各类下载任务
• 轻量级NAS下载组件，整合到家庭媒体中心
• 远程服务器下载管理，通过Web界面随时控制下载任务

使用方法

创建容器

使用以下命令创建容器，替换/DOWNLOAD_DIR（下载目录）和/CONFIG_DIR（配置目录）为实际主机路径：

bash
sudo docker run -d \
--name aria2 \
-p 6800:6800 \
-p 6880:80 \
-p 6888:8080 \
-p 51443:51443 \
-p 51443:51443/udp \
-v /DOWNLOAD_DIR:/data \
-v /CONFIG_DIR:/config \
-e SECRET=YOUR_SECRET_CODE \
getnas/aria2

参数说明：

• 端口映射：
  • 6800:6800：Aria2 RPC端口
  • 6880:80：AriaNg Web管理界面端口
  • 6888:8080：文件浏览服务端口（不需要可移除）
  • 51443:51443（TCP/UDP）：BT/Tracker连接端口
• 卷挂载：
  • /DOWNLOAD_DIR:/data：下载文件存储目录
  • /CONFIG_DIR:/config：配置文件存储目录
• 环境变量：
  • SECRET=YOUR_SECRET_CODE：Web管理认证密码，替换为自定义字符串
• 其他选项：
  • 添加--restart=always可实现容器随Docker自动启动

指定用户和组

通过环境变量PUID和PGID指定容器与主机的用户权限映射：

bash
-e PUID=1000 -e PGID=1000

访问方式

• Web管理界面：http://服务器IP:6880
• 文件浏览：http://服务器IP:6888（需保留6888端口映射）

涉及项目

• https://github.com/aria2/aria2%EF%BC%9A%E6%A0%B8%E5%BF%83%E4%B8%8B%E8%BD%BD%E5%BC%95%E6%93%8E
• https://github.com/mayswind/AriaNg%EF%BC%9AWeb%E7%AE%A1%E7%90%86%E7%95%8C%E9%9D%A2

特别鸣谢

• 本项目基于https://github.com/XUJINKAI/aria2-with-webui%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%84%9F%E8%B0%A2%E4%BD%9C%E8%80%85XUJINKAI
• Aria2配置文件参考https://github.com/P3TERX/aria2.conf%E9%A1%B9%E7%9B%AE%EF%BC%8C%E6%84%9F%E8%B0%A2%E4%BD%9C%E8%80%85@P3TERX