安装

本页介绍了在您的系统上安装 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 的 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 插件源代码