簡介

Caddy 2 是一個強大的、企業級的、開源的 Web 服務器。是一個 Go 編寫的 Web 服務器，類似于 Nginx，Caddy 提供了更加強大的功能。

支持 HTTP/2 的 Web 服務端。它使用 Golang 標準庫提供 HTTP 功能。Caddy 一個顯著的特性是默認啟用HTTPS。它是第一個無需額外配置即可提供HTTPS 特性的Web 服務器。

• 官網：https://caddyserver.com
• 文檔：https://caddyserver.com/docs/

基于 Spring Boot + MyBatis Plus + Vue & Element 實現的后臺管理系統 + 用戶小程序，支持 RBAC 動態權限、多租戶、數據權限、工作流、三方登錄、支付、短信、商城等功能

• 項目地址：https://github.com/YunaiV/ruoyi-vue-pro
• 視頻教程：https://doc.iocoder.cn/video/

特性

• 全自動支持 HTTP/2 協議，無需配置。
• 全自動變成 HTTPS 站點，無需任何配置。
• 合理使用多核
• 支持 IPv6 環境
• 對 WebSockets 有很好的支持
• 可以自動把 Markdown 轉成 HTML
• Caddy 對 log 格式的定義很容易
• 易于部署 ,沒有依賴
• 作為反向代理支持主動和被動健康檢查、負載均衡、斷路、緩存等功能。
• 支持 Windows、 Linux、Mac 三大主流系統

相較于 Nginx 來說使用 Caddy 的優勢如下

• 自動的 HTTPS 證書申請(ACME HTTP/DNS 挑戰)
• 自動證書續期以及 OCSP stapling 等
• 更高的安全性包括但不限于 TLS 配置以及內存安全等
• 友好且強大的配置文件支持
• 支持 API 動態調整配置(有木有人可以搞個 Dashboard)
• 支持 HTTP3(QUIC)
• 支持動態后端，例如連接 Consul、作為 k8s ingress 等
• 后端多種負載策略以及健康檢測等
• 本身 Go 編寫，高度模塊化的系統方便擴展(CoreDNS 基于 Caddy1 開發)

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實現的后臺管理系統 + 用戶小程序，支持 RBAC 動態權限、多租戶、數據權限、工作流、三方登錄、支付、短信、商城等功能

• 項目地址：https://github.com/YunaiV/yudao-cloud
• 視頻教程：https://doc.iocoder.cn/video/

安裝

下載地址：https://caddyserver.com/download

Fedora/RHEL/CentOS 8

$dnfinstall'dnf-command(copr)'
$dnfcoprenable@caddy/caddy
$dnfinstallcaddy

MacOS

brewinstallcaddy

RHEL/CentOS 7

$yuminstallyum-plugin-copr
$yumcoprenable@caddy/caddy
$yuminstallcaddy

Debian/Ubuntu/Raspbian

$sudoaptinstall-ydebian-keyringdebian-archive-keyringapt-transport-https
$curl-1sLf'https://dl.cloudsmith.io/public/caddy/stable/gpg.key'|sudotee/etc/apt/trusted.gpg.d/caddy-stable.asc
$curl-1sLf'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt'|sudotee/etc/apt/sources.list.d/caddy-stable.list
$sudoaptupdate
$sudoaptinstallcaddy

安裝完成后，在終端命令行下輸入 caddy ：

$caddy

Caddyisanextensibleserverplatform.

usage:
caddy[]

commands:
adaptAdaptsaconfigurationtoCaddy'snativeJSON
build-infoPrintsinformationaboutthisbuild
environPrintstheenvironment
file-serverSpinsupaproduction-readyfileserver
fmtFormatsaCaddyfile
hash-passwordHashesapasswordandwritesbase64
helpShowshelpforaCaddysubcommand
list-modulesListstheinstalledCaddymodules
reloadChangestheconfigoftherunningCaddyinstance
reverse-proxyAquickandproduction-readyreverseproxy
runStartstheCaddyprocessandblocksindefinitely
startStartstheCaddyprocessinthebackgroundandthenreturns
stopGracefullystopsastartedCaddyprocess
trustInstallsaCAcertificateintolocaltruststores
untrustUntrustsalocally-trustedCAcertificate
upgradeUpgradeCaddy(EXPERIMENTAL)
validateTestswhetheraconfigurationfileisvalid
versionPrintstheversion

Use'caddyhelp'formoreinformationaboutacommand.

Fulldocumentationisavailableat:

常用命令

$systemctlstart[stop|restart]caddy//啟動服務
$systemctlreloadcaddy//重新加載配置文件
$systemctlstatuscaddy//查看運行狀態

配置

