ngc7331/mcsmanager-web

MCSManager Docker镜像（非官方）

镜像概述和主要用途

本镜像为非官方的MCSManager Docker封装，内置OpenJDK运行环境，旨在简化MCSManager的部署流程。MCSManager是一款功能强大的Minecraft服务器管理工具，支持多服务器管理、实时监控、配置修改、玩家管理等功能。通过本镜像，用户无需手动配置Java环境，可快速在Docker容器中部署MCSManager，实现对Minecraft服务器的便捷管理。

核心功能和特性

• 内置OpenJDK：无需额外安装Java环境，简化部署步骤
• 完整MCSManager功能：支持服务器创建、启动/停止、监控、日志查看、配置管理等核心功能
• 容器化部署：提供环境隔离，避免与主机环境冲突，便于迁移和升级
• 数据持久化：支持挂载宿主机目录，确保配置文件、服务器数据等持久化存储
• 轻量高效：基于官方基础镜像构建，体积小巧，资源占用低

使用场景和适用范围

• 个人玩家或小型团队快速搭建Minecraft服务器管理平台
• 需要在容器化环境（如Docker、Kubernetes）中运行MCSManager的场景
• 希望简化Java环境配置，减少部署复杂度的用户
• 需对MCSManager运行环境进行隔离和版本控制的场景

使用方法和配置说明

基本部署（docker run）

使用以下命令快速启动容器：

bash
docker run -d \
  --name mcsmanager \
  -p 23333:23333 \  # Web管理界面端口
  -p 24444:24444 \  # 服务器通信端口（根据需要调整）
  -v /path/to/mcsmanager/data:/opt/mcsmanager/data \  # 持久化数据目录
  ngc7331/docker-mcsmanager

说明：请将/path/to/mcsmanager/data替换为宿主机实际目录，用于保存MCSManager的配置、服务器数据等。

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mcsmanager:
    image: ngc7331/docker-mcsmanager
    container_name: mcsmanager
    ports:
      - "23333:23333"  # Web管理界面端口
      - "24444:24444"  # 服务器通信端口
    volumes:
      - ./mcsmanager-data:/opt/mcsmanager/data  # 相对路径持久化数据
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动容器：

bash
docker-compose up -d

持久化数据

为确保配置和服务器数据不丢失，需将容器内的MCSManager数据目录挂载到宿主机。默认数据目录为/opt/mcsmanager/data，建议始终挂载此目录。

访问管理界面

容器启动后，通过浏览器访问 http://宿主机IP:23333 即可打开MCSManager管理界面，首次使用需根据提示完成初始化配置（如设置管理员账号密码）。

环境变量（可选）

本镜像可能支持以下环境变量（具体请参考GitHub仓库文档）：

• MCSM_PORT：自定义Web管理界面端口（默认23333）
• MCSM_PASSWORD：设置管理员初始密码
• TZ：设置时区，如Asia/Shanghai

使用示例（修改端口）：

bash
docker run -d \
  --name mcsmanager \
  -e MCSM_PORT=8080 \
  -p 8080:8080 \
  -v /path/to/data:/opt/mcsmanager/data \
  ngc7331/docker-mcsmanager

注意事项

• 本镜像为非官方构建，使用前建议参考https://github.com/ngc7331/docker-mcsmanager%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E4%BF%A1%E6%81%AF%E5%92%8C%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97
• 确保宿主机已安装Docker环境，且端口未被占用
• 持久化数据目录权限需正确配置，避免容器内无法读写数据