当前位置：首页 > news >正文

Caddy 反向代理 - EM

news 2026/5/4 17:47:50

Caddy官网：https://caddyserver.com

为什么我开始用 Caddy

最初接触 Caddy，是因为它在社区中被广泛推荐为一款“自动 HTTPS 一把梭”的轻量级 Web 服务器；只要你有个域名、端口没被封，Caddy 理论上能自动申请并续签 HTTPS 证书，全程无需手动操作，真正实现开箱即用；

不过，实话实说，我并没能成功实现自动 HTTPS；
我这台小水管部署在没有公网 IP 的局域网环境中，Let's Encrypt 验证域名所有权时无法访问到我的服务器，自然无法成功签发证书；翻了一些文档后确认，这种内网场景确实不适合自动签证；

但我使用 Caddy 的真正目的其实并不是自动 HTTPS，而是简洁地实现反向代理；我的需求是把一些局域网服务（比如 Web 控制面板、API 服务、博客页面）通过统一的域名访问，而不是记一堆不同端口；

相比 Nginx 那一堆配置、手动写 location、reload 重载，Caddy 用 Caddyfile 几行就搞定，还能自动帮我处理 header、压缩、缓存等常用设置；
虽然 HTTPS 自动签发失败，但 Caddy 依然凭借其优秀的反向代理能力和极简配置体验让我留下它；

安装和基本使用

安装 Caddy（推荐官方一键脚本）

curl -fsSL https://get.caddyserver.com | bash -s personal

或者使用包管理器，如在 Debian/Ubuntu 下：

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/caddy.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy.list
sudo apt update
sudo apt install caddy

编写配置文件

默认配置文件路径为 /etc/caddy/Caddyfile，也可以自己创建一个 Caddyfile 并通过命令指定；

sudo nano /etc/caddy/Caddyfile

启动 Caddy

编辑完配置后，使用 systemd 启动 Caddy：

sudo systemctl restart caddy
sudo systemctl enable caddy

或者直接在本地调试运行：

caddy run --config /path/to/Caddyfile

我的 Caddy 配置详解

配置监听端口（http_port）

{http_port 8080
}

因为 80 端口经常被占用（尤其内网小主机上），我将默认 HTTP 监听端口改为了 8080，更灵活些；

反代局域网里的服务

你的域名 {# 你的域名证书tls cert.crt cert.key# 本地服务reverse_proxy 127.0.0.1:34718
}

这个配置用于访问运行在本机 34718 端口的服务；

域名解析的是我在虚拟组网中的主机地址，因此组网内的设备都能通过域名来访问该服务；

这里的证书我是使用Certd申请的，详情见：Docker部署Certd，实现HTTPS证书自动申请与更新；

反代局域网中的https服务

你的域名 {reverse_proxy https://192.168.0.1:1234 {transport http {# 跳过 TLS 验证，避免证书错误导致Caddy反代失败tls_insecure_skip_verify}}# 你的证书tls cert.crt cert.key
}

这里反向代理的是别的设备的https服务；

Caddy 默认验证目标服务的 TLS 证书，由于我这里是自签的，就使用 tls_insecure_skip_verify 跳过了验证，避免反代失败；

本地静态页面（端口访问）

:21824 {tls emtime.crt emtime.keyroot * /home/time/doc/blog/publicfile_serverhandle_errors {@404 {expression {http.error.status_code} == 404}rewrite @404 /404.htmlfile_server}
}

这是一个纯静态服务配置，我用来部署 Hexo 生成的博客页面；

Caddy 会监听 21824 端口，并将 /home/time/doc/blog/public 目录作为静态资源根目录；配置中还加了自定义的 404.html 页面处理逻辑；

因为没有公网 IP，这个页面更多是在局域网访问时使用；

本地静态页面（绑定域名）

blog.emtime.top {tls emtime.crt emtime.keyroot * /home/time/doc/blog/publicfile_serverhandle_errors {@404 {expression {http.error.status_code} == 404}rewrite @404 /404.htmlfile_server}
}

这个配置和上面几乎一致，只是绑定了 blog.emtime.top 这个域名，可能正是你现在正在访问的这个博客的域名（我还有别的域名也同样部署了同样的博客）；