Nixpacks 构建包 | Coolify Docs

Nixpacks 是由 Railway 创建的开源构建包，源代码可在 Github 上获取。Coolify 将 Nixpacks 用作其构建包之一。

Nixpacks 会检查你的 Git 仓库（在 Nixpacks 中也称为**“源目录”**），并生成一个 Dockerfile，然后基于生成的 Dockerfile 构建 Docker 镜像。

Nixpacks 可以部署完全静态的网站和非静态应用程序。设置好仓库后，你可以轻松使用 Coolify 部署你的项目。

如何使用 Nixpacks？

在 Coolify 中，你只能在基于 Git 的部署中使用 Nixpacks。

在 Coolify 仪表板中打开你的项目，然后点击 创建新资源 按钮。

A. 如果你的 Git 仓库是公开的，请选择 公共仓库 选项。

B. 如果你的仓库是私有的，你可以选择 Github App 或 部署密钥。（这些方法需要额外的配置。如有需要，你可以查看有关设置 Github App 或部署密钥的指南。）

如果你使用的是公共仓库，请在提示时粘贴你的 GitHub 仓库 URL。其他选项的步骤非常相似。

Coolify 默认会使用 Nixpacks。如果没有，请点击选择 Nixpacks 作为你的构建包。

我们有不同的选项，如基础目录、发布目录和端口，这些选项会根据你部署的应用程序（静态网站/应用程序）略有不同。因此，下面有两个关于 Nixpacks 可能部署的部分。

首先，按照本文档的前一部分操作：如何使用 Nixpacks。之后，继续执行以下步骤。

分支： Coolify 会自动从你的仓库中检测分支。
基础目录： 输入 Nixpacks 应用作根目录的目录（例如，如果你的文件在根目录下，则输入 /，或者如果有子文件夹则输入相应的子文件夹）。
- 如果你使用的是 monorepo，则可以输入你想用作基础目录的目录路径（例如 /backend）
是静态站点吗？ 点击此选项以启用静态模式。
端口： 一旦你启用了 是静态站点吗，端口将自动设置为 80 且不可更改。（这是有意为之）
发布目录： 一旦你启用了 是静态站点吗，此发布目录选项将在 UI 上可见。你必须输入生成静态文件的输出目录（通常是 /dist）。
设置好上述所有设置后，点击继续按钮。
为你的静态网站选择 Web 服务器

注意！

你必须点击重启按钮才能使新配置生效。

Nixpacks 将使用你的代码库构建网站，并创建一个带有 Web 服务器的 Docker 镜像来提供服务。这意味着你的最终 Docker 镜像已经准备好提供 HTML、CSS 和 JavaScript 文件。

首先，按照本文档的前一部分操作：如何使用 Nixpacks。之后，继续执行以下步骤。

分支： Coolify 会自动从你的仓库中检测分支。
基础目录： 输入 Nixpacks 应用作根目录的目录（例如，如果你的文件在根目录下，则输入 /，或者如果有子文件夹则输入相应的子文件夹）。
- 如果你使用的是 monorepo，则可以输入你想用作基础目录的目录路径（例如 /backend）
端口： 输入你的应用程序监听传入请求的端口。
是静态站点吗？ 保持未选中状态，因为你正在部署非静态应用程序。
配置好上述所有选项后，点击继续按钮。
点击继续按钮后，你可以调整域名和环境变量等设置，然后点击部署按钮启动你的应用程序。