Files
CLICD/docs/features/networking.md
T
MengMengCode a45e063fc2 Add comprehensive documentation for CLICD features and operations
- Introduced Container Management documentation covering lifecycle operations, resource management, and console access.
- Added Dashboard documentation detailing metrics and related APIs.
- Created Host Report documentation summarizing host environment and resource status.
- Included Image Management documentation for template handling and management actions.
- Documented Networking and Routing features including NAT4 and IPv6 management.
- Added Security Alerts documentation outlining alert scenarios and API usage.
- Created Snapshot Management documentation for snapshot operations and scheduling.
- Documented Sub-user management for granting access to specific containers.
- Added Configuration guide detailing runtime settings and security recommendations.
- Created Installation guide for setting up CLICD with requirements and steps.
- Added Introduction and Quick Start guides for new users.
- Documented Upgrade process with version checking and pre-upgrade checklist.
- Created Deployment guide for service exposure and firewall recommendations.
- Added FAQ section addressing common questions and concerns.
- Documented Troubleshooting steps for common issues encountered.
2026-06-10 00:42:06 +08:00

1.7 KiB

网络与路由

CLICD 提供 NAT4 端口映射、随机可用端口、公网 IPv4 分配、IPv6 状态检查和 IPv6 分配能力。创建容器时可以只分配 NAT、只分配公网 IPv4、只分配 IPv6,或按需混合使用。

NAT4

NAT4 用于把宿主机端口转发到容器内部端口。典型用途:

  • 转发 SSH。
  • 暴露 Web 服务。
  • 给子用户分配固定外部端口。

端口映射包含:

字段 说明
名称 用于识别用途,例如 sshweb
协议 tcpudp
外部端口 宿主机对外监听端口。
内部端口 容器内部服务端口。

IPv6

IPv6 分配要求宿主机本身拥有可路由 IPv6 地址段,并且系统路由、邻居发现或代理策略配置正确。

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 地址列表。

公网地址池相关接口:

GET /api/v1/routing
PUT /api/v1/routing
POST /api/v1/routing/ipv4-scan

路由状态

GET /api/v1/routing

该接口用于查看 NAT、IPv6、端口容量等运行时状态。