先给结论
社区常用的 itzg/minecraft-bedrock-server 镜像把 BDS 下载、版本选择与配置项封装成环境变量,适合需要快速部署或多实例运行的服主。部署成败取决于三件事:数据目录必须挂载到宿主机、19132 必须按 UDP 映射、版本与 EULA 等关键环境变量必须明确。做好这三点,容器化会让迁移和升级都更省事。
一、为什么用容器跑 BDS
容器把运行环境固定下来,同一份配置在不同主机上表现一致,减少「这台能跑那台不能」的问题。
多实例部署更简单:每个服务器一个容器、一个数据目录、一个端口,互不干扰。
升级与回退也更清晰:程序在镜像里,数据在挂载目录里,替换镜像不碰世界文件。
代价是多了一层网络与存储抽象。端口映射、目录权限与日志查看方式都要重新熟悉。
如果只是单台机器跑一个小服,直接运行 BDS 也完全可以;容器化的收益在多实例、频繁迁移和标准化运维时更明显。
二、关键环境变量
EULA 需要明确接受,否则服务端不会启动,这是最常见的首启失败原因。
VERSION 用于指定服务端版本,可以写具体版本号,也可以使用最新版本。生产环境建议固定版本,避免容器重建时被动升级。
服务器名称、游戏模式、难度、白名单、最大人数等常用配置可通过对应环境变量写入 server.properties。
环境变量与手工修改配置文件同时存在时,要清楚以哪个为准,否则会出现改了文件、重启后又被覆盖的情况。
把所有环境变量写进 compose 文件并纳入版本记录,团队成员能一眼看清当前配置。
三、数据卷挂载
容器内的数据目录必须挂载到宿主机目录,否则删除或重建容器时,世界、配置和权限文件会一起消失。
挂载目录中会包含 worlds、server.properties、allowlist.json、permissions.json 以及内容包目录,备份时直接备份该目录即可。
宿主机目录的读写权限要与容器内运行用户匹配,权限不足会表现为启动报错或存档无法保存。
不要把数据目录放在容器的临时层里做测试后就直接上线,很多人第一次重建容器时才发现世界没了。
数据目录建议放在性能稳定的磁盘上,世界变大后磁盘读写会直接影响保存与加载体验。
四、端口映射必须是 UDP
基岩版使用 UDP,端口映射要写成 19132:19132/udp,漏写协议时默认按 TCP 处理,外网玩家会连不上。
若开放 IPv6,还需要关注 19133 等 IPv6 端口与宿主机的 IPv6 网络配置。
多实例时为每个容器分配不同的宿主机端口,例如 19132、19142、19152,并在公告中写清对应关系。
映射完成后仍要检查宿主机防火墙与云安全组,容器端口映射不会自动放行这两层。
用外部网络实际测试连接,而不是只在宿主机本地验证。
五、日志与控制台
容器日志可以通过 docker logs 查看,排查启动失败时先看最后几十行输出。
需要向服务端输入命令时,要使用镜像提供的方式连接控制台,而不是直接停止容器。
停止容器时应给服务端留出保存时间,强制杀掉容器可能导致世界数据写入中断。
日志会持续增长,要配置日志驱动的大小限制或轮转,避免写满磁盘。
把常用的查看日志、执行命令、重启的方式写进文档,方便多人维护。
六、升级与备份流程
升级前先备份挂载的数据目录,再修改 VERSION 或拉取新镜像,最后重建容器。
首次启动新版本后检查日志,确认世界加载成功、内容包没有报错。
若新版本异常,把 VERSION 改回旧值并恢复备份即可回退,这是容器化带来的主要便利。
备份可以在宿主机层面定时打包数据目录,并把副本存到其他磁盘或主机。
不要让容器在无人知情的情况下自动更新,版本变化应当是一次可控的变更。
七、常见问题
有人问容器起来了但外网进不来。九成是端口没写 /udp,或者宿主机防火墙与安全组没有放行。
还有人问重建容器后世界没了。说明数据目录没有挂载到宿主机,需要从备份恢复并修正挂载。
也有人遇到改了 server.properties 重启又变回去。检查是否有对应环境变量在启动时覆盖了配置。
最后一个常见问题是权限报错。核对宿主机目录归属与容器运行用户,必要时调整目录权限。
执行步骤
- 准备宿主机数据目录,并确认磁盘空间与读写性能。
- 编写 compose 文件,设置 EULA、VERSION 与常用配置环境变量。
- 把容器数据目录挂载到宿主机目录。
- 以 UDP 方式映射 19132 端口,多实例使用不同宿主机端口。
- 放行宿主机防火墙与云安全组的对应 UDP 端口。
- 启动容器并查看日志,确认世界与配置正常生成。
- 用外部网络测试连接并记录结果。
- 建立数据目录定时备份与版本升级流程。
验收标准
- 容器重建后世界、配置与权限文件仍然存在。
- 端口映射为 UDP,外网玩家可以正常连接。
- VERSION 固定,不会在重建时被动升级。
- 环境变量与配置文件的优先关系明确。
- 日志有大小限制,不会写满磁盘。
- 备份可以恢复并成功启动。
常见误区
- 未挂载数据目录,重建容器后世界丢失。
- 端口映射漏写 /udp,外网无法连接。
- 未接受 EULA,容器反复启动失败。
- 使用最新版本标签,重建时被动升级导致不兼容。
- 强制停止容器,世界写入中断。
- 只做容器映射,忘记宿主机防火墙与安全组。
容器化的价值在于把程序和数据彻底分开。数据卷挂好、UDP 映射对、版本固定住,BDS 的部署、迁移和回退都会变得可重复、可预期。