KangLab

Caddy 进阶配置详解：全局配置、HTTPS 跳转、访问认证与安全策略

Fri, 24 Jul 2026 00:00:00 GMT

上一篇文章介绍了 Caddy 通过 DNS Challenge 配置 Wildcard 证书，实现泛域名 HTTPS 自动申请和续签。

实际生产环境中，除了 HTTPS 证书管理，还需要进一步优化：

全局参数统一管理；
ACME 配置统一设置；
强制 HTTPS；
域名访问规范化；
HTTP 请求处理；
多站点统一管理。

这些功能主要通过 Caddyfile 的：

Global Options Block（全局配置块）
Site Block（站点配置块）

实现。

Caddyfile 配置结构

`Caddyfile` 基本结构

{
    # 全局配置
}

example.com {

    # 站点配置

}

全局配置块

全局配置块可以：

配置整个 Caddy 实例；
对所有站点生效。

例如：

{
    email admin@example.com
}

全局配置块只能存在一个。

站点配置块

站点配置块可以：

控制具体域名行为；
每个站点独立配置；
包含代理、静态文件、跳转等逻辑。

例如：

example.com {
    reverse_proxy localhost:8000
}

全局配置块常用配置

配置 ACME 邮箱

申请 Let's Encrypt 或其他 ACME 证书时使用。

避免每个站点重复配置；
方便证书到期提醒。

{
    email admin@example.com
}

开启 Debug 模式

开发环境中，开启此功能可以看到更详细的日志，方便排查 TLS、代理问题。

{
    debug
}

生产环境通常选择关闭。

站点配置块常用配置

静态文件代理

example.com {
    handle {
        root * /var/www/html
        file_server
    }
}

反向代理

example.com {
    handle {
        reverse_proxy 127.0.0.1:8000
    }
}

请求路径分流

Caddy 的 handle 可以实现类似 Nginx location 的路径分流功能，但匹配规则和优先级机制不同。

例如：

