文档
一个 项目

从源代码构建

有多种构建 Caddy 的选项，如果您需要自定义构建（例如，使用插件）

  • Git: 从 Git 仓库构建
  • xcaddy: 使用 xcaddy 构建
  • Docker: 构建自定义 Docker 镜像

要求

  • Go 1.20 或更高版本

“软件包支持文件”部分包含针对在 Debian 派生系统上使用 APT 命令安装 Caddy 的用户的说明，但需要自定义构建的可执行文件来执行操作。

Git

要求

  • 已安装 Go（见上文）

克隆仓库

git clone "https://github.com/caddyserver/caddy.git"

如果您没有 git，可以从 GitHub 下载源代码作为文件存档。每个 版本 也包含源代码快照。

构建

cd caddy/cmd/caddy/
go build

Go 程序很容易为其他平台编译。只需设置与您不同的 GOOS、GOARCH 和/或 GOARM 环境变量。（有关详细信息，请参阅 go 文档。）

例如，当您不在 Windows 上时，要为 Windows 编译 Caddy

GOOS=windows go build

或者类似地，当您不在 Linux 上或不在 ARMv6 上时，要为 Linux ARMv6 编译

GOOS=linux GOARCH=arm GOARM=6 go build

xcaddy

xcaddy 命令 是使用版本信息和/或插件构建 Caddy 的最简单方法。

要求

  • 已安装 Go（见上文）
  • 确保 xcaddy 在您的 PATH 中

您**不需要**下载 Caddy 源代码（它会为您完成）。

然后，构建 Caddy（包含版本信息）就像这样简单

xcaddy build

要使用插件构建，请使用 --with

xcaddy build \
    --with github.com/caddyserver/nginx-adapter
	--with github.com/caddyserver/[email protected]

如您所见，您可以使用 @ 语法自定义插件的版本。版本可以是标签名称、提交 SHA 或分支。

使用 xcaddy 进行跨平台编译与使用 go 命令相同。例如，要为 macOS 跨编译

GOOS=darwin xcaddy build

Docker

您可以使用 :builder 镜像作为构建具有自定义模块的新 Caddy 二进制文件的快捷方式

FROM caddy:<version>-builder AS builder

RUN xcaddy build \
    --with github.com/caddyserver/nginx-adapter \
    --with github.com/hairyhenderson/[email protected]

FROM caddy:<version>

COPY --from=builder /usr/bin/caddy /usr/bin/caddy

确保将 <version> 替换为 Caddy 的最新版本以开始。

请注意第二个 FROM 指令——这通过简单地将新构建的二进制文件覆盖到常规 caddy 镜像之上来生成更小的镜像。

构建器使用 xcaddy 来构建 Caddy，并使用提供的模块，类似于 上面概述 的过程。

要使用 Docker Compose，请参阅我们推荐的 compose.yml 和使用说明。

用于 Debian/Ubuntu/Raspbian 自定义构建的软件包支持文件

此过程旨在简化运行自定义 caddy 二进制文件，同时保留 caddy 软件包中的支持文件。

此过程允许用户利用来自官方软件包的默认配置、systemd 服务文件和 bash-completion。

要求

  • 根据 这些说明 安装 caddy 软件包
  • 构建您的自定义 caddy 二进制文件（见上文部分），或 下载 自定义构建
  • 您的自定义 caddy 二进制文件应位于当前目录中

步骤

sudo dpkg-divert --divert /usr/bin/caddy.default --rename /usr/bin/caddy
sudo mv ./caddy /usr/bin/caddy.custom
sudo update-alternatives --install /usr/bin/caddy caddy /usr/bin/caddy.default 10
sudo update-alternatives --install /usr/bin/caddy caddy /usr/bin/caddy.custom 50
sudo systemctl restart caddy

说明

  • dpkg-divert 会将 /usr/bin/caddy 二进制文件移动到 /usr/bin/caddy.default，并在任何软件包想要安装文件到此位置时放置一个转移。

  • update-alternatives 会从所需的 caddy 二进制文件创建到 /usr/bin/caddy 的符号链接。

  • systemctl restart caddy 会关闭 Caddy 服务器的默认版本并启动自定义版本。

您可以通过执行以下操作并在屏幕上显示的信息后，在自定义和默认 caddy 二进制文件之间切换。然后，重新启动 Caddy 服务。

update-alternatives --config caddy

在这一点之后升级 Caddy，您可以运行 caddy upgrade。这会尝试 下载 与当前构建具有相同插件的构建，并使用 Caddy 的最新版本，然后将当前二进制文件替换为新的二进制文件。