📌 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
发表回复