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

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

工具

Caddy 两行配置上 HTTPS,客户网络却常让它失灵

会前先问清哪些端口开放、证书由谁签发、哪些机器会信任它,否则浏览器警告会当场弹出。

分享微博

要点速览

  • 一个站点地址加一行 reverse_proxy,Caddy 就会自动申请、续期证书,并把 HTTP 重定向到 HTTPS。
  • HTTP 验证要求 80 端口对互联网开放。客户防火墙拦截所有入站连接时,DNS 验证是备选方案。
  • 内部主机名和 IP 地址的证书来自 Caddy 本地 CA,因此客户侧浏览器必须信任该 CA 的根证书。
决策树:如果服务有公网主机名,Caddy 从 Let's Encrypt 或 ZeroSSL 获取公共证书,无需其他操作;如果没有,Caddy 使用本地 CA 签发的自签名证书,额外一步是询问客户 IT 团队,是安装内部根 CA 还是使用他们自己的 CA。
有公网主机名时,Caddy 会自行申请证书,无需其他操作;没有时,要尽早询问客户 IT 团队。来源:Caddy 自动 HTTPS 与 reverse_proxy 文档。

Caddy 官方文档讲解 reverse_proxy 指令时,只用了一个配置块:一个站点地址,加上一行 reverse_proxy localhost:9005。对于要在客户会议前让演示跑在 HTTPS 上的前线部署工程师(FDE)来说,这两行就替代了申请证书、编写重定向规则和安排续期。

难点在客户的网络。有三个问题要先弄清:哪些端口开放,证书由谁签发,哪些机器会信任它。三个问题都有了答案,浏览器才不会在客户盯着屏幕的那一刻弹出安全警告。

Caddy 开箱即用能做什么?

Caddy 官网首页写明,它默认会为你声明的每个站点申请并续期 TLS 证书。自动 HTTPS(Automatic HTTPS)文档补充说,80 端口上的 HTTP 请求会自动重定向到 443 端口上的 HTTPS,无需写任何配置。

证书有两个可能的来源。Caddy 默认启用两家兼容 ACME 的 CA:Let’s Encrypt 和 ZeroSSL,所以查看证书时,签发方可能是其中任意一家。

触发整套机制的是主机名。根据 reverse_proxy 文档,当站点地址是公网域名时,Caddy 会自动为该站点开启 HTTPS。

实例:从 Caddyfile 到客户能打开的 URL

假设你在一台 VPS 的 9005 端口上跑着一个演示 API,并且已经把 demo.example.com 解析到这台机器。Caddyfile 只需要这几行:

demo.example.com {
	reverse_proxy localhost:9005
}

第一行是站点地址,中间一行把所有请求转发到 9005 端口上的后端。按照反向代理快速入门的做法,在 Caddyfile 所在目录运行 caddy run。每次修改后都要重新加载 Caddy,否则服务器仍在使用旧配置。

服务跑起来,不等于工作完成。把链接发给客户之前,要检查三件事。首先,在浏览器里打开 https://demo.example.com,看页面能否加载、有没有警告。接着查看证书详情:签发方应该是 Let’s Encrypt 或 ZeroSSL。

最后检查重定向。运行 curl -I http://demo.example.com,看响应是否指向 https:// 地址。重定向走的是 80 端口,所以这一步失败,问题通常出在这个端口上;在客户现场排查时,这里也是首先要看的地方。

客户侧必须开放哪些端口?

Caddy 向 CA 证明你控制某个域名的过程叫作验证(challenge),每种验证方式都有各自的网络要求。Caddy 文档明确指出,HTTP 验证要求 80 端口能从外部访问。Let’s Encrypt 同样确认,HTTP-01 只能使用 80 端口,没有替代端口。

如果 80 端口被封,但 443 端口仍对外开放,还可以用 TLS-ALPN 验证。如果客户防火墙拦截了所有入站连接,Caddy 文档指出,DNS 验证完全不需要开放端口,代价是你需要有为该域名创建 DNS 记录的权限。

Let’s Encrypt 建议所有面向 Web 的服务器同时开放 80 和 443 端口。它还提到,如果 ISP 封锁 80 端口,HTTP-01 就会失败,而且这种验证方式无法签发通配符证书。所以如果客户需要 *.demo.example.com,一开始就改用 DNS-01。

由此可以整理出三个问题,在安装前几天发给客户的 IT 团队:从互联网到这台机器的 80 端口是否开放?443 端口呢?如果两个都关闭,团队里谁有权限为该域名创建 DNS 记录?

你自己的准备工作,是提前读一遍 Caddy 文档中 DNS 验证的部分。等第三个问题的答案回来,你已经清楚切换到这个备选方案需要什么。

私有网络里的演示怎么办?

如果服务只有 IP 地址或内部主机名,Caddy 代码仓库中的说明是:Caddy 不找公共 CA,而是从一个完全由它自己管理的本地 CA 获取证书。流量依然加密,但只有当浏览器所在机器信任这个本地 CA 的根证书时,浏览器才会信任该证书。

这一点同样要尽早问清:IT 团队是否同意在用户机器上安装这个根证书,还是更愿意使用自家 CA 签发的证书?如果客户已经有代理、自己的 CA 和证书管理流程,你要做的就是遵循这套流程。

先学什么,简历上写什么

先从一个站点块和一行 reverse_proxy 入手,再学验证方式和网络端口,本地 CA 放在最后。简历上,写一句“在客户网络内为演示 API 部署 HTTPS,并为 IT 团队编写端口与证书运维手册”,远比在工具列表里写上 Caddy 有分量。

客户很少会注意到地址栏里的小锁。他们记住的是演示中途弹出的安全警告,而这个警告,往往源于一个事先没人检查过的 80 端口。

这篇文章对你有帮助吗?

7 个信源
路线图上的下一篇 · 阶段 5: 部署上线客户不要 Terraform?原因决定选 Pulumi 还是 OpenTofu担心许可证的客户与想用编程语言写基础设施的团队,需要的工具不同,先问清原因。