安装

此页面描述了在您的系统上安装 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 并将其作为名为 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

测试版本（包括 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 防火墙规则以允许非本地主机传入连接。

在 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 插件源代码