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

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

原文: https://fdetimes.net/zh/tools/caddy-reverse-proxy-https-client-demo/

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 端口。

**本周动手试试:**

- 把你自己的一个子域名解析到 VPS，开放 80 和 443 端口，用那两行 Caddyfile 运行 caddy run，然后逐一检查三点：https 地址能打开，证书签发方是 Let's Encrypt 或 ZeroSSL，http 会自动重定向到 https
- 在 VPS 防火墙上封掉 80 端口，看证书签发是否还能成功，提前了解这种失败是什么样子
- 为客户 IT 团队写一页运维手册，说明必须开放哪些端口、证书由谁签发，以及如何让用户机器信任内部根证书

## 信源

- [Caddy - The Ultimate Server with Automatic HTTPS](https://caddyserver.com/)

- [GitHub - caddyserver/caddy: Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS](https://github.com/caddyserver/caddy)

- [Automatic HTTPS — Caddy Documentation](https://caddyserver.com/docs/automatic-https)

- [Challenge Types - Let's Encrypt](https://letsencrypt.org/docs/challenge-types/)

- [Best Practice - Keep Port 80 Open - Let's Encrypt](https://letsencrypt.org/docs/allow-port-80/)

- [Reverse proxy quick-start — Caddy Documentation](https://caddyserver.com/docs/quick-starts/reverse-proxy)

- [reverse_proxy (Caddyfile directive) — Caddy Documentation](https://caddyserver.com/docs/caddyfile/directives/reverse_proxy)
