pzg's blog

Caddy 常用命令速查表

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

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注