安裝 Caddy 最推薦透過官方套件庫進行(如 Ubuntu/Debian 使用 apt),並透過編輯 /etc/caddy/Caddyfile 完成基本網站或反向代理設定。Caddy 最大的特色是內建自動申請與續期 HTTPS 憑證,無需繁瑣的 SSL 配置。

以下以最常見的 Ubuntu / Debian 環境為例,整理安裝與基本設定步驟(其他系統可參考 Caddy 官方安裝文件):

1. 安裝 Caddy (Ubuntu / Debian)

透過官方軟體源安裝可確保獲得穩定更新,並自動設定好系統背景服務:

在 Ubuntu/Debian 系統上,可透過新增官方 Cloudsmith 儲存庫並執行 sudo apt install caddy 完成安裝;其他系統如 CentOS/RHEL 可用 sudo dnf install caddy、macOS 可用 brew install caddy、或透過 Docker 執行 docker pull caddy。 [1]

2. 基本 Caddyfile 設定

安裝後,設定檔預設位於 /etc/caddy/Caddyfile,常見設定範例包含:

  • 靜態網站託管:設定 root 與 file_server,Caddy 會自動處理 HTTPS。
  • 反向代理:使用 reverse_proxy 將流量轉發至後端服務。
  • 本機測試:直接監聽特定連接埠(如 :8080)回傳文字。

3. 服務管理與套用設定

修改 Caddyfile 後,可透過以下指令管理服務:

  • 驗證語法:sudo caddy validate --config /etc/caddy/Caddyfile
  • 重載設定:sudo systemctl reload caddy
  • 檢查狀態:sudo systemctl status caddy

4. 部署注意事項

  • 防火牆與 DNS:需開啟 80 及 443 連接埠,並確保網域 A/AAAA 記錄正確指向伺服器 IP,以利 Let’s Encrypt 簽發憑證。
  • 檔案權限:確保靜態目錄對 caddy 使用者具備讀取權限。

Categorized in:

Tagged in:

,