pihizi/aria2

aria2-server Docker镜像文档

镜像概述和主要用途

aria2-server Docker镜像基于aria2构建，提供轻量级、多协议的下载服务。aria2是一款支持HTTP/HTTPS、FTP、BitTorrent等多种协议的命令行下载工具，该镜像将其容器化，方便用户快速部署和管理下载服务，支持配置持久化和下载数据存储，适用于个人或小型团队搭建私有下载服务器。

核心功能和特性

• 多协议支持：兼容HTTP/HTTPS、FTP、SFTP、BitTorrent等多种下载协议
• 持久化配置：通过挂载配置目录(/etc/aria2)，保存aria2配置文件，支持自定义下载参数
• 数据持久化：下载文件存储在挂载的共享目录(/data/aria2/download)，避免容器重启后数据丢失
• 端口映射：默认暴露6800端口，用于aria2 RPC接口，支持远程客户端连接管理
• 后台运行：支持以守护进程模式运行，稳定提供下载服务

使用场景和适用范围

• 个人私有下载服务器，用于后台下载各类资源
• 家庭媒体中心配套下载服务，自动下载影视、音乐等媒体文件
• 小型团队共享下载服务，集中管理团队所需资源下载
• 需要轻量级、低资源占用的下载解决方案

使用方法和配置说明

拉取镜像

shell
docker pull pihizi/aria2

基本运行命令

shell
docker run --name pihizi-aria2 \
    -v /dev/log:/dev/log \
    -v /YOUR/ARIA2/CONFIG/DIR:/etc/aria2 \
    -v /YOUR/SHARED/DIR:/data/aria2/download \
    -p 6800:6800 \
    -d pihizi/aria2

参数说明：

• --name pihizi-aria2：指定容器名称为pihizi-aria2
• -v /dev/log:/dev/log：挂载系统日志设备，实现容器内日志输出
• -v /YOUR/ARIA2/CONFIG/DIR:/etc/aria2：挂载本地配置目录到容器内aria2配置目录，需将/YOUR/ARIA2/CONFIG/DIR替换为实际本地目录
• -v /YOUR/SHARED/DIR:/data/aria2/download：挂载本地共享目录到容器内下载目录，下载文件将保存在此目录，需将/YOUR/SHARED/DIR替换为实际本地目录
• -p 6800:6800：映射容器6800端口到主机6800端口，用于aria2 RPC通信
• -d：以守护进程模式运行容器

交互式运行（调试用）

如需进入容器进行调试，可使用以下命令：

shell
docker run --name pihizi-aria2 \
    -t \
    -v /dev/log:/dev/log \
    -v /YOUR/SHARED/DIR:/data/aria2/download \
    -p 6800:6800 \
    -d pihizi/aria2 \
    /bin/bash

说明：添加-t参数分配伪终端，最后指定/bin/bash作为启动命令，可通过docker exec -it pihizi-aria2 /bin/bash进入容器交互

客户端支持

提供PHP客户端库，方便通过代码管理aria2下载任务：

• pihizi/aria2-php-client