FDE Times 数据在招 FDE 职位 882▼2 近 7 天在招职位数的变化(同口径比较):不计入本周新开始追踪的公司的职位近 7 天新增 52在招公司 185支持远程 25%美国薪资中位数 $200k招聘最多 Databricks 98
ENVI

前线部署工程师(FDE)的专业媒体

技能指南 · 指南

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

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

分享微博

要点速览

  • 出站清单必须来自官方来源。Snowflake 提供一个函数,返回需要放行的主机和端口,其中就包括 80 端口。
  • 按域名申请规则,而不是按 IP。Databricks 提醒,其域名背后的 IP 地址会定期变化,固定 IP 的做法可能导致服务中断。
  • 好的申请只要求出站连接,去掉不必要的遥测,并说明每个主机的用途。
横向条形图,展示一份假设的 SYSTEM$ALLOWLIST 输出,共 6 行:1 行账户主机,端口 443;2 行 STAGE,端口 443;3 行 OCSP_RESPONDER,端口 80。OCSP 条形被高亮标出:只写 443 的工单会漏掉这 3 行。
工单如果只写"放行 443 到公网",6 行里只能覆盖 3 行,80 端口上的证书检查会全部漏掉。来源:文中的假设示例,基于 Snowflake 的 SYSTEM$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 提供了一个函数,能准确返回需要加入防火墙白名单的主机和端口。在客户自己的账号上执行:

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 协作”这种空泛说法。讲一张具体的工单:清单取自哪个来源,删掉了哪些主机,为什么一次就获批。

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

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

这篇文章对你有帮助吗?

4 个信源
路线图上的下一篇 · 阶段 5: 部署上线管道不能停时,客户的坏数据该去哪里死信队列能安全存放坏数据,前提是重试、保留期和值班人员都配置到位。