zhoutaomtv/amule

aMule Docker镜像文档

镜像概述

本镜像基于https://hub.docker.com/r/tchabaud/amule/%E6%94%B9%E9%80%A0%EF%BC%8C%E9%80%9A%E8%BF%87%E4%BC%98%E5%8C%96%E6%98%BE%E8%91%97%E5%87%8F%E5%B0%8F%E4%BA%86%E9%95%9C%E5%83%8F%E4%BD%93%E7%A7%AF%E3%80%82aMule%E6%98%AF%E4%B8%80%E6%AC%BEeDonkey%E7%BD%91%E7%BB%9C%E5%AE%A2%E6%88%B7%E7%AB%AF%EF%BC%8C%E6%94%AF%E6%8C%81%E6%96%87%E4%BB%B6%E5%85%B1%E4%BA%AB%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E4%B8%AA%E4%BA%BA%E6%88%96%E5%B0%8F%E5%9E%8B%E7%BD%91%E7%BB%9C%E7%8E%AF%E5%A2%83%E7%9A%84%E6%96%87%E4%BB%B6%E5%85%B1%E4%BA%AB%E9%9C%80%E6%B1%82%E3%80%82

核心功能与特性

• 体积优化：相比原始镜像显著减小，降低存储和传输成本
• 多界面支持：同时支持GUI图形界面和WebUI网页界面
• 配置持久化：通过卷挂载实现配置文件、下载文件和临时文件的持久化存储
• 权限控制：支持通过环境变量设置运行用户ID(PUID)和组ID(PGID)，确保文件权限正确
• 网络端口映射：包含eDonkey网络所需的标准端口配置

使用场景

• 个人文件共享服务器搭建
• 局域网内文件分发与共享
• 轻量级eDonkey网络客户端部署
• 家庭媒体文件共享中心

使用方法

前置配置

首先创建必要的本地目录用于数据持久化：

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

从零开始部署

如果没有现有aMule配置，可以通过环境变量指定GUI或WebUI密码进行初始化部署。

使用GUI界面

sh
docker run -p 4712:4712 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[所需用户ID] -e PGID=[所需组ID] \
    -e GUI_PWD=[GUI界面密码] \
    -v ./amule/conf:/home/amule/.aMule -v ./amule/incoming:/incoming -v ./amule/tmp:/temp tchabaud/amule

使用WebUI界面

sh
docker run -p 4711:4711 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[所需用户ID] -e PGID=[所需组ID] \
    -e WEBUI_PWD=[Web界面密码] \
    -v ./amule/conf:/home/amule/.aMule -v ./amule/incoming:/incoming -v ./amule/tmp:/temp tchabaud/amule

使用现有配置

如果已有aMule配置文件，直接挂载现有配置目录即可：

sh
docker run -p 4711:4711 -p 4662:4662 -p 4672:4672/udp \
    -e PUID=[所需用户ID] -e PGID=[所需组ID] \
    -v ~/.aMule:/home/amule/.aMule -v ~/.aMule/Incoming:/incoming -v ~/.aMule/Temp:/temp tchabaud/amule

启动后，通过浏览器访问 http://localhost:4711 即可打开WebUI界面。

参数说明

环境变量

• PUID: 运行容器的用户ID，用于权限控制
• PGID: 运行容器的组ID，用于权限控制
• GUI_PWD: GUI界面访问密码（首次启动时设置）
• WEBUI_PWD: Web界面访问密码（首次启动时设置）

端口映射

• 4711: WebUI访问端口
• 4712: GUI界面访问端口
• 4662: eDonkey网络TCP端口
• 4672/udp: eDonkey网络UDP端口

卷挂载

• /home/amule/.aMule: aMule配置文件目录
• /incoming: 下载文件保存目录
• /temp: 临时文件目录