20260514:增加新内容

concepts/caddy-web-server.md

@@ -0,0 +1,42 @@
+---
+title: Caddy Web Server
+created: 2025-04-15
+updated: 2026-05-01
+type: concept
+tags: []
+sources: []
+---
+
+# Caddy Web Server
+
+**现代化的 Go 语言 Web 服务器/反向代理**，以自动 HTTPS 和简洁 Caddyfile 配置著称。
+
+## 核心特性
+
+- **自动 HTTPS**: 无需额外配置即可自动获取和续期 Let's Encrypt 证书
+- **Caddyfile**: 简洁直观的配置语法，远优于 Nginx 的复杂配置
+- **命名匹配器 (Named Matcher)**: `@name { conditions... }` 定义可复用的请求匹配规则
+- **原生反向代理**: `reverse_proxy` 指令内置健康检查、负载均衡
+- **API 控制**: 支持运行时通过 REST API 动态修改配置
+
+## 关键指令
+
+| 指令 | 功能 |
+|------|------|
+| `reverse_proxy` | 反向代理到后端 |
+| `header` | 请求头匹配器 |
+| `respond` | 直接返回 HTTP 响应 |
+| `route` / `handle` | 路径级别的路由控制 |
+| `basicauth` | HTTP Basic 认证 |
+| `forward_auth` | 委托外部认证 |
+
+## 常见使用场景
+
+- [[reverse-proxy-authentication|反向代理层认证]] — 在 Caddy 层拦截未认证请求
+- [[forward-authentication|外部认证委托]] — 复杂认证逻辑交给外部服务
+- [[api-key-authentication|API Key 网关]] — 统一 API Key 校验入口
+
+## 相关概念
+
+- [[caddy-reverse-proxy-auth]] — 反向代理认证完整方案
+- [[reverse-proxy-authentication]] — 认证模式