# 在客户 IT 追问 80 端口之前，先画好出站清单

> 主机清单取自厂商官方，按域名而非 IP 申请，提交防火墙工单前把每一行讲清楚。

原文: https://fdetimes.net/zh/guides/egress-map-firewall-allowlist/

Snowflake 建议客户加入防火墙的主机清单里包含 80 端口。这个端口走明文 HTTP，用于检查证书是否已被吊销，即在线证书状态协议（OCSP）。如果白名单申请只写“443 出站访问互联网”，连接仍可能恰好在少有人留意的地方断掉。

对前线部署工程师（FDE）来说，在客户企业内部，网络往往是拖住部署最久的环节。代码能跑，数据也已就绪，所有工作却都停下来等一张防火墙工单。IT 每带着问题退回一次工单，就又要多耗几天。

本指南介绍如何做出一份足够清楚、让 IT 一次就能批准的出站清单，并用一个假设的客户贯穿始终。

客户是一家物流公司。你的方案从 Snowflake 读取数据，在 GitHub Enterprise Server 的自托管 runner 上运行持续集成（CI），团队还在客户网络内使用 Claude Code。

动手之前，你需要：在 Snowflake 账号上执行查询的权限（如果方案用到 Snowflake）、各厂商的网络文档，以及客户所用的云和区域。

## 第 1 步：先列组件，再列域名

先列出方案中所有会向网络外发起调用的组件。本例中有三个：Snowflake、CI runner 和 Claude Code。为每个组件记下云、区域和连接模式，因为正是这三项决定了哪些端点真正需要放行。

Databricks 不在本例场景中，但它的文档最能说明这一点。需要放行的端点随区域和部署模式而变；比如使用 PrivateLink 时，会有单独的 SCC relay 端点。因此，从其他区域项目照搬来的清单可能完全不对。

**检查：** 每个组件的三列都已填写：云、区域和连接模式。只要有一格空着，先问清客户再往下做。

## 第 2 步：清单取自来源，不要靠猜

Snowflake 提供了一个函数，能准确返回需要加入防火墙白名单的主机和端口。在客户自己的账号上执行：

```sql
SELECT SYSTEM$ALLOWLIST();
```

该函数返回一个 JSON 数组，每个元素包含三组键值：类型（`type`）、主机和端口。下面的片段只用来示意结果的结构。尖括号中的值是占位符，不是真实主机：

```json
[
  {"type": "<TYPE>", "host": "<host-1>", "port": 443},
  {"type": "OCSP_RESPONDER", "host": "<host-2>", "port": 80},
  {"type": "STAGE", "host": "<host-3>", "port": 443}
]
```

这里有两点要注意。端口并不总是 443：文档明确写着其中也包括 80 端口。另外，`STAGE` 和 `OCSP_RESPONDER` 等类型可能返回多行，所以清单必须依据完整输出来做，不能只看某一个主机名。

回到那家物流客户。假设输出有 6 个元素：1 个账号主机、2 行 `STAGE`，以及 3 行使用 80 端口的 `OCSP_RESPONDER`。只写“443 出站访问互联网”的工单只覆盖了 6 行中的 3 行，整个证书检查环节都被漏掉了。

**检查：** 表中 Snowflake 的行数与输出的元素个数相等，本例为 6。每个 80 端口的行都注明用于证书检查。

## 第 3 步：为什么要让 IT 按域名而不是按 IP 放行？

很多 IT 团队偏好基于 IP 的规则，觉得这样更好管控。你要提出相反的方案，并带上理由。Databricks 建议客户始终按域名（完全限定域名，FQDN）把 SCC relay 端点加入白名单。

Databricks 还提醒，这些域名背后的 IP 地址会定期变化。固定具体 IP 的客户，在基础设施变动时可能遭遇服务中断。

把这段理由原样写进工单。否则你就是在给几个月后埋下一起事故，而半夜被叫醒的往往就是你自己。

## 第 4 步：写清 CNAME 和通配符

GitHub 指出，自托管 runner 所需的部分域名配置为 CNAME 记录。对通过解析 DNS 生成规则的防火墙来说，这一点很关键，因为最终指向的域名可能也需要放行。在 runner 这一行加上备注，方便 IT 在自己的设备上核实。

通配符必须原样写出。Claude Code 的文档要求放行 `*.claudemcpcontent.com`，星号要保留。如果这个主机被拦截，应用其余部分仍能运行，但 widget 无法加载。

这种“半坏”的故障极难排查，所以要把拦截的后果写进用途一栏，并且只有团队确实用到 widget 时才申请这一行。

## 第 5 步：发送前先精简

清单越短，IT 批得越快。有些厂商已经标出了哪些主机是可选的。根据 Claude Code 的文档，两个 Datadog 采集主机只承载可选的运维遥测，设置 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 变量即可同时关闭：

