- 版权类型
- 原创
- 插件中文名称
- 网站管理员
- 插件英文名称
- WebManager
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.21
[MD]
# WebManager 插件概述
WebManager 是一个基于 Spigot API 开发的 Minecraft 服务器管理插件,提供了直观的 Web 界面来监控和管理服务器。
## 核心功能
### 1. 服务器监控
- 系统资源监控 :CPU 使用率、内存使用率、磁盘使用率
- 服务器状态 :TPS(每秒tick数)、在线玩家数量、实体数量、加载区块数量
- 实时数据更新 :通过定时请求 API 实现数据实时刷新
### 2. 玩家管理
- 在线玩家列表 :显示所有在线玩家及其基本信息
- 玩家数量统计 :在线玩家数/最大玩家数
### 3. 命令执行
- Web 界面执行命令 :通过 Web 界面直接执行服务器命令
- 操作日志记录 :记录所有通过 Web 界面执行的命令
### 4. 日志查看
- 服务器日志 :查看服务器近期日志
- 操作日志 :查看所有 Web 界面操作记录,包括操作 IP、时间、类型和详情
### 5. 授权管理
- 基于配置文件的授权 :通过 auth_config.txt 文件管理授权 IP
- 命令行管理 :使用 /webmanager 命令管理授权
- /webmanager add <ip> <days> - 添加授权
- /webmanager remove <ip> - 移除授权
- /webmanager list - 查看授权列表
## 技术架构
### 后端实现
- 插件主类 : WebManager - 插件入口,初始化各组件
- HTTP 服务器 : WebHttpServer - 基于 com.sun.net.httpserver.HttpServer 实现
- 资源监控 : ResourceMonitor - 监控系统和服务器资源
- 日志监听器 : LogListener - 监听服务器日志
- 授权管理 : IpAuthorizationManager - 管理 IP 授权
- 配置管理 : AuthConfigManager - 管理授权配置文件
- 操作日志 : OperationLogger - 记录操作日志
### 前端实现
- HTML 模板 : template.html - 响应式 Web 界面
- JavaScript :实现数据更新、页面交互
- CSS :现代化的卡片式布局
### API 端点
- / - 主页
- /api/players - 玩家列表
- /api/resources - 资源监控数据
- /api/command - 命令执行
- /api/logs - 服务器日志
- /api/operation-logs - 操作日志
## 技术特点
1. HTML 模板分离 :前端界面与后端逻辑分离,通过 API 动态加载数据
2. 主线程安全 :所有 Bukkit API 调用都通过 callSyncMethod 在主线程执行,避免线程安全问题
3. 配置文件持久化 :授权信息存储在配置文件中,插件重启后保持
4. 实时数据更新 :前端通过定时请求 API 实现数据实时刷新
5. 操作日志记录 :详细记录所有 Web 界面操作,便于安全审计
6. 响应式设计 :现代化的卡片式布局,适配不同屏幕尺寸
## 部署与使用
1. 构建 :使用 Maven 构建插件( mvn clean package )
2. 安装 :将构建生成的 WebManager-1.1.jar 放入服务器的 plugins 目录
3. 启动 :启动服务器,插件会自动创建必要的目录和文件
4. 访问 :通过 [URL='http://xn--ip-fr5c86lx7z:9876']http://服务器ip:9876[/URL] 访问 Web 管理界面
5. 授权 :首次使用需要通过服务器命令添加授权 IP
## 安全特性
- IP 授权机制 :只有授权的 IP 才能访问管理界面
- 操作日志记录 :所有操作都有详细记录
- 命令执行权限 :仅授权 IP 可执行命令
- 配置文件管理 :授权信息存储在服务器本地,避免远程篡改
WebManager 插件为 Minecraft 服务器管理员提供了一个便捷、安全、功能强大的管理工具,通过直观的 Web 界面实现了对服务器的实时监控和管理。
[/MD]