安裝

本頁面介紹了在您的系統上安裝 Caddy 的各種方法。

官方：

• 靜態二進位檔案
• Debian, Ubuntu, Raspbian 套件
• Fedora, RedHat, CentOS 套件
• Arch Linux, Manjaro, Parabola 套件
• Docker 映像檔
• Railway 範本

社群維護：

• Gentoo
• Homebrew (Mac)
• Chocolatey (Windows)
• Scoop (Windows)
• Webi
• Ansible
• Termux
• Nix/Nixpkgs/NixOS
• Unikraft
• OPNsense
• Mise

靜態二進位檔案

如果是安裝到生產系統，如果下方有適用於您發行版的官方套件，我們建議使用官方套件。

1. 獲取 Caddy 二進位檔案：
   • 從 GitHub 上的版本發布中獲取（展開「Assets」）
     • 參考 驗證資產簽名 了解如何驗證資產簽名
   • 從我們的下載頁面獲取
   • 從源代碼構建（使用 go 或 xcaddy）
2. 將 Caddy 安裝為系統服務。 強烈建議執行此操作，特別是對於生產伺服器。

將二進位檔案放置在您的 $PATH（或 Windows 上的 %PATH%）目錄之一，這樣您就可以直接運行 caddy 而無需輸入可執行文件的完整路徑。（運行 echo $PATH 查看符合條件的目錄列表。）

您可以通過將靜態二進位檔案替換為新版本並重啟 Caddy 來進行升級。caddy upgrade 命令 可以簡化此過程。

Debian, Ubuntu, Raspbian

安裝此套件會自動啟動並將 Caddy 作為名為 caddy 的 systemd 服務 運行。它還附帶一個可選的 caddy-api 服務，該服務預設 not 啟用，但如果您主要通過 API 而不是配置檔案來配置 Caddy，則應使用該服務。

安裝後，請閱讀 服務使用說明。

穩定版本：

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

測試版本 （包含測試版和發行候選版）：

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

查看 Cloudsmith 倉庫

如果您希望在自定義 Caddy 構建中使用隨附的支援檔案（systemd 服務、bash 完成和預設配置），可以 在此處找到說明。

Fedora, RedHat, CentOS

此套件附帶了 Caddy 的兩個 systemd 服務 單元檔案，但預設不啟用它們。建議使用該服務。如果您這樣做，請閱讀 服務使用說明。

Fedora：

dnf install dnf5-plugins
dnf copr enable @caddy/caddy
dnf install caddy

CentOS/RHEL：

dnf install dnf-plugins-core
dnf copr enable @caddy/caddy
dnf install caddy

查看 Caddy COPR

Arch Linux, Manjaro, Parabola

此套件附帶了經過大幅修改的 Caddy 兩個 systemd 服務 單元檔案，但預設不啟用它們。 這些修改包括自定義的啟動/停止行為和額外的沙箱標記，這些標記在 systemd 的執行文件 中有詳細說明，這可能導致某些主機目錄對 Caddy 程式不可用。

pacman -Syu caddy

在 Arch Linux 倉庫中查看 Caddy 以及 Arch Linux Wiki

Docker

docker pull caddy

在 Docker Hub 上查看

請參閱我們 推薦的 Docker Compose 配置 和使用說明。

Railway

通過來自 Railway 的贊助，我們官方支援此範本：

Gentoo

注意：這是一個社群維護的安裝方法。

emerge www-servers/caddy

查看 Gentoo 套件

Homebrew (Mac)

注意：這是一個社群維護的安裝方法。

brew install caddy

查看 Homebrew formula

Chocolatey (Windows)

注意：這是一個社群維護的安裝方法。

choco install caddy

查看 Chocolatey 套件

Scoop (Windows)

注意：這是一個社群維護的安裝方法。

scoop install caddy

查看 Scoop manifest

Webi

注意：這是一個社群維護的安裝方法。

Linux 和 macOS：

curl -sS https://webi.sh/caddy | sh

Windows：

curl.exe https://webi.ms/caddy | powershell

您可能需要調整 Windows 防火牆規則以允許非本地主機的傳入連線。

在 Webi 上查看

Ansible

注意：這是一個社群維護的安裝方法。

ansible-galaxy install nvjacobo.caddy

查看 Ansible role 倉庫

Termux

注意：這是一個社群維護的安裝方法。

pkg install caddy

查看 Termux build.sh 檔案

Nix/Nixpkgs/NixOS

注意：這是一個社群維護的安裝方法。

• 套件名稱：caddy
• NixOS 模組：services.caddy

在 Nixpkgs 搜尋中查看 Caddy 以及 NixOS 選項搜尋

Unikraft

注意：這是一個社群維護的安裝方法。

首先安裝 Unikraft 的配套工具 kraft：

curl --proto '=https' --tlsv1.2 -sSf https://get.kraftkit.sh | sh

然後使用以下命令運行帶有 Unikraft 的 Caddy：

kraft run --rm -p 2015:2015 --plat qemu --arch x86_64 -M 256M caddy:2.7

要允許非本地主機傳入連線，您需要 將 unikernel 實例連接到網絡。

查看 Unikraft 應用程式目錄 以及 KraftCloud 平台範例（由 Unikraft 提供支援）。

OPNsense

注意：這是一個社群維護的安裝方法。

pkg install os-caddy

查看 FreeBSD caddy-custom makefile 以及 os-caddy 插件源代碼

Mise

注意：這是一個社群維護的安裝方法。

如果您正在使用 mise（多語言工具版本管理器），可以使用類似以下的命令來安裝最新版本：

mise use -g caddy@latest