[ PROMPT_NODE_24156 ]
Network Interconnect 说明文档
[ SKILL_DOCUMENTATION ]
# Cloudflare 网络互联 (CNI)
连接到 Cloudflare 网络的私有高性能连接。**仅限企业版**。
## 连接类型
**Direct(直连)**: 共享数据中心内的物理光纤。10/100 Gbps。需订购交叉连接。
**Partner(合作伙伴)**: 通过 Console Connect, Equinix, Megaport 等虚拟连接。通过合作伙伴 SDN 管理。
**Cloud(云)**: AWS Direct Connect 或 GCP Cloud Interconnect。仅限 Magic WAN。
## 数据平面版本
**v1 (经典)**: 支持 GRE 隧道、VLAN/BFD/LACP、非对称 MTU (1500↓/1476↑)、对等互联支持。
**v2 (测试版)**: 无 GRE,双向 1500 MTU,暂不支持 VLAN/BFD/LACP,改用 ECMP。
## 使用场景
- **Magic Transit DSR**: DDoS 防护,通过 ISP 出口 (v1/v2)
- **Magic Transit + Egress**: DDoS + 通过 CF 出口 (v1/v2)
- **Magic WAN + Zero Trust**: 私有骨干网 (v1 需要 GRE,v2 原生)
- **Peering(对等互联)**: PoP 点的公共路由 (仅 v1)
- **应用安全**: WAF/缓存/负载均衡 (v1/v2 通过 Magic Transit)
## 前置条件
- 企业版套餐
- IPv4 /24+ 或 IPv6 /48+ 前缀
- v1 需要 BGP ASN
- 查看 [位置 PDF](https://developers.cloudflare.com/network-interconnect/static/cni-locations-2026-01.pdf)
## 规格
- /31 点对点子网
- 最大光纤距离 10km
- 10G: 10GBASE-LR 单模
- 100G: 100GBASE-LR4 单模
- **无 SLA** (免费服务)
- 需要备份互联网连接
## 吞吐量
| 方向 | 10G | 100G |
|-----------|-----|------|
| CF → 客户 | 10 Gbps | 100 Gbps |
| 客户 → CF (对等互联) | 10 Gbps | 100 Gbps |
| 客户 → CF (Magic) | 1 Gbps/隧道 或 CNI | 1 Gbps/隧道 或 CNI |
## 时间线
通常 2-4 周。步骤:请求 → 配置审查 → 订购连接 → 配置 → 测试 → 启用健康检查 → 激活 → 监控。
## 本参考文档内容
- [configuration.md](./configuration.md) - BGP, 路由, 设置
- [api.md](./api.md) - API 端点, SDK
- [patterns.md](./patterns.md) - HA, 混合云, 故障转移
- [gotchas.md](./gotchas.md) - 故障排除, 限制
## 按任务阅读顺序
| 任务 | 加载文件 |
|------|---------------|
| 初始设置 | README → configuration.md → api.md |
| 通过 API 创建互联 | api.md → gotchas.md |
| 设计 HA 架构 | patterns.md → README |
| 故障排除连接 | gotchas.md → configuration.md |
| 云集成 (AWS/GCP) | configuration.md → patterns.md |
| 监控 + 警报 | configuration.md |
## 自动化边界
**API 可自动化:**
- 列出/创建/删除互联 (Direct, Partner)
- 列出可用插槽
- 获取互联状态
- 下载 LOA PDF
- Cr