用 Docker 部署 Minecraft 服务器：原版 / Paper / Spigot / Forge / Fabric / BungeeCord 全面实战

一、整体思路：用 Docker 管理所有 Minecraft 服务端#

传统部署 Minecraft 服务端通常是：

• 直接在系统里装 JDK；
• 下载 server.jar（原版或 Paper 等）；
• 自己写脚本启动。

问题是：

• 环境难以迁移：换一台机器要重配一遍 Java/脚本；
• 多服管理麻烦：开多个不同版本 / 不同核心容易乱；
• 升级/回滚不方便。

Docker 化之后的好处：

• Java 环境、启动脚本都在镜像里，宿主机只要有 Docker 就能跑；
• 数据分离在挂载卷中，迁移就是复制一份目录；
• docker-compose 一键启动/停止多个服（生存 / 创造 / 练级 / Mod 服 / Bungee 网关）。

本文会围绕一个非常好用的镜像：

• itzg/minecraft-server：支持 Vanilla / Paper / Spigot / Forge / Fabric / Quilt / Sponge 等 多种类型；
• itzg/bungeecord：可用来搭建 BungeeCord / Waterfall 等代理。

二、准备工作：硬件 / 端口 / 目录 / Java 认知#

1
mkdir -p ~/docker-data/minecraft
2
cd ~/docker-data/minecraft

三、基础镜像与最小原版服示例#

首先拉取通用服务端镜像：

1
docker pull itzg/minecraft-server:latest

生产环境建议固定版本，如：itzg/minecraft-server:java17 或指定日期/版本标签。

1
mkdir -p ~/docker-data/minecraft/vanilla

1
docker run -d \
2
  --name mc-vanilla \
3
  -e EULA=TRUE \
4
  -e VERSION=1.20.4 \
5
  -e MEMORY=4G \
6
  -p 25565:25565 \
7
  -v ~/docker-data/minecraft/vanilla:/data \
8
  itzg/minecraft-server:latest

1
docker logs -f mc-vanilla

四、用 docker-compose 管理原版核心#

推荐用 docker-compose 管理所有 MC 服。

在 ~/docker-data/minecraft 下新建 docker-compose.yml（先从一个原版服开始）：

1
version: "3.9"
2

3
services:
4
  mc-vanilla:
5
    image: itzg/minecraft-server:latest
6
    container_name: mc-vanilla
7
    restart: unless-stopped
8
    ports:
9
      - "25565:25565"
10
    environment:
11
      EULA: "TRUE"
12
      VERSION: "1.20.4"
13
      MEMORY: "4G"
14
      # 设置简单白名单/在线模式等也可以用 env：
15
      # ONLINE_MODE: "TRUE"
16
      # ENABLE_WHITELIST: "TRUE"
17
    volumes:
18
      - ./vanilla:/data

同目录执行：

1
docker compose up -d
2
docker compose logs -f mc-vanilla

停服：

1
docker compose down

注意：down 不会删卷，只要不加 -v，世界存档和配置都在 ./vanilla 中安全存放。

五、Paper 服务器（推荐生产用）：高性能原版体验#

Paper 是基于 Spigot 的高性能分支，特点：

• 更高 TPS，更好性能优化；
• 更丰富的配置项；
• 插件生态兼容 Spigot/Bukkit；
• 适合绝大多数 “生存 + 插件” 服。

itzg/minecraft-server 中，只需要把 TYPE 改为 PAPER 即可。

在 docker-compose.yml 中新增一个服务：

1
  mc-paper:
2
    image: itzg/minecraft-server:latest
3
    container_name: mc-paper
4
    restart: unless-stopped
5
    ports:
6
      - "25566:25565"  # 宿主 25566 -> 容器 25565
7
    environment:
8
      EULA: "TRUE"
9
      TYPE: "PAPER"
10
      VERSION: "1.20.4"
11
      MEMORY: "6G"
12
      # 开启白名单（可选）
13
      # ENABLE_WHITELIST: "TRUE"
14
      # 设置服务器图标/描述等也可通过挂载文件解决
15
    volumes:
16
      - ./paper:/data

说明：

