tekgator/docker-mcmyadmin

docker-mcmyadmin

https://github.com/tekgator/docker-mcmyadmin/actions/workflows/build-and-publish.yml https://hub.docker.com/r/tekgator/docker-mcmyadmin https://hub.docker.com/r/tekgator/docker-mcmyadmin/tags?page=1&ordering=last_updated https://github.com/tekgator/docker-mcmyadmin/blob/main/LICENSE https://github.com/tekgator/docker-mcmyadmin/releases

用于管理和运行所有Java版Minecraft服务器变体的McMyAdmin面板Docker镜像。

• 由https://github.com/tekgator%E7%BB%B4%E6%8A%A4
• 问题可在https://github.com/tekgator/docker-mcmyadmin/issues%E6%8F%90%E4%BA%A4

注意： 以下信息常被忽略，McMyAdmin登录的默认用户/密码为admin/pass123

支持作者

喜欢我的工作？请我喝杯咖啡 ☕（更可能是啤酒 🍺，或者给妻子买双鞋 👠 或包 👜 😄）

镜像概述

本Docker镜像旨在提供易于使用的最新版McMyAdmin面板，支持运行各种Java版Minecraft服务端。与Docker Hub上多数镜像不同，本镜像在停止容器时会保存游戏世界，确保数据安全。实际持久化数据（如世界文件、配置等）通过卷挂载，便于配置管理。此外，镜像会跟踪最新的McMyAdmin日志文件，方便通过Portainer或命令行查看日志。

核心功能与特性

• 基础环境：基于Debian 10 Buster slim版本，使用OpenJDK-17（满足部分Minecraft插件运行需求）
• 管理面板：集成McMyAdmin Minecraft Web管理面板，运行于tcp/8080端口
• 游戏服务端：默认Minecraft服务器端口为tcp/25565
• 数据持久化：通过卷挂载数据目录，支持McMyAdmin和Minecraft配置修改
• 优雅关闭：容器停止时，先保存游戏世界，再正常关闭服务器
• 工具集成：包含GIT，支持McMyAdmin构建Spigot服务端jar包
• 内存配置：Java内存默认2GB（推荐容器至少分配2GB RAM）
• 插件支持：如需运行Dynmap，可额外暴露tcp/8123端口

使用方法

基础运行命令

快速启动容器的基础命令：

bash
docker run -d \
  --name mcmyadmin \
  -p 8080:8080 \
  -p 25565:25565 \
  --stop-timeout 30 \
  --restart unless-stopped \
  tekgator/docker-mcmyadmin:latest

关键配置参数

本地存储映射与用户权限

通过主机现有用户映射本地存储（可通过id命令获取UID/GID）：

bash
-v /home/xxx/McMyAdmin:/data  # 本地数据目录挂载
-e PUID=xxx                   # 主机用户UID
-e PGID=xxx                   # 主机用户GID

自动接受Minecraft EULA

通过环境变量自动接受Minecraft服务端用户协议：

bash
-e EULA=1

容器自动启停

配置容器自动启动和重启：

bash
--restart unless-stopped

优雅关闭超时

给予容器足够时间优雅关闭Minecraft和McMyAdmin：

bash
--stop-timeout 30  # 30秒超时

插件端口暴露

如需为插件（如Dynmap）暴露额外端口：

bash
-p 8123:8123 \

推荐使用方式

1. 在主机创建专用用户（如minecraft）：useradd minecraft
2. 切换至该用户，创建数据目录：mkdir ~/mcmyadmin
3. 获取用户UID和GID：id minecraft（示例：UID 1000 / GID 100）
4. 使用管理员账户创建Docker容器

Docker Run示例

bash
docker run -d \
  --name mcmyadmin \
  -p 8080:8080 \
  -p 25565:25565 \
  -v /home/minecraft/mcmyadmin:/data \
  -e PUID=1000 \
  -e PGID=100 \
  -e EULA=1 \
  --restart unless-stopped  \
  --stop-timeout 30 \
  tekgator/docker-mcmyadmin:latest

Docker Compose示例

仓库中提供示例docker-compose文件：

yaml
  mcmyadmin:
    image: tekgator/docker-mcmyadmin:latest
    container_name: mcmyadmin
    environment:
      PUID: 1000       # 主机用户UID
      PGID: 100        # 主机用户GID
      EULA: 1          # 自动接受EULA
    volumes:
      - /home/minecraft/mcmyadmin:/data  # 数据目录挂载
    ports:
      - 8080:8080      # McMyAdmin面板端口
      - 25565:25565    # Minecraft游戏端口
    stop_grace_period: 30s  # 优雅关闭超时
    restart: unless-stopped  # 自动重启策略

配置完成后，可通过主机的minecraft用户访问数据目录：cd ~/mcmyadmin

祝您使用愉快！

后续步骤

1. 在浏览器中打开McMyAdmin面板（如：http://localhost:8080）
2. 使用默认账户登录：
   • 用户：admin
   • 密码：pass123
3. 立即修改密码！
4. 在设置中选择Minecraft服务端版本（如Vanilla、Spigot等），点击安装按钮（注意：Spigot构建可能需要较长时间）
5. 在服务器设置中配置Minecraft服务器参数
6. 在状态标签页点击“启动服务器”（服务端可能会自动停止/重启几次，请耐心等待）

推荐配置（可选）

1. 停止容器
2. 用编辑器打开本地存储中的McMyAdmin.conf文件
3. 搜索Java.Memory配置项
4. 根据需求修改内存大小（推荐至少2GB）
5. 启动容器

插件安装与配置修改

在挂载的卷中可找到以下关键文件/目录：

• McMyAdmin.conf：McMyAdmin面板配置文件（如Java内存设置等）
• Minecraft目录：包含Minecraft服务端配置（如server.properties）、日志等
• plugin目录：用于添加插件及修改插件配置

补充信息

• 容器运行时Shell访问：docker exec -it mcmyadmin /bin/bash
• 实时监控容器日志：docker logs -f mcmyadmin