```bash
# 设为 1 是开启该标志的常用方式；请以所用版本的文档为准
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

在本例中，先设置这个标志，再从表中删掉两行 Datadog。工单少了两行，IT 也能看出你只申请了真正需要的东西。

## 第 6 步：代理和 TLS 检查也要写进清单

在许多企业里，出站流量必须经过代理，还可能被解密 TLS 以做检查。Claude Code 使用标准的代理环境变量和操作系统的证书存储。因此，清单里需要有一节记录代理地址以及客户安装证书的方式：

```bash
# 标准代理变量；地址为示意用的占位符
export HTTPS_PROXY=http://<customer-proxy>:<port>
```

一开始就问 IT 是否解密 TLS。如果是，要明确写出：他们的根证书必须装进运行方案的机器的证书存储中。

## 第 7 步：一张完整的工单长什么样？

Claude Code 的网络文档页面是值得照搬的范本：一张 URL 表，每个 URL 都写明用途。你的申请也应采用同样的形式，再加上连接方向和是否必需两列。下面是本例填好的表格。主机名放在尖括号里，因为它们必须取自客户的真实环境：

| 主机（FQDN） | 端口 | 方向 | 用途 | 是否必需？ |
|---|---|---|---|---|
| SYSTEM$ALLOWLIST 返回的 `` | 443 | 出站 | 在 Snowflake 中查询数据 | 是 |
| ``、``（类型 STAGE） | 443 | 出站 | 通过 stage 读写数据 | 是，两行都需要 |
| `` 至 ``（OCSP_RESPONDER） | 80 | 出站 | 证书吊销检查 | 是，3 行都需要 |
| runner 所需的 GitHub Enterprise Server 域名 | 按 GitHub 文档 | 出站 | runner 领取 CI 任务；部分域名是 CNAME | 是 |
| `*.claudemcpcontent.com` | 按文档 | 出站 | 加载 widget；被拦截时其余部分仍能运行，但 widget 不显示 | 仅当团队使用 widget；如申请，保留通配符 |
| 2 个 Datadog 采集主机 | — | — | 可选遥测 | 不申请：已用标志关闭 |

表格上方写明云、区域和代理地址。表格下方加一句话，说明不需要任何入站访问。对于自托管 runner，GitHub 说明只需要从 runner 出站连接 GitHub Enterprise Server，反方向无需任何连接。不用开放任何入站端口，是你能向客户安全团队给出的最有力理由。

**检查：** 每一行都有用途，没有一行写的是 IP 地址，每个被排除的行都写明了删除原因。

## 让工单被退回的常见错误

最常见的是写“443 出站访问互联网”，却忘了 OCSP 用的 80 端口。其次是提交一次 DNS 查询得到的 IP 列表，等厂商基础设施更换地址时连接就断了。第三是照搬了区域或连接模式与客户环境不同的端点表。

还有两个小错误，代价同样不小。一是把通配符写成某一个具体主机；二是申请放行遥测主机，而其实一个环境变量就能把它们关掉。

## 把这项技能用到项目和简历上

客户项目启动时，争取在第一周就见到负责网络的人，不要等代码写好再说。带上上面那张表，并提前填好区域和连接模式。

在简历或面试中，避免“与客户 IT 协作”这种空泛说法。讲一张具体的工单：清单取自哪个来源，删掉了哪些主机，为什么一次就获批。

当岗位描述提到受限网络、企业代理或本地部署时，就是讲这个故事的时机。在这类环境里，几乎肯定有一张防火墙工单等着人来写。

写得好的防火墙工单不会引人注意：批了，事情就结束了。仓促写成的工单，却可能让整个项目停下来等待。

**本周动手试试:**

- 在测试用的 Snowflake 账号上执行 SELECT SYSTEM$ALLOWLIST();，数一数输出中有几行 OCSP_RESPONDER、几行 STAGE。
- 挑一个正在做的项目，写一张出站表，列出主机、端口、方向、用途以及必需或可选。在表格上方写明云、区域和连接模式。
- 打开你所用某个工具的网络配置页面，标出可选主机，并找到关闭它们的标志。

## 信源

- [SYSTEM$ALLOWLIST | Snowflake Documentation](https://docs.snowflake.com/en/sql-reference/functions/system_allowlist)

- [IP addresses and domains for Databricks services and assets | Databricks on AWS](https://docs.databricks.com/aws/en/resources/ip-domain-region)

- [Communicating with self-hosted runners - GitHub Enterprise Server 3.13 Docs](https://docs.github.com/en/enterprise-server@3.13/actions/concepts/runners/communicating-with-self-hosted-runners)

- [Enterprise network configuration - Claude Code Docs](https://code.claude.com/docs/en/network-config)
