在客户 IT 追问 80 端口之前,先画好出站清单
主机清单取自厂商官方,按域名而非 IP 申请,提交防火墙工单前把每一行讲清楚。
要点速览
- 出站清单必须来自官方来源。Snowflake 提供一个函数,返回需要放行的主机和端口,其中就包括 80 端口。
- 按域名申请规则,而不是按 IP。Databricks 提醒,其域名背后的 IP 地址会定期变化,固定 IP 的做法可能导致服务中断。
- 好的申请只要求出站连接,去掉不必要的遥测,并说明每个主机的用途。
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 提供了一个函数,能准确返回需要加入防火墙白名单的主机和端口。在客户自己的账号上执行:
SELECT SYSTEM$ALLOWLIST();
该函数返回一个 JSON 数组,每个元素包含三组键值:类型(type)、主机和端口。下面的片段只用来示意结果的结构。尖括号中的值是占位符,不是真实主机:
[
{"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 变量即可同时关闭:
# 设为 1 是开启该标志的常用方式;请以所用版本的文档为准
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
在本例中,先设置这个标志,再从表中删掉两行 Datadog。工单少了两行,IT 也能看出你只申请了真正需要的东西。
第 6 步:代理和 TLS 检查也要写进清单
在许多企业里,出站流量必须经过代理,还可能被解密 TLS 以做检查。Claude Code 使用标准的代理环境变量和操作系统的证书存储。因此,清单里需要有一节记录代理地址以及客户安装证书的方式:
# 标准代理变量;地址为示意用的占位符
export HTTPS_PROXY=http://<customer-proxy>:<port>
一开始就问 IT 是否解密 TLS。如果是,要明确写出:他们的根证书必须装进运行方案的机器的证书存储中。
第 7 步:一张完整的工单长什么样?
Claude Code 的网络文档页面是值得照搬的范本:一张 URL 表,每个 URL 都写明用途。你的申请也应采用同样的形式,再加上连接方向和是否必需两列。下面是本例填好的表格。主机名放在尖括号里,因为它们必须取自客户的真实环境:
| 主机(FQDN) | 端口 | 方向 | 用途 | 是否必需? |
|---|---|---|---|---|
SYSTEM$ALLOWLIST 返回的 <account host> |
443 | 出站 | 在 Snowflake 中查询数据 | 是 |
<stage-1>、<stage-2>(类型 STAGE) |
443 | 出站 | 通过 stage 读写数据 | 是,两行都需要 |
<ocsp-1> 至 <ocsp-3>(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 协作”这种空泛说法。讲一张具体的工单:清单取自哪个来源,删掉了哪些主机,为什么一次就获批。
当岗位描述提到受限网络、企业代理或本地部署时,就是讲这个故事的时机。在这类环境里,几乎肯定有一张防火墙工单等着人来写。
写得好的防火墙工单不会引人注意:批了,事情就结束了。仓促写成的工单,却可能让整个项目停下来等待。
这篇文章对你有帮助吗?
感谢你的反馈!