多服务器更新管理中心

数据看板 LIVE 实时监控线上版本 - 15s 后自动刷新

近 24 小时命令活动趋势

24h 更新成功率

主机在线状态

客户机版本分布

主机实时状态

近 24 小时命令记录成功 0 · 失败 0

下发时间	客户	类型	状态	结果

当前线上版本

-

客户机 agent 每 2 分钟轮询本中心，领到更新命令后自动下载该包执行更新（失败自动回滚）。

上传新版本包

新版本号（例如 1.2.1，只允许英文数字点）

版本包 zip 文件（上限 300MB）

点击选择 zip 文件，或把文件拖到这里

发版历史

时间	版本	包大小	SHA256	操作

下发时间	命令ID	客户	类型	目标版本	状态	结果

-

离线主机

客户主机	最后心跳	离线时长	当前版本

最近失败的命令最近 20 条

完成时间	客户	类型	原因

时间	来源IP	操作	详情

基础信息站点显示与访问入口

站点 Logo（PNG / JPG / GIF / WebP / SVG，≤5MB，显示在登录页 / 侧栏 / 浏览器标签）

暂无

建议使用正方形透明背景 PNG，尺寸 ≥ 64×64。上传后即时生效。

站点名称（显示在页头 / 标题栏）

中心访问地址（用于生成 Agent 配置的 $CenterUrl，留空则自动取当前访问地址）

管理员账号

账号由启动参数 ADMIN_USER 决定，如需修改请编辑启动脚本的环境变量。

安全策略登录与会话

登录失败锁定次数（1~50 次）

锁定时长（分钟，1~1440）

会话有效期（小时，1~720）

达到失败次数后，账号在锁定时长内无法登录；会话超时后需重新登录。

修改管理员密码

当前密码

新密码（至少 6 位）

确认新密码

提示：密码保存在 data/config.json，升级发版不会覆盖。

运行参数主机监控与发版窗口

主机离线判定（分钟，3~1440）

命令超时判定（分钟，3~720）

启用维护窗口（窗口外禁止下发「更新」命令，可用「强制立即执行」豁免）

每日至支持跨午夜，如 22:00 ~ 06:00

数据保留历史数据清理策略

发版包大小上限（MB，10~2048）

命令历史保留条数（50~10000）

发版历史保留条数（10~1000）

操作审计保留条数（50~5000）

超过保留条数的旧记录会在下次写入时自动截断；发版历史记录删除不影响已上传的版本包文件。

Agent 通信客户机接入凭证

Agent 通信密钥（留空则使用启动环境变量 AGENT_TOKEN）

旧密钥宽限

轮换后新密钥立即生效，旧密钥在宽限期内仍可连接，客户机不会断联；请逐台修改客户机 agent.ps1 的 $Token，全部完成后在上方提示中「立即作废」旧密钥，到期也会自动失效。

注意：修改密钥后，已安装的客户机 agent.ps1 里的 $Token 必须同步更新，否则将无法连接中心。密钥保存后立即生效。

数据备份与恢复全量 JSON 导入导出

包含客户主机、命令历史、发版记录、系统设置；不含版本包 zip（升级后重新上传即可）。导入会覆盖当前数据，请谨慎操作。

关于系统运行信息

系统版本

-

数据目录

-

服务端口

-

运行时长

-

已登记主机

-

命令总数

-

? 整体架构：客户机找你，你不用连客户机

本管理中心（1 台）

保存最新版本包
存放待执行命令

客户机每 2 分钟主动来问

只出不进 · 客户机不开任何端口

客户机 A

业务系统 + agent

客户机 B

业务系统 + agent

每台客户服务器上装一个很小的 agent 脚本（Windows 计划任务，每 2 分钟运行一次）。它做三件事：上报本机版本和端口 → 领取你下发的命令 → 执行命令并回报结果。更新、重启、查状态全部自动化，你只需要在本页面点按钮。

安全性：agent 只用出站 HTTPS/HTTP 访问本中心，客户机不开端口、你也不需要知道客户机密码。所有接口都有密钥校验，版本包（整套源码）必须带密钥才能下载。

1 怎么添加新的客户主机

1

点「主机管理」右上角 [+ 添加客户主机]，填一个客户编号（英文，如 client-C）和备注名（如"张先生"）。登记后主机显示为 待上线。

2

把本机 update-center\agent 整个文件夹复制到客户服务器（任意目录，如 C:\gq-agent）。共 3 个文件：agent.ps1、安装agent.bat、卸载agent.bat。

3

用记事本打开 agent.ps1，只改顶部【配置区】前 4 行。选一台已登记的主机，下面自动生成对应配置，直接复制粘贴覆盖：

