Caddy 两行配置上 HTTPS,客户网络却常让它失灵
会前先问清哪些端口开放、证书由谁签发、哪些机器会信任它,否则浏览器警告会当场弹出。
要点速览
- 一个站点地址加一行 reverse_proxy,Caddy 就会自动申请、续期证书,并把 HTTP 重定向到 HTTPS。
- HTTP 验证要求 80 端口对互联网开放。客户防火墙拦截所有入站连接时,DNS 验证是备选方案。
- 内部主机名和 IP 地址的证书来自 Caddy 本地 CA,因此客户侧浏览器必须信任该 CA 的根证书。
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 个信源
- Caddy - The Ultimate Server with Automatic HTTPS
- GitHub - caddyserver/caddy: Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS
- Automatic HTTPS — Caddy Documentation
- Challenge Types - Let's Encrypt · 2026-02-12
- Best Practice - Keep Port 80 Open - Let's Encrypt · 2019-01-24
- Reverse proxy quick-start — Caddy Documentation
- reverse_proxy (Caddyfile directive) — Caddy Documentation