• 宿主机端口 25566 对应容器 25565，这样不会和原版服冲突；
• 你可以同时开原版和 Paper，分别用 25565 和 25566。

启动：

1
docker compose up -d mc-paper
2
docker compose logs -f mc-paper

Paper 标签页中你可以找到更多配置文件：

• paper.yml
• spigot.yml
• bukkit.yml

都位于 ./paper 目录里，可以按需要优化。

六、Spigot 服务器：插件服的经典选择#

Spigot 是 Bukkit 的一个高性能分支，很多插件仍然把它当作最基础的服务端。

依然可以通过 TYPE=SPIGOT 方式部署：

1
  mc-spigot:
2
    image: itzg/minecraft-server:latest
3
    container_name: mc-spigot
4
    restart: unless-stopped
5
    ports:
6
      - "25567:25565"
7
    environment:
8
      EULA: "TRUE"
9
      TYPE: "SPIGOT"
10
      VERSION: "1.20.4"
11
      MEMORY: "4G"
12
    volumes:
13
      - ./spigot:/data

Spigot 和 Paper 的主要区别在于：

• Paper 补充了更多优化和配置项；
• Spigot 更趋近于 “官方改的稳定性能版”。

现在主流更推荐 Paper 作为性能服首选，Spigot 可以作为兼容性备选。

七、Forge 模组服：大型模组生存#

Forge 是老牌模组框架，很多经典整合包都基于 Forge。

itzg/minecraft-server 支持 TYPE=FORGE：

1
  mc-forge:
2
    image: itzg/minecraft-server:latest
3
    container_name: mc-forge
4
    restart: unless-stopped
5
    ports:
6
      - "25568:25565"
7
    environment:
8
      EULA: "TRUE"
9
      TYPE: "FORGE"
10
      VERSION: "1.16.5"   # 例如多数整合包使用的经典版本
11
      MEMORY: "8G"        # 模组多时适当给大一点
12
      # FORGE_VERSION: "" # 如需特定 Forge 构建可加
13
    volumes:
14
      - ./forge:/data

启动后：

• Forge 会在 /data/mods、/data/config 等目录中生成文件；
• 你可以把 .jar 模组放到宿主机的 ./forge/mods 中；
• 对应配置文件放 ./forge/config。

提醒：Forge 模组服对内存和 CPU 要求会明显高于纯原版，越多模组越夸张。

八、Fabric 模组服：轻量级新秀#

Fabric 是另一种模组 API，相对 Forge 更轻量、更新速度更快。

同样通过 TYPE=FABRIC 部署：

1
  mc-fabric:
2
    image: itzg/minecraft-server:latest
3
    container_name: mc-fabric
4
    restart: unless-stopped
5
    ports:
6
      - "25569:25565"
7
    environment:
8
      EULA: "TRUE"
9
      TYPE: "FABRIC"
10
      VERSION: "1.20.4"
11
      MEMORY: "6G"
12
      # FABRIC_LOADER_VERSION: ""  # 如需特定 Loader 可指定
13
    volumes:
14
      - ./fabric:/data

Fabric 模组服的要点：

• 模组同样放在 /data/mods；
• 很多 Fabric 模组和 Forge 不兼容，整合包时要注意区分；
• 有不少性能优化类 Fabric 模组（如 Lithium、Phosphor 等），适合做 “轻量高性能模组服”。

九、BungeeCord / Waterfall：多服代理与跨服传送#

当你想要：

• 一个统一入口 IP / 端口；
• 后面挂多个子服（大厅服、生存服、创造服、小游戏服……）；

这时就需要一个代理层：BungeeCord / Waterfall / Velocity 等。

这里以 itzg/bungeecord 为例搭建一个 BungeeCord 节点。

1
networks:
2
  minecraft-net:
3
    driver: bridge

1
  bungeecord:
2
    image: itzg/bungeecord:latest
3
    container_name: mc-bungee
4
    restart: unless-stopped
5
    ports:
6
      - "25565:25577"  # 默认 Bungee 监听 25577，我们映射到宿主 25565
7
    environment:
8
      # 按需设置最大内存等
9
      JAVA_OPTS: "-Xmx1G"
10
    volumes:
11
      - ./bungee:/server
