如何快速开始使用DevPush：从GitHub仓库到生产部署的完整指南

DevPush是一个开源的、自托管的平台即服务（PaaS）解决方案，类似于Vercel，但支持所有编程语言。无论你是个人开发者还是团队，DevPush都能帮助你快速将GitHub仓库部署到生产环境，实现零停机更新和实时监控。

🚀 DevPush核心功能概览

Git推送即部署 - 只需向GitHub仓库推送代码，DevPush就会自动构建和部署你的应用。

多语言支持 - 支持Python、Node.js、PHP、Go等任何可以在Docker中运行的语言。

环境管理 - 支持多环境配置，包含分支映射和加密的环境变量。

实时监控 - 提供可搜索的构建和运行时日志，让你随时了解部署状态。

团队协作 - 基于角色的访问控制，支持团队邀请和权限管理。

📋 准备工作清单

在开始使用DevPush之前，请确保准备好以下资源：

• 服务器：Ubuntu 20.04+ 或 Debian 11+，具有SSH访问权限和sudo权限

• DNS服务：推荐使用Cloudflare进行域名管理

• GitHub账户：用于创建GitHub应用进行登录和仓库访问

• 邮件服务：需要一个Resend账户用于登录邮件和团队邀请

🛠️ 快速安装步骤

1. 服务器安装

在全新的服务器上执行一键安装命令：

curl -fsSL https://install.devpu.sh | sudo bash

2. 创建GitHub应用

访问官方文档指南，按照步骤创建GitHub应用。这是连接你的GitHub仓库和DevPush平台的关键步骤。

3. 配置环境变量

编辑配置文件 /var/lib/devpush/.env，填入你的GitHub应用凭据和域名配置。

4. 配置DNS记录

设置以下DNS记录：

• A 记录：example.com → 服务器IP（应用主机名）
• A 记录：*.example.com → 服务器IP（部署子域名）

5. 启动服务

执行启动命令：

sudo systemctl start devpush.service

🏗️ 项目架构解析

DevPush采用现代化的微服务架构，主要组件包括：

FastAPI应用 - 处理用户界面逻辑，包括团队管理、项目管理和认证

工作器服务 - 处理部署任务和清理作业

Traefik反向代理 - 负责路由管理和TLS证书

PostgreSQL数据库 - 存储用户、团队、项目和部署数据

Redis缓存 - 用于作业队列和实时更新的Redis Streams

📁 关键目录结构

• app/ - 主要的FastAPI应用程序
• app/workers/ - 后台工作器服务
• docker/ - 容器定义和入口点脚本
• scripts/ - 本地和生成环境的辅助脚本
• compose/ - Docker Compose容器编排配置

🔄 部署流程详解

1. 触发部署

有两种方式触发部署：

• 自动触发：通过GitHub webhook，当向仓库推送代码时自动创建部署
• 手动触发：用户在界面中选择特定提交和环境进行部署

2. 构建阶段

DevPush会创建运行器容器，执行以下步骤：

• 克隆指定提交的代码仓库
• 运行可选的构建和预部署命令
• 启动应用服务

3. 监控阶段

系统每2秒探测一次容器状态，确保服务正常运行

4. 完成阶段

部署成功后，系统会：

• 更新部署状态为完成
• 创建或更新别名配置
• 生成Traefik动态配置
• 触发清理任务

🛡️ 安全特性

DevPush内置了多重安全保护机制：

• 会话安全：带有CSRF保护的签名Cookie
• 密钥加密：使用Fernet加密算法保护环境变量和令牌
• 容器安全：运行器容器以非root用户运行，并设置资源限制

📊 监控和日志

系统提供完整的监控能力：

• 日志收集：运行器容器日志通过Alloy收集并发送到Loki
• 状态更新：Redis Streams为项目和部署更新提供SSE支持

💡 使用建议

新手入门技巧

1. 从小项目开始 - 先使用简单的静态网站或API项目熟悉DevPush的工作流程

2. 充分利用环境变量 - 将敏感信息存储在加密的环境变量中

3. 定期备份 - 使用 scripts/backup.sh 创建数据备份

4. 监控资源使用 - 通过实时日志了解应用运行状况

🎯 总结

DevPush为开发者提供了一个强大而灵活的平台，让你能够专注于代码开发，而不必担心基础设施的复杂性。通过简单的Git推送，你的应用就能快速上线，享受零停机更新、实时监控和团队协作等企业级功能。

无论你是个人开发者还是团队负责人，DevPush都能显著提升你的部署效率和开发体验。现在就按照本指南开始使用DevPush，体验开源PaaS平台的强大功能！