SuperAPI AI 工具集

caddy-reverse-proxy

写作与研究

查看项目

更新于 10-16 05:06

技能介绍

Caddy 是具备自动 HTTPS 的 Web 服务器,可自动获取和续期证书、把 HTTP 重定向到 HTTPS,并以简洁语法进行配置。本技能用于编写反代场景的 Caddyfile,并提供配置参考与排障思路。

用途:编写 Caddyfile 反向代理配置;配置自动 HTTPS;在 Docker 环境中代理容器或宿主机服务;设置路径路由、请求头、负载均衡与安全响应头。

主要能力与用法:基础代理用 reverse_proxy backend:8080;多上游写多个地址;路径路由用 handle /api/* { reverse_proxy api:8080 };去除路径前缀用 handle_path;请求头通过 header_up/header_down 增删,如 header_up Host localhost、header_down -Server。TLS 默认自动签发,通配符需 DNS 插件,例如 tls { dns cloudflare {env.CF_API_TOKEN} };开发环境可用 tls internal。请求匹配支持 path、header、method 及组合。负载均衡可配 lb_policy round_robin 与 health_uri、health_interval。Docker 中同网络直接使用容器名作主机名,代理宿主机需 extra_hosts 配 host.docker.internal:host-gateway。

验证与重载:caddy validate --config /etc/caddy/Caddyfile;caddy fmt --overwrite /etc/caddy/Caddyfile;caddy reload --config /etc/caddy/Caddyfile 实现零停机重载。

适用场景:单站点或站点群的反向代理、API 与前端分流、SPA 托管、gRPC(h2c://)、WebSocket、多后端负载均衡。

限制与注意事项:自动证书需域名 DNS 指向服务器、80/443 端口可访问;403 常需 header_up Host;SSE 需考虑 flush_interval -1;通配符证书依赖 DNS 提供商插件。资料未提供收费、价格与具体平台限制信息。