安装

本页介绍在系统上安装 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 的发布页面（展开 “Assets”）
     • 有关如何验证资源签名，请参阅验证资产签名
   • 从我们的下载页面
   • 从源码构建（使用 go 或 xcaddy）
2. 将 Caddy 安装为系统服务。 强烈建议这样做，尤其是在生产服务器上。

将二进制文件放到你的某个 $PATH（或 Windows 上的 %PATH%）目录中，这样就可以无需输入可执行文件的完整路径即可运行 caddy。（运行 echo $PATH 可查看符合条件的目录列表。）

你可以通过用新版二进制替换来升级静态二进制并重启 Caddy。caddy upgrade 命令 可以简化此操作。

Debian、Ubuntu、Raspbian

安装此包会自动以名为 caddy 的 systemd 服务 启动并运行 Caddy。它还带有一个可选的 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
chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
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
chmod o+r /usr/share/keyrings/caddy-testing-archive-keyring.gpg
chmod o+r /etc/apt/sources.list.d/caddy-testing.list
sudo apt update
sudo apt install caddy

查看 Cloudsmith 仓库

如果你希望将打包的支持文件（systemd 服务、bash 自动补全和默认配置）与自定义 Caddy 构建一起使用，相关说明可在此处找到 package support files for custom builds for debian/ubuntu/raspbian。

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 的 exec 文档，这可能导致某些主机目录对于 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 插件源码