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

发表回复

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