algonrey/airdcpp

AirDC++ Web Client Docker镜像

镜像概述

本镜像为AirDC++ Web客户端与服务器的Docker化部署方案，基于DC++协议实现P2P文件共享功能，提供Web界面用于管理文件下载、共享目录及网络连接设置，支持非特权用户运行和HTTPS加密访问，适用于个人或小团队的轻量级文件交换场景。

核心功能

• 支持P2P文件传输（TCP/UDP连接及TLS加密连接）
• 提供HTTP/HTTPS Web UI进行可视化管理
• 可映射本地下载、共享目录到容器
• 支持非特权用户运行，保障文件权限安全
• 允许添加/修改管理员用户
• 内置自签名证书，支持生成自定义HTTPS证书

使用场景

• 个人用户搭建本地P2P文件共享服务
• 小团队内部快速交换文件资源
• 需要P2P传输能力的轻量级文件分发场景

配置说明

基础运行

1. 创建命名卷存储应用设置：

bash
docker volume create --name airdcpp

2. 启动容器：

bash
docker run -d --name airdcpp \
    -p 80:5600 -p 443:5601 -p 21248:21248 -p 21248:21248/udp -p 21249:21249 \
    -v airdcpp:/.airdcpp \
    -v $HOME/Downloads:/Downloads \
    -v $HOME/Share:/Share \
    algonrey/airdcpp

Web UI访问地址：http://localhost，默认管理员账号：admin/password。

非特权用户运行

bash
docker run -d --name airdcpp \
    -p 80:5600 -p 443:5601 -p 21248:21248 -p 21248:21248/udp -p 21249:21249 \
    -v airdcpp:/.airdcpp \
    -v $HOME/Downloads:/Downloads \
    -v $HOME/Share:/Share \
    -u $(id -u):$(id -g) \
    algonrey/airdcpp

若已用root运行过，修复卷权限：

bash
docker run --rm \
    -v airdcpp:/.airdcpp \
    ubuntu:16.04 \
    chown -R $(id -u):$(id -g) /.airdcpp

Docker Compose部署

使用docker-compose.yml启动服务：

bash
docker-compose up -d

支持的环境变量：

• UID：运行用户ID（默认0）
• GID：运行组ID（默认0）
• HTTP_PORT：HTTP端口（默认5600）
• HTTPS_PORT：HTTPS端口（默认5601）
• TCP_PORT：TCP连接端口（默认21248）
• UDP_PORT：UDP连接端口（默认21248）
• TLS_PORT：TLS加密端口（默认21249）

卷说明

• /.airdcpp：存储应用配置文件
• /Downloads：默认下载目录
• /Share：默认共享目录

暴露端口

• 5600：HTTP端口
• 5601：HTTPS端口
• 21248：TCP/UDP连接端口（需保持内外端口一致）
• 21249：TLS加密连接端口（需保持内外端口一致）

管理管理员用户

bash
docker stop airdcpp
docker run --rm -it --volumes-from airdcpp \
    algonrey/airdcpp --add-user
docker start airdcpp

升级镜像

bash
docker pull algonrey/airdcpp
docker stop airdcpp
docker rm airdcpp
# 重新执行原启动命令

自定义HTTPS证书

生成自定义证书：

bash
docker exec -it airdcpp openssl req \
    -subj "/C=CN/ST=省份/L=城市/O=组织/CN=localhost" \
    -x509 -nodes -days 365 -newkey rsa:2048 \
    -keyout /.airdcpp/Certificates/client.key \
    -out /.airdcpp/Certificates/client.crt

替换CN为服务的域名或IP地址。