讲清楚允许列表和白名单
允许列表(基岩版)和白名单(Java 版)是干什么的、用哪些命令管理,以及那个经典的坑:名单空着就打开它,会把所有人挡在外面,包括你自己。
阅读约 2 分钟 · 更新于 2026年10月21日 · 作者:GuavaHost Team
允许列表(Minecraft 基岩版)或白名单(Minecraft Java 版)是一份名单,只有名单上的玩家才被允许加入。同一个概念,两个不同的名字。打开之后,不在名单上的人都会被拒之门外。这是把服务器留给你和朋友私用的最简单办法。
必须知道的那个坑
下面这个错,几乎每个人至少犯过一次。如果你在名单里一个名字都没有的时候就把它打开,你会挡住所有人,包括你自己。一份空的允许名单意味着谁都不被允许。永远先把名字加好,或者在同一次操作里把自己加进去,否则你会把自己锁在门外。
在基岩版上管理
在面板的 Console(控制台)标签页里输入这些命令,或者如果你是管理员,也可以在游戏里输入。
- 添加玩家:
allowlist add <name>,比如allowlist add Steve。 - 移除玩家:
allowlist remove <name>。 - 查看名单上有谁:
allowlist list。 - 关掉它,让任何人都能进:
allowlist off。 - 打开它:
allowlist on。只在你已经加好名字之后才这么做。
在 Java 版上管理
一样的思路,换个词。
- 添加玩家:
whitelist add <name>,比如whitelist add Steve。 - 移除玩家:
whitelist remove <name>。 - 查看名单上有谁:
whitelist list。 - 关掉它,让任何人都能进:
whitelist off。 - 打开它:
whitelist on。同样,先加名字。
在 Java 版上,编辑过名单之后可能需要运行 whitelist reload 才能让改动生效。
server.properties 里的那个设置
名单是否开启,同时也存在一个叫 server.properties 的文件里,这个文件放着你服务器的核心设置。你可以在服务器菜单 Minecraft tools(Minecraft 工具)下的 Server properties(服务器属性)页面里改它,也可以在 Files(文件)标签页里直接编辑这个文件。
- 基岩版上那一行是
allow-list=true或allow-list=false。 - Java 版上那一行是
white-list=true或white-list=false。 - 把它设成
true等同于打开名单,所以空名单那个坑在这里同样适用。设成true之前先把名字加好。 - 如果你直接编辑了文件,就从
Console标签页重启服务器,让改动被读取到。
故障排查
- 你把自己锁在外面了:打开面板的 Console 标签页,运行
allowlist off(基岩版)或whitelist off(Java 版)。即使你在游戏里进不去,控制台照样能用,所以你总能这样救回来。 - 加了名字但他还是进不去:仔细核对他用户名的拼写是否完全一致。Java 版上可以试试
whitelist reload。基岩版上,名字必须和他账号名一致。 - 改动不生效:如果你是手动编辑了
server.properties,就重启服务器,让它重新读取文件。
还是搞不定?来我们的 Discord:discord.gg/GuavaHost,团队会帮你解决。
- minecraft
- allowlist
- whitelist
- connecting
Host a Minecraft Java server From $3.99/mo, with instant setup and DDoS protection.
还是没解决? 我们的团队 7x24 小时在线,随时解答你的问题。