MineWiki
基岩版开服教程配置与管理

配置 server.properties 与 allowlist

先了解 BDS 的核心配置和白名单,再以最小权限方式开放玩家访问

BDS 的多数服务端选项都在根目录的 server.properties 中管理。它是每行一个 key=value 的 INI 风格文本文件,注释以 # 开头。1 修改前先停止服务端并备份原文件;一次只改一组相关设置,启动后观察控制台和测试客户端,再记录最终值。

先关注这些核心项

配置项用途修改时要确认
server-name在客户端列表中显示的服务器名称不要将私人地址、账号或内部信息写进名称。
level-name指定 worlds/ 中的活动世界目录值必须与目标世界目录名完全一致,包括大小写。
gamemode设置新玩家的默认游戏模式先在测试账号上确认玩法和管理流程。
server-port / server-portv6BDS 的 IPv4/IPv6 端口同步检查 UDP 防火墙、路由器或云安全组规则。
allow-list是否只允许名单中的玩家进入对只邀请熟人的服务器,建议先启用再逐个添加玩家。

配置项名称与可用值会随 BDS 更新变化。需要完整参数说明时,应查看 Microsoft 的 BDS server.properties 参考,而不是复制不明来源的整份配置。2

使用 allowlist 限制访问

allow-list=true 时,BDS 只允许 allowlist.json 中的玩家加入。最简单的管理方式是在游戏内或控制台使用以下命令:

/allowlist add <GamerTag>
/allowlist remove <GamerTag>
/allowlist reload

如果 GamerTag 含有空格,官方文档要求使用引号包住名称。也可以直接编辑 allowlist.json,但外部编辑完成后需要运行 /allowlist reload,让服务端重新读取名单。1

修改完配置或名单后,使用测试账号验证一次:允许的玩家能进入,不在名单内的账号按预期被拒绝,控制台中没有新的配置错误。下一步可进入世界与备份,为配置变更和世界数据建立恢复点。

参考

On this page