OPNsense防火墙自动化规则在HA备节点同步失效问题分析

问题背景

在OPNsense防火墙高可用(HA)集群环境中，管理员发现从24.7.12_2版本升级到25.1后，通过API或防火墙自动化界面创建的过滤规则无法正确同步到备用节点。当主备切换发生时，备用节点接管后网络流量将中断，因为关键的防火墙规则缺失。

问题现象

具体表现为：

1. 主节点上通过"防火墙→自动化→过滤器"界面或API创建的规则
2. 执行HA同步操作后
3. 备节点对应界面显示为空
4. 配置文件对比发现主节点配置中包含完整的规则定义，而备节点仅包含空规则标签

技术分析

经过开发团队排查，确认这是25.1版本引入的一个回归性问题。根本原因在于代码提交0bd12b554971618bfef9ee29c4f8665a94d3df2a中引入的变更影响了HA同步机制对自动化防火墙规则的处理逻辑。

该问题特别影响：

• 使用API管理的防火墙规则
• 通过自动化界面手动创建的规则
• 大型规则集（测试环境中约590条规则）

解决方案

开发团队迅速提供了修复补丁1a2eeb9044f2e7a6d9119fd7d0cdfb740092ac70。用户只需在主防火墙节点上执行以下命令即可应用修复：

opnsense-patch 1a2eeb9044f2e7a6d9119fd7d0cdfb740092ac70

验证结果

用户确认修复后：

1. API防火墙规则正确显示在备节点
2. HA切换后网络功能恢复正常
3. 规则同步机制完全恢复

最佳实践建议

对于使用OPNsense HA集群的管理员：

1. 重要升级前应测试HA切换功能
2. 定期验证配置同步状态
3. 大型规则集环境下更需关注同步完整性
4. 保持关注官方更新和已知问题公告

该问题的及时修复体现了OPNsense团队对高可用性功能的重视，确保了企业级防火墙环境的稳定运行。