Caddy Server 簡介
簡介
Caddy 是一個年輕的 web server,以 Go 語言撰寫,特色:
- 支援自動從 Let’s Encrypt 取得與更新 TLS 1.3 加密憑證。
- 以 HTTPS 作為預設的通訊協定。
- 支援 HTTP/3。
- 支援 IPv6。
- 不依賴其它套件或 runtime,可獨立執行,因此很適合放在容器內跑。
- 以 production 為目標,可替代爺爺級的 Apache 或 Nginx。
- 提供組態設定 API。
- 支援 virtual host。
- 支援 reverse proxy。
- 支援 rewrite。
- 支援壓縮。
當然其它特色還很多,但其中比較值得一提的就是上面這幾點。
下載
前面提到 Caddy 本身不用依賴其它套件,所以官方發布的就只是個單一的執行檔,撇開之後由我們自己產生的設定檔不算的話,這就是 Caddy 的全部了!也或許是這樣的緣故,Caddy 並沒有提供任何的套件包或安裝檔。
依照 Caddy 網站的路徑下載 caddy,這裡我們直接抓 Caddy 2 的版本(以下的範例也都是以 Caddy 2 為基準),抓下來的檔名因版次或平台不同會有差異,先改名成簡潔的 caddy
,再幫它加一下可執行的屬性:
> chmod a+x ./caddy
靜態網頁伺服器
在 Caddy 所在位置新增一個 index.html,內容如下:
<h1>Hello Caddy!</h1>
最單純的用法,這個簡易的指令體現了 Caddy 的簡潔:
> ./caddy file-server 2019/11/30 00:36:24.301 WARN admin admin endpoint disabled 2019/11/30 00:59:38.744 INFO tls cleaned up storage units 2019/11/30 08:36:24 [INFO][cache:0xc0000d0140 Started certificate maintenance routine 2019/11/30 08:36:24 Caddy 2 serving static files on :2015
從最後一行我們可以知道埠號是 2015,Caddy 會去找當前位置下的 index.html 來顯示,因此用瀏覽器開 127.0.0.1:2015 應該會看到如下圖畫面:
檔案伺服器
先把剛剛的 index.html 改名或刪除,再加上 --browse
來跑,--browse
表示如果找不到 index.html,就列出當前位置下的檔案:
> ./caddy file-server --browse 2019/11/30 00:36:24.301 WARN admin admin endpoint disabled 2019/11/30 08:36:24 [INFO][cache:0xc0000d0140 Started certificate maintenance routine 2019/11/30 08:36:24 Caddy 2 serving static files on :2015
從最後一行我們可以知道埠號是 2015,打開 127.0.0.1:2015 應該可以看到類似下面的畫面:
前面指令內的 --browse
表示開啟瀏覽目前 Caddy 所在位置的目錄檔案清單 ,也就是上面看到的抓圖內容。
Caddyfile
前面都是簡單的範例,如果要做比較正規的應用,則需要一些組態設定,在 Caddy 的世界,除了用 API 之外,還支援 Caddyfile 的設定檔,API 與 Caddyfile 不同之處在於,API 必須使用 JSON 格式傳遞溝通,而 Caddyfile 的語法更像是傳統的定檔的格式,對人類來說更容易讀寫。
這裡必須再提一次這篇文章是講 Caddy 2,因為 Caddy 1 與 Caddy 2 的 Caddyfile 是不同的,雖然不同,但只是設定檔的關鍵字與格式不同,整體的 Caddyfile 語法結構還是相同的,所以還是得參考 Caddy 1 的 The Caddyfile Syntax 來了解 Caddyfile 的結構。
沿用剛才的例子,做一個簡單的 index.html,以及一個 Caddyfile 內容如下:
localhost:8080 { file_server }
應該很容易理解,第一行表示監聽 localhost:8080,並且後方以大括號包住的區塊都是這組 localhost:8080 的設定。(在 Linux 針對埠號 1024 以下的常用埠號有權限限制,如果沒有權限的用戶要監聽埠號 80 的話會被系統阻擋,故要監聽 1024 以下的埠號須以 root 權限跑 Caddy。)
第二行表示啟動靜態檔案伺服,有 index.html 就會回應出去,並且未開啟目錄瀏覽。
跑起來看看:
> ./caddy run
caddy run
會自己去找同樣位置下的 Caddyfile,所以應該會看到同樣的 Hello Caddy! 網頁:
Virtual Host
如果想要設定兩組網址,以 www1.example.com 與 www2.example.com 為例,可能的 Caddyfile 會長這樣:
www1.example.com:80 { root /www/www1.example.com file_server } www2.example.com:80 { root /www/www2.example.com file_server }
在上面的例子中,我們用 root
來指定該組網址對應到的真實路徑。
結語
這篇文章介紹了 Caddy 2 的特性與 Caddyfile 的基本設定,並且只涉及到 Caddy 本身,關於 Caddy 與其它 web framework 之間的整合之後有機會再另外寫一篇。
Caddy 2 的文件還沒有很完整,想要用的人還是必須多多參考 Caddy2 網站或 Caddy wiki 的文件。
喜欢我的作品吗?别忘了给予支持与赞赏,让我知道在创作的路上有你陪伴,一起延续这份热忱!