安装灵犀·Studio
在 Windows 工控机、Linux 服务器或触摸屏一体机上安装灵犀·Studio,确认四个服务都在运行,并用浏览器打开登录页。包含部署形态选择、安装命令、端口说明与常见问题。
视频教程 · 灵犀·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 端口对外开放:
| 服务名 | 作用 | 默认监听 |
|---|---|---|
iiot-web | Web 层:提供页面,并把请求转给灵犀·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 入口
运行安装程序#
按目标机系统选择对应的方式:
- 在解压目录中右键
install.bat,选择 以管理员身份运行。 - 弹出图形安装向导,按页面提示确认安装目录、端口和管理员初始密码,开始安装。
不需要界面时,可以在管理员命令提示符中一条命令完成:
install.bat --cli install --yes
默认安装目录 C:\Program Files\IIoTGateway,数据目录 C:\ProgramData\IIoTGateway。四个服务注册为 Windows 服务,开机自动启动。
安装时可以调整的参数
命令行安装时可以追加参数,常用的几个:
| 参数 | 默认值 | 说明 |
|---|---|---|
--web-port | 8080 | Web 层对外端口 |
--backend-port | 8999 | 灵犀·Studio 服务端口(只监听本机) |
--edge-port | 521 | 采集引擎主端口,其余端口按它顺延 |
--bind | 0.0.0.0 | Web 层绑定地址,改成 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 打开:
http://<机器IP>:8080
看到灵犀·Studio 登录页即安装成功。
服务管理命令#
| 操作 | 命令(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 访问。
本机能打开,其它电脑打不开#
- 确认安装时
--bind不是127.0.0.1; - 检查系统防火墙是否放行了 Web 端口(默认
8080); - 在其它电脑上
ping目标机,确认网络互通。
浏览器打开是空白页#
使用 Chrome 或 Edge 的较新版本。系统自带的老版本浏览器可能无法运行页面。
下一步#
这篇文档对你有帮助吗?