XB Control 是面向 Xboard V2 管理 API 的独立 Vue 3 管理端，提供用户、订单、套餐、工单、内容、支付、节点、机器、统计和站点配置等后台功能，并保留 API 工作台供开发调试。
Vercel 测试站：https://xbamdin.vercel.app/（用于界面与接口测试，尚不代表生产就绪）
初期项目提示：本管理端仍处于初期阶段，可能存在尚未发现的 Bug 或兼容性问题。请先在隔离、可恢复且符合自身安全要求的环境中评估和使用，并在操作真实数据前充分验证。项目 UI、README、API 参考及其他开发文档由 GPT 自动生成，仅供参考；如发现错误或有改进建议，欢迎补充和反馈。
页面截图采用浏览器内固定演示响应生成，样例邮箱和域名使用
.invalid；截图没有读取或包含真实站点或本机数据库中的数据。按钮和表单仅用于展示界面，没有执行写操作。
需要 Node.js 18 或更新版本。
npm install
cp .env.local.example .env.local
# 按需编辑 .env.local 中的 Xboard 地址和管理员安全路径
npm run dev本地开发地址：http://127.0.0.1:5173/。.env.local 是本机默认配置，改动后重启 Vite。也可以直接在登录页设置连接。公开示例不预填管理员安全路径；该路径会发送到浏览器并编入前端资源，不能当作身份认证或密码使用，也不要把管理员密码、令牌或其他秘密放入 Vite 环境变量。
登录使用 Xboard 管理员账号。密码不会保存；令牌保留在当前浏览器会话的 sessionStorage，退出或结束会话后失效。浏览器跨域访问要求 Xboard 允许管理端来源的 CORS 请求；生产环境应使用 HTTPS，或配置同源反向代理。
登录后，侧边栏各页面可使用 /#/<功能名> 直接打开。下表链接指向 Vercel 测试站；截图可在 GitHub 页面中直接查看或点击放大。
| 功能 | Vercel 测试地址 | 页面截图 |
|---|---|---|
| 连接登录 | https://xbamdin.vercel.app/ |  |
| 运营概览 | /#/overview |  |
| 订单 | /#/orders |  |
| 套餐 | /#/plans |  |
| 工单 | /#/tickets |  |
| 公告 | /#/notices |  |
| 用户 | /#/users |  |
| 知识库 | /#/knowledge |  |
| 优惠券 | /#/coupons |  |
| 礼品卡 | /#/gift-cards |  |
| 支付方式 | /#/payments |  |
| 节点 | /#/servers |  |
| 机器 | /#/machines |  |
| 统计报表 | /#/statistics |  |
| 流量重置 | /#/traffic-reset |  |
| 站点配置 | /#/configuration |  |
| 邮件模板 |  |
|
| 系统状态 | /#/system |  |
| 主题 | /#/themes |  |
| 插件 | /#/plugins |  |
目前包含运营概览、订单、套餐、工单、公告、用户、知识库、优惠券、礼品卡、支付方式、节点/分组/线路、机器、统计报表、流量重置、站点配置、邮件模板、系统状态、主题和插件等功能页。接口明细、迁移顺序及后端缺失项见 MIGRATION.md。
面向二次开发的登录认证、请求/响应格式、分页/上传下载约定和完整管理接口目录见 Xboard Admin API 开发参考。
当前 Xboard 后端还存在 3 个路由与控制器实现不匹配的接口：user/setInviteUser、notice/update、stat/getRanking。另外，构建通过只代表前端代码可打包；连接目标 Xboard 后仍需用测试实例逐页验收。
- 不要提交
.env.local、管理员密码、会话令牌、数据库导出或真实业务数据。 - 所有管理 API 请求由当前浏览器直接发往 Xboard；部署前需确认 CORS、HTTPS 和网络访问策略。
- 删除用户、机器、支付方式等写操作有确认提示；继续在真实实例操作前应确认连接地址和目标账号。