Caddy2 极简入门教程

Caddy 是 Go 写的 Web 服务器最大亮点自动 HTTPS自动申请 / 续期 SSL 证书配置简单替代 Nginx 做反向代理、静态网站非常适合。 本文使用Caddyfile最常用配置格式不要混淆老旧 Caddy v1一、安装 Caddy官网下载https://caddyserver.com/download1. LinuxUbuntu/Debian 官方源推荐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安装后自带 systemd 服务。2. 通用二进制方式Windows/macOS/Linux下载对应系统二进制包解压得到caddyLinux/mac/caddy.exeWindows# Linux/mac 添加权限 chmod x caddy # 移动到全局命令 sudo mv caddy /usr/local/bin/ # 允许监听80/443端口可选 sudo setcap cap_net_bind_serviceep /usr/local/bin/caddy验证安装caddy version二、核心命令# 前台运行读取当前目录 Caddyfile调试推荐 caddy run # 修改配置后平滑重载不中断连接生产常用 caddy reload # 监视Caddyfile文件改动自动重载开发调试 caddy run --watch # 格式化、检查配置语法 caddy fmt Caddyfile caddy validate Caddyfile三、Caddyfile 基础语法# 站点地址域名/IP:端口 域名 { 指令 参数 }重要规则写域名如xxx.com→自动 HTTPS自动申请证书、80 自动跳转 443写http://xxx.com/:8080→ 只使用 HTTP关闭自动证书四、常用配置示例例 1简单文字输出Hello World本地测试localhost:2015 { respond Hello Caddy! }运行caddy run浏览器访问 http://127.0.0.1:2015示例 2静态文件服务器托管网页把/www/site目录作为网站根目录# 公网域名自动HTTPS demo.example.com { root * /www/site file_server # 开启静态文件服务 }目录权限注意caddy 用户需要可读/www/site示例 3反向代理最常用转发后端服务后端本地启动了程序127.0.0.1:8080demo.example.com { reverse_proxy 127.0.0.1:8080 }自动 HTTPS自带 WebSocket 支持无需额外配置Nginx 需要手动加头示例 4前后端分离场景静态页面直接访问/api请求转发后端demo.example.com { root * /www/web file_server # api路径反向代理 handle /api/* { reverse_proxy 127.0.0.1:9000 } }示例 5纯 HTTP 本地代理不启用 HTTPS:8080 { reverse_proxy 127.0.0.1:3000 }示例 6全局配置放在文件最顶部设置证书邮箱证书到期通知{ email youremail.com } demo.example.com { reverse_proxy 127.0.0.1:8080 }五、自动 HTTPS 使用条件域名 A 记录 解析到服务器公网 IP服务器防火墙放行80、443 端口域名不能写http://直接写domain.com配置填写email推荐证书默认保存在Linux systemd 安装/var/lib/caddy/二进制运行~/.local/share/caddy/六、快速排坑端口 80/443 权限不足Linux要么加 setcap要么用 sudo 运行 caddy无法申请证书检查防火墙、安全组是否开放 80/443确认域名解析正确修改配置不生效记得执行caddy reload不要用记事本保存 Caddyfile避免 Windows 换行符问题七、快速启动# 静态文件服务器 caddy file-server --listen :8080 --root ./html # 反向代理 caddy reverse-proxy --from :8080 --to 127.0.0.1:3000