itzg/minecraft-bedrock-server

![]([] ![]([***]

快速开始

以下命令启动运行默认版本并暴露默认UDP端口的基岩版专用服务器：

bash
docker run -d -it -e EULA=TRUE -p 19132:19132/udp -v mc-bedrock-data:/data itzg/minecraft-bedrock-server

寻找Java版服务器

如需Minecraft Java版服务器，请使用此镜像： https://hub.docker.com/r/itzg/minecraft-server

环境变量

容器特定

• EULA（无默认值）：必须设置为TRUE以接受Minecraft最终用户许可协议
• VERSION（默认LATEST）：可设置为特定服务器版本或以下特殊值：
  • LATEST：获取最新版本，容器启动时可自动升级
  • PREVIOUS：使用先前维护的主要版本，适用于移动应用逐步升级场景
  • 1.11、1.12、1.13、1.14、1.16：对应主版本的最新版
  • 其他特定版本：用于临时规避漏洞等情况
• UID（默认从/data所有者派生）：运行基岩服务器进程的用户ID
• GID（默认从/data所有者派生）：运行基岩服务器进程的组ID
• PACKAGE_BACKUP_KEEP（默认2）：保留的包备份数量

服务器属性

以下环境变量对应server.properties中的属性，详细说明见此处：

SERVER_NAME、SERVER_PORT、SERVER_PORT_V6、GAMEMODE、DIFFICULTY、LEVEL_TYPE、ALLOW_CHEATS、MAX_PLAYERS、ONLINE_MODE、WHITE_LIST、VIEW_DISTANCE、TICK_DISTANCE、PLAYER_IDLE_TIMEOUT、MAX_THREADS、LEVEL_NAME、LEVEL_SEED、DEFAULT_PLAYER_PERMISSION_LEVEL、TEXTUREPACK_REQUIRED、SERVER_AUTHORITATIVE_MOVEMENT、PLAYER_MOVEMENT_SCORE_THRESHOLD、PLAYER_MOVEMENT_DISTANCE_THRESHOLD、PLAYER_MOVEMENT_DURATION_THRESHOLD_IN_MS、CORRECT_PLAYER_MOVEMENT

例如，配置平面创造模式服务器：

bash
docker run -d -it --name bds-flat-creative \
  -e EULA=TRUE -e LEVEL_TYPE=flat -e GAMEMODE=creative \
  -p 19132:19132/udp itzg/minecraft-bedrock-server

暴露端口

• UDP ***：基岩服务器端口。注意：暴露端口时必须附加/udp，如-p 19132:19132/udp

卷

• /data：服务器文件存储目录，包含server.properties配置文件

创建并使用命名卷：

shell
docker volume create mc-volume
docker run -d -it --name mc-server -e EULA=TRUE -p 19132:19132/udp -v mc-volume:/data itzg/minecraft-bedrock-server

非root用户运行时需预先设置卷权限（如UID/GID 1000）：

shell
docker run --rm -v bedrock:/data alpine chown 1000:1000 /data

Compose文件中声明外部卷：

yaml
volumes:
  bedrock:
    external:
      name: bedrock

连接

局域网内运行时，可在"好友"选项卡的"局域网游戏"中找到并连接服务器。

权限配置

通过XUID定义操作员（OPS）、成员（MEMBERS）和访客（VISITORS）权限：

shell
-e OPS "1234567890,0987654321"
-e MEMBERS "1234567890,0987654321"
-e VISITORS "1234567890,0987654321"

白名单设置

两种方式：1. 设置WHITE_LIST=TRUE并映射自定义whitelist.json；2. 使用WHITE_LIST_USERS指定玩家名称列表：

shell
-e WHITE_LIST_USERS="player1,player2,player3"

1.16.230.50版本起，将使用ALLOW_LIST、ALLOW_LIST_USERS和allowlist.json。

执行服务器命令

使用-it启动容器后，通过以下命令附加到控制台：

shell
docker attach CONTAINER_NAME_OR_ID

执行命令（如设置管理员）：

op YOUR_XBOX_USERNAME

使用Ctrl-p+Ctrl-q分离控制台。

Docker Compose部署

examples目录包含示例compose文件，声明服务、卷及环境变量配置：

yaml
environment:
  EULA: "TRUE"
  GAMEMODE: survival
  DIFFICULTY: normal

部署命令：

bash
docker-compose up -d

查看日志：

bash
docker-compose logs -f bds

Kubernetes部署

examples目录包含示例Kubernetes清单，声明PVC、部署和服务。部署命令：

bash
kubectl apply -f examples/kubernetes.yml

查看日志：

bash
kubectl logs -f deployment/bds

数据备份方案

• https://hub.docker.com/r/kaiede/minecraft-bedrock-backup%EF%BC%88@Kaiede%E6%8F%90%E4%BE%9B%EF%BC%89