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

以下是如果您选择自托管 Coolify 的安装说明。

自托管安装

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

它完全免费（除了服务器费用），让您完全控制自己的设置。

⚡️ 快速安装（推荐）：

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

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

开始之前

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

1. 服务器要求

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

• VPS（虚拟专用服务器）
• 专用服务器
• 虚拟机 (VM)
• 树莓派（请参阅我们的树莓派系统设置指南 ↗）
• 或任何其他具有 SSH 访问权限的服务器

注意：

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

提示：

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

2. 支持的操作系统

Coolify 支持多种 Linux 发行版：

• 基于 Debian 的（例如，Debian、Ubuntu）
• 基于 Redhat 的（例如，CentOS、Fedora、Redhat、AlmaLinux、Rocky、Asahi）
• 基于 SUSE 的（例如，SLES、SUSE、openSUSE）
• Arch Linux（注意：并非所有 Arch 衍生产品都受支持）
• Alpine Linux
• 树莓派 OS 64 位（Raspbian）

注意

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

其他 Linux 发行版可能也能与 Coolify 一起使用，但尚未经过官方测试。

3. 支持的架构

Coolify 在 64 位系统上运行：

• AMD64
• ARM64

⚠️ 树莓派用户注意：

请确保使用 64 位版本的树莓派 OS（Raspbian）。有关详细信息，请查看我们的树莓派 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 安装。

例如，您可以设置默认的根用户或定义默认的 docker 网络池。

有关更多详细信息，请参阅使用 ENV 定义自定义 Docker 网络 ↗或使用 ENV 创建根用户 ↗。

3. 访问 Coolify

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

⚠️ 警告：

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

注意：

如果您在家庭网络中的树莓派上安装了 Coolify，请使用您的私有 IP 地址访问它，因为公共 IP 可能不起作用。

安装程序的操作：

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

⚠️ 警告：

不支持通过 snap 安装的 Docker！

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

---

手动安装

对于那些更喜欢更多控制的人，您可以手动安装 Coolify。这种方法需要几个额外的步骤。

先决条件

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

⚠️ 警告：

不支持通过 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。

8. 访问 Coolify

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

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