Repository navigation
Home
基于浏览器的 ZenithProxy（2b2t 代理 / 机器人）管理面板插件。后端是 Java 21 + Netty（NIO + SSE），前端是原生 HTML/CSS/JS，不依赖任何前端框架和构建步骤。
本项目以 AGPL-3.0-or-later（GNU Affero 通用公共许可证 v3 或更高版本）开源，全文见 LICENSE。
| 能力 | 说明 |
|---|---|
| 仪表板 | 连接状态、当前账号、代理地址、运行时间、玩家数、队列位置一屏看完 |
| 系统资源 | CPU、内存、网络吞吐、延迟曲线（Chart.js，每 1 秒推一次） |
| 服务器控制 | 一键连接 / 断开 / 重连 / 关闭代理 |
| 命令终端 | 网页里直接跑 ZenithProxy 命令，带自动补全、历史、快捷键 |
| 日志流 | SSE 实时推送日志，级别配色、自动中文翻译、可导出 |
| 玩家管理 | 查看在线玩家（控制器 / 观察者）与其延迟，可踢出 |
| 白名单 | 开关、增删玩家、改踢出提示、自动添加机器人账号 |
| 认证 | Cookie + Token，首次启动自动生成随机密码，登录失败限流 |
- 从 Releases 下载
ZenithProxy-WebUI-<version>.jar； - 把它放进 ZenithProxy 的
plugins/目录； - 启动 ZenithProxy，在日志里找到首次生成的随机密码；
- 浏览器打开
http://localhost:8080，用admin+ 该密码登录。
详细步骤见 安装与部署。
| 页面 | 内容 |
|---|---|
| 安装与部署 | 环境要求、构建、安装、反向代理、升级与卸载 |
| 配置说明 |
plugins/webui/config.json 全部字段、离线认证绕过配置、配置自愈行为 |
| 功能说明 | 四个页面各自怎么用、队列解析规则、日志翻译 |
| API-参考 | 全部 HTTP 端点、请求/响应示例、SSE 帧格式、curl 示例 |
| 架构与代码结构 | 模块划分、请求链路、线程模型、SSE 广播、缓存策略 |
| 认证与安全 | Token 生命周期、Cookie 属性、通道级缓存与 epoch、安全部署建议 |
| 开发与发布 | 本地构建、CI、版本号规则、发布流程 |
| 常见问题 | 打不开、忘密码、日志不动、CPU/网络显示异常等 |
- 源码仓库：https://github.com/wxh1024/ZenithProxy-WebUI
- 问题反馈：https://github.com/wxh1024/ZenithProxy-WebUI/issues
- 更新日志：CHANGELOG.md
- ZenithProxy 主程序：https://github.com/rfresh2/ZenithProxy
- 官方插件示例：https://github.com/rfresh2/ZenithProxyExamplePlugin
本项目采用 AGPL-3.0-or-later。简单说：
- 可以自由使用、修改、分发；
- 分发 JAR（含打包进整合包）时要一并提供对应源码；
- 如果你改了代码并通过网络向他人提供服务（例如把带 Web UI 的代理作为公开服务运行），必须向这些用户提供获取修改后源码的途径（AGPL 第 13 条）；
- 自己搭、自己用、不对外提供服务，不触发源码提供义务。
第三方依赖许可见各自项目：Netty（Apache-2.0）、Gson（Apache-2.0）、Chart.js（MIT）。ZenithProxy 通过 maven.2b2t.vc 以 compileOnly 引入，不随本项目分发。