网络与路由

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 或上游没有正确路由，面板中分配出的地址也无法从公网访问。

IPv6 NAT（NAT66）

宿主机只有一个公网 IPv6 /128 时，可在「网络与路由」启用 IPv6 NAT，让容器通过 ULA 内网地址共享该公网 IPv6。ULA 不是独立公网地址池，不能直接从公网访问；入站服务使用 [宿主机 IPv6]:外部端口 → [容器 ULA]:内部端口 映射。

全局开关默认关闭。启用后，普通 lxcbr0 LXC 容器自动分配 ULA；可设置 ULA /64 子网和上联网卡。此功能不为 KVM 或其他自定义网桥自动分配地址。

映射默认同步 IPv4 配置，IPv6 侧只读。管理员关闭同步时，会把当前映射保存为独立 IPv6 映射，之后可单独新增、编辑和删除，并受端口配额限制；未单独指定配额时继承 IPv4 配额。端口或地址冲突会返回错误，不会覆盖其他容器的映射。

http

GET /api/v1/ipv6/nat
PUT /api/v1/ipv6/nat
GET /api/v1/containers/{id}/ipv6-port-mappings
POST /api/v1/containers/{id}/ipv6-port-mappings
PUT /api/v1/containers/{id}/ipv6-port-mappings/{index}
DELETE /api/v1/containers/{id}/ipv6-port-mappings/{index}
PUT /api/v1/containers/{id}/ipv6-nat-sync

全局设置仅限管理员。容器映射接口要求 container:network 权限及对应容器授权；同步开关接收 {"enabled":true} 或 {"enabled":false}。{index} 从零开始，现有 IPv4 接口和旧模块的索引语义保持不变；同步模式下，IPv4 映射更新也会反映到 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、端口容量等运行时状态。

网络与路由 ​

NAT4 ​

IPv6 ​

IPv6 NAT（NAT66） ​

公网 IPv4 ​

路由状态 ​

网络与路由

NAT4

IPv6

IPv6 NAT（NAT66）

公网 IPv4

路由状态