# XDP 内核态拦截

在网卡驱动层丢弃封禁与黑名单流量，节点级开关、自动降级与授权说明。

XDP 高速拦截把封禁 IP 和黑名单流量放到网卡驱动层(XDP)直接丢弃,在内核协议栈之前处理,降低大量恶意连接对节点的消耗。入口:「节点管理 › XDP 高速拦截」。这是需要授权的增值功能,授权状态见[授权与增值功能](https://www.gocdn888.com/zh/guide/license)。


## 使用条件
- 节点网卡与驱动支持 XDP,内核版本 5.10 及以上。不满足时节点保持「标准模式」,并在页面上说明原因。
- 拦截范围只包括网站端口:TCP 80 / 443 和 UDP 443。白名单、主控地址、SSH 与管理端口、健康探测点会先被放行,不会被误拦。

## 两种模式
每个节点单独显示当前模式和原因:

| 模式 | 含义 |
|---|---|
| 高速模式 | 封禁与黑名单流量在网卡驱动层丢弃 |
| 标准模式 | 由系统防火墙执行拦截,封禁与名单不变,只是不走网卡驱动层 |

可用的操作有:启用高速模式、切换至标准模式、暂停、恢复、改为手动恢复。

## 性能实测
| 测试条件 | 标准模式 | 高速模式 |
|---|---|---|
| 4 vCPU，封禁来源 6 万 pps | 网络中断 CPU 1.0% | 0.4% |
| 4 vCPU，封禁来源 12 万 pps | 网络中断 CPU 12.3% | 5.5%；同时正常访问 9438→11381 次/秒、p99 5.29→3.60 ms、成功率 100% |
| 4 vCPU，封禁来源 117 万 pps | 网络中断 CPU 65% | 15%，99% 以上数据包在驱动层丢弃 |
| 2 vCPU 单队列 | 收包约 23–26 万 pps 时最热核 93–97% | 收包 52 万 pps、最热核约九成 |

建议：封禁来源每秒超过 6 万个数据包时开启高速模式；6 万以内两种模式差别不大。

数据来自真机压测（virtio 网卡）。

## 暂停与自动降级
- **暂停**:全部节点临时以标准模式运行,防护不中断。暂停可以设为若干小时后自动恢复,也可以改为手动恢复(「改为手动恢复」),此时需要在页面上点「恢复」才会重新启用。
- **自动降级**:运行中出现异常时,节点会自动回到标准模式并发出告警,网站继续正常服务;排除原因后再启用。

需要在节点本机关闭时,以 root 执行:

```
gocdn-agent xdp off
```

## 授权与升级
- 授权到期后进入缓冲期:缓冲开始时已部署的节点继续运行,其余节点暂不部署。缓冲期结束或授权被回收后,所有节点按标准模式运行,封禁与名单照常生效;续费后自动恢复。
- 节点程序升级后,XDP 组件会随之自动部署,不需要单独安装。

:::tip
XDP 只处理“已经确定要拦”的流量(封禁与黑名单)。识别攻击仍由 CC、WAF 与 Bot 防护完成,见[CC 防护](https://www.gocdn888.com/zh/guide/cc)和[名单与访问控制](https://www.gocdn888.com/zh/guide/lists)。
:::