我的世界服务器白名单本质是一份“允许进入名单”，在服务端开启后，只有名单内的玩家ID才能连接，这是防止熊孩子和陌生人入侵最直接的手段。配置过程只需修改两个配置文件并执行一条指令,全程五分钟内可完成。
我的世界服务器白名单指令是什么
很多玩家第一次接触白名单，是在开服教程里看到 whitelist 这个词。白名单指令的完整体系并不复杂，核心就四条：whitelist on（开启）、whitelist off（关闭）、whitelist add 玩家ID（添加）、whitelist remove 玩家ID（移除），这些指令在服务端控制台输入,也可以在游戏内以OP身份执行。
单条指令的实操细节
whitelist add 玩家ID：ID必须与对方正版账号完全一致，大小写不能错，添加成功后控制台会返回Added 玩家ID to the whitelist提示。whitelist remove 玩家ID：把玩家移出名单,对方下次进服会被拒绝连接。whitelist list：查看当前白名单里的全部玩家,适合开服时核对名单。whitelist reload：当你手动编辑了white-list.json文件后，执行这条指令让配置热加载，无需重启服务器。
白名单文件藏在哪个位置
白名单数据存放在服务端根目录下的 white-list.json 文件里，用记事本打开能看到类似 {"uuid":"具体字符","name":"玩家ID"} 的格式，这是游戏自动生成的，如果你熟悉JSON语法，可以手动往里加内容，但操作前务必备份原文件，格式写错会导致文件损坏,白名单功能异常。
开启白名单前必须确认的两个前提
白名单生效依赖两个前置条件，第一，服务器必须开启正版验证，也就是 server.properties 文件里 online-mode=true，如果你的服务器是离线模式（online-mode=false），那白名单形同虚设，因为离线模式下玩家可以随意伪造ID，绕过名单限制，第二，你的服务端版本要支持白名单功能。几乎所有主流服务端（Vanilla、Paper、Spigot、Forge）都内置白名单系统,不需要额外装插件。
我的世界开服务器怎么给朋友加白名单
很多玩家问“我的世界开服务器怎么给朋友加白名单”，这要分两种情况：你开的是正版服，还是离线（盗版）服，两种场景操作路径完全不同，弄混了会产生“加了白名单但朋友进不来”的问题。
正版服务器的完整配置流程
这是最省心的方案，前提是你和你的朋友都购买了正版Minecraft,操作步骤如下：
- 停止服务器运行，用文本编辑器打开
server.properties文件。 - 找到
white-list=这一行，把后面的false改成true。 - 确认
online-mode=true（默认就是true，不要改动）。 - 保存文件并启动服务器。
- 在控制台或游戏内执行
whitelist add 朋友的游戏ID。 - 执行
whitelist list确认添加成功。
这里有个常见坑：修改 server.properties 前必须完全停止服务器，否则保存的配置会被服务器关闭时自动覆盖，你改的内容就丢失了，行业共识认为，大部分白名单失效问题都出在“改配置没停服”这个操作失误上。
离线服务器的白名单方案
离线服（也就是俗称的“盗版服”）情况复杂很多，因为玩家ID不经过正版验证，单纯开启白名单等于没开，任何人都能顶用名单里的ID进服，业内专家指出，离线服保护玩家身份的唯一可靠方案是绑定登录插件,常见的有：
- CatSeedLogin：支持UUID锁定,玩家首次注册后ID与密码绑定。
- AuthMe Reloaded：老牌登录插件，具有二次验证功能,可设置白名单密码。
- MultiLogin：支持正版与离线共存,能隔离正版ID和离线ID冲突。
以AuthMe为例，基础配置方法是：将插件放入 plugins 文件夹，重启服务器让插件生成配置，在 config.yml 里开启白名单选项和强制登录功能，这套方案本质上是用“注册+密码”替代正版验证，确保只有知道密码的人才能使用该ID,这就间接实现了白名单效果。
局域网联机场景下的白名单问题
“我的世界局域网联机白名单怎么设置” 这个问题的答案是：原版局域网联机（Open to LAN）不支持白名单功能，这是单人游戏内开启的临时服务器，它的所有权限配置都继承自单人存档，没有独立的服务端配置文件，如果你在局域网联机里遇到捣乱的人，只能用“踢出”按钮手动处理,没有持久化的白名单机制。
解决方案是：把单人存档迁移到独立服务端上，用上述服务端白名单方式管理，具体迁移方法：将存档文件夹从 .minecraft/saves 复制到服务端的 world 文件夹,启动服务端即可。
白名单为什么设置不生效
常见的问题是“我明明开了白名单，为什么别人还能进来”或“朋友被挡在门外”，以下归纳为三类成因,按出现频率排序。
正版验证与白名单的冲突
online-mode=false，服务器不会校验玩家ID是否真实，白名单直接失去意义，这是离线服玩家最常踩的坑。如果你开了离线模式，就别指望内置白名单能拦住有恶意的人，你要做的是加装登录插件，并确保插件强制开启“自动补全白名单”或“未登录不可交互”的选项。
服务端缓存导致白名单未刷新
部分服务端（尤其是一些插件端）会缓存玩家数据，白名单修改后不会立即生效，这在添加新玩家时尤其明显，对方尝试连接时被提示 “You are not whitelisted on this server” 或 “Not white-listed”,解决办法是：
- 在控制台执行
whitelist reload。 - 再执行
whitelist add 玩家ID（如果之前执行过，会提示已在名单中）。 - 如果还不行，重启服务器,给缓存一个强制刷新。
玩家ID拼写与UUID通用性问题
正版服对ID是严格校验的。如果朋友改名了，但白名单里还是旧ID，他就进不来，此时需要先 whitelist remove 旧ID，再重新 whitelist add 新ID，个人的解决习惯是：让朋友在联机界面把ID截图发过来，对照着添加,不要凭记忆输入。
白名单相关配置推荐与常见问题解答
开服时推荐的白名单配置组合
针对不同场景,配置思路参考下表：
| 服务器类型 | 核心配置需求 | 推荐方案 |
|---|---|---|
| 正版纯净服 | 内置白名单 | online-mode=true，white-list=true
|
| 正版插件服 | 内置白名单+权限管理 | 配合LuckPerms插件，按组分配权限 |
| 离线小型朋友服 | 登录插件 | AuthMe + 开启动态白名单 |
| 离线大型公益服 | 登录插件+验证系统 | CatSeedLogin + 注册密码限制 |
玩家在服务器里如何查询自己是否在白名单内
普通玩家没有权限执行 whitelist list 指令，如果你不确定自己是否被添加，看连接提示就能判断，如果提示 “You are not whitelisted on this server”（你不在本服务器白名单中），说明你的ID未在名单内或ID拼写有误，如果是正版服,请检查你的微软账号当前ID是否和白名单里的一致。
白名单和OP权限是一回事吗
完全不是，白名单管的是“能不能进服务器”，OP权限管的是“进了服务器能干什么”，一个玩家可以不在白名单里，但拥有管理员权限，这没有意义；同理，一个玩家可以在白名单里，但没有任何权限，只能正常游玩，配置服务器时不要混用这两个概念,否则会导致权限泄露风险。
我的世界服务器白名单怎么弄才能防住破解版玩家
如果你的服务器是正版模式（默认开启），破解版玩家根本连接不上，压根不需要白名单来防。你真正要防的是“已通过正版验证但怀有恶意的玩家”，白名单正好能解决这个问题,只让熟人进入就行。
如果你的服务器是离线模式，那防破解玩家的思路就不对了，因为离线模式下所有玩家都可以用任意ID，包括正版ID，这时你应该用登录插件绑定每人的唯一密码,比白名单靠谱得多。
白名单文件备份与迁移
white-list.json 是你服务器的核心数据文件。更换服务器机器或重装服务端时，记得把这个文件一起复制走，否则所有白名单玩家都要重新添加，备份方式：直接压缩该文件，放到服务端根目录以外的位置,比如专门的备份文件夹。
服务器迁移时，将 white-list.json 和安全配置一起复制，放到新服务端的根目录下，确认路径正确后启动服务器即可，这一个文件的备份动作，能省下跟朋友解释“为什么我进不去了”的一整晚时间。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/702757.html
