> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/welcome/cn/elastic-compute/networking/01-overview-4/02-customer-cidr.md).

# 自带 IP 客户 CIDR

客户 CIDR 是核心的 BYOIP 资源。它代表您携带进 Zenlayer 的一个 IPv4 前缀、该前缀宣告所使用的线路，以及负责宣告该前缀的 ASN。所有其他 BYOIP 操作 — 分配、宣告更新、删除 — 都以该资源为基础。

![客户 CIDR → EIP 池 → 已分配的 EIP](https://2318250923-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBWy7DFFtkhyEC9R4kE%2Fuploads%2Fgit-blob-26b9c0c77a7bb1a214b8f2bae72261947aea301a%2Fpool-structure.svg?alt=media)

## 您需要提供的信息

添加客户 CIDR 时，您需要确定三项值：

| 字段       | 控制内容         | 备注                             |
| -------- | ------------ | ------------------------------ |
| **CIDR** | 您拥有的 IPv4 前缀 | 必须可在公网路由；`/24` 或更短是实际最小值       |
| **ISP**  | 用于宣告前缀的线路类型  | 平台仅接受支持自动宣告的 ISP               |
| **ASN**  | 公开路由中的源 ASN  | 必须在平台支持列表中，且须经 RPKI 授权用于该 CIDR |

CIDR 本身即是标识符。针对特定客户 CIDR 的操作 — 查询、更新 ASN、删除 — 均直接使用前缀来引用。无需记录额外的合成 ID。

## CIDR 详情页显示的属性

CIDR 被接受后，其详情视图将显示以下属性：

| 属性          | 描述                                  |
| ----------- | ----------------------------------- |
| **CIDR**    | 您携带进来的 IPv4 前缀                      |
| **ISP**     | 宣告线路类型                              |
| **源 ASN**   | 当前宣告该前缀的 ASN                        |
| **池 ID**    | 存放该 CIDR 地址的 EIP 池                  |
| **客户自有标记**  | 将池中每个地址标记为客户自有，便于与 Zenlayer 分配的地址区分 |
| **IP 分配详情** | 每个地址的分配状态及其绑定的工作负载                  |

当您需要查找"哪个工作负载正在使用该地址"时，IP 分配详情是最快速的路径，可将地址精确定位到具体资源。

## 从客户 CIDR 到 EIP 池

客户 CIDR 被接受后，会创建 — 并与之绑定 — 恰好一个 EIP 池：

1. 您提交 CIDR、ISP 和 ASN。
2. 平台验证请求，运行 RPKI 检查，并开始宣告该前缀。
3. 该前缀注册到 EIP 资源系统，以池的形式暴露该地址块。
4. 以该池为目标的分配请求将返回来自该 CIDR 的地址。

池是从 CIDR 中提取地址的唯一途径 — 没有更底层的机制。反之，一旦 CIDR 被删除，其池也随之消失。

## 生命周期状态

客户 CIDR 经历一组由 Console 操作驱动的状态：

| 状态      | 含义                                                                                                                                                            |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **验证中** | 请求已受理，RPKI / ASN 检查正在运行。                                                                                                                                      |
| **活跃**  | 前缀已宣告，EIP 池已开放分配。                                                                                                                                             |
| **更新中** | 源 ASN 变更正在处理中；现有分配继续正常工作。                                                                                                                                     |
| **删除中** | 撤销宣告正在进行中；不再允许新的分配。                                                                                                                                           |
| **错误**  | 验证失败，或平台无法将前缀投入服务。事件日志将说明原因（参见[最佳实践](https://docs.console.zenlayer.com/welcome/cn/elastic-compute/networking/01-overview-4/pages/c2RSUfyXuwdEIR8QsRTR#故障排查)）。 |

## 与已分配 EIP 的关系

在其任何地址仍处于绑定状态时，客户 CIDR 无法被干净地删除。因此，释放 CIDR 是一个逆序操作：

1. 解绑从该池分配的 EIP。
2. 释放这些 EIP。
3. 删除客户 CIDR。此操作同时撤销宣告并移除 IP 池。

删除操作会拒绝在任何地址仍处于分配状态时执行 — 该检查防止了前缀在活跃工作负载下被静默移除所导致的服务中断。

***

## 常见问题

**创建后可以更改 ISP 线路吗？** 不可以。ISP 选择在创建时确定。如需切换到其他线路，需删除当前 CIDR 并以新 ISP 重新添加。

**多个池可以共享一个 CIDR 吗？** 不可以。每个被接受的客户 CIDR 对应恰好一个 EIP 池。

**更新源 ASN 后，我的分配会受到影响吗？** 不会。已分配的 EIP 继续正常工作；变更只影响前缀在公开路由中的宣告方式。