网络与路由
CLICD 提供 NAT4 端口映射、随机可用端口、公网 IPv4 分配、IPv6 状态检查和 IPv6 分配能力。创建容器时可以只分配 NAT、只分配公网 IPv4、只分配 IPv6,或按需混合使用。
NAT4
NAT4 用于把宿主机端口转发到容器内部端口。典型用途:
- 转发 SSH。
- 暴露 Web 服务。
- 给子用户分配固定外部端口。
端口映射包含:
| 字段 | 说明 |
|---|---|
| 名称 | 用于识别用途,例如 ssh、web。 |
| 协议 | tcp 或 udp。 |
| 外部端口 | 宿主机对外监听端口。 |
| 内部端口 | 容器内部服务端口。 |
IPv6
IPv6 分配要求宿主机本身拥有可路由 IPv6 地址段,并且系统路由、邻居发现或代理策略配置正确。
http
GET /api/v1/ipv6/status
POST /api/v1/containers/{id}/ipv6如果宿主机没有公网 IPv6 或上游没有正确路由,面板中分配出的地址也无法从公网访问。
公网 IPv4
公网 IPv4 分配会从主机检测到的可用公网 IPv4 中选择地址,或使用 API 指定的 public_ipv4s。创建容器时可使用:
| 字段 | 说明 |
|---|---|
assign_nat | 是否启用 NAT 端口映射。 |
assign_ipv4 | 是否分配公网 IPv4。 |
ipv4_count | 自动分配公网 IPv4 数量。 |
public_ipv4s | 指定公网 IPv4 地址列表。 |
assign_ipv6 | 是否分配 IPv6。 |
ipv6_count | 自动分配 IPv6 数量。 |
ipv6_addresses | 指定 IPv6 地址列表。 |
公网地址池相关接口:
http
GET /api/v1/routing
PUT /api/v1/routing
POST /api/v1/routing/ipv4-scan路由状态
http
GET /api/v1/routing该接口用于查看 NAT、IPv6、端口容量等运行时状态。