什么是白名单？
白名单 是 Minecraft 服务器的一种安全和管理机制，它就像一个“邀请制”的派对。
（图片来源网络，侵删）
- 开启白名单后：只有管理员预先添加到“白名单”列表中的玩家，才能成功连接到你的服务器，任何未在列表上的玩家尝试加入时，都会收到“你不是这个服务器的白名单成员”或类似的提示,并被拒绝连接。
- 关闭白名单后：任何拥有服务器 IP 地址的玩家都可以自由加入,就像一个公开派对。
为什么要使用白名单？
使用白名单的好处非常多,这也是它被广泛使用的原因：
- 防止陌生人入侵：这是最主要的目的，可以有效阻止恶意玩家（俗称“小白”或“Griefer”）随意进入你的服务器进行破坏，比如挖矿、烧毁建筑、使用作弊模组等。
- 保证社区纯净：让你的服务器成为一个只属于你和朋友们的小圈子,避免与不认识的玩家发生冲突。
- 提升服务器性能：虽然效果有限，但限制连接人数可以在一定程度上减少不必要的网络请求和服务器资源消耗,尤其是在服务器硬件配置不高的情况下。
- 管理方便：你可以精确控制谁能进入服务器,方便组织朋友间的游戏活动。
如何设置和管理白名单？（以 Java 版为例）
白名单的命令需要在服务器控制台或拥有 op 权限的玩家的游戏内输入。
开启白名单
在服务器控制台输入以下命令：
whitelist on
执行后，服务器会立即生效,只有白名单玩家可以加入。
（图片来源网络，侵删）
关闭白名单
如果需要暂时对外开放服务器,可以输入：
whitelist off
添加玩家到白名单
使用 whitelist add 命令，后面跟上玩家的 Minecraft 用户名（注意是用户名，不是 UUID，也不是游戏内显示的名字）。
whitelist add <玩家用户名>
示例：
whitelist add Steve whitelist add Notch
从白名单中移除玩家
使用 whitelist remove 命令。
（图片来源网络，侵删）
whitelist remove <玩家用户名>
示例：
whitelist remove Steve
查看白名单列表
如果你想查看当前所有在白名单上的玩家,可以使用：
whitelist list
这会显示白名单的总人数和所有玩家的用户名。
强制刷新白名单（重要！）
你添加或移除玩家后，他们仍然无法加入，这可能是因为服务器没有及时更新名单，这时可以使用 reload 命令来刷新服务器的配置文件,包括白名单。
whitelist reload
或者直接使用更通用的：
reload
建议： 每次修改白名单列表（添加/移除）后，都执行一次 whitelist reload 或 reload,以确保所有玩家都能正确地被识别或拒绝。
查看某个玩家是否在白名单上
如果你想快速检查某个特定玩家是否已被添加,可以使用：
whitelist list <玩家用户名>
如果该玩家在名单上，命令会返回他的信息；如果不在,则不会有任何输出。
基于权限插件的高级白名单管理
对于更复杂的服务器，通常会使用权限管理插件，如 LuckPerms 或 PermissionsEx，这些插件提供了更强大、更灵活的白名单功能。
- LuckPerms 的白名单组：
- 你可以在 LuckPerms 中创建一个组，
whitelisted。 - 给这个组设置一个权限节点：
whitelist.*或者whitelist.exempt（豁免白名单检查）。 - 将你想要加入服务器的玩家都添加到
whitelisted组中。 - 在服务器核心配置（如
server.properties）中，将enforce-whitelist设置为true，这个选项会强制所有插件（包括 LuckPerms）都遵守白名单规则。 - 在 LuckPerms 的配置中,启用白名单功能。
- 你可以在 LuckPerms 中创建一个组，
这种方式的优点是：
- 与权限系统集成：白名单玩家可以自动获得特定权限。
- 更灵活：可以轻松地添加或移除整个组的白名单权限。
重要注意事项
-
区分 Java 版和基岩版：
- 所有命令和操作都适用于 Minecraft: Java 版。
- 基岩版 的白名单设置完全不同，它是在
server.properties文件中通过white-list=true来开启的，但基岩版的白名单功能非常不稳定，在很多版本中可能无法正常工作，对于基岩版服务器，强烈建议使用第三方管理工具（如 Akliz, G-Portal）或插件（如 Floodgate + LuckPerms）来实现更可靠的管理。
-
OP 与白名单：
- OP（管理员）玩家不受白名单限制，即使一个玩家是 OP 且不在白名单上，他依然可以加入服务器，这是一个常见的安全隐患，请确保你信任所有 OP。
-
enforce-whitelist属性：- 在
server.properties文件中，有一个enforce-whitelist属性。 enforce-whitelist=false：只阻止非白名单玩家加入，但 OP 可以自由加入。enforce-whitelist=true：强制所有插件都遵守白名单，包括权限插件，这是最安全的设置，即使是 OP，如果不在白名单上也无法加入。强烈建议在开启白名单后将其设置为true。
- 在
-
服务器重启：
- 修改
server.properties文件后,需要重启服务器才能生效。
- 修改
| 操作 | 命令 (Java版) | 描述 |
|---|---|---|
| 开启 | whitelist on |
启用白名单功能 |
| 关闭 | whitelist off |
关闭白名单功能 |
| 添加玩家 | whitelist add <用户名> |
将指定玩家加入白名单 |
| 移除玩家 | whitelist remove <用户名> |
将指定玩家从白名单移除 |
| 查看列表 | whitelist list |
显示所有白名单玩家 |
| 刷新列表 | whitelist reload 或 reload |
重新加载白名单配置 |
希望这份详细的指南能帮助你成功管理你的 Minecraft 服务器！白名单是保护你和朋友们心血结晶的最好工具之一。