4

在客户机上右键管理员运行 安装agent.bat。它注册一个 Windows 计划任务（SYSTEM 账户、每 2 分钟一次、无需有人登录）。

5

回到本页等 2 分钟，主机变成绿色在线，版本、端口状态全部自动上报。

注解：$AppRoot 必须指向客户机业务系统根目录（里面要有 start.bat / stop.bat），agent 更新后靠这两个脚本重启服务。$Token 必须和中心一致，否则会被拒绝（403）。卸载主机 = 客户机运行"卸载agent.bat"，再在本页删除记录。

2 怎么更新代码（发版）

1

本地打包：把改好的业务系统整个文件夹压成一个 zip。zip 根目录必须包含一个 versions.json，内容如下（agent 靠它上报版本号）：

{
  "web": "1.2.0",      // 前端版本
  "server": "1.2.0",    // 后端版本
  "bridge": "1.2.0"     // MT5桥接版本
}

2

上传发版：到「发版管理」，填新版本号（和 versions.json 保持一致），选择 zip，点 [上传并发布]。上传时可见进度条，发布后版本号立即生效。

3

推送：点 [向全部在线主机推送更新]；或者到「主机管理」对某一台点 [更新]（适合先给一台试点验证，再全量推）。

4

看结果：2 分钟内客户机领取命令并执行，「最近命令」里每台主机一行结果记录，变绿=成功。主机列表里版本没跟上的会自动标红。

更新过程客户机会自动做这些事（无需人工）：下载 zip → 全量备份旧版到 AppRoot.bak → 暂存客户配置（server\config.json、server\data 等，客户的密钥配置不会丢、不用重新配置）→ 解压覆盖 → 还原配置 → 重启服务 → 健康检查 → 失败自动回滚旧版，并在命令历史里告诉你失败原因。

3 三个命令分别做什么

更新：执行一次完整发版流程（见上）。重启：只执行 stop.bat + start.bat 并做端口健康检查，不换代码，适合服务卡死时远程救急。状态：立刻回报三个端口（前端5000/后端9091/桥接5001）是否存活和当前版本，不改变任何东西。

端口小圆点含义（主机列表"服务端口"列）：绿点=该端口存活。依次为前端5000 / 后端9091 / MT5桥接5001。桥接灰点通常意味着客户机 MT5 终端没开或没登录。

4 更新状态流转与报错处理

命令状态怎么流转：待领取 → 更新中 · 下载新包 → 完成 / 失败。执行中会显示客户机当前做到哪一步：下载新包 → 备份旧版 → 保存客户配置 → 解压新版本 → 还原客户配置 → 重启服务 → 健康检查；如失败则出现"自动回滚中"阶段。

报错自动翻译：客户机返回的报错通常是英文技术信息（PowerShell 异常等）。系统内置报错知识库，命令失败时会自动生成红色诊断卡片：中文原因 + 处理办法，照着做即可；卡片底部保留原始报错，便于深入排查。已覆盖的典型错误：网络不通 / 密钥不匹配(403) / 包不存在(404) / 磁盘空间不足 / 文件被占用 / 权限不足 / zip 损坏 / 健康检查失败 / versions.json 格式错等。

实时盯一台主机：打开主机详情抽屉，它每 3 秒自动刷新，可以看着更新一步步走完。

关于 AI 智能诊断：当前使用规则知识库而非 AI——更新失败是有限集合，规则库零成本、零延迟、离线可用、判断稳定，也不会把客户机报错内容发送到外部服务。如果使用中发现"未知错误"占比升高，再评估接入大模型 API 作为兜底翻译（需要时找开发者开通）。

5 常见问题

主机一直"离线"？

依次检查：客户机计划任务是否存在（运行 schtasks /Query /TN "GoldenQuantUpdateAgent"）→ agent.ps1 里 $CenterUrl 能否从客户机访问（上云后要用 https 域名，不能用 127.0.0.1）→ $Token 是否与中心一致。排查日志：客户机 agent 目录下 agent.log。

全部主机同时离线？

多半是中心服务本身停了。宝塔里找到 Node 项目"update-center"重启即可；数据都在 data 目录的 json 文件里，不会丢。

更新失败了怎么办？

先别慌——失败会自动回滚，客户机仍跑旧版，不影响交易。看「最近命令」里的失败原因；再到客户机看 agent.log。常见原因：zip 里缺 start.bat / 端口被占用 / 磁盘空间不足。修复后重新发版再推一次即可。

客户换了服务器/重装系统？

在新机器上重新装 agent（配置里的 $ClientId 用原来的编号），主机列表会自动恢复绑定，历史命令记录还在。