# Coolify 自托管 PaaS 部署 ## 快速入门 ### 在虚拟机上安装 Coolify ssh -i <密钥文件> <用户>@<实例 IP> 卷曲-fsSL https://cdn.coollabs.io/coolify/install.sh |须藤巴什 # 访问：http://<实例 IP>:8000 ### 部署应用程序 1. 通过“http://:8000”访问 Coolify UI 2. 创建管理员帐户（第一个访问者获得管理员帐户） 3.添加GitHub源→创建项目→从repo部署 4. 通过“http://..sslip.io”访问应用程序 ## 服务器要求资源 |最低 |推荐 ---|---|--- 中央处理器 | 2 个虚拟CPU | 4 个虚拟CPU 内存 | 2GB | 4GB 存储| 30GB | 50GB 操作系统 | Ubuntu 20.04/22.04/24.04 LTS | Ubuntu 24.04 LTS **所需端口：** * TCP 22 (SSH) * TCP 80（HTTP/让我们加密） * TCP 443 (HTTPS) * TCP 8000（Coolify UI） ## 云虚拟机部署 ### 1\.提供基础设施 # 创建包含所需端口的安全组 # - TCP 22 (SSH) # - TCP 80 (HTTP) # - TCP 443 (HTTPS) # - TCP 8000（Coolify UI） # 启动实例： # - 2+ vCPU、2GB+ RAM # - 30GB+ 根卷 # - Ubuntu LTS # - 公共IP # - SSH 密钥对 ### 2\.安装 Coolify # 设置关键权限 chmod 400 /path/to/key.pem # 连接并安装 ssh -o StrictHostKeyChecking=no -i /path/to/key.pem <用户>@<实例 IP> 卷曲-fsSL https://cdn.coollabs.io/coolify/install.sh |须藤巴什 ### 3\.初始设置 1. 打开浏览器：`http://:8000` 2. **重要**：立即创建管理员帐户 3. 完成设置向导 ### 4\.验证安装 ssh -i /path/to/key.pem <用户>@<实例 IP> \ “sudo docker ps --format 'table {{.Names}}\t{{.Status}}' | grep Coolify” ## 应用程序部署 ### 支持的构建方法方法|使用案例 ---|--- Dockerfile |自定义容器构建尼克斯包 |自动检测的语言构建 Docker 组合 |多容器应用程序静态| HTML/JS/CSS 网站 ### 从 GitHub 部署 1. **添加源**：源→添加新→GitHub应用程序 2. **创建项目**：项目→添加新项目 3. **添加资源**：添加新资源→公共/私有存储库 4. **配置**： * 存储库网址 * 分行 * 构建包（Dockerfile/Nixpacks） * 暴露的端口 5. **部署**：单击部署按钮 ### 示例 Dockerfile 应用程序应用程序/ ├── main.py # 应用代码 ├──requirements.txt # 依赖关系 └── Dockerfile # 容器定义 **Docker 文件：** 来自 python:3.12-slim 工作目录/应用程序复制requirements.txt。运行 pip install --no-cache-dir -rrequirements.txt 复制。。曝光8080 CMD [“python”，“-m”，“uvicorn”，“main：app”，“--host”，“0.0.0.0”，“--port”，“8080”] ### 域配置 **自动生成（sslip.io）：** * 格式：`..sslip.io` * 立即生效，无需 DNS **自定义域：** 1.添加DNS A记录→EC2公网IP 2.更新Coolify资源设置中的域 3.启用SSL（Let's Encrypt自动配置） ## 验证 ### 检查容器状态 ssh -i /path/to/key.pem <用户>@<实例 IP> \ “sudo docker ps --format '表{{.Names}}\t{{.Ports}}\t{{.Status}}'” ### 测试应用 # 从 Coolify UI 获取应用程序 URL APP_URL="http://..sslip.io" 卷曲 -s $APP_URL/ 卷曲 -s $APP_URL/health ### 检查日志 # 应用程序日志 ssh -i /path/to/key.pem <用户>@<实例 IP> \ “sudo docker log <容器名称> --tail 50” # 冷却日志 ssh -i /path/to/key.pem <用户>@<实例 IP> \ “须藤泊坞窗日志coolify --tail 50” ## 配置参考 ### 冷却容器集装箱|目的|港口 ---|---|--- 冷却 |主要应用| 8000 Coolify 代理 | Traefik 反向代理 | 80, 443 酷化数据库 | PostgreSQL 数据库 | 5432 酷化Redis | Redis缓存| 6379 Coolify-实时 | WebSocket 服务器 | 6001-6002 ### 重要路径路径|目的 ---|--- `/data/coolify/source/.env` |酷化配置 `/data/coolify/proxy/dynamic/` | Traefik 动态配置 `/data/coolify/applications/` |应用数据 `/data/coolify/databases/` |数据库卷 ### 环境变量（安装）变量|目的|示例 ---|---|--- `ROOT_USERNAME` |管理员用户名 | `管理员` `ROOT_USER_EMAIL` |管理员邮箱| `admin@example.com` `ROOT_USER_PASSWORD` |管理员密码 | `SecurePass123` `自动更新` |自动更新切换 | `真`/`假` ## 生产清单 * 安装后立即创建管理员帐户 * 备份 `/data/coolify/source/.env` 到安全位置 * 配置防火墙/安全组规则 * 使用 SSL 设置自定义域 * 限制 SSH 访问特定 IP * 配置监控/警报 * 测试部署回滚过程 * 安全地记录访问凭证 ## 故障排除问题 |解决方案 ---|--- 公共 IP 上的 404 |通过 sslip.io 域访问，而不是原始 IP 无法访问 Coolify UI |检查安全组允许8000端口部署失败 |检查 Coolify 日志和 Dockerfile 语法 SSL 证书失败 |确保端口 80 打开，DNS 已配置容器未启动 |检查容器日志是否有错误磁盘空间不足 |修剪 Docker：`docker 系统修剪 -a` Coolify 反应迟钝 |重启：`docker restart Coolify` ## 更新 Coolify ssh -i /path/to/key.pem <用户>@<实例 IP> \ “cd /data/coolify/source && sudo bash update.sh” ## 清理 # 停止所有容器 ssh -i /path/to/key.pem <用户>@<实例 IP> \ “cd /data/coolify/source && sudo docker compose down” # 删除 Coolify 数据（破坏性） ssh -i /path/to/key.pem <用户>@<实例 IP> \ “sudo rm -rf /数据/coolify” # 终止云实例 ## 参考文献 * [Coolify 文档]() * [Coolify 安装指南]() * [Coolify GitHub]() * [Traefik 文档]() * [sslip.io]()

酷化部署

包含技能