升级为什么不能直接换包
WAF 版本升级不只是替换安装包：新版本可能改变默认规则集、解析行为与接口字段处理方式。稳妥做法是按「评估、备份、备机先行、观察」推进，并确认存在可回退的镜像与配置。WAF 通常串接在网站入口，一台设备升级失败就直接影响业务可用性，所以流程比速度重要。
基本信息
| 评估 | 阅读版本说明、已知问题、与现网组件的兼容性 |
|---|---|
| 备份 | 全量配置、规则库、证书与自定义规则导出并校验 |
| 执行 | 先升级备机并验证业务，再切换角色升级原主机 |
| 观察 | 升级后至少观察 48 小时，重点看误报与放行日志 |
典型使用场景
- 版本迭代升级：修复安全漏洞或更新规则库时按流程执行
- 跨大版本升级：行为变化较多，必须先读说明并在测试环境验证
- 串接环境升级：先确认备机可用，避免单台升级造成业务中断
- 升级失败回退：确认回退镜像与配置可用，缩短中断时间
- 升级后验收：对比升级前后误报数据，确认业务未被新规则误拦
升级步骤
升级步骤
# 1. 从官方渠道下载升级包并校验哈希值
# 2. 导出现网全量配置与规则库，确认备份可读、可导入
# 3. 升级备机，切换验证业务与告警是否正常
# 4. 切换主备角色后再升级原主机，逐台验证
# 5. 升级后观察 48 小时误报与性能，更新升级记录台账升级前后核对
| 核对项 | 升级前 | 升级后必查 |
|---|---|---|
| 规则库版本 | 记录当前版本号 | 确认已更新且授权有效 |
| 证书与真实 IP | 记录传递方式 | 业务访问正常、日志来源 IP 未变成设备地址 |
| 双机状态 | 确认同步正常 | 两台版本一致、同步恢复 |
| 误报数据 | 记录升级前基线 | 对比是否出现新误报 |
跨大版本升级可能改变默认规则行为，升级说明必须精读；只按以往经验操作是这类故障最常见的起因。