安裝

此頁面描述在您的系統上安裝 Caddy 的各種方法。

官方

• 靜態二進位檔
• Debian、Ubuntu、Raspbian 套件
• Fedora、RedHat、CentOS 套件
• Arch Linux、Manjaro、Parabola 套件
• Docker 映像

社群維護

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

靜態二進位檔

如果要安裝到生產系統，我們建議使用我們在下方提供的官方套件（如果有的話）。

1. 取得 Caddy 二進位檔
   • 從 GitHub 上的版本（展開「資產」）
     • 請參閱 驗證資產簽章 以了解如何驗證資產簽章
   • 從我們的下載頁面
   • 透過建立來源（使用 go 或 xcaddy）
2. 將 Caddy 安裝為系統服務。強烈建議這樣做，特別是對於生產伺服器。

將二進位檔案放置在 $PATH（或 Windows 上的 %PATH%）目錄之一，這樣您就可以執行 caddy，而不用輸入可執行檔案的完整路徑。（執行 echo $PATH 來查看符合資格的目錄清單。）

您可以透過將靜態二進位檔案替換為較新版本並重新啟動 Caddy 來升級。caddy upgrade 指令可以輕鬆做到這一點。

Debian、Ubuntu、Raspbian

安裝此套件會自動啟動並執行 Caddy 作為名為 caddy 的 systemd 服務。它還附帶一個可選的 caddy-api 服務，預設未啟用，但如果您主要透過 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 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 apt update
sudo apt install caddy

檢視 Cloudsmith 存放庫

如果您希望使用封裝的支援檔案（systemd 服務、bash 完成和預設設定）與自訂 Caddy 建置，可以在 這裡找到說明。

Fedora、RedHat、CentOS

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

Fedora 或 RHEL/CentOS 8

dnf install 'dnf-command(copr)'
dnf copr enable @caddy/caddy
dnf install caddy

RHEL/CentOS 7

yum install yum-plugin-copr
yum copr enable @caddy/caddy
yum 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 設定 和使用說明。

Gentoo

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

emerge www-servers/caddy

檢視 Gentoo 套件

Homebrew (Mac)

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

brew install caddy

檢視 Homebrew 公式

Chocolatey (Windows)

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

choco install caddy

檢視 Chocolatey 套件

Scoop (Windows)

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

scoop install caddy

檢視 Scoop 清單

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 角色存放庫

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 外掛程式原始碼