很多团队在选高防IP时，最关心的不是防护能力，而是“接入会不会很麻烦、要不要改代码、要不要迁移服务器”。答案是：坚果盾高防IP接入不需要改动业务代码，不需要迁移源站，最快5分钟完成。本文讲清接入原理与四步操作流程，以及需要配合调整的配置项。
一、接入原理：端口转发，不动业务
坚果盾高防IP的接入方式是端口转发。业务客户端原本连接源站IP和端口，接入后改为连接高防IP和端口，高防节点清洗流量后再转发给源站。
| 接入前 | 接入后 |
|---|---|
| 客户端 → 源站IP:端口 | 客户端 → 高防IP:端口 → 源站IP:端口 |
| 源站直接对外 | 源站仅接受高防回源IP |
源站架构、业务代码、数据库连接全部不需要改动。唯一变化的是客户端连接的地址，从源站IP改为高防IP。
二、四步接入流程
| 步骤 | 操作 | 是否需要改代码 |
|---|---|---|
| 1.购买套餐 | 按带宽、端口、保底需求选档 | 否 |
| 2.配置端口转发 | 添加协议、监听端口、源站IP与端口 | 否 |
| 3.修改客户端连接 | 连接地址由源站IP改为高防IP | 否（改配置即可） |
| 4.源站白名单 | 防火墙仅放行高防回源IP | 否 |
四步在坚果盾控制台均可自助完成，无需提交工单等待。配置端口转发时支持批量导入与一键导入源站端口，多区多服场景效率更高。
三、需要配合调整的配置项
虽然不需要改代码，但有几个配置项需要配合调整：
| 配置项 | 调整内容 | 说明 |
|---|---|---|
| 客户端连接地址 | 源站IP → 高防IP | 可通过配置或服务端下发 |
| 源站防火墙 | 仅放行高防回源IP | 隐藏源站的关键一步 |
| 回源协议 | 与业务协议一致 | TCP/UDP不要配错 |
| 日志配置 | 来源IP识别 | 源站日志会看到高防回源IP |
如果客户端地址无法修改（如硬编码在安装包中），需要提前规划版本更新。过渡期间可保留源站旧入口，但应尽快完成切换。
四、什么情况下需要改代码
绝大多数业务接入坚果盾高防IP不需要改代码。以下情况可能需要少量调整：
业务逻辑依赖客户端真实IP：需要从HTTP头或转发协议中获取真实IP
使用了IP白名单校验：源站需要更新白名单，放行高防回源IP
自定义协议需要特征识别：需向坚果盾技术支持提供协议格式，配置识别规则
这些调整属于配置层面，不涉及业务逻辑重构。
五、接入后的验证
连通性：客户端能正常连接高防IP并完成业务交互
源站隐藏：从外部直连源站IP，应被拒绝或超时
延迟：业务响应时间与接入前相比无明显上升
日志：源站日志中来源IP应为高防回源IP
四项全部通过，接入才算成功。坚果盾高防IP支持免费测试，可以先测试再正式切换。
六、常见问题
Q：接入坚果盾高防IP需要停机吗？
不需要。客户端地址可逐步切换，灰度发布更稳妥。
Q：客户端地址改不了怎么办？
保留源站旧入口过渡，同时推动客户端更新。过渡期越短越好。
Q：源站白名单配错了会怎样？
回源流量被拦截，业务不可用。建议先放行回源IP，确认正常后再收紧其他规则。
Q：坚果盾高防IP接入后多久生效？
转发规则配置保存后即时生效，客户端无需改动。攻击清洗在流量接入后自动开始。
