设备接入与远程运维控制台
下载设备侧代理部署包 → 现场安装 → 台账看在线状态 → 下发白名单运维命令 → 跟踪指令回执。代理只出站连接云端，现场不需要公网 IP、不需要 VPN、不需要内网穿透。
① 代理部署包下载给现场工程师的独立交付包（zip）
包内含什么：解压后是一个独立目录
plcworks-agent-<设备名>/，里面包含——
① agent/ 设备侧代理源码（Python 3.8+，零第三方必选依赖，只用标准库）；
② agent.conf.json 配置文件；
③ plcworks-agent.service systemd 服务单元；
④ install.sh 一键安装脚本（只新增 / 覆盖，不删现场文件）；
⑤ selfcheck.sh 自检脚本；
⑥ README.md 现场手册（部署步骤、systemd 命令、白名单清单、安全边界、故障排查）。- 第 1 步：把 zip 拷到现场工控机（Linux / Debian / Ubuntu，有
systemd）并解压。 - 第 2 步：只改
agent.conf.json（填device_id、cloud_base、token）——现场不改一行代码。 - 第 3 步：用 root 执行
sh install.sh（装到/opt/plcworks-agent/<设备名>并systemctl enable --now）。 - 第 4 步：跑
sh selfcheck.sh自检，确认 Python 版本、配置项与云端连通性都正常。 - 第 5 步：回本页「设备台账」刷新，设备变成 online 即可下发运维命令。
前置条件只有一条：现场能出站访问云端（默认 https://www.u.org.cn 的 HTTPS 端口）。代理默认走 HTTP 长轮询通道，MQTT 为可选项，现场不需要自建 broker。同一设备重复下载包不会带上任何时间戳与随机数，包内容可复现、可审计。
② 设备台账设备名 / 状态 / 版本 / 主机 / 最后在线 / 传输方式 / 速查联动
| 设备名 | 状态 | 版本 | 主机 | 最后在线 | 传输方式 | 速查 |
|---|
状态判定：最近一次心跳距今 90 秒内为 online（绿），超过为 offline（灰），从未心跳为 unknown（橙）。
③ 指令下发远程运维只支持 6 条白名单命令
二次确认：
reload_config（重载点表配置）与 restart_collector（重启采集进程）属中风险命令，
该命令会中断采集，需二次确认；本页在下发前会弹确认框，确认后指令才带上 confirm: true 入队。
真正的把关在设备侧代理：缺 confirm 的中风险命令代理会直接拒绝执行（回 confirm_required）。④ 指令历史与回执command_id / 命令 / 状态 / ok / 结果摘要 / 错误
| command_id | 命令 | 状态 | ok | 结果摘要 | 错误 |
|---|
结果摘要为回执 JSON 压缩后的单行文本，超长截断；完整回执与日志留在设备侧代理的 state/ 与 logs/ 目录。
说明与边界：远程运维只支持 6 条白名单命令（read_points / ping_gateway / pull_logs / reload_config / restart_collector / firmware_check），
不提供任意命令执行、不提供远程 shell、不下发固件（固件只做版本核对）；反向控制默认不启用。
设备侧代理只出站连接云端，云端不开放任何入站端口，现场不需要公网 IP、不需要 VPN 客户端、不需要内网穿透。
中风险命令会中断采集，请在业务允许的窗口期下发；命令执行结果以设备侧回执为准，本页只展示回执内容。
先用 点表助手把点表与上云配置生成出来，再到本页下载代理部署包交给现场；现场只改 agent.conf.json，不改代码。详见 设备上云工场 · 能力边界 · 价格。
扫码加微信13369210212 · 发照片或图纸，当天给答复