查端口与防火墙
安装后只有 Web 端口对局域网开放,默认 8080。灵犀·Studio 服务、采集引擎和配置生成都只监听本机。工控机防火墙放行 Web 端口即可。
你将完成
读完本篇你将完成:
- 分清哪些端口要在防火墙上放行,哪些必须留在本机;
- 知道改过
--web-port之后,浏览器和防火墙要一起改; - 知道访问 PLC 时,要通的是设备上的协议端口,不是网关这些监听端口。
开始之前
- 已按安装与部署完成安装,或准备安装;
- 知道现场电脑是通过浏览器访问工控机,而不是直连采集引擎。
谁在听哪个端口#
安装完成后四个服务都在跑。浏览器、车间大屏和触摸屏一体机只访问 Web 层。其余端口绑定在 127.0.0.1,局域网里的其它电脑连不上,也不应该放行。
| 服务 | 作用 | 默认监听 | 防火墙 |
|---|---|---|---|
iiot-web | 页面,并把 /api 等请求转给灵犀·Studio 服务 | 0.0.0.0:8080 | 放行。这是唯一对局域网开放的端口 |
iiot-backend | 灵犀·Studio 服务:权限、存储、组态、规则、开放接口 | 127.0.0.1:8999 | 不放行 |
iiot-edgeserver | 采集引擎:与现场设备通讯 | 127.0.0.1 上的 521(主端口)、522、523、525 | 不放行,仅本机 |
iiot-sidecar | 为采集引擎生成设备配置 | 127.0.0.1:526 | 不放行,仅本机 |
实时推送走 Web 端口上的同一条站点,不另开端口。所以防火墙规则里只需要 Web 端口,不需要为「实时数据」再开一档。
安装向导只在安装过程中临时监听 9080。装完就可以关掉,不必写进长期防火墙策略。
为什么采集引擎不对局域网开放
采集引擎直接读写现场设备。所有读写都经过灵犀·Studio 服务的权限和审计。把 521 到 526 或 8999 暴露到车间网,等于绕过这层控制。
安装时改过端口怎么办#
命令行参数的默认值:
| 参数 | 默认 | 改了之后 |
|---|---|---|
--web-port | 8080 | 浏览器改用 http://<机器IP>:<新端口>,防火墙放行这个新端口,不再放行 8080 |
--backend-port | 8999 | 仍然只监听本机,防火墙不用放行 |
--edge-port | 521 | 采集引擎主端口。522、523、525 以及配置生成用的 526 随它顺延,全部仍是仅本机 |
--bind | 0.0.0.0 | 改成 127.0.0.1 时,连 Web 端口也只允许本机打开 |
--enable-firewall | 关闭 | 打开后,安装程序让系统防火墙只放行 Web 端口 |
8080 或 8999 已被占用时,三个端口一起换,例如 --web-port 18080 --backend-port 18999 --edge-port 1521。不要只改 Web、留下和旧程序冲突的本机端口。
要去连 PLC 时#
下表是设备侧的常见协议端口,工控机是主动连出去,不是在这些端口上听。防火墙若限制出站,放行到设备 IP 的对应端口;不需要在工控机上对局域网开放它们。
| 协议 | 设备上的常见端口 | 文档 |
|---|---|---|
| Modbus TCP | 502 | 接入 Modbus TCP 设备 |
| 西门子 S7 | 102 | 接入西门子 S7 |
| 三菱 MC(Q 系列以太网) | 5007 | 接入三菱 MC |
| 欧姆龙 FINS-TCP / FINS-UDP | 9600 | 地址与数据类型速查 |
具体以设备手册和添加设备时填的端口为准。内置仿真设备的端口显示在 PLC模拟器 页面的「采集网关接入」上,不要套用 502。
怎样确认#
在工控机上:
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/healthz
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8999/health
两端都应返回 200。换过端口时,把命令里的端口改成实际值。
另一台电脑上只测试 Web 端口:浏览器打开 http://<工控机IP>:8080 应看到登录页。若本机可以、其它电脑不行,按顺序查:
--bind是不是127.0.0.1;- 系统防火墙有没有放行 Web 端口;
- 中间交换机或上层防火墙有没有只允许部分端口。
不要为了「其它电脑打不开」去放行 8999 或 521。
常见问题#
页面能开,实时值不刷新#
页面和实时推送都在 Web 端口上。先看网络配置与诊断里到设备的 Ping 和端口检测,再看点位是否已下发。这不是防火墙少开了一个「实时端口」。
安装向导 9080 打不开#
向导只在安装程序运行期间存在。安装已经结束时,改访问 Web 端口。向导还在跑但打不开,检查当时有没有改向导端口,以及本机防火墙是否挡住了这一个临时端口。
下一步#
这篇文档对你有帮助吗?