查端口与防火墙

安装后只有 Web 端口对局域网开放,默认 8080。灵犀·Studio 服务、采集引擎和配置生成都只监听本机。工控机防火墙放行 Web 端口即可。

  • 入门
  • 动手约 8 分钟
  • 阅读 3 分钟
  • 更新于 2026-11-09

你将完成

读完本篇你将完成:

  • 分清哪些端口要在防火墙上放行,哪些必须留在本机;
  • 知道改过 --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-port8080浏览器改用 http://<机器IP>:<新端口>,防火墙放行这个新端口,不再放行 8080
--backend-port8999仍然只监听本机,防火墙不用放行
--edge-port521采集引擎主端口。522、523、525 以及配置生成用的 526 随它顺延,全部仍是仅本机
--bind0.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 TCP502接入 Modbus TCP 设备
西门子 S7102接入西门子 S7
三菱 MC(Q 系列以太网)5007接入三菱 MC
欧姆龙 FINS-TCP / FINS-UDP9600地址与数据类型速查

具体以设备手册和添加设备时填的端口为准。内置仿真设备的端口显示在 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 应看到登录页。若本机可以、其它电脑不行,按顺序查:

  1. --bind 是不是 127.0.0.1;
  2. 系统防火墙有没有放行 Web 端口;
  3. 中间交换机或上层防火墙有没有只允许部分端口。

不要为了「其它电脑打不开」去放行 8999 或 521。

常见问题#

页面能开,实时值不刷新#

页面和实时推送都在 Web 端口上。先看网络配置与诊断里到设备的 Ping 和端口检测,再看点位是否已下发。这不是防火墙少开了一个「实时端口」。

安装向导 9080 打不开#

向导只在安装程序运行期间存在。安装已经结束时,改访问 Web 端口。向导还在跑但打不开,检查当时有没有改向导端口,以及本机防火墙是否挡住了这一个临时端口。

下一步#

这篇文档对你有帮助吗?