WebConsole - 网页远程控制台

WebConsole

WebConsole 是一款适用于 Minecraft 1.8-1.21 的 Spigot 插件，它允许你随时随地查看服务器控制台并管理服务器。它会在后台创建一个 WebSocket 服务器，供网页界面连接，用于发送命令、接收控制台日志和管理服务器。

无需担心隐私或安全问题：所有数据都离线存储在您的浏览器中，您的电脑将直接连接到您的 Minecraft 服务器。没有中间网络服务器，只有您和您的服务器。

💡主要特性

• 多用户系统与仅查看模式：您可以创建多个用户，并将其角色设置为“管理员”或“查看者”。角色为“查看者”的用户只能读取控制台、CPU 和 RAM 使用情况。角色为“管理员”的用户还可以在服务器上执行命令。如果您想让朋友查看服务器控制台，但禁止他们输入命令破坏服务器，这将非常有用。您还可以对某些命令设置白名单或黑名单。
• 命令历史记录：像在真实控制台中一样，使用上/下箭头键浏览命令历史。
• 支持颜色：支持 Windows 和 Linux 主机（不同平台的颜色表示方式不同）。
• 实时信息：显示实时在线的玩家、机器 CPU 和服务器 RAM 使用情况。
• 多服务器连接：能够保持与多个服务器的活动连接，以便在后台持续获取所有服务器的控制台日志。
• 多语言支持：支持英语、西班牙语、中文（感谢 Neubulae 和 OPhantomO）、捷克语（感谢 Tada）、德语（感谢 NoNamePro0）、荷兰语（感谢 Twockx）、法语（感谢 pickatchou999）、意大利语（感谢 AlexZap）、韩语（感谢 XxPKBxX）、葡萄牙语（感谢 AlexandreMuassab 和 Connect500BR）、俄语（感谢 Stashenko）和土耳其语（感谢 acarnd03）。
• 免费使用

🎮安装与配置

步骤 1：插件安装

• 从下载链接获取插件文件 WebConsole.jar。
• 启动并关闭您的服务器，以生成 config.yml 配置文件。打开该文件，您将看到类似以下的内容：

useSSL: false
StoreType: JKS
KeyStore: plugins/WebConsole/keystore.jks
StorePassword: storepassword
KeyPassword: keypassword
host: 0.0.0.0
port: 8080
language: en
passwords:
  admin:
    user1:
      password: mySecurePassword
  commandWhitelist:
    enabled: true
    commandWhitelistActsAsBlacklist: false
    whitelist:
      - whisper
      - gamemode survival
  viewer: {}

配置说明

• host：保持 0.0.0.0 通常即可。如果遇到问题，可以将其更改为您的设备 IP。
• 如果您在 VPS 或专用服务器上（或您的设备拥有完整的公网 IP），请填写您的公网 IP。
• 如果您在家用网络中（设备没有公网 IP），请填写您的私有 IP（通常类似 192.168.xx.xx）。
• port：运行此插件所使用的端口（不能与 Minecraft 服务器使用的端口相同）。
• language：设置控制台和命令消息的显示语言。有效语言代码包括：英语 (en)、西班牙语 (es)、中文 (zh)、捷克语 (cs)、德语 (de)、荷兰语 (nl)、法语 (fr)、意大利语 (it)、韩语 (ko)、葡萄牙语 (pt)、俄语 (ru)、土耳其语 (tr)。

> 注意：已知在 Microsoft Windows 的 cmd 中使用非英语语言时，可能会显示乱码。如果您使用 Windows 托管服务器，请查看相关 Wiki 页面以解决问题。

用户配置

自 2.0 版本起，您可以创建多个用户，并将其设置为管理员（拥有读取控制台和执行命令的权限）或查看者（仅拥有读取控制台、CPU 和 RAM 使用情况的权限）。这通过 passwords 部分进行配置：

• 默认创建了一个名为 user1、密码为 mySecurePassword 的用户，请务必修改或删除它，这仅作为示例。
• 如果要创建仅查看用户，请删除 viewer: {} 中的 {}，并在下方添加类似 用户名: 密码 的行。
• 您可以根据需要创建任意数量的管理员或查看者用户。
• 对于所有管理员用户，您可以在其 commandWhitelist 部分启用命令白名单。

其余字段用于 SSL 配置。如果您想启用 SSL，请参阅下文。

🔧使用网页界面

您可以选择下载并自行托管客户端，或使用我们提供的托管服务。

• 自行托管：从 Releases 页面下载 client.zip，并将这些文件放入您喜欢的 Web 服务器中，例如 Apache、NGINX 等。
• 使用托管客户端：您也可以使用 WebConsole Hosted Clients 网页，那里提供了所有版本的客户端。

检查已连接的客户端

自 v1.3 起，您可以使用 /WebConsole 命令查看有多少客户端已连接及其 IP 地址。这是本插件提供的唯一 Minecraft 命令。执行此命令需要您拥有 webconsole.webconsole 权限。

✨SSL 配置（可选）

默认情况下，服务器与客户端之间以明文通信（无加密）。要设置加密连接，请遵循 此指南。

❓技术信息

您可以在 此处 找到 WebConsole 客户端与服务器之间的通信原理说明。

⭐用户贡献与相关项目

• WebConsoleApp：由 Donkaos501 开发的 Web 客户端可执行程序移植版。
• WebConsoleElectronClient：由 ddomino007 开发的客户端 Electron 应用程序。

💡反馈与支持

如果您在使用 WebConsole 时遇到错误、有建议或配置问题：

• 可以在 GitHub 上提交问题。
• 或在 Spigot 论坛 上向我提问。