vsbmeza/minecraft-fabric-server

Minecraft Fabric Server 基础镜像

镜像概述

源代码：https://github.com/meza/minecraft-fabric-server

注意：此镜像不作为独立镜像使用，且目前处于积极开发阶段。

该镜像为托管Fabric服务器提供基础运行环境，支持自定义配置、数据包管理和扩展脚本执行，适用于构建定制化Minecraft服务器镜像。

核心功能与特性

• 支持自定义Minecraft版本、服务器端口及RCON配置
• 提供结构化的配置文件管理机制
• 数据包自动覆盖与优先级管理
• 支持构建时参数定制与运行时环境变量配置
• 集成服务器备份与世界数据存储卷

运行时配置

卷挂载

/minecraft/setup-files

作为服务器配置文件的主目录，包含以下关键子组件：

• server 文件夹：存储服务器核心配置文件（如server.properties）。该文件夹内的配置文件会通过符号链接关联到服务器运行目录，其中server.properties会被自动复制并调整以下配置项：

  • server-port（服务器端口）
  • query.port（查询端口）
  • rcon.port（RCON端口）
  • rcon.password（RCON密码）

• datapacks 文件夹：存储服务器数据包。该文件夹内的所有内容会覆盖world/datapacks目录，优先加载自定义数据包。

• scripts/configure.sh 脚本：服务器配置完成后自动执行的自定义脚本，可用于添加额外配置逻辑。

TBD: configure.sh脚本的详细使用说明待补充

/minecraft/world

存储服务器世界数据，包含所有游戏存档文件。

/minecraft/backups

存储服务器自动或手动生成的备份文件。

/minecraft/setup-files/server/config

存储 mods 配置文件，用于自定义服务器模组行为。

构建参数

构建镜像时可通过--build-arg指定以下参数：

MINECRAFT_VERSION

指定 Minecraft 版本，示例：

bash
docker build --build-arg MINECRAFT_VERSION=1.18.2 .

RCON_PORT

指定 RCON 管理端口，示例：

bash
docker build --build-arg RCON_PORT=25575 .

RCON_PASSWORD

指定 RCON 访问密码，示例：

bash
docker build --build-arg RCON_PASSWORD=minecraft .

MINECRAFT_PORT

指定 Minecraft 服务器端口，示例：

bash
docker build --build-arg MINECRAFT_PORT=25565 .

QUERY_PORT

指定服务器查询端口，示例：

bash
docker build --build-arg QUERY_PORT=25565 .

环境变量

运行容器时可通过-e参数设置以下环境变量：

NAME

服务器名称，默认值：minecraft

XMS

服务器最小内存分配（Java 参数），用于设置 JVM 初始堆大小

XMX

服务器最大内存分配（Java 参数），用于设置 JVM 最大堆大小

XMN

新生代内存大小（Java 参数），用于设置 JVM 年轻代内存

MAX_THREADS

服务器最大线程数（Java 参数），控制并发处理能力

AUTO_UPDATE

是否自动更新 mods，设置为true时启用。需确保/minecraft/config/server目录下存在 https://github.com/meza/minecraft-mod-manager 所需的modlist.json文件。

使用场景

适用于需要构建定制化 Minecraft Fabric 服务器的开发者，可作为基础镜像集成自定义 mods、数据包和配置逻辑，快速搭建个性化游戏服务器环境。