bulzipke/minecraft

docker-minecraft

镜像概述和主要用途

bulzipke/minecraft 是一个用于部署 Minecraft Bedrock 版服务器的 Docker 镜像，基于 Ubuntu 系统构建。该镜像旨在简化 Minecraft Bedrock Server 的部署流程，通过自动化运行官方服务器二进制文件，帮助用户快速搭建可持久化的 Bedrock 版服务器环境，适用于个人、小型团队或社区快速部署独立的 Minecraft 多人游戏服务器。

核心功能和特性

• 自动化部署：内置官方 Minecraft Bedrock Server 二进制文件，启动容器即可自动运行服务器，无需手动配置启动流程。
• 数据持久化：支持通过卷挂载持久化服务器数据（如世界存档、配置文件等），避免容器重启导致数据丢失。
• 日志分离：独立日志目录设计，便于日志收集、分析和备份。
• 标准端口映射：默认支持 Minecraft Bedrock Server 标准网络端口配置，适配客户端连接需求。

使用场景和适用范围

• 个人服务器搭建：适用于个人用户在本地或云服务器上快速部署 Bedrock 版服务器，供自己或朋友联机游戏。
• 小型团队/社区服务器：支持多人同时连接，满足小型团队或游戏社区的基础联机需求。
• 测试环境：可用于快速测试不同服务器配置（如世界设置、权限管理等），验证配置效果。

详细使用方法和配置说明

基础部署（docker run 命令）

通过以下命令可快速启动容器，需提前准备数据存储目录和日志目录：

bash
$ docker run \
  -v /your_minecraft_path:/data \  # 挂载数据卷（存储世界存档、配置文件等）
  -v /your_log_path:/logs \        # 挂载日志卷（存储服务器运行日志）
  -p 19132:19132/udp \             # 映射 Bedrock 服务器默认 UDP 端口（客户端连接端口）
  -p 80:80/tcp \                   # 映射 TCP 80 端口（可根据实际需求调整，如用于管理界面等）
  -d \                             # 后台运行容器
  bulzipke/minecraft               # 镜像名称

参数说明：

• -v /your_minecraft_path:/data：本地目录 /your_minecraft_path 挂载至容器内 /data 目录，用于持久化存储服务器数据（如 server.properties 配置文件、世界存档 worlds 目录等）。首次启动时，容器会在 /data 下生成默认配置文件。
• -v /your_log_path:/logs：本地目录 /your_log_path 挂载至容器内 /logs 目录，用于存储服务器运行日志，便于问题排查。
• -p 19132:19132/udp：Minecraft Bedrock Server 默认使用 UDP *** 端口进行客户端通信，需映射该端口以允许外部客户端连接。
• -p 80:80/tcp：示例中映射 TCP 80 端口，具体用途需根据实际需求调整（如部署服务器管理界面等非默认服务），若无需可删除该端口映射。
• -d：以守护进程模式运行容器，避免终端退出导致服务停止。

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'
services:
  minecraft-bedrock:
    image: bulzipke/minecraft
    container_name: minecraft-bedrock-server
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）
    ports:
      - "19132:19132/udp"  # 必要端口，Bedrock 客户端连接
      # - "80:80/tcp"      # 可选端口，根据需求启用
    volumes:
      - /path/to/your/data:/data  # 替换为本地数据目录绝对路径
      - /path/to/your/logs:/logs  # 替换为本地日志目录绝对路径

启动服务：

bash
$ docker-compose up -d

服务器配置说明

1. 配置文件修改：服务器核心配置文件为 /data/server.properties，通过修改该文件可调整服务器名称、最大玩家数、游戏模式等参数。修改后需重启容器使配置生效。

2. 数据备份：建议定期备份 /data 目录下的文件，尤其是 worlds 目录（世界存档），避免数据丢失。

3. 日志查看：服务器运行日志存储在 /logs 目录下，可通过 docker logs minecraft-bedrock-server（需替换为容器名称）快速查看实时日志。

注意事项

• 基础系统：该镜像基于 Ubuntu 构建（原文档中提及的 "Alpine Linux" 可能为尚未实现的计划，实际以 Ubuntu 为准）。
• 端口冲突：若宿主机已占用 ***/udp 端口，需修改端口映射（如 -p 19133:19132/udp），并同步更新客户端连接端口。
• 资源需求：根据服务器玩家数量和世界大小，建议适当调整容器的 CPU/内存资源限制（通过 --cpus、-m 参数或 docker-compose 的 deploy.resources 配置）。

参考链接

• https://github.com/mjungnickel18/papyruscs
• https://github.com/pogznet/papyruscs