安装与运行

Caddy 提供 单二进制、Docker 镜像 与 systemd 服务 三种常见部署方式。与 ngx-install 对照，Caddy 默认自带 ACME 客户端，无需单独装 certbot。

学习目标

• 在 Linux 上安装 Caddy 并验证版本
• 用 caddy validate 检查 Caddyfile 语法
• 了解 Docker 与 systemd 两种运行模式

核心内容

二进制安装（Linux）

# 官方脚本（示例）
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install caddy

caddy version
caddy validate --config /etc/caddy/Caddyfile

Windows 可从 Caddy 官网 下载 .exe，开发机 caddy run 即可。

systemd 运行

sudo systemctl enable --now caddy
sudo systemctl status caddy
sudo journalctl -u caddy -f

默认配置路径 /etc/caddy/Caddyfile，数据目录 /var/lib/caddy（证书持久化）。修改后 systemctl reload caddy，等价 Nginx 的 nginx -t && reload。

Docker 快速启动

docker run -d --name caddy \
  -p 80:80 -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  caddy:2-alpine

卷 caddy_data 存 ACME 证书，重启不重复申请。完整 Compose 见 caddy-docker。

与 CodeRoadMap 本地联调

测试机先启动 backend :8080 与 platform :3000，再启 Caddy 反代。DNS 将 test.coderoadmap.cn 指本机（dns-records）。

练习

• 安装 Caddy 并运行 caddy version
• 用最小 Caddyfile respond "ok" 验证 curl localhost
• 对比 Nginx 与 Caddy 的配置文件默认路径

小结

安装后先 caddy validate，再 reload；Docker 务必挂载 /data 存证书。 下一课 Caddyfile 语法。