VoidkitVoidkit
指南
模块
反作弊
审计
管理平台
开发
GitHub
指南
模块
反作弊
审计
管理平台
开发
GitHub
  • 管理平台(VoidkitHub)

    • 管理平台(VoidkitHub)

管理平台(VoidkitHub)

hub/            ← 本仓库内的 Go 程序,与 JVM 无关

一个单二进制 Go 程序,部署在小内存机器上即可。 它把多台游戏服的 voidkit_web API 聚合成一个后台,浏览器直接访问。

单服也能用:配一台服(本机 127.0.0.1:8765)即可当普通面板; 多服则配多台,页面自动跨服汇总。

架构

浏览器 ──▶ VoidkitHub(中心节点)──▶ 各游戏服的 voidkit_web(Agent)
            令牌托管 / 账号 / 聚合        只听 127.0.0.1
  • 各服的 apiToken 只存在 Hub 上,浏览器只认 Hub 一个凭据。
  • Hub 支持账号密码(HTTP Basic)+ 机器令牌两种认证方式。

快速开始

不想自己编译?Releases 里有 3 平台的预编译二进制 (voidkithub-windows-amd64.exe / voidkithub-linux-amd64 / voidkithub-darwin-arm64), 下载后 chmod +x 直接跑。

或者从源码构建(需要 Go 1.22+):

cd hub
go build -o voidkithub .          # 单文件,无运行时依赖
./voidkithub -listen 0.0.0.0:9000 -user admin -pass '改成你自己的'

启动参数:

参数说明
-listen监听地址(默认 0.0.0.0:9000)
-data数据目录(默认 ./hubdata,存 config.json / state.json)
-user / -pass面板登录用户名 / 密码(留空则首次运行自动生成并打印)
-token机器访问令牌(给脚本 / 监控用)
-poll轮询各服的间隔(秒)
-timeout单台服务器探测超时(秒)
-show-token只打印当前面板令牌然后退出

界面

VoidkitHub 总览页:在线服务器数、在线玩家、平均 TPS、玩家档案,以及智能提示与各服务器卡片
总览 —— 实时状态 + 智能提示(主动指出 TPS 偏低 / 内存偏高 / 离线等问题)
智能审计页:按玩家聚合的操作数条形图、破坏与放置占比、动作分布
智能审计 —— 聚合视图 / 时间线 / 表格三种视图共用一份查询结果
反作弊会话控制台:校验状态、Mod 数、可疑信号、机器码、一键截图 / 深度扫描 / 封禁
反作弊会话控制台 —— 一键截图 / 深度扫描 / 封禁,点击行打开玩家报告
反作弊审计日志:进服 / 校验通过 / 校验失败 / 封禁 / 截屏等事件流水
反作弊 · 审计日志 —— 跨服事件流水(进服 / 校验 / 封禁 / 截屏 / 深扫)
功能模块页:按服务器列出全部功能模块及其开关
功能模块 —— 每台服的功能模块一键开关,保存即重载

页面

分组页面说明
机队总览所有服的在线人数、TPS、延迟一屏汇总
服务器增删改受管服务器(地址 + apiToken),探测连通性
玩家玩家查询跨服查玩家(在线 / 历史、IP、当前所在服)
日志上下线日志汇总
审计审计Inspector 的智能审计:按玩家 / 动作聚合条形图 + 操作时间线
反作弊控制台Guard 会话表(校验状态、一键操作)
封禁管理IP / 机器码 / UUID 封禁与解封
白名单哈希锁白名单审核(批准 / 移除)
判定报告深度扫描与综合判定结论
审计流水校验 / 封禁 / 截屏 / 白名单事件的跨服流水
系统模块各服 /vk features 一键开关

开发

  • hub/tools/fake-agent.js —— 模拟 Agent,便于本地做端到端调试
  • hub/tools/smoke-test.sh —— 冒烟测试
  • 前端在 hub/web/(index.html + app.js + style.css),无构建步骤,直接静态托管

安全提醒

  • 游戏服的 voidkit_web 请保持 bind: 127.0.0.1,不要直接暴露公网。
  • Hub 才是唯一对外入口,请务必设置强密码,并在前面加 HTTPS 反向代理。
在 GitHub 上编辑此页
最后更新: 2026/10/14 05:16