ezjos/amule-web

aMule Docker镜像文档

镜像概述

本镜像为aMule（一款P2P文件共享客户端）提供容器化运行环境，仅支持x86_64架构。若需ARM架构支持，可参考https://github.com/synopsis8/dockerfiles%E3%80%82%E9%80%9A%E8%BF%87%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%EF%BC%8C%E5%8F%AF%E7%AE%80%E5%8C%96aMule%E7%9A%84%E5%AE%89%E8%A3%85%E4%B8%8E%E9%85%8D%E7%BD%AE%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%94%AF%E6%8C%81GUI%E5%92%8CWebUI%E4%B8%A4%E7%A7%8D%E7%AE%A1%E7%90%86%E6%96%B9%E5%BC%8F%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E7%81%B5%E6%B4%BB%E7%9A%84%E6%8C%81%E4%B9%85%E5%8C%96%E5%AD%98%E5%82%A8%E6%96%B9%E6%A1%88%E3%80%82

核心功能与特性

• 架构支持：仅适用于x86_64架构
• 多界面支持：同时支持GUI图形界面和WebUI网页界面
• 灵活配置：通过环境变量设置用户ID（PUID）、组ID（PGID）及界面访问密码
• 持久化存储：配置文件、临时文件和下载文件可通过卷挂载实现持久化
• 主题自定义：支持切换WebUI主题（如AmuleWebUI-Reloaded）

使用场景与适用范围

• 新用户部署：从零开始配置aMule，快速搭建P2P文件共享环境
• 现有用户迁移：将已有的aMule配置无缝迁移至容器环境
• 界面个性化：通过自定义WebUI主题优化管理体验

使用方法与配置说明

1. 准备工作：创建必要目录

首先创建用于存储配置文件、临时文件和下载文件的本地目录：

sh
mkdir -p ./amule/conf
mkdir -p ./amule/tmp
mkdir -p ./amule/incoming

2. 运行容器

2.1 从零开始配置

若暂无aMule配置，可通过环境变量指定GUI或WebUI的访问密码。

2.1.1 使用GUI界面

通过以下命令启动容器并启用GUI界面（需aMule GUI客户端连接）：

sh
docker run -p 4712:4712 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[wanted_uid] -e PGID=[wanted_gid] \
    -e GUI_PWD=[wanted_password_for_gui] \
    -v ./amule/conf:/home/amule/.aMule -v ./amule/incoming:/incoming -v ./amule/tmp:/temp docker.xuanyuan.run/tchabaud/amule

参数说明：

• -p 4712:4712：GUI界面通信端口映射
• -p 4662:4662：aMule TCP通信端口映射
• -p 4672:4672/udp：aMule UDP通信端口映射
• -e PUID=[wanted_uid]：运行容器的用户ID
• -e PGID=[wanted_gid]：运行容器的组ID
• -e GUI_PWD=[wanted_password_for_gui]：GUI界面访问密码
• 卷挂载：./amule/conf存储配置文件，./amule/incoming存储下载文件，./amule/tmp存储临时文件

2.1.2 使用WebUI界面

通过以下命令启动容器并启用WebUI界面（通过浏览器访问）：

sh
docker run -p 4711:4711 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[wanted_uid] -e PGID=[wanted_gid] \
    -e WEBUI_PWD=[wanted_password_for_web_interface] \
    -v ./amule/conf:/home/amule/.aMule -v ./amule/incoming:/incoming -v ./amule/tmp:/temp docker.xuanyuan.run/tchabaud/amule

访问方式：启动后通过浏览器访问 http://localhost:4711 进入WebUI界面。

2.2 使用现有配置

若已有aMule配置文件，可直接挂载现有配置目录运行容器：

sh
docker run -p 4711:4711 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[wanted_uid] -e PGID=[wanted_gid] \
    -v ~/.aMule:/home/amule/.aMule -v ~/.aMule/Incoming:/incoming -v ~/.aMule/Temp:/temp docker.xuanyuan.run/tchabaud/amule

说明：将本地现有aMule配置目录（通常为~/.aMule）挂载至容器内对应路径，实现配置迁移。

2.3 WebUI主题切换

若需自定义WebUI主题（如使用基于Bootstrap的AmuleWebUI-Reloaded），可通过WEBUI_TEMPLATE环境变量指定：

sh
docker run -p 4711:4711 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[wanted_uid] \
    -e PGID=[wanted_gid] \
    -e WEBUI_TEMPLATE=AmuleWebUI-Reloaded \
    -v ~/.aMule:/home/amule/.aMule \
    -v ~/.aMule/Incoming:/incoming \
    -v ~/.aMule/Temp:/temp tchabaud/amule