coollabsio/coolify Docker 镜像

Coolify 中文技术文档

镜像概述和主要用途

Coolify 是一款开源、自托管的平台即服务（PaaS）解决方案，定位为 Heroku、Netlify 等商业平台的替代方案。它允许用户通过简单配置实现应用的自动部署、数据库及开源服务的一键搭建，适用于个人开发者或团队构建自托管的应用部署平台。

核心功能和特性

Git 源代码集成

支持多种 Git 源代码托管平台，实现代码提交后自动部署至 Coolify 实例（同时支持自托管版本）：

• GitHub
• GitLab
• Bitbucket（开发中）

部署目标

应用可部署至以下目标环境：

• 本地 Docker 引擎
• 远程 Docker 引擎（开发中）
• Kubernetes（开发中）

应用构建支持

提供预设构建模板，通过 Docker 构建模板可支持任何具备 Dockerfile 的应用：

• 静态网站
• NodeJS
• VueJS
• NuxtJS
• NextJS
• React/Preact
• Gatsby
• Svelte
• PHP
• Rust
• Docker（自定义 Dockerfile）

数据库一键部署

支持内部使用或互联网共享的一键式数据库部署：

• MongoDB
• MySQL
• PostgreSQL
• CouchDB
• Redis

开源服务一键部署

可快速部署主流开源服务：

• https://wordpress.org（博客/内容管理系统）
• https://ghost.org（轻量级博客平台）
• Plausible Analytics（隐私友好的网站统计工具）
• NocoDB（开源 Airtable 替代方案）
• https://github.com/cdr/code-server（浏览器中的 VS Code）
• https://min.io（兼容 S3 的对象存储）
• https://github.com/dani-garcia/vaultwarden（Bitwarden 兼容的密码管理器）
• https://languagetool.org（语法和拼写检查工具）
• https://n8n.io（工作流自动化工具）
• https://github.com/louislam/uptime-kuma（服务监控工具）

使用场景和适用范围

目标用户

• 个人开发者：需要自托管、低成本的应用部署平台
• 小型开发团队：构建内部统一的应用发布和管理系统
• 开源爱好者：快速部署和测试各类开源服务

典型场景

• 替代 Heroku/Netlify 用于前端、后端应用的自动部署
• 本地开发环境与生产环境的快速同步
• 一键搭建开发或测试用数据库（如 MongoDB、PostgreSQL）
• 自托管开源服务（如 WordPress、n8n、Uptime Kuma）

使用方法和配置说明

安装步骤

标准安装

通过官方自动化脚本安装，支持交互式配置：

bash
/bin/bash -c "$(curl -fsSL https://get.coollabs.io/coolify/install.sh)"

静默安装

如需跳过交互步骤，使用静默安装模式（具体参数需参考官方文档，以下为示例）：

bash
/bin/bash -c "$(curl -fsSL https://get.coollabs.io/coolify/install.sh)" -- --silent

Docker 部署示例

单容器部署（docker run）

bash
docker run -d \
  --name coolify \
  -p 80:3000 \  # 映射端口（根据实际情况调整）
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载 Docker 套接字（用于本地部署）
  -v /coolify/data:/app/data \  # 持久化数据存储
  -e ADMIN_EMAIL="admin@example.com" \  # 管理员邮箱（示例）
  coollabs/coolify:latest

Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  coolify:
    image: docker.xuanyuan.run/coollabs/coolify:latest
    container_name: coolify
    restart: always
    ports:
      - "80:3000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./coolify-data:/app/data
    environment:
      - ADMIN_EMAIL=admin@example.com
      - PORT=3000
      - DATA_PATH=/app/data

启动服务：

bash
docker-compose up -d

配置说明

目前主要通过安装脚本或环境变量进行配置，常用配置项包括：

• ADMIN_EMAIL：管理员***（用于初始登录）
• PORT：服务监听端口（默认 3000）
• DATA_PATH：数据持久化路径（默认 /app/data）
• DOCKER_HOST：远程 Docker 引擎地址（用于远程部署）

详细配置参数请参考 官方文档

迁移说明

从 v1 版本迁移至 v2 版本时，需执行全新安装，v2 与 v1 不兼容，无法直接升级。

支持与贡献

获取支持

• ***：@andrasbacsai
• ***：@andrasbacsai
• ：
• ***：邀请链接

贡献指南

详见项目仓库 贡献指南（需访问源码仓库查看）。

许可证

本项目采用 GNU Affero General Public License v3.0 许可证，详见 LICENSE 文件。