跳到主内容

Coolify 部署怎么用:从一条 curl 命令到能自动发版的完整流程

一台 2 核 2G 的 VPS,除了挂个静态页,还能不能像 Vercel 那样点一下就发版?我上周拿一台空机器试了 Coolify,结论是能,但第一步就不是「跑一条命令」那么轻松。

先说它是什么:coollabsio/coolify,Apache-2.0,主语言 PHP,把 Docker 包了一层做成自托管控制台。它自己不是一个容器——装完之后机器上会多出主程序、Coolify 自己的 Postgres 与 Redis、Traefik 反代、sentinel 指标采集这一组,再往上的应用都在它们之下跑。仓库到 10 月 28 日是 65,031 星、5,837 个 fork,最新 release 是 v4.5.0(2026-10-23)。

起因:为什么不在云平台上直接点

我的场景很土:一个内部工具、一个 Postgres、一个定时任务,一个月跑不了几次构建。放云平台按项目收费,闲置也照扣;自己拿 VPS 又得手写 Dockerfile、配反代、申请证书、写更新脚本,四件事串起来就是半天。

Coolify 想省的就是这半天。反代、证书、环境变量、健康检查、回滚它都接管,还带 360 多个一键服务模板。差别在责任边界:控制面在你机器上,坏了你修。

先算门槛:2C2G 是底线,10G 是文档数,30G 才是脚本数

官方文档开头那句很短:2 核、2 GB 内存、10 GB 磁盘,amd64 或 arm64。同页补了一句——1 核 512 MB、4 GB 磁盘也能跑,但不推荐。

去读仓库里的 scripts/install.sh(45,635 字节)会发现另一套数:REQUIRED_TOTAL_SPACE=30、REQUIRED_AVAILABLE_SPACE=20。脚本自己认为总盘 30 GB、可用 20 GB 才叫够,不到 10 GB 可用会拦,10 到 20 GB 之间只 warn 不中断。文档的 10 GB 是「能启动」,脚本的 30 GB 是「装得下镜像和备份」,二手教程那句「10 GB 就够」多半只抄了前半句。

还有三条硬门槛:Docker 必须 ≥ 24(脚本里 MIN_DOCKER_VERSION=24,低于它是 exit 1 不是警告);发行版要在白名单内,除 Debian 系、RedHat 系、SUSE 系、Arch 系,还认 alpine、raspbian、tencentos、almalinux、rocky,用腾讯云 TencentOS 的机器不用改系统;Ubuntu 要用 LTS,文档点名 20.04 / 22.04 / 24.04。我搜到一篇教程推荐「Ubuntu 26.04 最新 LTS」,这句跟官方文档对不上,照着装属于赌。

过程:四条命令的距离

我这台是 Debian 12 空机,root 登录,80/443 都空着。

第一步,确认端口。80 和 443 给 Traefik,控制台在 8000,实时更新走 6001,网页终端走 6002。后三个只对自己的 IP 开放就行,绑了域名再关。机器上不能已经有 Nginx 占着 80,否则 Traefik 起不来。

第二步,跑脚本。

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

它会自己装 Docker、拉镜像、生成 /data/coolify/source/.env、把 Coolify 拉起来。4 GB 机器上大概五到十分钟。中途别关终端,半截中断容易留下配置到一半的 Docker。

第三步,立刻开 http://机器IP:8000 建管理员。这不是可选项。官方文档原话:谁先打开注册页,谁就成为实例管理员,也就拿到了这台机器的 root 级控制。放公网上晾着等于把机器交出去。

第四步,备份 .env。里面有 APP_KEY,Coolify 用它加密自己库里的值。文件丢了,即使数据库备份还在也解不开。

进后台建项目、贴公开 Git 仓库、选 Nixpacks 或 Dockerfile、点 Deploy,第一次构建我等了 37 秒(一个很小的 Node 应用)。这跟站内 开源低代码平台搭建踩坑实录 里那条规律一致——卡住人的从来不是代码,是目录不可写、代理没配、端口被占。

踩坑:三个真会让人重装的地方

一、脚本会改 /etc/docker/daemon.json。它要加日志轮转和网络地址池,这两项生效需要重启 Docker daemon。机器上已经跑着别的容器,重启就是一次全员掉线。脚本对此是保守的:默认只在没配过地址池时才写,想强制覆盖得显式传 DOCKER_POOL_FORCE_OVERRIDE=true。反过来说,别在「已经跑着业务」的机器上装。

二、snap 装的 Docker 要先卸。文档单独拎出来说过。snap 版数据目录和路径跟官方 Docker Engine 不一样,装完可能连不上 daemon。

三、按 2 GB 内存规划是骗自己的。有篇实测文给了数字:Coolify 自己那组容器约 500 MB(主程序 428、数据库 45、Traefik 22、Redis 7、sentinel 3),构建用的 Railpack 容器完事不退出,又占 549 MB。光控制面加一次构建就一 GB 出头,剩下才是你应用的。2 GB 是最低能开机,4 GB 才是能干活。

还有个容易忽略的默认行为:Coolify 默认每晚自动更新自己。版本钉死过、或者不想半夜被动升级的,记得关掉。

解法:装完先做四件事,再谈部署

按上面踩过的坑,我现在固定做四件事,顺序不能换:建管理员,密码用密码管理器生成;把 .env 拷到另一台机器;设置里给实例绑域名,让 Traefik 申请证书,成功后 8000/6001/6002 从公网关掉,只留 80/443;给应用准备一个泛解析(如 *.apps.example.com),以后加应用不用改 DNS。

顺序反了会怎样?我先建项目后补域名,旧应用还挂在 IP:端口 上,域名切过去证书对不上,得回去把端口映射重看一遍。

适用边界:什么时候别用它

单应用、低流量。一个静态站或一个 API,用 Caddy 加 systemd 单元两小时能配完,还少一层要维护的控制面。Coolify 的价值随应用数量上升,只有一个应用时它只是多出来的攻击面。

团队里没人愿意读 Docker 报错。官方文档默认你懂容器,报错也基本是 Docker 原话。站内 memos 部署搭建教程 里那份「部署成服务的检查表」同样适用——进程怎么守护、日志往哪落、备份多久一次,三问答得上来再算上线。

机器上已有生产服务。原因就是那条 daemon.json。真要共存,先用 docker ps 数清多少容器会被重启带走。

想要一个能放十几个小项目的发布入口,它是这条路上最省事的。源码在 github.com/coollabsio/coolify,文档在 coolify.io/docs。另有官方托管 Cloud 版,价格随方案变,以官网定价页为准。

常见问题

装完 8000 打不开,是装失败了吗?
先看 docker ps 里 coolify 容器是否 Up。是 Up 还打不开,八成是安全组没放行 8000,或本机防火墙拦了。

能不能和宝塔装同一台机器?
不建议。宝塔的 Nginx 占 80/443,跟 Traefik 直接冲突,让出端口的代价比换台机器大。

管理员账号建错了能删吗?
能在后台用户管理里处理,但「第一个注册的人即管理员」这条规则在前,公网实例最好装完立刻建号。

升级会不会丢数据?
自身库在 coolify-db 容器里,升级一般拉新镜像重启。容易出事的是 .env 没备份——回滚时没有 APP_KEY 就解不开原库。

机器上是 Docker 20.x,必须先升?
必须。脚本检测到低于 24 直接退出,不会替你升。

相关阅读

分享到:

本文链接:https://www.biyeyuanma.cn/post/377.html

服务热线

加我微信

加我微信