从 Nginx 迁移到 Caddy

适用场景

希望减少证书管理、简化配置，或需要自动 HTTPS 和更轻量的反向代理时，从 Nginx 迁移到 Caddy。复杂 rewrite/模块场景要先评估兼容性。

前置条件

• 导出完整 Nginx 配置（nginx -T）。
• 确认域名 DNS、80/443 端口和证书策略。
• 列出依赖的第三方模块、限流、缓存和 WAF 规则。
• 准备并行运行和回滚窗口。

步骤

1. 导出并梳理 Nginx 配置：

nginx -T > nginx-full.conf
grep -nE 'server_name|location|proxy_pass|rewrite|return|ssl_' nginx-full.conf

2. 编写 Caddyfile：

app.example.com {
    encode zstd gzip

    @api path /api/*
    reverse_proxy @api 127.0.0.1:8080

    root * /var/www/app
    try_files {path} /index.html
    file_server
}

3. 本地验证配置：

caddy validate --config Caddyfile
caddy fmt --overwrite Caddyfile

4. 在测试域名/端口启动，验证：

caddy run --config Caddyfile
caddy reload --config Caddyfile

5. 切换流量：

• 调整 DNS 或负载均衡到 Caddy。
• 保留 Nginx 实例作为回滚。
• 观察证书签发、重定向、WebSocket、超时和日志。

验证

• HTTPS 证书自动签发和续期正常。
• 反向代理、静态文件、SPA 回退、重定向正常。
• WebSocket/SSE 长连接正常。
• 访问日志和错误日志可观测。

回滚

• 把 DNS/LB 切回 Nginx。
• 保留 Nginx 配置和证书。
• Caddy 配置和证书目录保留，便于再次切换。

常见坑

• Caddy 自动 HTTPS 需要 80/443 可达和正确 DNS；内网要配置内部 CA。
• rewrite/location 的复杂语义不能一一对应，逐一验证。
• 第三方 Nginx 模块（限流、WAF、缓存）在 Caddy 中可能没有等价实现。
• 反向代理的 header、超时和缓冲默认值不同。
• 访问日志格式和 Nginx 不同，日志解析要调整。

相关命令

• caddy — Web 服务器
• nginx — 旧配置
• openssl — 证书排查