安裝 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 使用者具備讀取權限。