minecraft-vanilla

镜像概述

minecraft-vanilla是运行原版Minecraft（我的世界）服务器的Docker镜像，基于Temurin镜像构建，提供便捷的部署和管理方式，适用于快速搭建原版我的世界服务器环境。

核心功能与特性

• 基于Temurin运行环境：使用Temurin（原AdoptOpenJDK）作为基础镜像，确保Java运行环境的稳定性和兼容性
• 数据持久化：通过数据卷保存服务器数据（世界存档、配置等），支持数据持久化
• 灵活配置：通过环境变量自定义服务器参数（难度、游戏模式、最大玩家数等），无需手动修改配置文件
• 端口映射：提供服务器端口（25565）和RCON管理端口（25575）映射，支持玩家连接和远程管理
• 配置覆盖：支持通过覆盖目录自定义配置文件，满足个性化需求
• 继承环境变量：继承webhippie/temurin和webhippie/alpine基础镜像的环境变量，扩展配置能力

使用场景

• 个人用户搭建私有我的世界服务器，与朋友联机游戏
• 小型团队或社区部署原版Minecraft服务器，开展多人游戏活动
• 开发测试环境，用于测试不同配置下的服务器性能或功能

使用方法

版本选择

可用版本可通过以下平台查看：

• [Docker Hub][dockerhub]
• [Quay][quayio]
• [GitHub仓库][github]中的现有文件夹

数据卷

需映射以下数据卷以实现数据持久化：

• /var/lib/minecraft：存储服务器数据（世界存档、日志等）
• /etc/minecraft/override：用于覆盖服务器配置文件

端口

需映射以下端口：

• 25565：Minecraft服务器默认端口，用于玩家连接
• 25575：RCON管理端口，用于远程管理服务器

环境变量配置

通过环境变量可自定义服务器参数，常用环境变量示例：

• MINECRAFT_MAX_PLAYERS：最大玩家数量，默认20
• MINECRAFT_MOTD：服务器描述信息（MOTD），默认"Minecraft"
• MINECRAFT_RCON_PASSWORD：RCON管理密码，默认"webhippie"
• MINECRAFT_DIFFICULTY：游戏难度（0:和平,1:简单,2:普通,3:困难），默认1
• MINECRAFT_GAMEMODE：游戏模式（0:生存,1:创造,2:冒险,3:旁观），默认0

部署示例

使用docker run快速启动

bash
docker run -d \
  --name minecraft-vanilla \
  -p 25565:25565 \
  -p 25575:25575 \
  -v /本地路径/minecraft/data:/var/lib/minecraft \
  -v /本地路径/minecraft/override:/etc/minecraft/override \
  -e MINECRAFT_MAX_PLAYERS=10 \
  -e MINECRAFT_MOTD="我的原版Minecraft服务器" \
  -e MINECRAFT_RCON_PASSWORD="安全密码" \
  -e MINECRAFT_DIFFICULTY=2 \
  -e MINECRAFT_GAMEMODE=1 \
  webhippie/minecraft-vanilla

环境变量说明

服务器核心配置

网络与连接配置

RCON管理配置

Java与性能配置

完整环境变量列表

