安装灵犀·Studio

在 Windows 工控机、Linux 服务器或触摸屏一体机上安装灵犀·Studio,确认四个服务都在运行,并用浏览器打开登录页。包含部署形态选择、安装命令、端口说明与常见问题。

  • 入门
  • 动手约 20 分钟
  • 阅读 4 分钟
  • 更新于 2026-11-08

视频教程 · 灵犀·Studio 从入门到精通 · 第 2 集 6:26

安装部署与首次登录

你将完成

读完本篇你将完成:

  • 根据现场条件选好部署形态和安装包;
  • 在目标机器上完成安装,四个服务全部运行;
  • 用浏览器打开 http://<机器IP>:8080 看到登录页。

开始之前

  • 一台 Windows x64、Linux x86_64 或 Linux ARM64 的机器,并拥有管理员(root)权限;
  • 已从下载中心取得与系统、架构对应的安装包(需要试用凭据登录);
  • 目标机的 8080 端口未被其它程序占用(被占用时见文末「常见问题」)。

选择部署形态#

灵犀·Studio 是一套装在你自己机器上的服务,数据全部留在厂内。同一套程序可以装在下面几类机器上:

部署形态系统与架构典型用法
服务器Windows x64、Linux x86_64机房集中部署,多个车间通过浏览器访问
工控机Windows x64、Linux x86_64装在电柜旁,就近采集一条产线
触摸屏一体机Linux ARM64(RK3568,1024×600 屏)安装后开机全屏显示组态画面,现场直接操作
桌面客户端连接已安装的服务工程师电脑上以独立窗口使用,本身不采集数据

安装包内已经带齐运行所需的全部组件,目标机不需要预先安装数据库或其它运行环境,安装过程也不需要联网。

安装后机器上有什么#

安装完成后,机器上运行四个服务,只有 Web 层的 8080 端口对外开放:

一台机器上的灵犀·Studio 服务与端口浏览器、桌面客户端和触摸屏只访问 Web 层的 8080 端口;Web 层转发给只监听本机 8999 端口的灵犀·Studio 服务;服务再调用只监听本机的采集引擎(521 到 525)与配置生成服务(526);采集引擎通过工业协议连接现场设备。访问端浏览器桌面客户端触摸屏一体机8080安装灵犀·Studio 的机器工控机 / 服务器 / 触摸屏一体机Web 层0.0.0.0:8080灵犀·Studio 服务127.0.0.1:8999采集引擎127.0.0.1:521~525配置生成服务127.0.0.1:526只有 8080 对外开放,其余端口只监听本机工业协议现场设备PLC仪表变频器
图 1 浏览器、客户端和一体机只访问 8080;其余服务只监听本机,由灵犀·Studio 服务统一调用
服务名作用默认监听
iiot-webWeb 层:提供页面,并把请求转给灵犀·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

为什么只开放一个端口

采集引擎直接面对现场设备,所有读写都要经过灵犀·Studio 服务的权限校验和审计。因此除 8080 外的端口都只监听本机,局域网里的其它电脑无法直接访问。

安装步骤#

把安装包拷到目标机并解压#

安装包是一个压缩文件,解压后的目录结构如下:

安装包目录
iiot-gateway-<版本>-<系统>-<架构>/
├── bin/iiot-installer       # 安装与服务管理程序(Windows 为 .exe)
├── payload/                 # 全部程序与运行环境
├── install.sh               # Linux 入口
└── install.bat / install.ps1  # Windows 入口

运行安装程序#

按目标机系统选择对应的方式:

  1. 在解压目录中右键 install.bat,选择 以管理员身份运行。
  2. 弹出图形安装向导,按页面提示确认安装目录、端口和管理员初始密码,开始安装。

不需要界面时,可以在管理员命令提示符中一条命令完成:

Windows 命令行安装
install.bat --cli install --yes

默认安装目录 C:\Program Files\IIoTGateway,数据目录 C:\ProgramData\IIoTGateway。四个服务注册为 Windows 服务,开机自动启动。

安装时可以调整的参数

命令行安装时可以追加参数,常用的几个:

参数默认值说明
--web-port8080Web 层对外端口
--backend-port8999灵犀·Studio 服务端口(只监听本机)
--edge-port521采集引擎主端口,其余端口按它顺延
--bind0.0.0.0Web 层绑定地址,改成 127.0.0.1 则只允许本机访问
--enable-firewall关闭打开后系统防火墙只放行 Web 端口
--dir / --data-dir见上文安装目录 / 数据目录

检查服务状态#

安装程序会把自己复制到安装目录的 bin 下,之后用它查看和管理服务:

查看服务状态(管理员命令提示符)
"C:\Program Files\IIoTGateway\bin\iiot-installer.exe" status

四个服务都应显示为运行中。再在目标机上检查两个健康接口:

健康检查(在目标机上执行)
curl http://127.0.0.1:8999/health
curl http://127.0.0.1:8080/healthz

第一个返回 "status":"ok" 表示灵犀·Studio 服务正常。

用浏览器打开登录页#

在同一局域网的电脑上,用 Chrome 或 Edge 打开:

text
http://<机器IP>:8080

看到灵犀·Studio 登录页即安装成功。

预期结果

  • iiot-installer status 显示四个服务都在运行;
  • 健康检查返回正常;
  • 浏览器能打开登录页。

接下来按首次登录与初始化登录并修改初始密码。

服务管理命令#

操作命令(Linux 示例,Windows 换成 iiot-installer.exe 并以管理员运行)
查看状态sudo /opt/iiot-gateway/bin/iiot-installer status
启动全部服务sudo /opt/iiot-gateway/bin/iiot-installer start
停止全部服务sudo /opt/iiot-gateway/bin/iiot-installer stop
重启全部服务sudo /opt/iiot-gateway/bin/iiot-installer restart
卸载服务,保留数据sudo /opt/iiot-gateway/bin/iiot-installer uninstall

卸载时不要随手加 --purge

uninstall --purge 会连同安装目录和数据目录一起删除,组态工程、点位配置、历史数据都无法恢复。需要彻底清除前,先做备份。

日志位于数据目录下的 logs 子目录,例如 Linux 的 /var/lib/iiot-gateway/logs,文件名形如 iiot-backend.out.log。

常见问题#

8080 端口已被占用#

目标机上已有其它程序(例如 Docker 服务)占用了 8080 或 8999。安装时整体换一组端口:

换端口安装
sudo ./install.sh --cli install --yes --web-port 18080 --backend-port 18999 --edge-port 1521

之后用 http://<机器IP>:18080 访问。

本机能打开,其它电脑打不开#

  1. 确认安装时 --bind 不是 127.0.0.1;
  2. 检查系统防火墙是否放行了 Web 端口(默认 8080);
  3. 在其它电脑上 ping 目标机,确认网络互通。

浏览器打开是空白页#

使用 Chrome 或 Edge 的较新版本。系统自带的老版本浏览器可能无法运行页面。

下一步#

这篇文档对你有帮助吗?