快速入门（5分钟）
假定安装已完成。从连接一台 PLC 并确认值能传入开始指导。
如果您需要从头开始安装，请参阅 单线安装（2026.05+ 容器模式），或者
install.sh 在首次安装时会为每台盒子生成随机密码，并一次性输出到 /etc/kopens/credentials.txt
(chmod 0600 root)。如果 UI 首次登录密码不是默认值，请通过盒子 SSH 使用
sudo cat /etc/kopens/credentials.txt 查看。
1. 访问界面
在 Web 浏览器中打开网关地址。
http://<gateway-ip>/
| 项目 | 值 |
|---|---|
| 默认 ID | admin |
| 默认密码 | admin123! |
请尽快更改您首次收到的默认密码。在右上角齿轮形状的 [环境设置]
菜单中修改 edge.admin_password 并点击 保存并重启 即可 —
更改密码 · API 密钥。
登录后即可看到主界面。显示 CPU / 内存 / 磁盘使用率仪表盘和 PLC 连接状态。 该界面中应该首先关注什么，上面的视频会带您过一遍 — PLC 连接数和 读取成功/失败次数，这两项说明网关是否在正常工作。
2. 进入 [连接] 菜单
点击顶部菜单中的 [连接] 。
- 如果是首次访问，会看到空白的 [连接列表] 表。
- 点击右上角的蓝色 [添加连接] 按钮继续。
3. 选择 PLC 类型
点击 [添加连接] 后，会出现「请选择要注册的 PLC 或协议」界面。请点击与您设备类型匹配的卡片。
| 您拥有的设备 | 选择的卡片 |
|---|---|
| 像 Kepware 这样的 OPC-UA 服务器 | OPC-UA |
| 通用 Modbus TCP 从站（大多数测量仪表） | Modbus |
| 三菱 PLC | MELSEC (三菱) |
| 西门子 PLC | S7 (西门子) |
| LS ELECTRIC PLC | LS |
| AB / Rockwell PLC | EtherNet/IP |
| 外部系统将要发送值过来 | HTTP |
| 没有 PLC 只想测试一下 | 模拟器 |
如果初次使用且没有 PLC，建议从 模拟器 开始。因为会自动生成模拟 PLC 数据，易于先熟悉界面操作。
4. 填写注册表单
根据所选的 PLC 类型，输入字段略有不同，但通常都会询问以下信息。
| 输入字段 | 填写内容 |
|---|---|
| 连接名称 | 界面上显示的名称（例如：1라인 미쓰비시） |
| IP 地址 | PLC 的 IP 地址（例如：192.168.0.60） |
| 端口 | PLC 的通信端口（各 PLC 页面有默认值说明） |
| 采集周期 | 每隔多少毫秒读取一次（通常为 1000 = 1 秒） |
| 自动启动 | 网关重启时是否自动开始采集 |
有关各 PLC 的详细输入说明，请参阅 各 PLC 类型指南 页面。
5. 注册标签（= 要读取的值）
只注册 PLC 连接，不会获取任何值。需要注册要读取哪个地址的值，这称为 [标签]。
| 输入字段 | 填写内容 |
|---|---|
| 标签名称 | 界面上显示的名称（例如：펌프1 RPM） |
| PLC 地址 | PLC 手册或现有 SCADA 中使用的地址（例如：三菱 D100） |
| 数据类型 | Float、Integer、Boolean、String 之一 |
格式辅助（format） | 如果是 32 位，则为 DW；如果是浮点数，则为 REAL 等（参见各 PLC 页面） |
详情请查看 标签注册 页面。由于不同 PLC 的地址表示方法不同，结合您自己 PLC 类型的页面一起参考是最快的。
6. [保存] → 自动开始采集
点击 [保存] 按钮后，网关会尝试连接 PLC 并立即开始采集数据。请稍等片刻。 通常在 1~3 秒内会收到第一个值。
7. 确认值是否正常传入
返回 [连接] 菜单，左侧会显示已注册的 PLC。
- 卡片上的采集徽章为绿色 「正常」 ，并且右侧的连接图标也是 绿色（工具提示「连接」）即为 OK
- 点击 PLC，右侧会显示已注册的标签列表和 当前值，每 5 秒自动刷新。
如果连接图标为 红色（工具提示「断开」） ，请检查 IP / 端口 / 防火墙。详细的排查流程请参阅 故障排除 页面。
下一步
| 接下来可以尝试的事项 | 页面 |
|---|---|
| 对值应用单位转换（例如：将整数 raw 值 ×0.1 转换为浮点数） | 应用计算公式 |
| 在同一 PLC 上注册多个标签 | 标签注册 |
| 查看时序图形 / 历史记录 | 查看采集历史 |
| 遇到问题 | 故障排除 |