iotechsys/opc-ua-browser

OPC UA Browser Client 镜像文档

1. 镜像概述

OPC UA Browser Client 是一个轻量级的 OPC UA 客户端 UI 工具，旨在提供直观的图形界面，用于连接、浏览和交互 OPC UA 服务器。该镜像封装了完整的客户端功能，支持快速部署和使用。详细技术文档请参考官方说明：[***]

2. 核心功能与特性

基于 OPC UA 客户端的通用特性及镜像定位，核心功能包括：

• OPC UA 服务器连接管理：支持配置多个 OPC UA 服务器连接参数（地址、端口、安全策略等），并保存连接配置
• 地址空间浏览：可视化展示 OPC UA 服务器的地址空间结构，支持节点层级展开、属性查看（如节点 ID、名称、数据类型等）
• 实时数据监控：订阅并实时显示服务器节点的实时数据值、时间戳及品质状态
• 安全通信支持：兼容 OPC UA 标准安全策略（如 None、Basic128Rsa15、Basic256 等），支持用户名/密码认证及证书加密
• 节点操作：支持对可写节点执行读写操作，便于调试和测试
• 日志与诊断：记录连接状态、数据交互日志，辅助问题排查

3. 使用场景与适用范围

适用于以下场景：

• 工业自动化调试：工程师在设备部署或系统集成阶段，通过客户端快速验证 OPC UA 服务器配置及数据通信
• 系统集成测试：验证 OPC UA 服务器与上层应用的数据交互正确性，模拟客户端请求
• 设备数据监控：实时查看工业设备（如 PLC、传感器）通过 OPC UA 协议暴露的实时数据
• 教学与培训：用于 OPC UA 协议学习，直观理解地址空间结构和数据交互流程

4. 使用方法

4.1 前提条件

• 已安装 Docker 引擎（版本 18.09+）
• 目标 OPC UA 服务器网络可通（容器需能访问服务器地址及端口）

4.2 快速启动（docker run）

通过以下命令启动容器，默认暴露 Web UI 端口（假设为 8080，具体以官方文档为准）：

bash
docker run -d \
  --name opc-ua-browser \
  -p 8080:8080 \  # 映射 Web UI 端口到宿主机
  -e OPCUA_SERVER_URL="opc.tcp://example-server:4840" \  # 目标 OPC UA 服务器地址
  -e SECURITY_POLICY="None" \  # 安全策略（None/Basic128Rsa15/Basic256等）
  iotechsys/edge-opcuabrowser:latest  # 镜像名称（假设，具体以官方为准）

启动后，通过浏览器访问 http://<宿主机IP>:8080 打开 Web UI。

4.3 docker-compose 配置示例

创建 docker-compose.yml 文件，定义服务及持久化配置（如保存连接历史）：

yaml
version: '3'
services:
  opc-ua-browser:
    image: iotechsys/edge-opcuabrowser:latest  # 镜像名称（假设）
    container_name: opc-ua-browser
    ports:
      - "8080:8080"  # Web UI 端口
    environment:
      - OPCUA_SERVER_URL="opc.tcp://example-server:4840"
      - SECURITY_POLICY="Basic256"
      - USERNAME="admin"  # 服务器认证用户名（如需）
      - PASSWORD="password"  # 服务器认证密码（如需）
    volumes:
      - ./browser-config:/app/config  # 持久化配置文件（如连接历史、证书）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 环境变量参数

容器支持通过环境变量配置核心参数，常用参数如下（具体以官方文档为准）：

5.2 持久化配置

通过挂载宿主机目录到容器内配置路径（如 /app/config），可持久化保存连接历史、证书等数据，避免容器重建后配置丢失：

bash
docker run -d \
  --name opc-ua-browser \
  -p 8080:8080 \
  -v /path/on/host/config:/app/config \  # 宿主机目录映射
  iotechsys/edge-opcuabrowser:latest

6. 注意事项

• 网络连通性：确保容器与 OPC UA 服务器之间网络可达，如需跨网段，可通过 --network 参数指定 Docker 网络
• 安全配置：生产环境中建议使用 Basic256 及以上安全策略，并启用证书认证（参考官方文档配置证书路径）
• 性能：同时监视大量节点时，建议调整容器资源限制（如 --memory=2g --cpus=1）

7. 参考文档

完整配置及高级功能请参考官方文档：[***]