12
    networks:
13
      - minecraft-net

1
  mc-paper-backend:
2
    image: itzg/minecraft-server:latest
3
    container_name: mc-paper-backend
4
    restart: unless-stopped
5
    environment:
6
      EULA: "TRUE"
7
      TYPE: "PAPER"
8
      VERSION: "1.20.4"
9
      MEMORY: "6G"
10
      ONLINE_MODE: "FALSE"   # 重要：后端服关闭正版验证，由 Bungee 统一处理
11
      ENABLE_RCON: "FALSE"
12
    volumes:
13
      - ./paper-backend:/data
14
    networks:
15
      - minecraft-net

十、常用环境变量与配置技巧#

itzg/minecraft-server 支持的大量环境变量，这里列几个最常用的：

• 基础：
  • EULA：必须为 TRUE；
  • VERSION：MC 版本；
  • TYPE：VANILLA / PAPER / SPIGOT / FORGE / FABRIC 等；
  • MEMORY：分配给 JVM 的内存，如 4G；
• 玩家与验证：
  • ONLINE_MODE：TRUE / FALSE，是否启用正版验证（Bungee 后端需关掉）；
  • ENABLE_WHITELIST：TRUE 时启用白名单；
  • WHITELIST：逗号分隔玩家名列表；
  • OPS：逗号分隔 OP 玩家，例如 OPS: "PlayerA,PlayerB"；
• RCON / 控制：
  • ENABLE_RCON：是否启用远程控制；
  • RCON_PASSWORD：RCON 密码；
  • RCON_PORT：RCON 端口；
• 世界与游戏规则（部分选项也可以通过 server.properties 或命令控制）：
  • DIFFICULTY：peaceful / easy / normal / hard；
  • ALLOW_NETHER、ENABLE_COMMAND_BLOCK、SPAWN_ANIMALS 等；
• 高级 JVM 配置：
  • JVM_OPTS / JVM_XX_OPTS：加 GC、压缩指针等参数；
  • 如：JVM_OPTS: "-XX:+UseG1GC -XX:+UnlockExperimentalVMOptions -XX:MaxGCPauseMillis=200"。

此外：

• 如果你更习惯直接编辑 server.properties，完全可以在第一次启动后：
  • 停服；
  • 修改 ./xxx/server.properties；
  • 再起服。

Docker 只是帮你封装了运行环境，并不限制你手动改配置。

十一、备份、迁移与升级#

1
cd ~/docker-data/minecraft
2
tar czf mc-vanilla-backup-$(date +%Y%m%d).tar.gz ./vanilla
3
tar czf mc-paper-backup-$(date +%Y%m%d).tar.gz ./paper

十二、常见问题与排查思路#

1
docker logs mc-xxx

十三、从零搭满：Minecraft + Docker 部署清单#

最后总结一份完整 checklist，作为今后开服时的速查表：

1. 选定机器（云服务器 / 家宽主机），安装 Docker；
2. 规划好端口（25565 主入口 + 若干子服端口）；
3. 在宿主创建 ~/docker-data/minecraft，并规划好子目录结构；
4. 拉取 itzg/minecraft-server 和 itzg/bungeecord 镜像；
5. 写一个 docker-compose.yml：
   • 原版服（TYPE=VANILLA）；
   • Paper / Spigot 插件服；
   • Forge / Fabric 模组服；
   • 如需多服入口，增加 BungeeCord 服务和后台子服；
6. 配置必要的环境变量：EULA、VERSION、TYPE、MEMORY、ONLINE_MODE、白名单/OPS 等；
7. docker compose up -d 启动，查看日志确保无报错；
8. 去各服的数据目录下微调 server.properties、paper.yml、模组配置等；
9. 对外公布 IP/端口，测试多端（PC/移动）连接；
10. 配置定期备份与监控，升级前一定先备份，必要时用 Bungee 拆分压力。

做到这里，你就拥有了一套高度可控、易迁移、易扩展的 Minecraft Docker 服主架构：
无论是一个安静的小伙伴生存服，还是多服联机的大型社区，都可以在这套基础上按需堆砌与优化，而不必每次都从手动装 Java 和 server.jar 开始折腾。