连接远程 Runtime target
本页只完成一项任务：把当前 App 连接到另一台工控机、边缘设备或现场服务器上的 Runtime target（运行目标）。如果还不确定是否需要远程目标，请先阅读 Runtime 与现场交付。
连接和绑定不会上传工程、替换 App 或改变运行状态。完成本页后，再按交付计划执行 Build、Start 或 Debug。
开始前
- 取得目标的准确名称和完整访问地址，例如
https://runtime.example.com。 - 确认开发电脑能访问目标网络，并且远程地址使用受信任的 HTTPS。
- 准备该目标自己的
Admin账户。首次初始化时，先确定第一个 Admin 的负责人和恢复方式。 - 确认这是测试目标还是生产目标，并取得连接现场网络所需的批准。
目标账户、Qixin 在线服务账号和 App user 的职责不同。需要判断该用哪个账户时，参见 Runtime target 账户与权限。
连接生产目标前，核对设备、现场位置、网络和证书。名称相似或地址可访问，都不能证明它就是本次任务批准的目标。
添加并检查目标
- 打开目标 App 的编辑器。
- 在顶栏打开 Runtime target 选择器，然后进入管理运行目标。
- 选择新增运行目标。
- 填写便于现场识别的名称和完整访问地址。
- 地址只包含协议、主机和端口。
- 不要添加
/api、Page 路径、查询参数或账户信息。
- 选择保存。
- 在目标行选择检查。
- 确认目标显示可访问，并核对返回的设备信息与现场记录一致。
如果检查失败，先解决地址、DNS / IP、端口、防火墙、网络或证书问题，不要继续尝试授权。
连接并绑定当前 App
- 在已检查的目标行选择连接。
- 按目标当前状态继续：
- 目标尚未初始化：创建第一个目标 Admin，并按现场流程保存恢复信息。
- 目标已经初始化：使用该目标自己的 Admin 登录。
- 授权成功后，把目标绑定到当前 App。
- 重新打开 Runtime target 选择器，核对以下信息：
- 名称和访问地址正确；
- 状态为已绑定和可访问；
- 当前目标会话为
Admin。
绑定只影响当前 App 后续的 Preview、Build、Start 和 Debug。其他已打开 App 的目标绑定不变，当前 App 的本机文件、Git 和 AI 会话也不会移动到远程目标。
成功标准
- 当前 App 顶栏显示批准的远程目标名称。
- 目标详情同时显示已绑定、可访问和
Admin。 - 名称、地址和设备信息与测试或生产记录一致。
- 目标上已有的 App 和运行状态没有因为连接而改变。
现在可以回到 Runtime 与现场交付 继续保存、Build、Start 和验收闭环。需要配置现场终端时，参见在现场终端使用 Theseus Player。
常见问题
目标显示“不可访问”
检查地址、DNS / IP、端口、现场网络、防火墙和目标是否在线。确认地址中没有附加 API 或 Page 路径。
目标可访问，但提示需要 HTTPS
改用该目标受信任的 HTTPS 地址，或按现场规范建立安全网络通道。不要通过关闭证书检查来绕过要求。
目标显示“需要初始化”
这是尚未建立目标账户的设备。由指定负责人创建第一个 Admin，并记录凭据保管和恢复责任；不要在不清楚设备归属时初始化。
目标显示“需要管理员”或无法绑定
当前目标会话不是 Admin，或者会话已经失效。使用该目标自己的 Admin 重新连接。Qixin 登录或 App 内的 Admin 角色不能替代它。
已绑定，但看不到当前 App
这是预期行为：连接不会交付工程。核对目标上的现有 App 和状态后，按Build 与运行验收执行 Build；如果需要替换另一 App，先取得停机批准。
必须人工确认
- 目标名称、地址、设备和现场位置属于同一台批准设备。
- HTTPS 证书和网络链路符合现场安全要求。
- 当前人员确实被授权使用目标 Admin。
- 连接生产目标不会被误认为已经完成部署或生产放行。