简介这是一份基于.NET Standard实现的OPC UA通用架构代码Demo面向工业自动化、物联网与远程监控领域的.NET开发者用于快速搭建跨平台OPC UA客户端或服务器。OPC UA作为工业领域通用的安全数据交换标准突破了操作系统与厂商限制此Demo将标准落地为可复用的通用工程代码。资源以zip压缩包形式提供整体大小约10.72MB包内为项目源码及通用工程结构便于直接研读与编译运行。目前已有342人学习适合希望从零上手OPC UA的初学者以及需要原型验证的中级开发者。通过分析这套Demo可系统掌握OPC UA连接建立、节点数据读写、订阅变化通知及安全事务处理等核心流程理解通用架构的模块划分与跨平台实现思路为后续自主开发OPC UA通信功能提供扎实参考。1. 为什么很多设备接入项目最后都绕不开 UA-.NETStandard 和它的 DEMO工厂上位机最头疼的一步是把不同年代、不同品牌的 PLC 和仪表统一送进 SCADA 或 MES。OPC UA 是当前最主流的工业通信标准而 UA-.NETStandard 是 OPC Foundation 官方的 .NET Standard 实现里面包含完整的 OPC UA 通信栈、客户端/服务端框架和通用架构代码。这里就围绕这套代码的 DEMO 工程展开先用一个最小 demo 程序把 UA Server 和 UA Client 跑通再讲清目录结构与参数最后列出我在实际项目里踩过的坑。适合正在选型 OPC UA 对接的上位机开发者也适合刚拿到 UA-.NETStandard 源码不知道从哪个工程开始读的人。2. 先看懂 UA-.NETStandard 的工程结构Client、Server 与 Stack 的分工UA-.NETStandard 的价值在于把 OPC UA 的「通用架构」铺成了一层一层的代码让你不需要从零实现协议栈。先花十分钟看懂结构后面跑 DEMO、改配置都会顺很多。很多人第一眼看到仓库里几十个工程会被吓到其实真正要关注的只有四块。2.1 从目录结构看分层Stack、Client、Server 各管什么仓库解压后你第一眼看到的是 Stack、Client、Server、Configuration、SampleApplications 这些目录。Stack 是通信栈负责 UA TCP 协议、二进制编码、安全通道和会话的底层处理Client 做的是高层封装比如连接管理、订阅管理、浏览与读写Server 则负责地址空间Address Space维护、节点管理器和请求分发。Configuration 解决的是应用配置、证书生成本地和信任管理。SampleApplications 里的 NetCoreConsoleServer / NetCoreConsoleClient部分老版本叫 ConsoleServer / ConsoleClient就是我们要跑的 DEMO 入口。UA-.NETStandard/ ├─ Stack/ # 协议栈UA-TCP、编码、安全通道 ├─ Client/ # 客户端 SDK会话、订阅、节点读写 ├─ Server/ # 服务端 SDK地址空间、节点管理器 ├─ Configuration/ # 应用配置、证书与信任存储 └─ SampleApplications/ # 官方示例DEMO 工程集中在这里Stack 里还拆了 internal 与 public 两部分Opc.Ua.Core 负责协议实现Opc.Ua.Transport 负责通道。很多人刚接触时不知道这些程序集怎么拆我建议只看两个Opc.Ua.Core 和 Opc.Ua.Client / Opc.Ua.Server。前者是跑不掉的底层后者才是你写业务代码要挂靠的地方。这个分层的直接好处是业务代码不会和协议编码混在一起。实际做设备接入时你写的代码基本只碰 Client 或 Server 这两层Stack 大部分时间是黑匣子只有抓包排错时才需要去翻它。把「写自己的逻辑」和「理解协议栈」拆开是这套架构少见的清爽点。如果你的目标是做一个网关系接的是 PLC 驱动或者 Modbus 采集的数据基本就在 Server 地址空间那一层干活如果是做 SCADA 客户端要对接多个服务器那 Client 层就是主战场。两个框架可以独立用但经常在一个进程里同存一边把老设备数据写进 Server 地址空间一边用同一个进程里的 Client 订阅别的 OPC UA 服务器。2.2 DEMO 工程入口NetCoreConsoleServer 与 NetCoreConsoleClient官方示例里最小可跑的 DEMO 组合是 NetCoreConsoleServer一个控制台版 UA Server和 NetCoreConsoleClient一个控制台版 UA Client它们都放在 SampleApplications 目录下配置写在 XML 文件里。Server 启动时会先创建或加载应用实例证书然后把地址空间初始化好监听 opc.tcp://localhost:4840。Client 启动后会自动发现服务器端点建立一个会话并浏览示例节点。ApplicationInstance是两端共同的入口负责加载配置、校验证书、启动或关闭应用。Server 侧内部会创建StandardServerClient 侧则是通过Session.Create建立连接。DEMO 里反复出现的ApplicationConfiguration就是那个 XML 配置在内存里的对象模型。理解这几个类再看任何官方 DEMO 代码都不会晕。DEMO 的 Server 会预置一些示例节点例如 ns2 命名空间下的 Demo 文件夹和若干模拟变量。地址空间的根是 ObjectsFolder下面按文件夹、对象、变量的层级组织对应工业设备的三层结构设备、采集点、数值。Server 端 DEMO 是支持外部客户端连接的你可以开着这个 Server再用另一个第三方 UA 客户端来测不一定要用官方 Client。2.3 为什么是这套架构从 OPC DA 的 COM 时代到 UA 的信息模型老一代 OPC DA 基于 Windows COM/DCOM跨机器访问要配置 DCOM 权限端口还经常是动态分配的。每次上线都要跟网络管理员来回扯端口、权限换一台机器就重新折腾一遍网络安全策略也很难落地。OPC UA 把架构重新做了传输层默认走 TCP 4840应用层定义了基于证书和策略的安全模型数据模型升级为完整的地址空间不只是「点表」而是带类型、方法、事件和历史能力的对象模型。这也解释了为什么很多工厂升级会选 UA 而不是在 DA 上修修补补UA 的 Server 可以同时把 PLC 数据、报警事件、历史数据和诊断信息统一挂到一个地址空间里。UA-.NETStandard 的意义就是把这套规范变成可编译、可扩展的 C# 代码让厂商不必自己解析 OPC UA 的二进制协议。实际项目里从 DA 迁到 UA 的改动大头不在通信代码而在把原来的点表改成地址空间结构、把 DCOM 安全域改成 UA 证书链这一步往往要占掉 40% 的工期。3. 把 DEMO 跑起来UA-.NETStandard 的 Server / Client 最小互通这一章的目标很明确在你的机器上把官方 DEMO 的 Server 和 Client 跑通。不要先去啃信息模型规范先把链路通起来你才有地方验证后面所有参数。3.1 编译准备TargetFramework 与 NuGet 依赖先确认本机的 .NET SDK 版本。UA-.NETStandard 当前分支的示例工程一般面向 net8.0 或者 net6.0用较新的 SDK 直接打开都行。不建议用 .NET Framework 4.x 跑新分支老生态里 NuGet 依赖经常缺。还原和编译命令如下dotnet restore ./UA-.NETStandard.sln dotnet build ./UA-.NETStandard.sln -c Release首次编译会花几分钟因为要还原一批 NuGet 包。编译完成后在 SampleApplications 下生成 NetCoreConsoleServer 的 Release 可执行文件。如果只想编译 Server 侧可以把命令行里的 .sln 换成对应 .csproj 路径减少一半编译时间。编译报错时先看版本本地 SDK 太旧或者 NuGet 源里包版本跟你拉取的源码不匹配是最大概率的两个原因。3.2 起一个最小 Server配置 Endpoint 与匿名登录运行 Server 的命令很简单dotnet run --project ./src/Server/NetCoreConsoleServer/NetCoreConsoleServer.csproj -c Release启动时ApplicationInstance会检查证书。本地没有证书会生成自签名证书到 ApplicationData 目录并且把它信任到本机当前用户的根证书存储。第一次启动时如果 Windows 弹出证书安装确认点确认即可。Server 的监听地址在配置文件里常见写法是BaseAddresses Stringopc.tcp://localhost:4840/String /BaseAddressesopc.tcp是 UA-TCP 协议默认端口 4840。如果你后面要跨机器连这里要改成0.0.0.0或者具体的局域网 IP不要留localhost。匿名登录对应的配置在 UserTokenPoliciesUserTokenPolicies UserTokenPolicy TokenTypeAnonymous/TokenType /UserTokenPolicy /UserTokenPolicies匿名只适合 DEMO生产环境至少要换 UserName 或证书登录。日志里留意证书、监听地址相关输出Server 确实起来后会在控制台打印监听端口。提示如果 Server 第一次启动没有生成证书检查当前用户有没有写 ApplicationData 目录的权限。证书生成失败时 Server 会直接退出不会等你手工补证书。3.3 Client 连接代码建立会话并读一个节点Client 最核心的就是Session.Create加ReadValue。下面是一段常见做法本地跑通 DEMO 完全够用using Opc.Ua; using Opc.Ua.Client; using Opc.Ua.Configuration; // 1. 客户端也需要一份应用配置DEMO 阶段可以不做证书 var app new ApplicationInstance { ApplicationName demo-client, ApplicationType ApplicationType.Client, ApplicationUri urn:demo:client }; await app.LoadApplicationConfiguration(client.Config.xml, false); // 2. 构造端点并建立会话 var ep new ConfiguredEndpoint( new EndpointDescription { EndpointUrl opc.tcp://localhost:4840, SecurityPolicyUri SecurityPolicies.None, SecurityMode MessageSecurityMode.None }, EndpointConfiguration.Create()); using var session await Session.Create( app.ApplicationConfiguration, ep, false, // updateBeforeConnectfalse 表示不做端点半线上更新 demo-session, // sessionNameServer 日志里能看到 60000, // sessionTimeout单位毫秒 null, // userIdentitynull 表示匿名 null); // 3. 按节点 ID 读值 var nodeId new NodeId(ns2;sDemo.MassFlow); DataValue dv session.ReadValue(nodeId); Console.WriteLine($value{dv.Value} status{dv.StatusCode});ConfiguredEndpoint里我显式把安全策略设为 None是为了绕开证书环节快速连通。sessionTimeout 60000表示会话超过 60 秒没有交互就断开。匿名身份传null即可。如果目标 Server 开了签名或加密这里的SecurityPolicyUri和SecurityMode要跟 Server 完全一致否则会报安全策略错误后面避坑章节会专门说。3.4 订阅与写值DEMO 里最值得抄的两个场景读节点是「拉」订阅是「推」。工业上位机里大部分曲线显示和报警都靠订阅。标准做法是建一个Subscription再把要监听的节点包成MonitoredItemvar subscription new Subscription(session) { PublishingInterval 500, // 发布间隔 500ms LifetimeCount 30, // 生命周期计数 KeepAliveCount 3 // 保活计数 }; session.AddSubscription(subscription); subscription.Create(); var item new MonitoredItem(subscription) { StartNodeId new NodeId(ns2;sDemo.MassFlow), SamplingInterval 200, // 采样间隔 200ms QueueSize 1, // 缓存 1 个最新值 AttributeId Attributes.Value }; item.Notification (s, e) { var changed (MonitoredItem)s; Console.WriteLine(${changed.StartNodeId} {e.NotificationValue.Value}); }; subscription.AddItem(item);发布间隔是服务端把一批变化批量推给客户端的节奏采样间隔是服务端监视节点变化的频率。这两个值不是越小越好后面参数章详细说。写值更直接var writeVal new DataValue(new Variant(123.456)); session.WriteValue(new NodeId(ns2;sDemo.MassFlow), writeVal);DEMO 的仿真变量很多都支持写。写入后订阅回调会马上触发一次拿它验证链路通不通比盯着日志猜快得多。4. UA-.NETStandard 必调参数安全策略、节点 ID 与推送间隔这一章只挑动手改 DEMO 时一定会碰到的三组参数安全策略、节点 ID 和订阅节奏。把这三组设对了DEMO 才真正在你的环境里站稳后面接业务数据才不会被莫名其妙的问题卡住。4.1 SecurityPolicy 与 MessageSecurityModeNone 不是不用管SecurityPolicy 决定加密算法和签名算法MessageSecurityMode 决定每条消息要不要签名、加密。两个不是一回事但经常写在一起SecurityPolicy签名加密适用场景None无无本地 DEMO、纯内网且无安全要求Basic256Sha256有有生产默认兼容性好旧设备也认识Aes128_Sha256_RsaOaep有有OPC UA 1.05 新策略加密强度更高MessageSecurityMode 只取三种值None、Sign、SignAndEncrypt。只设置 Sign 会丢加密设置 SignAndEncrypt 则要求两端能完成证书协商对端没有可信证书会失败。DEMO 阶段把两端都配成 None能省掉证书手续但生产环境我不建议开 None哪怕内网UA 的证书链本身代价不高。老项目里偶尔能看到 Basic256 策略已经被后续规范标为过时新旧库混用时最容易遇到尽量不要在新工程里用。4.2 节点 ID 与命名空间Server 定义什么样Client 才能读得到OPC UA 的节点 ID 格式是nsindex;type:identifier类型有 s字符串、i数字、gGUID、b字节串。DEMO 里常见的ns2;sDemo.MassFlow意思是应用命名空间索引为 2采用字符串标识。变量节点除了 NodeId 还必须有 BrowseName、DisplayName、DataType、AccessLevel 这些属性。Client 读的时候按 NodeId 直接找浏览树时按引用关系走。很多新手把 Modbus 点表思维带过来直接问「OPC UA 地址是什么」——在 UA 里没有统一地址表每个 Server 的命名空间和节点 ID 都是自己定义的。所以对接前第一件事永远是拿 Discovery 请求拿到端点再用 Browse 或 Read 确认节点 ID。你读到的命名空间索引要以 Server 的地址空间为准不是以 Client 的猜测为准。如果 Client 读节点返回BadNodeIdUnknown多半是命名空间索引或类型前缀写错了比如 Server 用的是数字 i101你却写了 s101。4.3 PublishingInterval、SamplingInterval 与 SessionTimeout实时性不是越小越好订阅参数里最容易调过头的三个PublishingInterval、SamplingInterval、SessionTimeout。PublishingInterval 默认 500ms控制 Server 把通知合并发送的频率。工业 SCADA 一般 100~1000ms非实时画面 1s 也行。调太小时 Server 负载高但数据根本没那么多变化CPU 白烧。SamplingInterval 默认继承发布间隔最小可为 0表示尽可能快。温度这种慢变量 2s 采样都嫌浪费转速变化快的设备 100ms 左右可以。SessionTimeout 是会话空闲判定时间UA-.NETStandard 默认 60s。调太短会频繁断连太长占用 Server 队列资源。还需要留意的两个参数QueueSize 是 Server 端为这个监控项保留的缓存条数变化快且 Client 处理慢时必须大于 1否则丢通知KeepAliveCount3 表示连续三个发布周期没有通知就发保活配合 LifetimeCount30 避免会话假死。订阅断开后最常见的现象是页面一直显示最后一条数据不动排错先看这几个值。5. UA-.NETStandard DEMO 排查证书信任、URL 与权限的五个翻车点DEMO 跑通的路径很短但从 DEMO 往交付环境走坑会集中在证书、URL 和权限三块。下面五条是我们在设备接入项目里反复撞过的按现象、原因、解决三步说清。5.1 BadCertificateUntrusted证书信任与 AutoAccept 的取舍现象Client 连接 Server 时抛BadCertificateUntrusted。原因Server 第一次启动生成了自签名证书Client 端证书存储里没有信任它也找不到对应的根 CA。解决DEMO 阶段在 Client 加载配置后加一个证书验证回调app.ApplicationConfiguration.CertificateValidator.CertificateValidation (s, e) { e.Accept true; };这只是把验证开关临时打开切记只能用于本机 DEMO。正式环境应该把 Server 的证书或自建 CA 签发的证书导入 Client 的受信任根证书存储区并把这段代码删掉。血泪经验是先配好证书再谈加密顺序反了排查会让你怀疑人生。提示AutoAccept 代码放到应用初始化阶段即可正式环境千万别保留。5.2 BadSecurityPolicyRejected两端策略不一致现象Client 可以 Discovery但创建 SecureChannel 时报BadSecurityPolicyRejected。原因Client 请求的 SecurityPolicy URI 和 Server 当前启用策略对不上。常见是 Client 默认 NoneServer 只开了 Basic256Sha256。解决在 Client 端先从 Discovery 拿到端点列表再按支持的策略构造ConfiguredEndpoint不要手写一个猜测策略。最简单的方式是两端都允许 None 并指定相同策略。UA-.NETStandard 对策略字符串很严格多一点少一点都会失败建议直接复制 Server 配置里的 URI 字符串不要凭记忆输入。5.3 本机连得上、别人机器连不上URL、防火墙与绑定地址现象Server 在同一台机器上用客户端能连换到另一台机器填opc.tcp://localhost:4840就失败。原因localhost会解析到发起连接的本机而且 Server 默认只绑定了 127.0.0.1 时外部请求到不了 4840。解决Client 把 URL 改成 Server 的局域网 IP如opc.tcp://192.168.1.50:4840Server 的 BaseAddresses 写上opc.tcp://0.0.0.0:4840或具体 IPWindows 防火墙放行 4840 端口。跨网段还要看交换机 VLAN 是否允许该端口。这个坑最气人因为本机一切正常换台机器就是死活不通。5.4 订阅建好却不回调变化检测与发布间隔一起作用现象MonitoredItem 已添加Server 端节点值在变但 Notification 事件不触发。原因SamplingInterval太长或没设置导致采样不检QueueSize0导致通知被丢或者监控属性写的是别的 Attribute而节点变化的是 Value。UA 的订阅是「变化才推」如果 Server 端一直写相同值不会有新通知。解决把SamplingInterval显式设为 100~500msQueueSize至少设为 1确认AttributeId Attributes.Value调试期可以同时订阅 StatusCode或者用session.ReadValue对比当前值。5.5 版本混用导致的“灵异问题”同一套库要统一版本现象编译通过运行到一半报程序集加载失败或证书解析报错跟代码完全没关系。原因项目里同时引用了不同 tag 的 Opc.Ua 系列 NuGet 包资源、序列化和安全兼容性微妙冲突。这个属于 UA-.NETStandard 生态里最常见的玄学。解决把 Opc.Ua.Core、Opc.Ua.Client、Opc.Ua.Server、Opc.Ua.Configuration 等包全部锁到同一个版本如果直接从源码引用确保子工程全是同一个 branch本地 publish 后检查输出目录里 dll 的版本是否一致。6. 从 DEMO 走向生产把示例改造成你自己的地址空间官方 DEMO 的 Server 永远在 ns2 下给你一堆仿真节点。真正接设备时要在一个自定义 NodeManager 里创建属于自己命名空间的节点。从 DEMO 到可交付 Server 的骨架就是这一步信息模型决定数据怎么组织NodeManager 决定运行时怎么响应浏览与读写。6.1 把仿真节点换成你自己的变量NodeManager 改哪里常见做法是继承StandardNodeManager在CreateAddressSpace里创建 FolderState 和 BaseDataVariableState再调AddPredefinedNode注册。示意如下public sealed class DemoNodeManager : StandardNodeManager { public DemoNodeManager(IServerInternal server, ApplicationConfiguration config) : base(server) { } protected override void CreateAddressSpace( IDictionaryNodeId, IListIReference externalReferences) { base.CreateAddressSpace(externalReferences); var ns NamespaceIndex; // 该管理器注册的命名空间索引 var folder new FolderState(this); folder.NodeId new NodeId(Demo, ns); folder.BrowseName new QualifiedName(Demo, ns); folder.DisplayName new LocalizedText(Demo); folder.AddReference(ReferenceTypeIds.Organizes, false, ObjectIds.ObjectsFolder); AddPredefinedNode(folder); var variable new BaseDataVariableState(folder); variable.NodeId new NodeId(MassFlow, ns); variable.BrowseName new QualifiedName(MassFlow, ns); variable.DisplayName new LocalizedText(MassFlow); variable.DataType DataTypeIds.Double; variable.Value 0.0; variable.AccessLevel AccessLevels.CurrentReadOrWrite; AddPredefinedNode(variable); } }NamespaceIndex来自NamespaceUris的索引Server 启动时会把命名空间字符串注册进去客户端看到的ns2或ns3就是那个索引。AddReference(ReferenceTypeIds.Organizes, false, ObjectIds.ObjectsFolder)是把文件夹挂到 Objects 根目录下浏览树才能看到它。把variable.Value的更新逻辑接到你设备采集线程上就是一套最小网关的雏形。6.2 方法调用与历史数据三个进阶验证手段地址空间里除了变量还有方法。Client 调方法用session.Call(methodId, inputValues)Server 端在 NodeManager 里创建 MethodState 并挂回调函数即可。方法通常用于启停、复位这类不想暴露为写变量值的操作。历史数据走session.ReadHistoryRaw前提是 Server 端配置了历史存储并实现 HistoryRead 能力UA-.NETStandard 的 Server 是支持这一块的但 DEMO 默认不一定开。验证时可以用 UaExpert 这类通用 OPC UA 客户端直接连上 UA-.NETStandard Server浏览地址空间、读节点值、看订阅比自己写代码排错效率高得多。另外养成一个习惯每次改完 Server 的地址空间我会用一个干净的 Client demo 程序回连一次只检查「新增节点能不能被发现、能不能写入」这两点确认后再接真正的业务逻辑比先把整个框架搭完再查快得多。希望帮到你。本文还有配套的精品资源点击获取