console
MINECRAFT_ADDITIONAL_PROPERTIES =          # 额外的服务器属性
MINECRAFT_ALLOW_FLIGHT = false             # 是否允许飞行
MINECRAFT_ALLOW_NETHER = true              # 是否允许下界
MINECRAFT_ANNOUNCE_PLAYER_ACHIEVMENTS = true  # 是否公告玩家成就
MINECRAFT_DATA_DIR = /var/lib/minecraft    # 数据目录路径
MINECRAFT_DIFFICULTY = 1                   # 难度(0:和平,1:简单,2:普通,3:困难)
MINECRAFT_ENABLE_COMMAND_BLOCK = false     # 是否启用命令方块
MINECRAFT_ENABLE_QUERY = false             # 是否启用查询功能
MINECRAFT_ENABLE_RCON = true               # 是否启用RCON
MINECRAFT_FORCE_GAMEMODE = false           # 是否强制游戏模式
MINECRAFT_GAME_DIR = /usr/share/minecraft  # 游戏目录路径
MINECRAFT_GAMEMODE = 0                     # 游戏模式(0:生存,1:创造,2:冒险,3:旁观)
MINECRAFT_GENERATE_STRUCTURES = true       # 是否生成结构(如村庄、地牢)
MINECRAFT_GENERATOR_SETTINGS =             # 生成器设置
MINECRAFT_HARDCORE = false                 # 是否开启极限模式
MINECRAFT_JAVA_OPTS = --server -XX:+UseConcMarkSweepGC  # Java运行参数
MINECRAFT_LEVEL_NAME = world               # 世界名称
MINECRAFT_LEVEL_SEED =                     # 世界种子
MINECRAFT_LEVEL_TYPE = DEFAULT             # 世界类型(DEFAULT, FLAT, LARGEBIOMES, AMPLIFIED, CUSTOMIZED)
MINECRAFT_LOGS_DIR = ${MINECRAFT_DATA_DIR}/logs  # 日志目录路径
MINECRAFT_MAX_BUILD_HEIGHT = 256           # 最大建筑高度
MINECRAFT_MAX_PLAYERS = 20                 # 最大玩家数量
MINECRAFT_MAX_TICK_TIME = 60000            # 最大tick时间(毫秒)
MINECRAFT_MAX_WORLD_SIZE = 29999984        # 最大世界大小
MINECRAFT_MAXHEAP = 2048M                  # Java最大堆内存
MINECRAFT_MINHEAP = 512M                   # Java最小堆内存
MINECRAFT_MOTD = Minecraft                 # 服务器描述信息(MOTD)
MINECRAFT_NETWORK_COMPRESSION_THRESHOLD = 256  # 网络压缩阈值
MINECRAFT_ONLINE_MODE = true               # 是否启用在线模式(验证正版)
MINECRAFT_OP_PERMISSION_LEVEL = 4          # OP权限等级(1-4)
MINECRAFT_OPTS = nogui                     # 服务器启动参数
MINECRAFT_OVERRIDE_DIR = /etc/minecraft/override  # 配置覆盖目录
MINECRAFT_PLAYER_IDLE_TIMEOUT = 0          # 玩家闲置超时时间(分钟,0为禁用)
MINECRAFT_PVP = false                      # 是否启用PVP
MINECRAFT_RCON_PASSWORD = webhippie        # RCON密码
MINECRAFT_RCON_PORT = 25575                # RCON端口
MINECRAFT_RESOURCE_PACK =                  # 资源包URL
MINECRAFT_RESOURCE_PACK_HASH =             # 资源包哈希值
MINECRAFT_SERVER_IP = 0.0.0.0              # 服务器绑定IP
MINECRAFT_SERVER_PORT = 25565              # 服务器端口
MINECRAFT_SNOOPER_ENABLED = true           # 是否启用数据收集
MINECRAFT_SPAWN_ANIMALS = true             # 是否生成动物
MINECRAFT_SPAWN_MONSTERS = true            # 是否生成怪物
MINECRAFT_SPAWN_NPCS = true                # 是否生成NPC(村民)
MINECRAFT_USE_NATIVE_TRANSPORT = true      # 是否使用原生传输
MINECRAFT_VIEW_DISTANCE = 10               # 视野距离(区块)
MINECRAFT_WHITE_LIST = false               # 是否启用白名单
MINECRAFT_WORLD_DIR = ${MINECRAFT_DATA_DIR}/world  # 世界目录路径

继承的环境变量

该镜像继承以下基础镜像的环境变量：

• webhippie/temurin
• webhippie/alpine

贡献

Fork -> 提交补丁 -> 推送 -> 拉取请求

作者

• Thomas Boerger

许可证

MIT

版权信息

console
Copyright (c) 2015 Thomas Boerger <[***]>

注：原文链接可能存在笔误，以下链接应为minecraft-vanilla相关： [upstream]: [] [parent]: [] [dockerhub]: [] [quayio]: [] [github]: [***]