pjnetnz/bedrock-server

Minecraft Bedrock Server Docker镜像文档

镜像概述和主要用途

Minecraft Bedrock Server Docker镜像是一个预配置的容器化解决方案，用于快速部署Minecraft Bedrock版服务器。该镜像集成Bedrock服务器核心，支持Windows 10/11、Xbox、PlayStation、Switch、移动设备等跨平台客户端连接，省去传统部署中的依赖配置与环境兼容问题，用户通过Docker命令即可一键启动功能完整的多人游戏服务器。

核心功能和特性

• 跨平台兼容：支持所有Bedrock版客户端，实现多设备玩家无缝联机
• 快速部署：预打包服务器核心，30秒内完成启动，无需手动配置系统依赖
• 数据持久化：通过卷挂载保存server.properties、游戏世界、日志等关键数据，容器重建不丢失
• 灵活配置：支持通过环境变量或配置文件自定义游戏模式、难度、最大玩家数等核心参数
• 版本可控：可通过镜像标签或环境变量指定服务器版本，满足不同版本兼容性需求
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低，适配个人电脑、NAS及云服务器

使用场景和适用范围

适用场景

• 个人玩家搭建私人服务器与朋友跨平台联机
• 小型游戏社区快速部署临时活动服务器（支持10-50人规模）
• 教育机构部署Minecraft教育版教学环境
• 开发者测试Bedrock服务器插件或资源包兼容性

不适用场景

• 大规模商业游戏社区（需额外扩展组件支持高并发）
• 对实时性要求极高的竞技类服务器（需额外性能优化）

详细使用方法和配置说明

基础部署（docker run命令）

通过以下命令启动默认配置的服务器：

docker
docker run -d \
  --name minecraft-bedrock \
  -p 19132:19132/udp \
  -v /path/to/host/data:/data \
  -e SERVER_NAME="My Bedrock Server" \
  -e MAX_PLAYERS=8 \
  -e GAME_MODE="survival" \
  minecraft-bedrock-server:latest

docker-compose配置示例

创建docker-compose.yml文件实现更复杂配置：

yaml
version: '3.8'
services:
  bedrock-server:
    image: minecraft-bedrock-server:latest
    container_name: minecraft-bedrock
    restart: unless-stopped
    ports:
      - "19132:19132/udp"
    volumes:
      - ./server-data:/data  # 宿主机目录挂载，持久化数据
    environment:
      - SERVER_NAME="Family Server"
      - GAME_MODE="creative"
      - DIFFICULTY="normal"
      - MAX_PLAYERS=10
      - ONLINE_MODE=true
      - WHITE_LIST=false
      - ALLOW_CHEATS=false
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

启动服务：

bash
docker-compose up -d

持久化数据配置

容器内/data目录包含所有关键数据，建议通过卷挂载到宿主机：

• server.properties：服务器核心配置文件（游戏规则、端口等）
• worlds/：游戏世界数据（玩家进度、建筑等）
• whitelist.json：白名单配置（启用时生效）
• logs/：服务器运行日志

修改配置后需重启容器生效：

bash
docker restart minecraft-bedrock

环境变量配置说明

通过环境变量快速配置服务器参数，对应server.properties字段：

服务器管理操作

查看实时日志

bash
docker logs -f minecraft-bedrock

重启服务器

bash
docker restart minecraft-bedrock

更新服务器版本

1. 拉取新版本镜像：

bash
docker pull minecraft-bedrock-server:latest

2. 重建容器（保留数据卷）：

bash
docker stop minecraft-bedrock && docker rm minecraft-bedrock
docker run -d --name minecraft-bedrock -p 19132:19132/udp -v /path/to/data:/data minecraft-bedrock-server:latest

注意事项

• 端口转发：互联网访问需配置路由器/云服务器的UDP端口转发（默认***）
• 防火墙设置：确保宿主机防火墙允许UDP目标端口入站连接
• 版本匹配：客户端版本需与服务器版本兼容，可在server.properties中设置server-version指定兼容范围
• 资源配置：根据玩家数量调整容器资源限制（如--memory=2g --cpus=1）避免性能问题