Studio 现场管理

“现场管理”集中维护各现场的 Watchdog 和 Gateway 入口，可测试管理连接、查看网关进程、打开现场界面、管理备份，并作为工程上传和回传的目标来源。管理连通与业务数据同步分别配置、分别验证。

首次部署请按中心与边缘部署全流程操作，包含安装、自动隧道、工程发布、SyncBridge / MQTT、可选 TLS 和运行验收步骤。

本页负责多个现场的连接、远程维护与批量程序更新。工程管理负责本地工程验证与发布回传，Watchdog 手册负责单个现场的项目应用、日志与进程守护。

接入前准备

使用前准备

• 确认 Watchdog Web 能从 Studio 服务器访问，并准备 Watchdog 地址、端口和有效账号。
• 远程上传、恢复或进程控制前，确认目标 Watchdog 已允许相应远程管理能力。
• 生产项目操作前先确认目标网关身份，避免把工程或备份应用到同名的其它站点。

页面入口

菜单路径：Studio Web > 现场管理。

点击现场的“操作”菜单，可打开带图标的“现场运维”入口，或编辑、删除该现场连接。“现场运维”打开 Watchdog，“网关界面”打开 Gateway，两者使用各自的账号。

状态含义

接入现场并测试连接

接入现场

1. 点击“新增现场”，选择“边缘主动连接中心”。填写现场名称、中心可访问主机、现场 Watchdog 端口、Gateway 端口和 Watchdog 账号。中心主机只填域名或 IP，不含协议、端口或路径。
2. 保存后，在现场的“操作”菜单选择“生成现场接入码”。核对中心 Studio 地址能从现场访问。
3. 在现场 Watchdog 打开“隧道管理 → 连接中心”，填写中心 HTTP/HTTPS 地址和接入码，点击“接入并连接”。
4. Watchdog 自动保存两条隧道配置并连接中心。检查两条均为“已连接、已绑定”，再回到 Studio 测试现场并打开“网关界面”。

接入码不代替管理账号；重新生成、修改或删除现场以及 Studio 重启会使尚未使用的码失效。关闭码面板后不再显示原码。需要再次接入时重新生成即可，无需下载或导入管理接入包。

局域网内可以选择“局域网直连”，直接填写 Watchdog 地址和端口。HTTP/HTTPS 管理与 TCP/TLS 隧道独立配置，TLS 不强制。私有 CA 的配置及 Watchdog 导入 Studio 信任证书步骤见管理证书维护。

新增或编辑现场

点击“新增现场”，或在已有现场的“操作”菜单中点击“编辑”，打开配置抽屉。

保存后建议立即点击“测试”。测试成功只表示 Studio 能访问 Watchdog；目标 TGateway 是否能正常运行，还要看网关状态和 Watchdog 日志。

Studio 使用保存的 Watchdog 账号和密码自动登录，并加密传输登录密码。连接测试、状态刷新、上传下载和备份管理都会自动完成登录验证。Watchdog 重启后，Studio 会自动重新登录并重试一次。

连接测试

测试失败时按顺序检查：

1. 浏览器或服务器能否访问 http://<Watchdog地址>:<端口>。
2. Watchdog Web 是否能用同一账号密码登录。
3. 防火墙是否放行 Watchdog 端口。
4. Watchdog 服务是否启动。
5. 如果通过隧道访问，确认 Studio Broker 和 Watchdog Client 都已绑定成功。

备份、上传与回传

备份与恢复现场连接

备份或迁移 Studio 中保存的现场连接时，先停止 Studio，将运行目录中的 Data/watchdog_configs.json 和 Data/studio_credentials.key 一起备份。恢复时将两个文件一起放回目标 Studio 的 Data 目录，再启动服务。密钥文件用于恢复已保存的密码和现场接入信息，必须与连接配置一起保留。

如果密钥丢失，或原连接配置无法解密，先停止 Studio，将原 Data/watchdog_configs.json 移到备份位置，再启动 Studio 并重新添加现场、填写 Watchdog 账号密码。使用“边缘主动连接中心”的现场还需生成新的接入码，并在 Watchdog 重新接入。

备份管理

在 Watchdog 卡片或列表操作中点击“备份”，打开备份抽屉。

备份面板会显示名称、类型、工程、创建时间、大小及操作；长名称可以换行。在窄窗口中可横向滚动查看各列，恢复和删除操作固定在右侧。

恢复前核对确认框中的现场、备份名称、工程及范围。“工程备份”保留已安装网关程序；“工程及网关程序包”覆盖其携带的程序文件；“工程和网关程序快照”将工程和完整程序一起回退。两类程序恢复均应安排维护窗口，现场缓存始终保持不变。

恢复后核对网关运行状态和业务数据。Studio 本机副本不会随现场恢复改变；需要时重新下载工程。

与项目上传联动

“工程管理”页面上传工程时，目标网关列表来自本页面保存的 Watchdog 服务。

上传前后的备份、平台匹配与数据验收统一按工程发布检查执行。本页只维护目标现场连接，测试在线后仍需验证现场 TGateway 的采集和转发。

与工程下载联动

“工程管理”页面点击“从网关下载”时，源网关同样来自本页面保存的 Watchdog 服务。

下载工程适合现场配置回传、故障复现和版本比对。当前工程下载取得在线最新内容，非当前工程下载取得已保存内容。覆盖同名本机工程前先停止本机运行；覆盖保留原本机工程标识、创建时间和本机端口。下载后可在 Studio 打开编辑、本机验证，再上传回 Watchdog；工程内容及覆盖规则见工程管理。

