network-exposure-baseline Skill — 默认限制绑定
network-exposure-baseline skill 如何将每个端口绑定分为四个层级,在没有正当理由时阻止公网暴露,并作为门禁集成到 /dr-plan、/dr-do 和 /dr-archive 中。
默认公开即默认泄露。在之前的一次部署事故中,Redis 7.x 在无身份验证的情况下监听 0.0.0.0:6379,Postgres 以 listen_addresses='*' 和默认密码运行——两者均可从公网访问,最终导致监管机构滥用报告。根本原因是 docker compose 默认绑定到 0.0.0.0,且没有 CI 门禁。network-exposure-baseline skill 的存在就是为了防止这类错误。
在任何涉及 Docker Compose 端口、Redis 绑定地址、Postgres listen_addresses、systemd socket ListenStream 值或防火墙规则的变更之前,必须加载该 skill。它不适用于不涉及网络变更的纯内部重构。
四个层级
每个绑定目标都属于四个层级之一。层级 0 是 Unix socket 或未发布端口——始终允许,无需正当理由。层级 1 是回环地址:127.0.0.1、::1 或其 IPv6 映射等价地址——始终允许。层级 2 是 Tailscale CGNAT 范围(100.64.0.0/10)——按定义仅限 mesh,始终允许。
层级 3 涵盖其他所有情况:0.0.0.0、::、通配符 *、特定公网 IPv4 地址、RFC1918 私有范围和链路本地地址。RFC1918 私有地址属于层级 3,因为静态 linter 无法证明私有范围绑定是安全的——私有地址桥接到公网路由接口上就是真实的暴露。回环和 Tailscale CGNAT 在构造上就是安全的;其他所有情况都需要人工正当理由。
正当理由格式与 TTL
层级 3 绑定需要在 docker-compose.yml 中为服务添加两个字段:x-exposure-justification,描述实际缓解措施;以及 x-exposure-expires,日期不超过未来 90 天。TTL 不是可选项。没有强制过期,豁免会累积并被遗忘。TTL 缺失或过期是 FAIL,而不是警告。
对于非 compose 配置——Redis、Postgres、systemd socket——相同信息放在行内注释中:# exposure: justified expires=YYYY-MM-DD — reason。
docker-compose 中的短格式端口(例如没有主机 IP 的 "5432:5432")是隐式的 0.0.0.0 绑定,默认失败。Docker Compose 变量插值如 ${TAILNET_IP}:443:443 会在分类前从环境解析;如果变量未设置且无默认值,linter 会发出警告并通过——它无法知道运行时值。
流水线集成
该门禁在四个流水线阶段运行。在 /dr-prd,PRD 中必须有 Network Exposure Baseline 部分,包含层级声明和层级 3 正当理由。在 /dr-plan,如果计划涉及网络表面但没有明确的层级分类,会发出警告。在 /dr-do,任何新的 0.0.0.0 绑定或无正当理由的短格式端口都会阻止该步骤。在 /dr-archive,每个层级 3 绑定都必须有未过期的正当理由。
规范验证器是 dev-tools/network-exposure-check.sh。skill 文档与脚本之间的任何偏差都是缺陷——两者必须一起更新。
阅读什么是 Datarim了解更广泛的背景,或查看关于infra-automation skill的相关文章,了解依赖正确绑定配置的服务器运维模式。