pzg's blog

1. 基本启动与控制

这些命令主要用于启动、停止、重载 Caddy 服务。

命令	作用	说明
caddy run	前台运行 Caddy	直接在终端运行，输出日志
caddy start	后台启动 Caddy	类似守护进程模式
caddy stop	停止正在运行的 Caddy	中断进程或后台服务
caddy reload	平滑重载配置	不影响现有连接，常用于更新 Caddyfile
caddy version	查看当前版本	可确认安装的版本号
caddy help	查看帮助	列出所有支持的子命令

---

2. 系统服务（Linux 常用）

如果用 systemd 管理 Caddy：

sudo systemctl start caddy        # 启动
sudo systemctl stop caddy         # 停止
sudo systemctl restart caddy      # 重启
sudo systemctl reload caddy       # 重载
sudo systemctl status caddy       # 查看运行状态
journalctl -u caddy -f             # 实时查看日志

---

3. 配置管理

有两种主要方式：文件模式 和 API 模式。

从 Caddyfile 启动：

caddy run --config /etc/caddy/Caddyfile --adapter caddyfile

从 JSON 配置启动：

caddy run --config /path/config.json

测试配置（不启动）：

caddy adapt --config /etc/caddy/Caddyfile --adapter caddyfile

适配后会输出 JSON，可以检查是否有语法错误。

---

4. 证书管理

对于 HTTPS 相关任务：

命令	作用
caddy list-certificates	列出所有已申请的证书
caddy renew	检查并续订即将到期的证书
caddy renew --force	即使未到期也强制续订
caddy trust	将 Caddy 的本地 CA 根证书加入系统信任（用于本地开发 HTTPS）
sudo rm -rf /var/lib/caddy/.local/share/caddy/certificates/域名	删除某个域名证书（重启会重新申请）

---

5. 日志与调试

caddy run --config /etc/caddy/Caddyfile --adapter caddyfile --environ

• --environ 会显示 Caddy 当前使用的系统环境变量，方便调试路径问题。

实时查看日志：

journalctl -u caddy -f

或在前台运行：

caddy run --config /etc/caddy/Caddyfile --adapter caddyfile

---

6. 常用组合示例

启动 Caddy 并用配置文件：

sudo caddy run --config /etc/caddy/Caddyfile --adapter caddyfile

重载配置：

sudo systemctl reload caddy

强制更新所有证书：

sudo caddy renew --force

---

总结：
常用的就是

• 运行/重载：caddy run / systemctl reload caddy
• 查看日志：journalctl -u caddy -f
• 证书管理：caddy list-certificates / caddy renew --force