超越Nginx的Web伺服器caddy優雅用法

前言

Nginx是一款非常流行的Web伺服器，在Github上已有16K+Star，我們經常用它來做靜態資源託管或反向代理。最近發現了一款全新的Web伺服器Caddy，Star數超越Nginx，標星38K+Star。試用了一下Caddy，發現它使用起來比Nginx優雅多了，功能也很強大，推薦給大家！

SpringBoot實戰電商專案mall（50k+star）地址：https://github.com/macrozheng/mall

Caddy簡介

Caddy是一款功能強大，擴充套件性高的Web伺服器，目前在Github上已有38K+Star。Caddy採用Go語言編寫，可用於靜態資源託管和反向代理。

Caddy具有如下主要特性：

• 對比Nginx複雜的設定，其獨創的Caddyfile設定非常簡單；
• 可以通過其提供的Admin API實現動態修改設定；
• 預設支援自動化HTTPS設定，能自動申請HTTPS證書並進行設定；
• 能夠擴充套件到數以萬計的站點；
• 可以在任意地方執行，沒有額外的依賴；
• 採用Go語言編寫，記憶體安全更有保證。

安裝

首先我們直接在CentOS 8上安裝Caddy，使用DNF工具安裝無疑是最簡單的，Docker安裝方式之後也會介紹。

使用如下命令通過DNF工具安裝Caddy，安裝成功後Caddy會被註冊成系統服務；

dnf install 'dnf-command(copr)'
dnf copr enable @caddy/caddy
dnf install caddy

使用systemctl status caddy檢視Caddy的狀態，可以發現Caddy已被註冊為系統服務，但是還沒開啟。

使用

下面我們體驗下Caddy的基本使用，對於Web伺服器來說都是常用的操作，你準能用的上！

基本使用

首先我們來個Caddy的入門使用，讓Caddy執行在2015埠上並返回Hello, world!。

直接使用caddy命令將輸出Caddy的常用命令，基本看介紹就知道如何使用了，標出來的是常用命令；

使用caddy start命令可以讓Caddy服務在後臺執行；

Caddy預設使用JSON格式的組態檔，但由於JOSN格式設定書寫比較麻煩，又提供了Caddyfile這種更加簡潔的設定形式，使用如下命令能自動把Caddyfile轉化為JSON設定；

caddy adapter

我們可以先建立一個名稱為Caddyfile的檔案，檔案內容如下，然後使用caddy adapter將它轉換為JSON設定，再使用caddy reload使設定生效，該設定將監聽2015埠，並返回Hello, world!；

:2015

respond "Hello, world!"

然後我們使用curl命令存取localhost:2015，將返回指定的資訊；

當然我們還可以使用Caddy提供的Admin API來檢視設定資訊，使用如下命令即可；

curl localhost:2019/config/

當前JSON設定如下，如果你直接使用JSON設定的話需要書寫如下設定，使用Caddyfile確實方便很多！

{
	"apps": {
		"http": {
			"servers": {
				"srv0": {
					"listen": [":2015"],
					"routes": [{
						"handle": [{
							"body": "Hello, world!",
							"handler": "static_response"
						}]
					}]
				}
			}
		}
	}
}

Caddyfile基本語法

下面案例將使用Caddyfile來進行設定，我們有必要了解下它的語法，Caddyfile的具體語法規則如下。

介紹下上圖中的關鍵字，有助於理解。

反向代理

反向代理就是當請求存取你的代理伺服器時，代理伺服器會對你的請求進行轉發，可以轉發到靜態的資源路徑上去，也可以轉發到動態的服務介面上去。下面我們以對域名進行代理為例，來講講如何進行靜態代理和動態代理。

靜態代理

靜態代理就是將請求代理到不同的靜態資源路徑上去，這裡我們將對docs.macrozheng.com的請求代理到我的檔案專案中，對mall.macrozheng.com的請求代理到mall的前端專案中。

首先我們修改下本機的host檔案：

192.168.3.106 docs.macrozheng.com
192.168.3.106 mall.macrozheng.com

然後將我們的檔案專案和mall前端專案上傳到Caddy的html目錄中去，並進行解壓操作：

修改Caddyfile檔案，使用如下設定，修改完成後使用caddy reload命令重新整理設定；

http://docs.macrozheng.com {
        root * /mydata/caddy/html/docs
        file_server browse
}

http://mall.macrozheng.com {
        root * /mydata/caddy/html/mall
        file_server browse
}

如果你的Caddyfile檔案格式不太合格的話，會出現如下警告，直接使用caddy fmt --overwrite格式化並重寫設定即可解決；

通過docs.macrozheng.com即可存取部署好的檔案專案了：

通過mall.macrozheng.com即可存取到部署好的前端專案了。

動態代理

動態代理就是把代理伺服器的請求轉發到另一個服務上去，這裡我們將把對api.macrozheng.com的請求代理到演示環境的API服務上去。

