Caddy 是一个现代 Web 服务器，能自动处理 HTTPS 证书配置和续期。

生成 Caddyfile

npx @docmd/core deploy --caddy

这会生成针对你项目定制的 Caddyfile：

• 站点地址设置为从 url 配置中提取的主机名。Caddy 会自动为其签发 SSL 证书。如果未配置 URL 则回退到 :80。
• 根目录使用你配置的 out 目录（不是硬编码的值）。
• SPA 回退仅在配置中 layout.spa 为 true 时包含。

生成内容

docs.example.com {
    root * ./site
    file_server

    # SPA Routing Fallback (only when layout.spa is true)
    try_files {path} {path}/ /index.html

    # Security Headers
    header {
        X-Content-Type-Options "nosniff"
        X-Frame-Options "SAMEORIGIN"
        -Server
    }

    # Custom 404
    handle_errors {
        rewrite * /404.html
        file_server
    }

    # Cache Static Assets (6 months)
    @static {
        file
        path *.ico *.css *.js *.gif *.jpg *.jpeg *.png *.webp *.avif *.svg *.woff *.woff2 *.eot *.ttf *.otf
    }
    header @static Cache-Control "public, max-age=15552000, immutable"
}

当你使用真实域名作为站点地址时（例如 docs.example.com 而不是 :80），Caddy 会通过 Let’s Encrypt 自动签发免费 SSL 证书。无需 HTTPS 配置。

部署步骤

1. 构建站点：npx @docmd/core build
2. 将输出文件夹和生成的 Caddyfile 传输到服务器。
3. 在包含 Caddyfile 的目录中运行 caddy start 或 caddy run。

重新生成

修改了站点 URL 或输出目录？重新运行 npx @docmd/core deploy --caddy - Caddyfile 会根据当前 docmd.config.json 重新生成。