didstopia/minecraft-server

Minecraft Server Docker镜像

镜像概述和主要用途

该Docker镜像提供了一个在容器中运行的Minecraft服务器，启动时会自动下载并更新到最新服务器版本，默认自动同意Minecraft Server EULA。适用于快速部署、自动维护的Minecraft服务器环境，支持标准服务器和模组服务器（如Forge）配置。

核心功能和特性

• 自动更新：启动时自动检测并更新到最新Minecraft服务器版本
• 内存管理：可通过环境变量灵活配置最小和最大内存使用量
• EULA处理：默认自动同意Minecraft Server EULA，简化部署流程
• RCON支持：内置RCON功能，可配置远程服务器管理
• 自定义JAR：支持指定自定义JAR文件，适用于模组服务器部署
• 数据持久化：通过挂载卷实现服务器数据（配置、世界等）持久化存储

使用场景和适用范围

适合个人玩家、小型游戏社区或开发测试环境，需要快速部署且低维护成本的Minecraft服务器。支持从标准 vanilla 服务器到自定义模组服务器的多种部署需求，尤其适合需要自动更新功能的场景。

使用方法和配置说明

基本运行步骤

1. 配置环境变量（如内存设置、RCON参数等）
2. 将容器内/app目录挂载到主机，确保数据持久化
3. 首次启动服务器以生成配置文件，停止后修改/app/server.properties，再次启动完成配置

环境变量配置

以下环境变量用于自定义服务器行为：

text
MINECRAFT_SERVER_MEMORY_MIN    (默认值: "1G"    - 设置服务器最小内存使用量)
MINECRAFT_SERVER_MEMORY_MAX    (默认值: "1G"    - 设置服务器最大内存使用量)
MINECRAFT_SERVER_AGREE_EULA    (默认值: "true"  - 自动同意Minecraft EULA协议)
MINECRAFT_SERVER_ARGUMENTS     (默认值: "nogui" - 服务器启动参数，默认无图形界面)
MINECRAFT_SERVER_CUSTOM_JAR    (默认值: <none>  - 指定自定义JAR文件路径，用于模组服务器)
MINECRAFT_SERVER_RCON_ENABLE   (默认值: "false" - 是否启用RCON远程控制)
MINECRAFT_SERVER_RCON_PORT     (默认值: "25575" - RCON服务端口)
MINECRAFT_SERVER_RCON_PASSWORD (默认值: ""      - RCON连接密码)

Docker部署示例

docker run 命令示例

bash
docker run -d \
  -p 25565:25565 \  # Minecraft游戏端口
  -p 25575:25575 \  # RCON控制端口（如需远程管理）
  -v /path/on/host/minecraft:/app \  # 挂载主机目录以持久化数据
  -e MINECRAFT_SERVER_MEMORY_MIN="2G" \
  -e MINECRAFT_SERVER_MEMORY_MAX="4G" \
  -e MINECRAFT_SERVER_RCON_ENABLE="true" \
  -e MINECRAFT_SERVER_RCON_PASSWORD="SecureRCONPassword123" \
  --name minecraft-server \
  [镜像名称]  # 替换为实际Docker镜像名称

远程连接服务器（RCON）

Minecraft支持RCON协议实现远程服务器管理，启用步骤如下：

1. 确保RCON端口（默认25575）已通过-p参数暴露到主机
2. 设置环境变量MINECRAFT_SERVER_RCON_ENABLE="true"
3. 设置安全的RCON密码：MINECRAFT_SERVER_RCON_PASSWORD="your_secure_password"

注意：首次启动服务器时，需重启一次才能使RCON生效。因为server.properties文件在首次启动后生成，RCON配置需在此文件创建后才能应用。

配置完成后，可使用任何兼容RCON的客户端（如mcrcon）连接服务器进行远程管理。

如需帮助、问题反馈或bug提交，可通过***联系 @Dids 或在GitHub上提交issue。