安装 | Coolify Docs

如果您选择 Coolify Cloud，则无需安装。只需访问 Coolify Cloud 注册创建账户，即可在几分钟内开始使用 Coolify！

如果您偏好 自托管，以下将提供安装 Coolify 的说明。

自托管安装

如果您喜欢掌控一切并自行管理，自托管 Coolify 是您的最佳选择。

它完全免费（除了服务器成本），并让您完全掌控您的设置。

快速安装（推荐）：

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

在终端中运行此脚本，Coolify 将自动安装。有关更多详细信息，包括防火墙配置和先决条件，请查看以下指南。

Ubuntu 用户须知：

自动安装脚本仅适用于 Ubuntu LTS 版本（20.04、22.04、24.04）。如果您使用的是非 LTS 版本（例如 24.10），请使用下面的手动安装方法。

开始之前

在安装 Coolify 之前，请确保您的服务器满足必要要求。

1. 服务器要求

您需要一台具有 SSH 访问权限的服务器。可以是：

VPS（虚拟专用服务器）
专用服务器
虚拟机 (VM)
Raspberry Pi（请参阅我们的 Raspberry Pi OS 设置指南）
或任何其他具有 SSH 访问权限的服务器

注意：

最好为 Coolify 使用全新的服务器，以避免与现有应用程序发生冲突。

提示：

如果您尚未选择服务器提供商，请考虑使用 Hetzner。您甚至可以使用我们的推荐链接来支持该项目。

2. 支持的操作系统

Coolify 支持多种 Linux 发行版：

Debian 系（例如 Debian、Ubuntu - 支持所有版本，但非 LTS Ubuntu 需要手动安装）
Redhat 系（例如 CentOS、TencentOS、Fedora、Redhat、AlmaLinux、Rocky、Asahi）
SUSE 系（例如 SLES、SUSE、openSUSE）
Arch Linux（注意：并非所有 Arch 衍生版本都受支持）
Alpine Linux
Raspberry Pi OS 64 位 (Raspbian)

注意

对于某些发行版（如 AlmaLinux），必须预先安装 Docker。如果安装脚本失败，请手动安装 Docker 并重新运行脚本。

其他 Linux 发行版可能与 Coolify 兼容，但尚未经过官方测试。

3. 支持的架构

Coolify 在 64 位系统上运行：

AMD64
ARM64

Raspberry Pi 用户须知：

请务必使用 64 位版本的 Raspberry Pi OS (Raspbian)。详情请查看我们的 Raspberry Pi OS 设置指南。

4. 最低硬件要求

您的服务器至少应具备：

CPU：2 核
内存 (RAM)：2 GB
存储：30 GB 可用空间

Coolify 可能在低于上述规格的服务器上也能正常运行，但我们建议稍微提高最低要求。

这确保用户拥有足够的资源来部署多个应用程序而不会出现性能问题。

注意！

如果您在同一台服务器上同时运行构建和 Coolify，请监控您的资源使用情况。高资源使用率可能导致服务器无响应。

如有必要，请考虑启用交换空间或升级您的服务器。

5. 项目的服务器资源

您所需的资源取决于您的项目。例如，如果您托管多个服务或较大的应用程序，请选择具有更高 CPU、内存和存储的服务器。

⚙️ 示例设置：

Andras 在一台具有以下配置的服务器上运行其生产应用：

内存：8GB（平均使用量：3.5GB）
CPU：4 核（平均使用量：20–30%）
存储：150GB（平均使用量：40GB）

此设置可轻松支持：

3 个 NodeJS 应用
4 个静态网站
Plausible Analytics
Fider（反馈工具）
UptimeKuma（运行状况监控）
Ghost（新闻通讯）
3 个 Redis 数据库
2 个 PostgreSQL 数据库

安装方法

有两种安装 Coolify 的方法：

快速安装（推荐）
手动安装

我们强烈建议 快速安装 方法，因为它自动化了流程并减少了出错的可能性。

快速安装（推荐）

这是让 Coolify 运行起来的最简单、最快的方法。

1. 准备您的服务器

以 root 用户身份登录（目前不完全支持非 root 用户）。
按照 SSH 设置指南配置 SSH。
在防火墙指南的帮助下设置防火墙。
确保已安装 curl（通常预装）。

2. 运行安装脚本

一旦服务器准备就绪，请运行：

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

查看脚本源代码

提示：

如果您没有以 root 用户身份登录，请使用 sudo 运行脚本：

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

高级：使用环境变量自定义安装

安装脚本支持多个环境变量来自定义您的 Coolify 安装。这些完全是可选的。

3. 访问 Coolify

安装完成后，脚本将显示您的 Coolify URL（例如 http://203.0.113.1:8000）。访问此 URL，您将被重定向到注册页面以创建您的第一个管理员账户。

注意：

安装后立即创建您的管理员账户。如果其他人在您之前访问注册页面，他们可能会获得您服务器的完全控制权。

注意：

