联邦到底在做什么
联邦用于把多个站点组织到同一套运行拓扑里。每个站点都有独立的站点编码、访问名、本地节点和可见模块；站点之间可以共享联邦状态、跨站点入口和联邦数据视角。单机项目通常只保留本地站点；多站点项目才需要维护远端站点和访问名。
- 单机项目：本地模式为主，确认默认站点和本地节点即可。
- 多站点项目：每个站点都要有稳定站点编码和可达访问名。
- 站点改动后回系统状态，看联邦拓扑是否按预期更新。
- 联邦是站点级组织能力，不等于把所有设备都复制成多份。
文档手册
联邦与冗余：多站点和双机接管理解方式
联邦用于把多个站点组织到同一套运行拓扑里。每个站点都有独立的站点编码、访问名、本地节点和可见模块；站点之间可以共享联邦状态、跨站点入口和联邦数据视角。单机项目通常只保留本地站点；多站点项目才需要维护远端站点和访问名。
联邦: 联邦与冗余：多站点和双机接管理解方式
联邦用来把多个站点放到一张运行拓扑里；冗余用来决定同一台设备当前由哪个节点采集和写入。先分清这两件事，排障会快很多。站点字段理解方式
联邦配置里的站点字段用于识别运行边界和访问路径。Site 表示一个 HQControl 运行站点；Local site 是当前服务器；Remote site 是通过方向性联邦认识到的其他站点；访问名应与对外访问地址、域名、反向代理地址或局域网访问地址保持一致。
- 站点编码应稳定，不要因为显示名称调整而频繁改动。
- 访问名应填写其他站点能够访问到的地址或名称。
- 反向代理部署时，访问名要和外部用户实际访问地址一致。
- 远端站点不可达时，先确认访问名、网络、端口和反向代理。
- 联邦是方向性的：A 配置 B，不代表 B 自动配置 A。
Site = 当前 HQControl 运行站点
Local site = 当前服务器所属站点
Remote site = 通过联邦认识到的其他站点
对外访问地址 = 对外展示和访问使用的站点地址联邦不替代本机 Tag 配置
画面、导入、报警和趋势都以本机配置的设备和 Tag 为准。联邦只让站点互相可见，并决定某台 PLC 当前由哪个采集节点连接。远端站点有同名 Tag，不代表本机已经有这个 Tag。
- 本机没有 Tag 时，画面应按本机缺失处理。
- Excel 导入按本机设备编码和本机已有 Tag 匹配；远端存在同名 Tag 不会影响本机导入。
- Tag 诊断读到远端值只表示诊断链路可用，不表示本机主数据已存在。
- 报警和趋势配置也应基于本机 Tag 主数据维护。
冗余到底在做什么
冗余用于同一批设备的采集节点切换。一个设备在同一时刻只有一个当前采集节点负责实际轮询、写入和对外提供最新值；备用节点处于待命状态，在当前采集节点异常时接管。这样既避免双采集，也避免两个节点同时写同一个设备。
- 当前采集节点负责实际采集和写入。
- 备用节点处于待命状态，不会同时对同一设备写入。
- 切换前先确认当前采集节点是否真的失效，而不是网络短抖动。
- 冗余的目标是稳定接管，不是让两个节点一起抢数据。
IO Owner 如何判断
IO Owner 是当前直接采集某台 PLC 的那个站点或节点。非 Owner 节点不会对同一 PLC 直接高频轮询，而是读取已经路由过来的最新值，或等待接管。判断当前 Owner 时，建议同时看系统状态、设备连接、联邦拓扑和 Tag 质量，不要只看某一页的在线标识。
- 同一台 PLC 同一时刻只能有一个 active IO Owner。
- Owner 健康时，读取和写入都路由到当前 active Owner。
- Owner 离线后，符合条件的备用节点才可以接管。
- 如果 PLC 本身离线，切换 Owner 也不会让 PLC 变得可读。
- 非 Owner 节点不会另建一套私有 Tag 目录，所有节点用同一份配置。
接管前后的分层确认
冗余接管不是单个状态变化，而是一组链路变化。先确认原 Owner 是否不可用，再确认备用节点是否具备采集条件，最后看设备状态、Tag 最新值和质量是否恢复。不要在 PLC 故障时误判为冗余切换失败。
- 第一层：系统状态确认联邦模块、IO 模块和服务状态。
- 第二层：设备连接确认当前 Owner 和备用节点。
- 第三层：Tag 诊断确认关键点的值、质量和更新时间。
- 第四层：报警、趋势、画面和 IO State API 确认消费的是同一份最新值。
- 第五层：写值场景确认权限、审计和路由结果。
查看方式当前配置是否正常
先看系统状态里的联邦拓扑，再看站点管理和设备连接。联邦拓扑要能看到本地站点、节点、访问名、备用节点和当前采集设备；设备连接要能确认关键设备当前归谁采集。Tag 数量和 Tag 列表要优先分清本地 PLC Tag 与联邦镜像 Tag，不要混在一起理解。
- 系统状态先看本地模式、站点访问名、节点数和当前采集设备数。
- 站点管理确认站点编码、访问名和远端站点信息。
- 设备连接确认关键设备当前由哪个节点负责。
- 联邦镜像 Tag 是同步视角，不是本地 PLC 新增点位。
- 排障时先分清是站点拓扑问题、采集节点问题，还是本地 IO 问题。
联邦或冗余异常时的最短排查顺序
先看系统状态，再看模块中心，再看设备与 Tag。常见问题是站点访问名填错、远端节点不可达、当前采集节点没切换、备用节点配置不完整，或者把联邦镜像点误当成本地 PLC 点使用。
- 第一步：系统状态看联邦模块、IO 模块和 WebSocket 状态。
- 第二步：模块中心确认联邦模块已安装且运行。
- 第三步：站点管理确认站点编码和访问名没有填错。
- 第四步：设备连接确认关键设备当前采集节点和备用节点。
- 第五步：Tag 管理与 Tag 诊断确认本地点、镜像点和实时值来源。
站点列表用于确认本地站点、节点数量、访问名和当前设备归属。
站点扫描用于发现或刷新远端站点，适合联邦配置后做连通性确认。
联邦配置要和公开主机名、访问名、站点编码和冗余接管策略一起确认。