Windows 部署

Watchdog 运行包包含 TGateway。先从完整目录启动并验证，再安装 Windows 服务；不要同时运行前台实例和服务实例。

准备运行目录

1. 在下载中心选择 Watchdog，下载与 Windows 系统架构匹配的包。
2. 安装相同架构的 .NET 10 Runtime。可运行 dotnet --list-runtimes 检查是否存在 Microsoft.NETCore.App 10.x。
3. 将完整包解压到固定目录，例如 D:\TGateway\WatchDog。保留 TGateway.Watchdog.exe、appsettings.json、GatewayApp 及包内其他文件。
4. 为运行账号授予该目录的读取、执行和数据写入权限。不要把安装目录放在临时解压目录或个人下载缓存中。

网关参考要求为最低 512 MB 内存、建议 1 GB 以上，存储 8 GB 以上。日志、历史和离线缓存还需按现场保留周期预留空间，见环境准备。

前台启动

在普通 PowerShell 或 Windows Terminal 中执行，路径换成实际目录：

Set-Location 'D:\TGateway\WatchDog'
.\TGateway.Watchdog.exe

当前程序继承启动账号权限，普通启动不要求管理员。目录权限、串口或现场策略有额外要求时，为运行账号配置相应权限；安装系统服务时再使用管理员终端。

保持窗口打开，在本机访问 http://localhost:6200，确认 Watchdog 仪表盘中的 TGateway 正在运行，再访问 http://localhost:6100。账号和工作区核对步骤见启动与首次登录。

本机正常后，再从另一台电脑使用部署主机 IP 访问。远程失败时检查监听地址和 Windows 防火墙；Web 端口与设备协议端口分别确认。

安装 Windows 服务

先用 Ctrl+C 结束前台 Watchdog，确认原进程退出。随后以管理员身份打开 PowerShell：

$watchdogExe = 'D:\TGateway\WatchDog\TGateway.Watchdog.exe'
sc.exe create TGatewayWatchdog binPath= "`"$watchdogExe`"" start= auto DisplayName= "TGateway Watchdog"
sc.exe start TGatewayWatchdog
sc.exe query TGatewayWatchdog
Get-Service TGatewayWatchdog

sc.exe query 应显示 RUNNING，Get-Service 应显示 Running。再次确认两个 Web 页面可访问；服务启动成功不等于设备数据已验证。

示例服务默认以 LocalSystem 运行。若改用专用服务账号，在 Windows“服务 → TGateway Watchdog → 属性 → 登录”设置账号，并赋予发布目录、项目数据及所用设备的访问权限。服务账号不能直接使用其他登录会话里的映射盘。

Watchdog 会从自身程序目录启动，并使用同目录下的 GatewayApp；移动安装位置后，需要同步修改服务的可执行文件路径。

查看日志与管理服务

按需要执行以下服务命令，不要在采集期间随意重启：

sc.exe stop TGatewayWatchdog
sc.exe start TGatewayWatchdog
sc.exe query TGatewayWatchdog

停用并卸载服务时，先确认已完成现场停机与备份，再执行：

sc.exe stop TGatewayWatchdog
sc.exe delete TGatewayWatchdog

删除服务注册不会删除运行目录和项目数据。服务正在停止时，等待其退出后再替换文件。

更新与恢复

网关程序更新优先使用 Studio 的批量更新网关程序，按平台选择发布包，并在完成后核对版本和业务数据。

需要更新 Watchdog 宿主或移动整个安装目录时：

1. 在 Watchdog 备份管理中创建备份，并下载到另一位置。
2. 记录当前服务路径、运行账号和端口；安排维护窗口后停止服务。
3. 对已停止的完整运行目录保留副本，包括 appsettings.json、GatewayApp、CurrentProject、Projects 和 Backups。不要在网关仍写入时只复制 SQLite 主文件。
4. 按发布说明更新程序，保留现场配置和数据；不要用新包的初始数据库覆盖现场数据库。
5. 启动服务，依次核对 Watchdog 状态、Runtime 版本、当前工程、一个已知变量和实际接收端的新数据。失败时先保留日志，再恢复停机前副本及原服务路径。

常见启动问题

更多诊断见故障排查。