如果您在家庭网络内的 Raspberry Pi 上安装了 Coolify，请使用您的私有 IP 地址访问它，因为公共 IP 可能无法工作。

安装程序执行的操作：

安装必要的工具（curl、wget、git、jq、openssl）
安装 Docker Engine（版本 24+）
配置 Docker 设置（日志记录、守护进程）
在 /data/coolify 设置目录
配置用于服务器管理的 SSH 密钥
安装并启动 Coolify

注意：

通过 snap 安装的 Docker 不受支持！

快速安装指南到此结束。如果您已按照上述步骤操作，现在就可以开始使用 Coolify。以下指南适用于希望手动安装和设置 Coolify 的人。

手动安装

对于偏好更多控制权的人，您可以手动安装 Coolify。此方法需要一些额外的步骤。

注意

以下手动安装方法适用于：

非 LTS Ubuntu 版本（例如 24.10）
自动脚本遇到问题时

先决条件

SSH：确保 SSH 已启用并正确设置（请参阅 SSH 配置指南）。
curl：确认已安装 curl。
Docker Engine：按照官方 Docker Engine 安装指南（版本 24+）安装 Docker。

注意：

通过 snap 安装的 Docker 不受支持！

请按照以下步骤进行手动设置：

1. 创建目录

在 /data/coolify 下为 Coolify 创建基本目录：

mkdir -p /data/coolify/{source,ssh,applications,databases,backups,services,proxy,webhooks-during-maintenance}
mkdir -p /data/coolify/ssh/{keys,mux}
mkdir -p /data/coolify/proxy/dynamic

2. 生成并添加 SSH 密钥

为 Coolify 生成一个 SSH 密钥以管理您的服务器：

ssh-keygen -f /data/coolify/ssh/keys/id.root@host.docker.internal -t ed25519 -N '' -C root@coolify

然后，将公钥添加到您的 ~/.ssh/authorized_keys：

cat /data/coolify/ssh/keys/id.root@host.docker.internal.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

提示！

如果您已经有 SSH 密钥，您可以跳过生成新密钥，但请记住在安装后将其添加到您的 Coolify 实例中。

3. 设置配置文件

从 Coolify 的 CDN 下载必要的文件到 /data/coolify/source：

curl -fsSL https://cdn.coollabs.io/coolify/docker-compose.yml -o /data/coolify/source/docker-compose.yml
curl -fsSL https://cdn.coollabs.io/coolify/docker-compose.prod.yml -o /data/coolify/source/docker-compose.prod.yml
curl -fsSL https://cdn.coollabs.io/coolify/.env.production -o /data/coolify/source/.env
curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh -o /data/coolify/source/upgrade.sh

4. 设置权限

为 Coolify 文件和目录设置正确的权限：

chown -R 9999:root /data/coolify
chmod -R 700 /data/coolify

5. 生成值

使用安全随机值更新 .env 文件：

sed -i "s|APP_ID=.*|APP_ID=$(openssl rand -hex 16)|g" /data/coolify/source/.env
sed -i "s|APP_KEY=.*|APP_KEY=base64:$(openssl rand -base64 32)|g" /data/coolify/source/.env
sed -i "s|DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -base64 32)|g" /data/coolify/source/.env
sed -i "s|REDIS_PASSWORD=.*|REDIS_PASSWORD=$(openssl rand -base64 32)|g" /data/coolify/source/.env
sed -i "s|PUSHER_APP_ID=.*|PUSHER_APP_ID=$(openssl rand -hex 32)|g" /data/coolify/source/.env
sed -i "s|PUSHER_APP_KEY=.*|PUSHER_APP_KEY=$(openssl rand -hex 32)|g" /data/coolify/source/.env
sed -i "s|PUSHER_APP_SECRET=.*|PUSHER_APP_SECRET=$(openssl rand -hex 32)|g" /data/coolify/source/.env

重要：

仅在首次安装 Coolify 时运行这些命令。稍后更改这些值可能会破坏您的安装。请妥善保管！

6. 创建 Docker 网络

确保已创建 Docker 网络：

docker network create --attachable coolify

7. 启动 Coolify

使用 Docker Compose 启动 Coolify：

docker compose --env-file /data/coolify/source/.env -f /data/coolify/source/docker-compose.yml -f /data/coolify/source/docker-compose.prod.yml up -d --pull always --remove-orphans --force-recreate

重要：

如果您在上述步骤中遇到任何问题，此时可能需要执行 docker login。

您可以通过创建 docker-compose.custom.yml 文件来自定义 Coolify 的容器（端口、资源限制、标签等），并且这些更改在升级后依然有效。详情请查看自定义 Compose 覆盖。

8. 访问 Coolify

您现在可以通过访问 http://203.0.113.1:8000 来访问 Coolify（将 203.0.113.1 替换为您的服务器 IP 地址）。

如果在任何步骤中遇到困难，请随时加入我们的 Discord 社区并在支持论坛频道中发帖。

点击查看所有可用的环境变量

On this page