安装

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

Static binaries

如果你是在生产系统安装，建议优先使用下方可用的官方发行版软件包。

1. 获取Caddy二进制文件：
   • 从GitHub Releases下载（展开“Assets”）
     • 关于如何验证资源签名，请参考验证资源签名
   • 从下载页面获取
   • 从源码构建（使用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 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

测试版本（包含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 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 exec文档。这可能导致某些宿主目录对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防火墙规则，以允许来自非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插件源码

Mise

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

如果你在使用多语言工具版本管理器mise，可以用下面命令安装最新版：

mise use -g caddy@latest