104 lines
3.2 KiB
Markdown
104 lines
3.2 KiB
Markdown
---
|
||
title: "Caddy"
|
||
type: concept
|
||
tags: [networking, web-server, https, reverse-proxy, golang]
|
||
last_updated: 2026-04-03
|
||
---
|
||
|
||
## Aliases
|
||
- Caddy Server
|
||
- Caddy Web Server
|
||
- Caddyfile
|
||
|
||
## Definition
|
||
Caddy 是一款由 Go 语言编写的开源 Web 服务器，以其零配置自动 HTTPS 特性著称——首次访问域名时自动向 Let's Encrypt 申请并续期 SSL/TLS 证书，无需手动配置。支持反向代理、静态文件服务、FastCGI、负载均衡等常用功能。Caddyfile 是其独特的配置格式，简洁易读，适合个人和小型部署。
|
||
|
||
## Core Features
|
||
- **自动 HTTPS**：首次访问自动申请 Let's Encrypt 证书，支持 ACME DNS-01 挑战（适合内网）
|
||
- **HTTP/3 支持**：默认启用 QUIC/HTTP3
|
||
- **反向代理**：简洁的 `reverse_proxy` 指令
|
||
- **Caddyfile**：人类可读的配置文件格式
|
||
- **默认 TLS 1.3**：安全开箱即用
|
||
- **热重载**：配置修改自动生效，无需重启
|
||
|
||
## Caddyfile 语法示例
|
||
```caddy
|
||
# 基础反向代理
|
||
example.com {
|
||
reverse_proxy localhost:8080
|
||
}
|
||
|
||
# 多域名配置
|
||
nas.ishenwei.online {
|
||
reverse_proxy 127.0.0.1:15000
|
||
}
|
||
|
||
n8n.ishenwei.online {
|
||
reverse_proxy 127.0.0.1:15678
|
||
}
|
||
|
||
# 带基础认证
|
||
admin.example.com {
|
||
basicauth /* {
|
||
admin <hashed_password>
|
||
}
|
||
reverse_proxy localhost:5678
|
||
}
|
||
```
|
||
|
||
## 常用命令
|
||
```bash
|
||
# 验证配置语法
|
||
sudo caddy validate --config /etc/caddy/Caddyfile
|
||
|
||
# 热重载配置
|
||
sudo caddy reload
|
||
|
||
# 彻底重启
|
||
sudo systemctl restart caddy
|
||
|
||
# 查看状态
|
||
sudo systemctl status caddy
|
||
|
||
# 生成密码哈希
|
||
caddy hash-password
|
||
```
|
||
|
||
## 与 Nginx 的对比
|
||
| 特性 | Caddy | Nginx |
|
||
|------|-------|-------|
|
||
| 自动 HTTPS | ✅ 默认 | ❌ 需手动配置 |
|
||
| 配置语法 | 简洁 Caddyfile | 复杂块结构 |
|
||
| 性能 | 略低于 Nginx | 极高 |
|
||
| 热重载 | ✅ 原生支持 | ❌ 需 signal |
|
||
| HTTP/3 | ✅ 默认 | 需额外编译 |
|
||
| 学习曲线 | 低 | 中高 |
|
||
|
||
## 在本 Wiki 中的应用
|
||
- [[通过VPS+内网反向代理实现域名访问内网穿透]]：Caddy 反向代理到 frp 映射端口，提供 `*.ishenwei.online` HTTPS 访问
|
||
- 映射关系：
|
||
- `nas.ishenwei.online` → `127.0.0.1:15000`
|
||
- `n8n.ishenwei.online` → `127.0.0.1:15678`
|
||
- `transmission.ishenwei.online` → `127.0.0.1:19091`
|
||
- `grafana.ishenwei.online` → `127.0.0.1:13000`
|
||
- `navidrome.ishenwei.online` → `127.0.0.1:14533`
|
||
- `calibre.ishenwei.online` → `127.0.0.1:18083`
|
||
|
||
## 重要限制
|
||
- **Caddy 不处理 SSH**：SSH 穿透（TCP 映射）不走 Caddy，只依赖 frps + frpc
|
||
- **Caddy 不处理 UDP**：UDP 流量（如 DNS）需要其他方案
|
||
|
||
## Related Concepts
|
||
- [[反向代理]]：Caddy 是反向代理的具体实现
|
||
- [[内网穿透]]：Caddy 通常与 frp 配合，Caddy 提供 HTTPS，frp 建立隧道
|
||
- [[TCP隧道]]：Caddy 处理 HTTP/HTTPS 层；TCP 隧道（Caddy 不参与）
|
||
|
||
## Related Entities
|
||
- [[RackNerd]]：Caddy 部署的 VPS 提供商
|
||
- [[VPS]]：运行 Caddy 的公网服务器
|
||
|
||
## References
|
||
- 官网: https://caddyserver.com/
|
||
- 文档: https://caddyserver.com/docs/
|
||
- Caddyfile 语法: https://caddyserver.com/docs/caddyfile
|