Skip to content

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

安裝

Caddy 是單一靜態執行檔,沒有執行期相依套件。正式環境優先用官方套件或官方 Docker image;第三方外掛(例如 Cloudflare DNS)不在標準二進位裡,要另外編譯,見 模組與 xcaddy

完整清單以 官方 Install 為準。

Debian/Ubuntu

官方 apt 套件會安裝 systemd 服務 caddy,並預設讀 /etc/caddy/Caddyfile

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \
  | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \
  | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

裝完後服務通常已在跑。確認版本:

caddy version

改設定後用 sudo systemctl reload caddy 重載,不要 stop 再開,以免網站中斷。細節見 當系統服務執行

Docker

docker pull caddy

Compose 範例與 volume 注意事項見 Docker 部署。映像只含標準模組;要 DNS 外掛需自己 build。

macOS(社群維護)

brew install caddy

Homebrew formula 由社群維護,不是官方套件來源。

Windows(社群維護)

scoop install caddy

或使用 Chocolatey:choco install caddy。本機測試夠用;正式站仍建議 Linux + 官方套件或 Docker。

靜態二進位

GitHub Releases官方下載頁 取得對應平台的檔案,放到 $PATH。下載頁可勾選要編譯進去的模組。

生產環境除了放好二進位,還應設成系統服務,開機自動啟動、當機可重啟、日誌可查。

裝完下一步

到本機跑 第一個網站。若這台機器已經有公開網域,可直接看 自動 HTTPS