快速开始 — 五分钟连接第一台PLC
本文假定安装已完成。我们将引导您连接一台PLC并验证数据是否正确流入。
如需重新安装，请参考 快速安装（2026.05+ 容器模式）或 完整硬件安装（legacy 本地模式）。
2026.05+ 盒子的初始密码
install.sh 在首次安装时为每台盒子生成随机密码，并在 /etc/kopens/credentials.txt（chmod 0600 root）中只打印一次。如果UI首次登录密码不是默认密码，请通过SSH连接盒子用 sudo cat /etc/kopens/credentials.txt 确认。
1. 访问网页界面
在网络浏览器中打开网关地址。
http://<gateway-ip>/
| 项目 | 值 |
|---|---|
| 默认用户名 | admin |
| 默认密码 | admin123! |
更改密码
请尽快更改收到的默认密码。在右上角齿轮形状的[环境设置]菜单中修改 edge.admin_password，然后保存后重启 — 详见 密码·API密钥变更。
登录后会显示主界面。上面显示CPU/内存/磁盘使用率仪表以及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页面标注默认值） |
| 采集周期 | 多久读取一次，单位ms（通常 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。
- 如果连接状态栏显示绿色"正常连接"，说明正常
- 点击PLC，右侧会显示注册的标签列表及当前值，每5秒自动刷新一次。
如果显示红色"连接失败"，请检查IP/端口/防火墙。详细排查流程请参考 故障排除 页面。
下一步
| 接下来可以尝试的操作 | 页面 |
|---|---|
| 对值应用单位转换（例：整数原始值乘以0.1转为小数） | 应用计算公式 |
| 在同一PLC上注册多个标签 | 标签注册 |
| 查看时序图表/采集历史 | 查看采集历史 |
| 遇到问题 | 故障排除 |