Skip to content

建立 2026-09-15 更新 2026-09-15

認識 Caddy

Caddy 是用 Go 寫成的現代 Web 伺服器。它預設用 HTTPS 對外服務,會自動申請、續期 TLS 憑證,也常拿來當反向代理(reverse proxy)與靜態檔案伺服器。本站用繁體中文整理最常用的那一層,讓你先把網站安全地上線,再按需要往深處走。

最需要掌握的 20%

學 Caddy 不必先把整本官方文件背完。先把下面五件事做熟,就能處理大多數個人網站、API 與 homelab 場景:

  1. Caddyfile 站台區塊:第一行寫網域或位址,大括號裡寫指令(directive)。
  2. 自動 HTTPS:設定檔出現公開網域、伺服器開 80/443,Caddy 就會向 Let's Encrypt 或 ZeroSSL 申請憑證,並把 HTTP 轉到 HTTPS。
  3. reverse_proxy:把流量轉到本機或 Docker 裡的應用程式。
  4. file_server:提供靜態網站或目錄瀏覽。
  5. 安裝與零停機重載:改完設定用 caddy reloadsystemctl reload caddy,不要停掉再啟動。

Caddy 適合什麼場景

  • 個人部落格、靜態站、小型公司官網:幾行 Caddyfile 就能上 HTTPS。
  • 一台機器跑多個服務:用網域或路徑把請求轉到不同後端。
  • 不想再維護 Certbot 排程:憑證申請與續期內建在伺服器裡。
  • 本機開發也要 HTTPS:localhost 會用 Caddy 自己的內部 CA 簽憑證。

它不是 Nginx 的逐行替身。Caddyfile 比較短,進階行為有時要改 JSON、加模組,或查官方指令參考。需要 DNS-01(例如泛域名 *.example.com)時,標準套件不夠,要另外編譯模組,見 模組與 xcaddy

官方學習資源

Caddy 沒有官方 YouTube 頻道,也沒有原廠證照課程。權威來源是官方文件與作者本人的公開演講。

官方文件(必看)

Getting StartedCaddyfile 教學 適合所有程度。安裝、設定請優先跟官方走,不要隨便複製來路不明的指令。

作者影音

作者 Matt Holt 在 API Platform Conference 與 Changelog Go Time 有公開演講/訪談,本站已在 官方與作者影音 用 iframe 內嵌。想系統精讀可看他的付費教材 Expert Caddy

YouTube 實作

Homelab、Docker、Cloudflare DNS-01 等實作示範見 YouTube 優質教學。先建立 Caddyfile 觀念,再對照影片動手。

建議學習順序

  1. 安裝 Caddy
  2. 跑起第一個網站
  3. 讀懂 Caddyfile
  4. 自動 HTTPS反向代理
  5. 依環境選 Dockersystemd

相關連結以官方為準:caddyserver.com文件首頁社群論壇。想認識唯客學院,請看 關於我們