Caddy

Caddy — 一个自动HTTPS的轻量级Web服务器，零配置即可上线。

提到Web服务器，很多人第一反应是Nginx或Apache。这两个老牌工具确实强大，但配置起来也够折腾——写Location、配SSL证书、处理反向代理规则，一套下来没个半小时搞不定。尤其是HTTPS，Let’s Encrypt虽然免费，但手动续期、验证域名所有权这些操作，对新手来说简直是劝退神器。

所以我今天要安利的这个工具——Caddy，就是来终结这些痛苦的。

Caddy最核心的卖点就四个字：自动HTTPS。你只要告诉它“我要托管这个域名”，它就会自动申请Let’s Encrypt证书，自动续期，甚至自动把HTTP重定向到HTTPS。整个过程用户完全无感知。而且它默认就启用了HTTP/2和HTTP/3，性能上完全不虚Nginx。

另外，Caddy的配置文件语法极其简洁，用的是Caddyfile，而不是Nginx那种块状嵌套结构。举个例子，你想反向代理一个Node.js应用：

example.com {
    reverse_proxy localhost:3000
}

就三行，搞定。没有upstream块，没有proxy_pass，没有ssl_certificate。Caddy会自动为example.com申请证书，然后把请求转发到本地的3000端口。

如果你觉得这还不够直观，Caddy还有一个API模式，可以通过JSON直接配置，适合Kubernetes或者Docker环境。当然，对于大多数人来说，Caddyfile已经够香了。

下载方式

Caddy的下载非常友好，官方提供了预编译的二进制文件，支持Windows、macOS、Linux，甚至还有ARM架构（树莓派用户狂喜）。你可以直接去官网下载：

👉 Caddy官网下载页面

如果你喜欢用包管理器，也可以一键安装：

• macOS：brew install caddy
• Linux (Ubuntu/Debian)：sudo apt install caddy（但可能版本较旧，建议用官方源）
• Docker：docker pull caddy:latest

我个人推荐直接下载二进制文件，因为Caddy本身就是一个单文件，丢到/usr/local/bin里就能跑，完全零依赖。

安装方法

安装过程简单到离谱。以Linux为例：

1. 下载对应系统的二进制文件（比如caddy_linux_amd64.tar.gz）
2. 解压：tar -xzf caddy_linux_amd64.tar.gz
3. 移动到PATH：sudo mv caddy /usr/local/bin/
4. 验证安装：caddy version

搞定。没有编译，没有依赖，没有环境变量配置。Windows用户更简单，解压后双击caddy.exe就能运行。

基础使用教程

1. 快速启动一个静态文件服务器

假设你有一个网站目录/var/www/mysite，想临时托管它：

caddy file-server --root /var/www/mysite --listen :8080

然后访问http://localhost:8080，就能看到你的网站。当然，这不是生产环境，但用来本地测试或者局域网分享文件非常方便。

2. 用Caddyfile配置反向代理

创建一个名为Caddyfile的文件（注意没有扩展名），内容如下：

myapi.example.com {
    reverse_proxy /api/* localhost:3000
    reverse_proxy /static/* localhost:4000
}

然后运行：

caddy run

Caddy会自动监听80和443端口，为myapi.example.com申请证书，并把不同路径的请求转发到不同后端。注意：如果你的域名还没有DNS解析，Caddy会报错无法验证域名所有权，所以请先确保域名指向了你的服务器IP。

3. 搭配Docker使用

这是生产环境最常用的方式。创建一个docker-compose.yml：

version: '3'
services:
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./data:/data
      - ./config:/config

然后docker-compose up -d即可。Caddy会把证书和配置数据持久化到./data目录，重启后不会丢失。

进阶技巧

1. 使用环境变量动态配置

Caddyfile支持环境变量，比如：

{$DOMAIN} {
    reverse_proxy {$BACKEND_HOST}:{$BACKEND_PORT}
}

启动时通过-e或--env传递变量，非常适合多环境部署。

2. 自定义错误页面

你想让404页面更友好？加一行：

example.com {
    errors {
        404 /404.html
        500 /500.html
    }
    file_server
}

Caddy会自动匹配错误码并返回对应页面。

3. 启用日志和访问控制

生产环境一定要记录访问日志：

example.com {
    log {
        output file /var/log/caddy/access.log
        format json
    }
    @blocked {
        path /admin/* 192.168.1.0/24
    }
    respond @blocked "Forbidden" 403
}

这里用@blocked定义了一个匹配规则，如果来自内网IP访问/admin路径，直接返回403。

4. 使用插件扩展功能

Caddy支持插件机制，比如你想用Basic Auth保护某个路径：

example.com {
    basicauth /admin/* {
        user $2a$14$...（加密后的密码哈希）
    }
    file_server
}

密码可以用caddy hash-password命令生成，不需要明文存储。

5. 结合Cloudflare DNS挑战

如果你的服务器在NAT后面，或者不想暴露80端口，可以用DNS挑战来申请证书。在Caddyfile里加上：

{
    acme_dns cloudflare {env.CLOUDFLARE_API_TOKEN}
}

这样Caddy会通过Cloudflare的API验证域名所有权，完全不需要开放端口。

总结

Caddy不是要取代Nginx，而是给那些不想在配置上浪费时间的人一个更优雅的选择。它把HTTPS、反向代理、负载均衡这些常用功能做成了“开箱即用”的体验。尤其是个人项目、小型团队、或者需要快速上线的场景，Caddy绝对能让你少掉一半头发。

如果你还在手动配Nginx的SSL证书，不妨试试Caddy，可能用一次就回不去了。