Caddy2 的配置文件核心采用 json，但是 json 可讀性不強，所以官方維護了一個轉換器，抽象出稱之為 Caddyfile 的新配置格式；關于 Caddyfile 的完整語法請查看官方文檔。文檔地址：https://caddyserver.com/docs/caddyfile

常用配置

站點配置

(site_option){
encodezstdgzip
file_server
handle_errors{
rewrite*/{http.error.status_code}.html
file_server
}
importacme_https
importlog_file
root*/www/{host}
}

多域名配置

地址{
........
}

這個地址支持以下幾種格式

localhost
example.com
:443
http://example.com
localhost:8080
127.0.0.1
[::1]:2015
example.com/foo/*
*.example.com
http://

全局配置選項

{
#開啟所有的調試輸出
debug
#設定默認的sni
default_snidomain.com
#打開或關閉管理端口
adminoff
}

錯誤頁面跳轉

www.mingongge.com{
root*/web/mingongge.com/
file_server
handle_errors{
rewrite*/{http.error.status_code}.html
file_server
}
}

Log 日志

(log_file){
log{
formatlogfmt
outputfile/var/log/caddy/{host}.access.log{
roll_keep7
}
}
}

Header

www.mingongge.com{
root*/web/mingongge.com/
file_server
headerAccess-Control-Allow-Origin*
headerCache-Controlmax-age=3600
header/css/*Cache-Controlmax-age=604800
}

Cache-Control

(cachecontrol){
header/css/*Cache-Controlmax-age=3600
header/img/*Cache-Controlmax-age=3600
header/js/*Cache-Controlmax-age=3600
}

反向代理

https://www.mingongge.com{
gzip
tlsadmin@mingongge.com
proxy/https://welcome.mingongge.com
}

快速創建一個站點

caddyfile-server--website./index--listen:8088--domainwww.mingongge.com

參數說明

file-server#這是一個文件服務器
--website#文件服務的根目錄
./index#首頁文件的存儲目錄（如存放index.html）
--listen:8088#定義監聽端口
--domainwww.mingongge.com#綁定域名

配置片段

Caddyfile 支持類似代碼中 function 一樣的配置片段，這些配置片段可以在任意位置被 import，同時可以接受參數，以下為配置片斷示例:

#括號內為片段名稱，可以自行定義
(TLS){
protocolstls1.2tls1.3
ciphersTLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
}

#在任意位置可以引用此片段從而達到配置復用
importTLS

配置模塊化

import 指令除了支持引用配置片段以外，還支持引用外部文件，同時支持通配符，有了這個命令以后我們就可以方便的將配置文件進行模塊化處理:

#引用外部的/etc/caddy/*.caddy
import/etc/caddy/*.caddy

模塊化配置實例

Caddyfile

Caddyfile 類似于 nginx 的 nginx.conf 主配置。

(LOG){
log{
formatformatted"[{ts}]{request>remote_addr}{request>proto}{request>method}<-?{status}?->{request>host}{request>uri}{request>headers>User-Agent>[0]}"{
time_format"iso8601"
}
outputfile"{args.0}"{
roll_size100mb
roll_keep3
roll_keep_for7d
}
}
}

(TLS){
protocolstls1.2tls1.3
ciphersTLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
}

(HSTS){
header/Strict-Transport-Security"max-age=63072000"
}

(ACME_GANDI){
#從環境變量獲取GANDI_API_TOKEN
dnsgandi{$GANDI_API_TOKEN}
}

#聚合上面的配置片段為新的片段
(COMMON_CONFIG){
#壓縮支持
encodezstdgzip

#TLS配置
tls{
importTLS
importACME_GANDI
}

#HSTS
importHSTS
}

#開啟HTTP3實驗性支持
{
servers:443{
protocol{
experimental_http3
}
}
}

#引入其他具體的站點配置
import/etc/caddy/*.caddy

站點配置

www.mingongge.com{
#重定向到mingongge.com(默認302)
redirhttps://mingongge.com{uri}

#日志
importLOG"/data/logs/mingongge.com.log"

#TLS、HSTS、ACME等通用配置
importCOMMON_CONFIG
}

mingongge.com{
#路由
route/*{
reverse_proxymingongge_com:80
}

#日志
importLOG"/data/logs/mingongge.com.log"

#TLS、HSTS、ACME等通用配置
importCOMMON_CONFIG
}

配置完成后，通過 systemctl start caddy 去啟動 caddy 服務器。每次配置修改后可以通過 systemctl reload caddy 進行配置重載。這些命令的功能與 Nginx 的命令功能基本一樣。

總結

Caddy 內置了豐富的插件，例如 “file_server”、內置各種負載均衡策略等，這些插件組合在一起可以實現一些復雜的功能。Caddy 采用 Go 語言編寫，相比較而言（Nginx 通過 Lua 或者 C 開發插件），對于后期的開發更容易上手。

---

---