首先我們修改下本機的host檔案，新增如下規則

192.168.3.106 api.macrozheng.com

修改Caddyfile檔案，使用如下設定，修改完成後使用caddy reload命令重新整理設定；

http://api.macrozheng.com {
        reverse_proxy http://admin-api.macrozheng.com
}

之後通過api.macrozheng.com/swagger-ui.html即可存取到mall-admin的API檔案頁面了。

檔案壓縮

如果我們的伺服器頻寬比較低，網站存取速度會很慢，這時我們可以通過讓Caddy開啟Gzip壓縮來提高網站的存取速度。這裡我們以mall的前端專案為例來演示下它的提速效果。

我們需要修改Caddyfile檔案，使用encode指令開啟Gzip壓縮，修改完成後使用caddy reload命令重新整理設定；

http://mall.macrozheng.com {
        root * /mydata/caddy/html/mall
        encode {
            gzip
        }
        file_server browse
}

有個比較大的JS檔案壓縮前是1.7M；

壓縮後為544K，存取速度也有很大提示；

另外我們可以看下響應資訊，如果有Content-Encoding: gzip這個響應頭表明Gzip壓縮已經啟用了。

地址重寫

有的時候我們的網站更換了域名，但還有使用者在使用老的域名存取，這時可以通過Caddy的地址重寫功能來讓使用者跳轉到新的域名進行存取。

我們需要修改Caddyfile檔案，使用redir指令重寫地址，修改完成後使用caddy reload命令重新整理設定；

http://docs.macrozheng.com {
        redir http://www.macrozheng.com
}

此時存取舊域名docs.macrozheng.com會直接跳轉到www.macrozheng.com去。

按目錄劃分

有時候我們需要使用同一個域名來存取不同的前端專案，這時候就需要通過子目錄來區分前端專案了。

比如說我們需要按以下路徑來存取各個前端專案；

www.macrozheng.com #存取檔案專案
www.macrozheng.com/admin #存取後臺專案
www.macrozheng.com/app #存取行動端專案

我們需要修改Caddyfile檔案，使用route指令定義路由，修改完成後使用caddy reload命令重新整理設定。

http://www.macrozheng.com {
        route /admin/* {
                uri strip_prefix /admin
                file_server {
                        root /mydata/caddy/html/admin
                }
        }
        route /app/* {
                uri strip_prefix /app
                file_server {
                        root /mydata/caddy/html/app
                }
        }
        file_server * {
                root /mydata/caddy/html/www
        }
}

HTTPS

Caddy能自動支援HTTPS，無需手動設定證書，這就是之前我們在設定域名時需要使用http://開頭的原因，要想使用Caddy預設的HTTPS功能，按如下步驟操作即可。

首先我們需要修改域名的DNS解析，直接在購買域名的網站上設定即可，這裡以docs.macrozheng.com域名為例；

之後使用如下命令驗證DNS解析記錄是否正確，注意設定的伺服器的80和443埠需要在外網能正常存取；

curl "https://cloudflare-dns.com/dns-query?name=docs.macrozheng.com&type=A" 
  -H "accept: application/dns-json"

修改Caddyfile組態檔，進行如下設定；

docs.macrozheng.com {
        root * /mydata/caddy/html/docs
        file_server browse
}

然後使用caddy run命令啟動Caddy伺服器即可，是不是非常方便！

caddy run

Docker支援

當然Caddy也是支援使用Docker進行安裝使用的，其使用和直接在CentOS上安裝基本一致。

首先使用如下命令下載Caddy的Docker映象；

docker pull caddy

然後在/mydata/caddy/目錄下建立Caddyfile組態檔，檔案內容如下；

http://192.168.3.105:80

respond "Hello, world!"

之後使用如下命令啟動caddy服務，這裡將宿主機上的Caddyfile組態檔、Caddy的資料目錄和網站目錄掛載到了容器中；

docker run -p 80:80 -p 443:443 --name caddy 
    -v /mydata/caddy/Caddyfile:/etc/caddy/Caddyfile 
    -v /mydata/caddy/data:/data 
    -v /mydata/caddy/html:/usr/share/caddy 
    -d caddy

之後使用docker exec進入caddy容器內部執行命令；

docker exec -it caddy /bin/sh

輸入Caddy命令即可操作，之後的操作就和我們直接在CentOS上安裝一樣了。

總結

今天體驗了一把Caddy，其強大的指令功能，讓我們無需多餘的設定即可實現各種功能，使用起來確實非常優雅！尤其是其能自動設定實現HTTPS，非常不錯！Nginx能實現的功能Caddy基本都能實現，大家可以對比下之前寫的Nginx使用教學 ，你就會發現使用Caddy來實現有多麼優雅！

參考資料

專案地址：https://github.com/caddyserver/caddy

官方檔案：https://caddyserver.com/

更多關於caddy伺服器的資料請關注it145.com其它相關文章！