Studio Web 操作手册

本页是 Studio Web 的任务入口。Studio 集中管理多个现场及其项目，提供远程更新、隧道管理，以及供 TGateway 编辑器连接的脚本分析和代码补全服务；工程发布、现场维护和语言服务的操作分别在对应专题中说明。

首次建立中心机房与边缘现场，请从中心与边缘部署全流程开始，按截图完成接入、发布、采集、同步和维护。

开始使用 Studio

登录与首页确认

访问 http://<服务器IP>:5100，输入用户名和密码后点击“登录”。首次安装的默认用户名为 admin，密码为 111111。登录后直接进入“概览”；修改密码时，点击右上角用户菜单中的“修改密码”。页面会自动加密登录密码；公网或不可信网络应使用 HTTPS，以保护工程包等其他数据的传输。

登录后进入“概览”，确认本机运行工程数量、名称和端口，查看隧道服务、现场在线数量和最近工程。菜单顺序为“概览 → 内网穿透 → 现场管理 → 工程管理 → 软件更新”。

日常现场接入和维护可直接进入“现场管理”。需要本地验证时，可使用“工程管理”，也可以在本机单独运行一个 Gateway，通过其 Web 页面配置和调试。

Studio 完整发布包已带上同版本、对应平台的网关，本机运行直接启动随包程序。运行环境与工程独立内容见工程管理。

外观设置

首次使用默认暗色主题，主色背景文字默认“自动对比”。点击右上角用户菜单中的“主题配置”，可调整外观；“恢复默认”会恢复暗色和自动对比。已经明确保存的主题偏好继续生效，设置保存在当前浏览器。

顶部搜索

点击顶部“搜索”，或按 Ctrl+K（macOS 为 ⌘+K），输入页面或操作名称。使用方向键选择结果，按回车执行，按 Esc 关闭。搜索支持进入工程管理、现场管理、内网穿透和软件更新，也可新建工程、定位工程搜索、切换主题或语言。

使用键盘时，按 Tab 定位左侧菜单，按回车打开页面；导航展开或折叠时均可操作。手机上先展开导航，选中页面后菜单自动收起。

使用前准备

• 明确本次操作的工程名称、目标网关、系统与 CPU 架构，以及是否同时更新网关程序。
• 上传、覆盖、删除或恢复工程前，先确认有可用项目包或 Watchdog 备份。
• 生产发布安排维护窗口，确认采集、规则和数据转发允许短时中断。
• 管理多个站点时，服务名称应包含站点或产线信息，避免选择同名目标。

按任务选择入口

脚本分析与代码补全

Studio 为 TGateway Web 的脚本和自定义节点编辑器提供语言服务，支持成员补全、方法签名、悬停说明和代码诊断。脚本源码在 TGateway 编辑器中维护，正式编译、加载和执行由目标网关完成。

编辑器默认使用官方语言服务；需要在内网分析源码时，可连接自建 Studio。展开编辑器顶部的“Roslyn 服务”，填写能够从当前浏览器访问的 Studio 根地址并连接，按代码编辑、补全与错误定位验证服务状态和补全结果。

软件更新

1. 点击左侧菜单中的“软件更新”，进入独立更新页面，查看当前 Studio 版本、最新发布和本机平台。手机上先展开导航菜单。
2. 点击“下载并校验”。Studio 从官方下载中心下载本机平台的完整发布包；此时本机工程继续运行。
3. 提示发布包已下载并校验后，点击“更新并重启 Studio”，核对版本并确认。本机工程和管理连接会短暂中断。
4. 等待重新连接，页面自动刷新。核对当前 Studio 版本，以及更新前运行的工程是否已恢复；原来停止的工程不会额外启动。
5. 需要更新现场时，进入“现场管理”，按批量更新网关程序操作。

软件更新只安装最新发布，不提供历史版本切换。普通完整发布包支持直接更新；容器、Windows 服务和 systemd 服务按原部署方式更新 Studio。安装目录需要可写，并留出完整包、解压目录和临时备份所需空间。下载或校验失败不会替换程序；更新保留本机工程、现场连接、账号、管理证书和宿主配置。

更新由 Studio 直接完成。被占用的旧程序文件会临时保留为 .del，重启后自动清理。

安装前会再次校验已下载的文件；校验失败时，本机工程继续运行。若程序替换失败，Studio 会恢复已修改的程序文件，并在恢复完成后重新启动此前运行的工程。排除文件占用或权限问题后，可重新下载并校验再试。

检查更新失败时，页面保留本机版本，可点击“检查更新”重试。已下载并校验的包可以继续安装。若更新未完成，先查看页面错误和工程运行状态，再重新检查更新。重新连接超时后可刷新页面确认实际版本，避免重复提交；重新进入页面会读取当前更新回执。

提示下载目录请求超时时，可稍后重新检查。持续出现超时或 HTTP 502 时，确认运行 Studio 的主机能够访问官方下载服务，并将发生时间和完整错误提示提供给服务维护人员，核查下载服务日志中的上游请求故障。目录查询失败期间，本机工程继续运行。

验证、发布与恢复

新建并本地验证工程

1. 进入“工程管理”，点击“新建工程”或“导入工程”。
2. 保存后核对工程名称和本机端口；需要修改端口时，点击端口旁的编辑按钮。该端口只用于本机运行，不会修改现场端口。
3. 点击该工程的“本机运行”，等待状态变为运行中。
4. 点击“打开工程”进入 TGateway Web，核对工程名称、通道、设备和变量数量。
5. 抽查一个采集变量和一个转发目标；暂时无法连接接收端时，先核对目标配置和运行日志，并在接收端可用后完成实际发送验证。

通过标准：工程能正常启动，Web 页面可访问，抽查配置与当前工程一致，运行日志没有持续错误。

发布到 Watchdog

1. 在“现场管理”中新增目标现场，完成接入并执行“测试”。
2. 到 Watchdog Web 创建当前项目备份。
3. 回到“工程管理”选择“上传”，核对目标网关。仅上传配置时保持“同时更新网关程序”未勾选；更新程序前核对随包版本、平台与目标系统及 CPU 架构一致。
4. 上传后到 Watchdog Web 确认项目已应用并检查运行状态；若网关此前手工停止，在允许运行时手工启动或重启。
5. 登录目标 TGateway，抽查采集和转发数据链路。

上传后继续确认目标工程已经启动、采集和转发链路正常。完整上传参数和检查步骤见工程管理。

回传与恢复工程

产品边界

不要在 Studio 上传成功后跳过 Watchdog 与 TGateway 检查，也不要把 Watchdog 在线误认为现场采集和转发正常。

常见问题