> 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](/files/6J7CJJyZulBG3bqkAMMH)

## 您需要提供的信息

添加客户 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 继续正常工作；变更只影响前缀在公开路由中的宣告方式。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/welcome/cn/elastic-compute/networking/01-overview-4/02-customer-cidr.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.