Web 分工与数据同步

与 Watchdog Web 的分工

配置中心与边缘数据同步

在现场点击“数据同步”，填写中心 Gateway 管理地址及两端 Gateway 账号。现场管理地址来自该现场登记；Gateway 和 Watchdog 使用独立账号，密码仅用于当前操作，关闭同步面板或离开页面后清空。

1. 选择 GatewayMqtt 或 SyncBridge，填写现场能够访问的中心数据主机及监听端口。管理地址与数据端口是两个独立入口。
2. 按需开启 使用 TLS，默认关闭。开启后自动生成并安装证书：中心保留 CA 私钥及服务端证书，现场只接收公有 CA；SyncBridge 另为每个现场签发包含私钥的客户端证书。
3. 点击 连接两端。该步骤只登录并检查插件，读取现场已启用的转发组。没有组时先在现场 Gateway 的数据转发页创建，再重新连接。
4. 选择要同步的现场转发组。保留其现有变量范围与触发方式，系统不会自动把现场全部变量加入同步。
5. 点击 配置并启用。Studio 保存中心配置和现场目标，然后查询真实数据连接。MQTT 在收到首次快照后继续创建或更新该现场的中心变量。页面逐项展示结果；失败时保留已完成步骤，可修复后重试。

GatewayMqtt 自动建立中心 GatewayMqttCollectServer 和现场 MqttClientProducer。多个现场使用同一中心地址及数据端口时复用中心监听，按现场身份合并来源并保留已有来源。重复执行复用对象和认证密码；不会每次生成新密码。使用外部 Broker 时仍在 Gateway 原插件编辑器中配置 GatewayMqttCollectClient。

SyncBridge 自动建立中心 HubServer 及现场 EdgePublisher，同步所选变量配置和最新值。TLS 模式执行双向证书验证；非 TLS 模式保留身份和令牌验证。自动生成的私有证书不提供在线吊销查询，部署时关闭该项查询，继续验证证书链、有效期、主机名和节点身份。新建链路默认关闭远程写入 / RPC。

同一中心监听的 TLS 模式必须保持一致。需要切换时使用另一个数据端口，或在 Gateway 中维护整条链路。自动证书可以在各 Gateway 的证书管理中查看、维护；同名证书不一致、过期或用途错误时明确报错，不静默覆盖。管理 HTTPS 的信任关系仍在 Studio 证书维护中配置；开启数据 TLS 不会自动改写管理入口。

“两端配置已保存”表示中心和现场的配置均已保存；“数据连接已确认”还要求 MQTT 首次快照和中心变量应用完成，或 SyncBridge 已连接并收到配置修订。MQTT 变量存在冲突或数据类型变化时停止自动应用，需在中心采集设备调试页核对同步计划后重试。随后可在中心插件调试页核对变量值。管理在线不能代替数据同步成功，最新值同步也不等同于完整历史补传。

验证结果

1. 保存服务后点击“测试”，确认 Watchdog 状态为在线并能读取版本。
2. 核对 TGateway 状态；显示停止或未知时，先到 Watchdog Web 查看日志。
3. 打开备份抽屉，确认能读取目标站点的备份列表。
4. 在“工程管理”上传或下载抽屉中确认该服务可被选择，且名称、地址对应正确站点。

连接测试成功只证明 Studio 能访问 Watchdog；工程发布还必须按工程管理完成目标 TGateway 和数据链路验证。

批量更新网关程序

1. 在卡片或表格中勾选要更新的现场，点击“批量更新网关程序”。手机卡片同样支持勾选。
2. 等待正式发布目录与现场状态加载，核对目标名称、最新网关版本及现场平台。同一批次应选择相同平台、处于在线状态的现场；不同平台分批操作。
3. 点击更新并确认。Studio 下载对应平台的完整现场发布包，校验文件完整性后，将其中的网关程序上传给 Watchdog。现场平台可以与 Studio 本机不同。
4. 查看逐个现场的结果。成功后打开网关界面，核对程序版本、当前工程、采集和转发；部分失败时按该现场的具体错误处理。

手机上勾选现场卡片左上角的复选框，再点击工具栏中的批量操作。筛选和切换视图后仍保留有效选择，提交前应核对面板中的全部目标名称。

离开“现场管理”会关闭更新面板，尚未完成确认的更新不会提交。已经提交的更新会继续执行；返回后刷新现场状态，核对实际网关版本和运行结果，避免重复更新。

此操作更新网关程序，保留 Watchdog 宿主、当前工程、现场配置、数据库、脚本、自定义节点、规则、证书和 PluginCache。运行中的网关会重启，原来手工停止的网关保持停止。Watchdog 在更新前创建安全备份；需要回退时，在备份列表核对“工程和网关程序快照”范围再恢复。

下载或校验失败时不会向现场提交程序。现场程序更新的临时停机、健康检查与失败恢复由目标 Watchdog 执行，完成后仍应检查实际业务数据链路。

若显示“检查更新失败”，检查 Studio 到下载服务的网络连接后，在原侧栏点击“检查更新”重试，已选现场保持不变。“暂时没有可用的发布包”表示目录查询成功但尚无发布；只有目录加载成功后才会提示缺少对应平台的网关包。

下载目录请求超时时，可稍后重新检查。持续出现超时或 HTTP 502 时，记录发生时间和完整错误提示，交由下载服务维护人员核查上游请求日志。目录查询失败不会向现场提交程序。

常见问题