3分钟上手Docker版我的世界服务器：从纯净服到模组服的全平台部署指南

你是否曾因复杂的服务器配置望而却步？是否想在同一台设备上轻松切换不同类型的Minecraft服务器？本文将带你通过Docker技术，在5分钟内完成从基础纯净服到复杂模组服的部署，无需担心环境冲突与版本兼容问题。

为什么选择Docker化部署？

传统Minecraft服务器部署往往面临版本冲突、配置繁琐、迁移困难等问题。而通过docker-minecraft-server项目，你可以获得：

• 环境隔离：不同版本/类型服务器独立运行，互不干扰
• 一键部署：通过简单配置即可启动各种类型服务器
• 跨平台支持：在Linux、Windows、MacOS甚至树莓派上均可运行
• 版本管理：自动下载指定版本，轻松切换Minecraft版本


快速开始：3步搭建基础服务器

1. 准备Docker环境

确保已安装Docker和Docker Compose，然后克隆项目仓库：

git clone https://gitcode.com/GitHub_Trending/do/docker-minecraft-server.git
cd docker-minecraft-server

2. 选择服务器类型

项目提供多种服务器类型配置示例，位于examples/目录：

服务器类型	配置文件路径	适用场景
纯净版	examples/docker-compose-simple.yml	原版游戏体验
插件服	examples/paper/compose.yml	Bukkit/Spigot/Paper插件
模组服	examples/forge/compose.yml	Forge/Fabric模组
模组包	examples/auto-curseforge/atm9/docker-compose.yml	整合包服务器

3. 启动服务器

以基础纯净版为例，执行以下命令：

docker-compose -f examples/docker-compose-simple.yml up -d

服务器启动后，通过docker logs -f minecraft-server查看日志，首次启动会自动下载Minecraft服务端文件。

服务器类型全解析

纯净版服务器 (Vanilla)

纯净版服务器使用官方原版服务端，适合追求原汁原味游戏体验的玩家。基础配置文件为examples/docker-compose-simple.yml，核心配置项：

version: "3.8"
services:
  mc:
    image: itzg/minecraft-server
    environment:
      EULA: "TRUE"
      VERSION: "1.20.1"
      TYPE: "VANILLA"
    ports:
      - "25565:25565"
    volumes:
      - ./data:/data

插件服务器 (Paper/Spigot)

插件服务器支持Bukkit/Spigot/Paper生态的插件，提供丰富的服务器管理功能。推荐使用性能优化更好的Paper服务器：

environment:
  TYPE: "PAPER"
  PAPERBUILD: "latest"
  PLUGINS: "https://www.spigotmc.org/resources/essentialsx.9089/download?version=396881"

详细配置指南见docs/types-and-platforms/server-types/paper.md。

模组服务器 (Forge/Fabric)

模组服务器允许安装各种客户端和服务端模组，极大扩展游戏内容。以Forge为例：

environment:
  TYPE: "FORGE"
  VERSION: "1.20.1"
  FORGEVERSION: "47.2.0"

支持的模组平台包括：

• CurseForge
• Modrinth
• FTB

模组包自动部署

对于复杂的模组包，项目提供自动部署功能，以All the Mods 9为例：

environment:
  TYPE: "AUTO_CURSEFORGE"
  CF_SLUG: "all-the-mods-9"
  CF_FILE_ID: "4888341"

完整示例见examples/auto-curseforge/atm9/docker-compose.yml。

高级配置与优化

数据目录管理

服务器数据（世界、配置、模组等）默认存储在容器的/data目录，建议通过卷挂载到宿主机：

volumes:
  - ./minecraft-data:/data

数据备份、迁移和恢复指南见docs/world-data.md。

JVM参数优化

根据服务器硬件配置调整JVM参数，提高性能：

environment:
  JVM_OPTS: "-Xms2G -Xmx4G -XX:+UseG1GC"

更多JVM优化建议见docs/jvm-options.md。

自动启停与休眠

对于资源有限的设备，可配置自动休眠功能：

environment:
  AUTOSTOP_TIMEOUT_1: "300"
  AUTOSTOP_PERIOD_1: "60"

详细配置见docs/autostop.md。

多平台部署示例

树莓派部署

项目支持ARM架构设备，树莓派部署指南见docs/raspberrypi.md。

Kubernetes部署

对于企业级部署，可使用Kubernetes进行编排，示例配置见examples/k8s/。

多服务器网络

通过Velocity或Waterfall实现多服务器网络，示例配置见examples/multi-project/。

常见问题与解决方案

端口映射冲突

若25565端口被占用，可修改端口映射：

ports:
  - "25566:25565"

模组兼容性问题

确保所有模组与服务器版本兼容，推荐使用packwiz进行模组管理。

性能监控

通过Prometheus和Grafana监控服务器性能，配置示例见docs/deployment/index.md。

总结与进阶学习

通过本文，你已掌握使用Docker快速部署各种类型Minecraft服务器的方法。更多高级功能：

• 自动备份：docs/world-data.md
• RCon远程管理：docs/commands.md
• 自定义启动脚本：docs/examples.md

项目贡献指南见docs/contributing/，欢迎提交PR和issue。