# IPWhiteList 插件
[](https://forthebadge.com)
**IPWhitelist** 插件专为 Minecraft 服务器 (1.17+) 设计，允许服务器管理员管理允许连接到服务器的 IP 地址。有了这个插件，服务器所有者可以强制执行严格的基于 IP 的访问控制，确保只有特定的 IP 地址才能加入，而其他 IP 地址会被自动踢出，并显示自定义消息。该插件支持通过游戏内命令动态管理白名单，并提供在无需服务器重启的情况下切换白名单的开启和关闭功能。
### **主要功能：**
- **白名单管理**: 管理员可以轻松地将 IP 地址添加到或从白名单中移除。
- **可配置的踢出消息**: 自定义显示给未在白名单中的玩家的消息。
- **IP 列表显示**: 通过简单的命令查看当前白名单中的 IP 地址列表。
- **启用/禁用白名单**: 使用命令切换白名单的开启或关闭状态，动态地允许或阻止基于 IP 的访问。
- **持久性白名单**: 该插件将所有白名单 IP 地址保存到单独的 `whitelist.yml` 文件中，确保它们在服务器重启后仍然有效。
- **命令别名**: 该插件支持 `/ipwhitelist` 和 `/ipwl` 命令，为管理员提供灵活性。
- **重新加载支持**: 从 `whitelist.yml` 文件重新加载白名单，而无需重启服务器。
### **命令：**
- `/ipwhitelist add ` - 将指定的 IP 地址添加到白名单。
- `/ipwhitelist remove ` - 从白名单中移除指定的 IP 地址。
- `/ipwhitelist list` - 列出所有白名单中的 IP 地址。
- `/ipwhitelist on` - 启用 IP 白名单（阻止非白名单中的 IP）。
- `/ipwhitelist off` - 禁用 IP 白名单（允许所有 IP）。
- `/ipwhitelist reload` - 从 `whitelist.yml` 文件重新加载白名单，应用任何手动更改。
- `/ipwl` (别名) - 与 `/ipwhitelist` 相同，方便访问。
### **可配置选项：**
- **`whitelist-enabled`**: 切换白名单是否启用或禁用。
- **`kick-message`**: 自定义显示给未在白名单中的玩家的消息。
### **使用场景：**
- **私人服务器**: 根据 IP 地址将 Minecraft 服务器的访问限制到一组已知的玩家。
- **管理员控制**: 动态启用到禁用白名单，无需重启服务器。
- **安全访问**: 通过控制可以加入的 IP，保护您的服务器免受不受欢迎或恶意连接。
这个插件是服务器所有者管理访问控制并在其 Minecraft 服务器上轻松实施基于 IP 的白名单的完美解决方案。