example.com {
    handle /api/* {
        reverse_proxy 127.0.0.1:8000
    }
    handle {
        root * /var/www/html
        file_server
    }
}

HTTPS 与域名规范化

强制 HTTPS

Caddy 默认会自动 HTTPS。例如，访问：

http://example.com

会自动跳转到：

https://example.com

这是因为 Caddy Automatic HTTPS 默认开启。

只有在特殊场景，例如：

自定义跳转规则；
多域名入口统一；
与其他代理层配合等情况下。

才需要手动配置 redir。

例如：

http://example.com {
    redir https://example.com{uri} permanent
}

通常情况下无需手动配置，Caddy 会自动监听 HTTP 请求并完成 HTTPS 跳转。

强制跳转到 www

很多网站需要统一访问入口，这样做的目的一般是：

SEO 权重统一；
Cookie 域管理；
避免两个站点重复等。

例如用户访问：

https://example.com

需要统一跳转到：

https://www.example.com

配置：

example.com {

    redir https://www.example.com{uri} permanent
}

www.example.com {

    reverse_proxy localhost:8000
}

如果使用 www 子域名，需要确保申请证书时包含 www.example.com 或 *.example.com。

需要保证 www 子域名，已完成 DNS 解析。

www 跳转到一级域名

与强制跳转到 www功能相反，目的都是统一网站访问入口，其配置如下：

www.example.com {

    redir https://example.com{uri} permanent
}


example.com {

    reverse_proxy localhost:8000
}

安全策略

访问认证（类似 nginx auth_basic）

Caddy 不保存明文密码。所以需要执行：

# 根据实际需求替换密码
caddy hash-password --plaintext "123456"

会得到类似：

$2a$14$xxxx

格式的 bcrypt 哈希字符串。

bcrypt 哈希字符串实际前缀和 cost 取决于 Caddy 版本。

修改 Caddyfile 文件，将账号、密码填充至想要加密访问的域名下：

admin.example.com {
    basic_auth {
        admin $2a$14$xxxx
    }
    reverse_proxy localhost:9000
}

Caddy 的 basic_auth 使用 bcrypt 哈希保存密码，不保存明文密码。

Basic Auth 必须配合 HTTPS 使用，否则用户名密码可能被截获。

安全 Header

example.com {

    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains"
        X-Content-Type-Options "nosniff"
        X-Frame-Options "SAMEORIGIN"
        Referrer-Policy "strict-origin-when-cross-origin"
    }
}

参数说明：

Header	作用
HSTS	强制 HTTPS
nosniff	防止 MIME 嗅探
X-Frame	防止 iframe 点击劫持
Referrer	控制来源信息

HSTS 建议确认所有子域名均支持 HTTPS 后开启，否则可能导致部分子域名无法访问。

响应压缩（Gzip / Zstd）

Caddy 可以通过 encode 自动压缩响应内容。 Caddy 会根据客户端发送的 Accept-Encoding 自动选择支持的压缩算法。常用于：

HTML
CSS
JavaScript
JSON API

example.com {
    encode gzip zstd
    reverse_proxy localhost:8000
}

常见问题

全局配置块能随意放置吗？

不可以。

全局配置块必须位于 Caddyfile 文件的最顶部。
全局配置块只能有一个。

为什么配置了 HTTPS 还需要 HTTP 重定向？

因为用户可能输入：

example.com

用户直接输入域名时，浏览器可能首先通过 HTTP 请求访问，因此需要确保 HTTP 请求能够正确跳转 HTTPS。

明确重定向可以保证 HTTP → HTTPS 统一入口。

为什么 example.com 和 *.example.com 要同时申请？

因为：

*.example.com

只能覆盖：

api.example.com
blog.example.com

等域名，不能覆盖：

example.com

为什么配置修改后没有生效？

需要重载配置文件，以 docker-compose 为例，执行：

# 检查配置
docker compose exec caddy caddy validate --config /etc/caddy/Caddyfile
# 重载配置
docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile

参考资料

Caddy 官方文档：介绍 Caddy 的安装、配置、自动 HTTPS、反向代理以及模块扩展等功能。
Caddy Automatic HTTPS：介绍 Caddy 自动 HTTPS、ACME 证书申请以及自动续签机制。
Caddyfile 官方文档：介绍 Caddyfile 配置格式、全局配置块、站点配置以及指令使用方式。
Caddyfile Directives 官方文档：介绍 reverse_proxy、handle、header、encode、redir 等请求处理指令。
ACME 协议标准（RFC 8555）：定义自动化申请、验证和管理 TLS 证书的标准流程。

Caddy 泛域名 HTTPS 配置教程：Docker 构建、DNS Challenge 与 Wildcard 证书

Mon, 20 Jul 2026 00:00:00 GMT

上一篇文章介绍了 Caddy 单域名 HTTPS 部署方式，通过 Caddyfile 实现静态资源托管、反向代理以及自动 HTTPS。

当项目进一步拆分为多个独立服务时，通常会为不同服务配置独立子域名。

随着项目规模增加，通常会拆分出更多服务，例如：

API 服务；
管理后台；
博客系统；
文件服务；
监控平台等。

这些服务通常会使用不同的子域名：

api.example.com
admin.example.com
blog.example.com
cdn.example.com

如果每个子域名单独申请 HTTPS 证书，需要维护多个证书配置。

此时可以使用泛域名证书（Wildcard Certificate）：

*.example.com

通过一个证书覆盖多个一级子域名，实现统一 HTTPS 管理。

什么是泛域名证书？

泛域名证书，也称通配符证书（Wildcard Certificate）。

它通过*匹配指定层级下的所有子域名。

例如：

*.example.com

可以匹配如：

api.example.com
blog.example.com
admin.example.com

但不支持：

test.api.example.com

如果需要支持多级子域名，则需要申请：

*.api.example.com

泛域名与单域名区别

类型	单域名证书	泛域名证书
示例	example.com	*.example.com
覆盖范围	单个域名	一级子域名
验证方式	HTTP Challenge	DNS Challenge
配置难度	简单	较高
适用场景	单站点	多服务、多子域名
自动续签	支持	支持

为什么泛域名需要 DNS Challenge？

普通 HTTPS 证书通常使用 HTTP Challenge。

验证流程为：

申请证书
↓
CA 返回验证信息
↓
服务器提供验证文件
↓
CA 访问验证地址
↓
签发证书

例如：

example.com/.well-known/acme-challenge/

但是泛域名：

*.example.com

无法通过 HTTP Challenge 验证。

因为 CA 需要确认：

申请者是否拥有整个域名的 DNS 控制权限。

因此泛域名证书需要使用DNS Challenge。

验证流程：

申请证书
↓
插件调用 DNS Provider API
↓
自动创建 TXT 记录
_acme-challenge.example.com
↓
CA 查询 TXT 记录
↓
验证成功
↓
签发证书

准备环境

本文示例：

域名：
example.com

目标：
*.example.com

DNS 服务商：
阿里云 DNS

Web Server：
Caddy

需要准备：

一个自己的域名；
DNS 服务商 API 权限；
支持 DNS Provider 的 Caddy。

如果服务器位于中国大陆：

域名需要提前完成备案，详见域名备案。
网站服务需要符合相关管理要求

安装支持 DNS Challenge 的 Caddy

Caddy 默认支持自动 HTTPS。但是：DNS Challenge需要额外安装对应的 DNS Provider 插件。

例如，阿里云 DNS：

github.com/caddy-dns/alidns

Cloudflare：

github.com/caddy-dns/cloudflare

本文以 Docker 部署方式为例。

使用 Docker 构建支持 DNS Provider 的 Caddy。

由于官方 Caddy 镜像默认不包含 DNS Provider，需要基于官方镜像重新构建。

目录结构为：

caddy/
├── Dockerfile
├── Caddyfile
├── docker-compose.yaml
├── .env
├── data/
└── config/

使用 vim 编辑Dockerfile文件。

vim Dockerfile

内容：

FROM caddy:builder AS builder

ENV GOPROXY=https://goproxy.cn,direct

RUN xcaddy build \
    --with github.com/caddy-dns/alidns


FROM caddy:latest

COPY --from=builder /usr/bin/caddy /usr/bin/caddy

国内服务器构建时可能无法访问 Go 官方代理，因此这里使用国内 Go Proxy 提高依赖下载成功率。

构建

docker build -t caddy-custom .

构建完成后，当前镜像已经包含：

dns.providers.alidns

插件。

使用 vim 编辑 .env 文件

以阿里云为例，将 AccessKey ID 和 AccessKey Secret 写入到文件中。

ALIYUN_ACCESS_KEY_ID=你的AccessKeyID
ALIYUN_ACCESS_KEY_SECRET=你的AccessKeySecret

使用 vim 编辑 docker-compose.yaml 文件

services:
  caddy:
    image: caddy-custom:latest
    container_name: caddy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      # Caddy 配置文件
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      # 自动申请的证书、ACME 数据等
      - ./data:/data
      # Caddy 配置持久化
      - ./config:/config
    environment:
      ALIYUN_ACCESS_KEY_ID: ${ALIYUN_ACCESS_KEY_ID}
      ALIYUN_ACCESS_KEY_SECRET: ${ALIYUN_ACCESS_KEY_SECRET}

如果 Caddy 与后端服务运行在不同 Docker Compose 网络中：

推荐创建共享 Docker Network：

docker network create proxy

然后让 Caddy 和后端服务加入同一个网络。

如果后端服务运行在宿主机，也可以使用：

network_mode: host

直接访问宿主机端口。

services:
  caddy:
    image: caddy-custom:latest
    container_name: caddy
    restart: unless-stopped
    network_mode: host
    volumes:
      # Caddy 配置文件
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      # 自动申请的证书、ACME 数据等
      - ./data:/data
      # Caddy 配置持久化
      - ./config:/config
    environment:
      ALIYUN_ACCESS_KEY_ID: ${ALIYUN_ACCESS_KEY_ID}
      ALIYUN_ACCESS_KEY_SECRET: ${ALIYUN_ACCESS_KEY_SECRET}

docker compose 会自动读取当前目录下的 .env 文件。

host 模式适合：

Caddy 在宿主机
后端服务也在宿主机
需要监听宿主网络

编辑 Caddyfile

example.com, *.example.com {

    tls {
        dns alidns {
            access_key_id {env.ALIYUN_ACCESS_KEY_ID}
            access_key_secret {env.ALIYUN_ACCESS_KEY_SECRET}
        }
    }

    handle {
        root * /data/home
        file_server
    }
}

启动容器

docker compose up -d

验证证书申请情况

docker compose logs -f caddy

成功时会看到类似：

obtaining certificate
presenting DNS challenge
certificate obtained successfully

等内容。

验证：

openssl s_client \
-connect api.example.com:443 \
-servername api.example.com

泛域名证书下的多服务配置

泛域名证书的主要用途，就是让多个子域名共享同一个 HTTPS 证书。

例如：

*.example.com

可以同时覆盖：

api.example.com
admin.example.com
blog.example.com
cdn.example.com

Caddy 可以通过同一个 Wildcard 证书统一管理这些 HTTPS 请求。

example.com, *.example.com {

    tls {
        dns alidns {
            access_key_id {env.ALIYUN_ACCESS_KEY_ID}
            access_key_secret {env.ALIYUN_ACCESS_KEY_SECRET}
        }
    }

    @api host api.example.com
    handle @api {
        reverse_proxy 127.0.0.1:8000
    }


    @admin host admin.example.com
    handle @admin {
        reverse_proxy 127.0.0.1:9000
    }


    @blog host blog.example.com
    handle @blog {
        root * /var/www/blog
        file_server
    }


    @cdn host cdn.example.com
    handle @cdn {
        root * /var/www/cdn
        file_server
    }
}

未匹配的子域名会进入默认 handle。

这样 Caddy 会自动：

使用 DNS Challenge 验证域名所有权；
申请 Wildcard 证书；
自动续签证书；
为不同子域名提供 HTTPS。

常见 DNS Provider

DNS 服务商	Provider 名称
阿里云 DNS	alidns
腾讯云 DNSPod	tencentcloud
Cloudflare	cloudflare
AWS Route53	route53
华为云 DNS	huaweicloud
Google Cloud DNS	gcpdns

DNS Provider 插件属于第三方模块，使用前请确认对应仓库维护状态。

更多 Provider 见 Caddy DNS Provider 官方仓库。

常见问题

泛域名证书可以覆盖所有子域名吗？

不可以。

例如：

*.example.com

只能匹配一级子域名，如：

api.example.com
blog.example.com
admin.example.com

但是无法匹配：

*.api.example.com

如果需要支持多级子域名，需要申请：

*.api.example.com

Caddy 为什么需要重新构建？

因为官方 Caddy 镜像只包含官方模块。

DNS Challenge Provider（例如阿里云 DNS、Cloudflare 等）属于第三方模块，需要通过 xcaddy 编译进去。构建后 Caddy 才支持：alidns等。

Caddy 可以代理 Docker 容器吗？

可以。

如果 Caddy 与后端服务运行在同一个 Docker Compose 网络中，可以直接使用服务名访问。

DNS 验证失败怎么办？

检查：

AccessKey 是否正确
API 是否拥有 DNS 权限
TXT 记录是否生效

查看：

dig TXT _acme-challenge.example.com

总结

泛域名证书适用于：

多个 Web 服务
API 服务拆分
Docker 多容器部署
个人服务器环境

通过：

Caddy
+
DNS Challenge
+
Wildcard Certificate

可以实现：

自动申请证书
自动续签
多子域名统一 HTTPS
降低维护成本

对于个人服务器和中小型项目：

*.example.com

是一种更加优雅的 HTTPS 管理方案。

参考资料

本文内容参考以下官方文档和标准资料：

Caddy 官方文档：介绍 Caddy 的安装、配置、自动 HTTPS、反向代理以及模块扩展等功能。
Caddy Automatic HTTPS：介绍 Caddy 自动 HTTPS、ACME 证书申请以及自动续签机制。
xcaddy 官方仓库：用于构建包含第三方模块的自定义 Caddy 二进制文件。
Caddy DNS Provider 插件：提供不同 DNS 服务商对应的 DNS Challenge 插件实现。
Let's Encrypt 官方文档：介绍免费 TLS 证书签发流程以及 ACME 协议相关内容。
ACME 协议标准（RFC 8555）：定义自动化申请、验证和管理 TLS 证书的标准流程。

Caddy 单域名多服务部署教程：反向代理、自动 HTTPS 与 Caddyfile 配置

Fri, 17 Jul 2026 00:00:00 GMT

适用场景

本文适用于以下部署环境：

Linux 云服务器；
Docker 部署环境；
FastAPI 后端服务；
React / Vue / Astro 前端项目；
个人博客和中小型 Web 应用。

Caddy 是什么？

Caddy 是一个基于 Go 语言开发的现代 Web 服务器。

它集成了：

Web Server（静态文件服务器）
Reverse Proxy（反向代理）
Automatic HTTPS（自动 HTTPS）
HTTP/2
HTTP/3

等功能。

简单理解：

Caddy 类似于 Nginx，但它通过更简单的配置文件和自动 HTTPS 机制，降低了网站部署和维护成本。

Caddy 可以做什么？

Caddy 常用于以下场景：

1. 静态网站托管

例如：

Vue / React 构建后的前端项目；
Astro、Hugo 等静态博客；
HTML、CSS、JavaScript 文件。

2. 反向代理后端服务

Caddy 可以将公网请求转发到本地应用。

3. 自动 HTTPS

Caddy 默认支持 Let's Encrypt。

无需手动：

申请证书；
配置证书路径；
设置自动续期；
定期 reload 服务。

只需要：

example.com {
    reverse_proxy localhost:8000
}

Caddy 会自动完成 HTTPS 配置。

Caddy 和 Nginx 如何选择？

对比	Caddy	Nginx
配置难度	⭐⭐⭐⭐⭐ 简单，配置文件简洁易读	⭐⭐⭐ 较复杂，需要理解更多指令和模块
HTTPS	自动申请、配置和续签 TLS 证书	通常需要手动申请、配置和续签证书
性能	很高，满足绝大多数中小型应用需求	极高，针对高并发场景深度优化
静态资源	支持，性能优秀	支持，性能非常优秀
反向代理	支持，配置简单	支持，非常成熟稳定
HTTP/3	原生支持，默认集成 QUIC	支持，但通常需要额外配置和版本支持
企业生态	快速增长，现代化部署场景应用增多	非常成熟，拥有大量企业级实践
学习成本	较低，适合快速部署	较高，需要掌握更多配置和优化技巧
配置可读性	Caddyfile 简洁直观，接近自然语言	配置体系复杂，学习曲线较高
模块生态	较少，但官方功能覆盖常见需求	生态丰富，拥有大量第三方模块
资源占用	Go Runtime 会带来一定额外开销，但现代服务器环境通常影响有限	资源控制能力强，长期优化成熟
高并发能力	性能优秀，可以满足大多数中小型及部分大型应用场景	长期经过大规模生产环境验证，适合复杂高并发场景
部署体验	非常优秀，适合 Docker、个人服务器和快速部署	成熟稳定，更适合长期运维和企业环境

如果目标是：

个人网站；
小型项目；
Docker 部署；
快速上线 HTTPS 服务；

Caddy 通常是更简单的选择。

如果目标是：

大规模企业架构；
复杂负载均衡；
深度定制网络策略；

Nginx 生态更加成熟。

Caddy 安装

Debian / Ubuntu 安装

推荐使用官方软件源：

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \
| sudo gpg --dearmor \
-o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \
| sudo tee /etc/apt/sources.list.d/caddy-stable.list

sudo apt update

sudo apt install caddy

查看版本：

caddy version

Docker 安装

拉取官方镜像：

docker pull caddy

简单运行：

mkdir -p data config

docker run -d \
--name caddy \
--restart unless-stopped \
-p 80:80 \
-p 443:443 \
-v $(pwd)/Caddyfile:/etc/caddy/Caddyfile:ro \
-v $(pwd)/data:/data \
-v $(pwd)/config:/config \
caddy

其他系统安装

其他系统安装方式：

参考 Caddy 官方中文文档。

使用 Caddy 先决条件

Caddy 自动申请 HTTPS 证书需要满足：

域名已经解析到服务器公网IP；
服务器安全组已开放80和443端口；
80/443端口没有被其他服务使用/占用；
CA 可以访问服务器。

例如：

DNS:

example.com

A记录:

example.com -> 服务器公网 IP

Caddy 单域名多服务配置

创建 Caddyfile

Caddy 使用名为：Caddyfile的配置文件。

注意：

文件没有扩展名；
默认位置通常为 /etc/caddy/Caddyfile。

例如：

touch Caddyfile

单服务反向代理示例

假设：

后端应用：

127.0.0.1:8000

例如：

FastAPI：

uvicorn main:app --host 127.0.0.1 --port 8000

Caddyfile：

example.com {
    reverse_proxy 127.0.0.1:8000
}

访问：

https://example.com

单应用静态文件服务示例

example.com {
    root * /var/www/html
    file_server
}

单域名静态文件 + 反向代理配置方式

example.com {
    reverse_proxy 127.0.0.1:8000

    root * /var/www/html
    file_server
}

这种配置虽然可以运行，但是由于反向代理和静态文件服务处于同一个请求处理链中，随着项目增加路由规则，容易产生请求匹配问题。

推荐使用handle明确划分不同请求。

example.com {
    handle /api/* {
        reverse_proxy 127.0.0.1:8000
    }

    handle {
        root * /var/www/html
        file_server
    }
}

如果后端接口统一增加/api前缀，例如/api/user，那么前端请求地址也需要同步调整为https://example.com/api/user。

此时，访问：

https://example.com/api/

将代理到后端接口。

而访问：

https://example.com

则是静态资源页面。

这种方式可以使用，但随着项目复杂度增加，路由规则会逐渐变复杂。

单域名部署前后端分离项目推荐方案

example.com {
    root * /var/www/html
    file_server
}

api.example.com {
    reverse_proxy 127.0.0.1:8000
}

此时，访问：

https://api.example.com

将代理到后端接口。

而访问：

https://example.com

则是静态资源页面。

同样，前端项目中的API请求地址需要配置为https://api.example.com。

Caddy 服务管理

检查配置

修改Caddyfile后，建议先验证配置：

caddy validate --config /etc/caddy/Caddyfile

可以选择格式化配置文件（非必要）：

caddy fmt --overwrite /etc/caddy/Caddyfile

确认无误后重新加载：

caddy reload --config /etc/caddy/Caddyfile

Linux systemd

启动：

systemctl start caddy

查看状态：

systemctl status caddy

开机启动：

systemctl enable caddy

重新加载配置：

systemctl reload caddy

Docker Compose 部署 Caddy

示例：

services:
  caddy:
    image: caddy:latest
    container_name: caddy
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - ./data:/data
      - ./config:/config

/data目录用于保存 Caddy 自动申请的证书和状态信息，生产环境不要删除，否则可能触发重新申请证书。

启动：

docker compose up -d

常见问题

Caddy 为什么不用手动配置 SSL？

因为 Caddy 内置 ACME 协议支持，可以自动完成证书申请和续签。

Caddy 可以代理 Docker 容器吗？

可以。

例如：

example.com {
    reverse_proxy app:8000
}

其中app是 Docker Compose 服务名。Caddy 需要与后端服务同属一个网络组内。

Caddy 和 Nginx 可以一起使用吗？

可以。不过大多数个人项目没有必要。

Caddy 支持泛域名证书吗？

支持。

例如：

*.example.com

但是泛域名证书需要 DNS Challenge。

Caddy 权限错误怎么办？

如果执行 Caddy 命令出现：

permission denied

通常是权限不足导致的。

检查当前用户是不是root

whoami

如果不是root，可以使用：

sudo <command>

例如：

sudo systemctl restart caddy

确保当前用户拥有读取权限

ls -l Caddyfile

# 如果当前用户没有权限，修改所有者
chown $USER:$USER Caddyfile

# 设置权限
chmod 644 Caddyfile

总结

Caddy 是一个简单、高效、现代化的 Web 服务器。

相比传统 Nginx，Caddy 最大优势是：

配置简单；
自动 HTTPS；
自动证书续签；
原生支持 HTTP/3；
非常适合个人项目和中小型服务部署。

对于 FastAPI、React、Astro、Docker 等现代技术栈，使用 Caddy 可以减少服务器运维成本，让开发者更加关注业务代码。

参考资料

本文内容参考以下官方文档和标准资料：

Caddy 官方文档：Caddy 官方文档详细介绍了 Caddy 的安装、配置、反向代理、自动 HTTPS 等功能。
Caddy 官方中文文档：提供 Caddy 官方文档的中文翻译站点，提供中文化阅读体验。
Caddy 官方 GitHub 仓库：Caddy 是一个基于 Go 语言开发的开源 Web 服务器，其源码托管于 GitHub。
Let's Encrypt 官方文档：Let's Encrypt 是目前广泛使用的免费 TLS 证书颁发机构（CA）。
ACME 协议标准（RFC 8555）：ACME（Automatic Certificate Management Environment）定义了自动化申请和管理 TLS 证书的标准流程。
HTTP/3 标准（RFC 9114）：HTTP/3 基于 QUIC 协议，是现代 Web 网络协议的重要发展方向。

KangLab

Caddy 进阶配置详解：全局配置、HTTPS 跳转、访问认证与安全策略

Caddyfile 配置结构

Caddyfile 基本结构

全局配置块

站点配置块

全局配置块常用配置

配置 ACME 邮箱

开启 Debug 模式

站点配置块常用配置

静态文件代理

反向代理

请求路径分流

HTTPS 与域名规范化

强制 HTTPS

强制跳转到 www

www 跳转到一级域名

安全策略

访问认证（类似 nginx auth_basic）

安全 Header

响应压缩（Gzip / Zstd）

常见问题

全局配置块能随意放置吗？

为什么配置了 HTTPS 还需要 HTTP 重定向？

为什么 example.com 和 *.example.com 要同时申请？

为什么配置修改后没有生效？

参考资料

Caddy 泛域名 HTTPS 配置教程：Docker 构建、DNS Challenge 与 Wildcard 证书

什么是泛域名证书？

泛域名与单域名区别

为什么泛域名需要 DNS Challenge？

准备环境

安装支持 DNS Challenge 的 Caddy

泛域名证书下的多服务配置

常见 DNS Provider

常见问题

泛域名证书可以覆盖所有子域名吗？

Caddy 为什么需要重新构建？

Caddy 可以代理 Docker 容器吗？

DNS 验证失败怎么办？

总结

参考资料

Caddy 单域名多服务部署教程：反向代理、自动 HTTPS 与 Caddyfile 配置

适用场景

Caddy 是什么？

Caddy 可以做什么？

1. 静态网站托管

2. 反向代理后端服务

3. 自动 HTTPS

Caddy 和 Nginx 如何选择？

Caddy 安装

Debian / Ubuntu 安装

Docker 安装

其他系统安装

使用 Caddy 先决条件

Caddy 单域名多服务配置

创建 Caddyfile

单服务反向代理示例

单应用静态文件服务示例

单域名静态文件 + 反向代理配置方式

单域名部署前后端分离项目推荐方案

Caddy 服务管理

检查配置

Linux systemd

Docker Compose 部署 Caddy

常见问题

Caddy 为什么不用手动配置 SSL？

Caddy 可以代理 Docker 容器吗？

Caddy 和 Nginx 可以一起使用吗？

Caddy 支持泛域名证书吗？

Caddy 权限错误怎么办？

总结

参考资料

`Caddyfile` 基本结构