安装

本页介绍在您的系统上安装 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

安装此软件包会自动以 systemd 服务 的方式启动并运行名为 caddy 的 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
sudo apt update
sudo apt install caddy

测试版（包含 beta 和候选发布）：

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 的 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 防火墙规则以允许非 localhost 的入站连接。

在 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

如需允许非 localhost 的入站连接，请将 unikernel 实例连接到网络。

查看 Unikraft 应用目录 和 KraftCloud 平台示例（由 Unikraft 提供）。

OPNsense

注意：这是社区维护的安装方式。

pkg install os-caddy

查看 FreeBSD caddy-custom makefile 和 os-caddy 插件源码