dr3w0623/minecraftserver

dr3w0623/minecraftserver 镜像说明

镜像概述

本镜像基于itzg/minecraftserver进行少量配置优化，提供轻量、灵活的Minecraft服务器部署能力。支持自动下载最新稳定版、指定版本或快照，兼容Forge、Spigot、PaperSpigot等多种服务器类型，可通过环境变量快速配置服务器参数，适合个人或团队搭建游戏服务器。

核心功能

• 自动版本管理：启动时自动获取最新稳定版、指定版本（如1.20.1）或快照
• 多类型支持：Forge、Spigot、PaperSpigot、FTB/CurseForge modpack等
• 数据持久化：通过/data卷挂载保存世界存档、配置文件和Mod
• 灵活配置：环境变量设置游戏模式、难度、白名单、管理员列表等
• 交互能力：RCON控制台交互、容器附着操作
• 健康检查：内置mcstatus工具监控服务器状态

使用场景

• 个人快速搭建Minecraft联机服务器
• 部署带有Mod的游戏服务器（如Forge modpack）
• 测试不同版本的Minecraft功能
• 多人联机游戏的容器化管理

配置说明

基础部署

需接受Mojang EULA（EULA=TRUE），指定端口映射：

bash
docker run -d -e EULA=TRUE -p 25565:25565 --name mc dr3w0623/minecraftserver

版本设置

通过VERSION变量指定版本：

• 最新稳定版：VERSION=LATEST（默认）
• 快照版：VERSION=SNAPSHOT
• 具体版本：VERSION=1.20.1

示例：

bash
docker run -d -e EULA=TRUE -e VERSION=1.20.1 -p 25565:25565 --name mc dr3w0623/minecraftserver

服务器类型

通过TYPE变量切换类型：

• Forge：TYPE=FORGE
• Spigot：TYPE=SPIGOT
• PaperSpigot：TYPE=PAPER

Forge服务器示例：

bash
docker run -d -e EULA=TRUE -e TYPE=FORGE -e VERSION=1.19.2 -v /host/path:/data -p 25565:25565 --name mc dr3w0623/minecraftserver

数据持久化

挂载/data目录到主机，保存服务器数据：

bash
docker run -d -e EULA=TRUE -v /host/mc_data:/data -p 25565:25565 --name mc dr3w0623/minecraftserver

Docker Compose示例

yaml
version: '3'
services:
  minecraft:
    image: dr3w0623/minecraftserver
    ports:
      - "25565:25565"
    volumes:
      - mc_data:/data
    environment:
      EULA: "TRUE"
      VERSION: "LATEST"
      MOTD: "我的Minecraft服务器"
      OPS: "player1,player2"
      WHITELIST: "friend1,friend2"
    restart: always
volumes:
  mc_data:

常用环境变量

• MOTD：服务器标语
• OPS：管理员列表（逗号分隔）
• WHITELIST：白名单玩家（逗号分隔）
• MODE：游戏模式（survival/creative/adventure）
• DIFFICULTY：难度（peaceful/easy/normal/hard）

交互操作

RCON控制台

bash
docker exec -i mc rcon-cli

执行单条命令：

bash
docker exec mc rcon-cli stop

附着容器

启动时添加-it参数：

bash
docker run -d -it -e EULA=TRUE -p 25565:25565 --name mc dr3w0623/minecraftserver

附着容器：

bash
docker attach mc

（按Ctrl+P+Q detach）