控制面 IP 限制
API7 控制面(控制台和 Admin API)是部署中权限最高的管理入口。限制可以访问控制面的 IP 地址,可以缩小凭证被盗、横向移动和暴力破解场景下的攻击面。
控制台和 Admin API 由同一个控制面进程提供,并共享同一个配置文件。在其中配置的内置 IP 允许列表同时应用于两个界面。
配置内置 IP 允许列表
控制面从配置文件中读取 security.ip_restriction 配置块。Docker Compose 布局使用 dashboard_conf/conf.yaml,Helm 使用相应的 ConfigMap。将受信任网络添加到 allow_list:
dashboard_conf/conf.yaml
security:
ip_restriction:
allow_list:
- 192.168.1.0/24
- 10.0.0.5/32
- 2001:db8::10/128
deny_list: []
message: "Access denied"
response_code: 403
行为说明:
- 两个列表仅接受 CIDR 格式。单个 IPv4 地址使用
/32,单个 IPv6 地址使用/128。不带前缀或格式错误的条目会导致控制面无法启动。 - 空
allow_list表示允许所有请求;空deny_list表示不拒绝任何请求。要限制控制面,请将allow_list设置为非空列表。 - 来自不在允许列表中的 IP 的请求会在执行任何身份认证前收到 HTTP
403和{"error_msg":"Access denied"}。这同时适用于同一监听端口(默认为7443)上的控制台界面和 Admin API。 message和response_code用于自定义拒绝响应。
重启控制面容器或 Pod 以应用更改。
警告
启用 allow_list 前,请确保包含所有需要访问控制面的操作人员工作站、CI/CD Runner 和监控系统的 IP。列表配置错误可能导致无法访问控制台和 Admin API;恢复时需要通过控制面主机的 shell 访问还原文件。