配置
命令行
run、start、stop、reload、adapt、fmt，以及那些开箱即用的子命令。
不带子命令的 caddy 会打印帮助。下面是常用的子命令，多数都能在--help 里看到完整说明。
运行与配置
| 命令 | 作用 |
|---|---|
caddy run | 前台运行，阻塞直到进程结束 |
caddy start | 后台运行 |
caddy stop | 优雅停止后台实例 |
caddy reload | 零停机替换配置 |
caddy adapt | 把配置适配成 JSON |
caddy validate | 校验配置而不运行 |
caddy fmt | 格式化 Caddyfile |
caddy environ | 打印 Caddy 能看到的环境变量 |
证书与 PKI
| 命令 | 作用 |
|---|---|
caddy trust | 把本地 CA 根证书装进系统信任库 |
caddy untrust | 从信任库移除本地 CA 根证书 |
开箱即用的子命令
这两个子命令不需要写配置文件，适合快速验证一个想法：
# 把当前目录以文件服务器形式跑起来
caddy file-server --listen :9000 --browse
# 一个指向后端的 HTTPS 反向代理
caddy reverse-proxy --from example.com --to 127.0.0.1:9000格式化
Caddyfile 有官方推荐的排版，fmt 会直接改写文件：
caddy fmt --overwrite Caddyfile把它放进 CI 或者 pre-commit 钩子里，配置的风格就不需要人操心。
常用参数
| 参数 | 说明 |
|---|---|
--config | 配置文件路径 |
--adapter | 配置适配器名称 |
--resume | 恢复上一次加载过的配置 |
--pretty | 让 JSON 输出带缩进 |
--overwrite | 配合 fmt 直接改写文件 |
--domain | file-server 使用的域名 |
--from / --to | reverse-proxy 的两端 |