GitHub Actions 自动化部署配置说明

📋 概述

本项目已配置 GitHub Actions 工作流，支持在推送代码到 soul-content 分支时自动部署到宝塔服务器。

✅ 项目兼容性

当前项目完全支持 GitHub Actions 部署方式，因为：

✅ 使用 standalone 模式，构建产物独立完整
✅ 使用 pnpm 包管理器
✅ 已配置 PM2 启动方式（node server.js）
✅ 端口配置为 30006

🔧 配置步骤

1. 在服务器上生成 SSH 密钥对

ssh root@43.139.27.93
ssh-keygen -t rsa -b 4096 -C "github-actions-deploy"
cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
cat ~/.ssh/id_rsa  # 复制私钥内容

2. 在 GitHub 仓库添加 Secrets

进入 GitHub 仓库：Settings → Secrets and variables → Actions → New repository secret

添加以下三个 Secrets：

Secret 名称	值	说明
`SSH_HOST`	`43.139.27.93`	服务器 IP
`SSH_USERNAME`	`root`	SSH 用户名
`SSH_PRIVATE_KEY`	`-----BEGIN OPENSSH PRIVATE KEY-----...`	服务器 SSH 私钥（完整内容）

3. 修改工作流分支（如需要）

编辑 .github/workflows/deploy.yml，修改触发分支：

on:
  push:
    branches:
      - soul-content  # 改为你的分支名

4. 提交并推送

git add .github/workflows/deploy.yml
git commit -m "添加 GitHub Actions 自动化部署"
git push origin soul-content

🚀 工作流程

构建阶段：
- 安装 Node.js 22
- 安装 pnpm
- 安装项目依赖
- 执行 pnpm build（生成 standalone 输出）
打包阶段：
- 复制 .next/standalone 内容
- 复制 .next/static 静态资源
- 复制 public 目录
- 复制 ecosystem.config.cjs PM2 配置
- 打包为 deploy.tar.gz
部署阶段：
- 通过 SCP 上传到服务器 /tmp/
- SSH 连接到服务器
- 备份当前版本（可选）
- 解压到 /www/wwwroot/soul
- 重启 PM2 应用 soul

📊 与当前部署方式对比

特性	GitHub Actions	deploy_soul.py
触发方式	自动（Push 代码）	手动执行脚本
构建环境	GitHub Ubuntu	本地环境
构建速度	较慢（每次安装依赖）	较快（本地缓存）
适用场景	团队协作、CI/CD	本地开发、快速部署
Windows 兼容	✅ 完美（云端构建）	⚠️ 需处理符号链接

⚠️ 注意事项

首次部署：确保服务器上 /www/wwwroot/soul 目录存在且 PM2 已配置项目
环境变量：如果项目需要环境变量，需要在服务器上配置（宝塔面板或 .env 文件）
数据库连接：确保服务器能访问数据库
构建时间：首次构建可能需要 5-10 分钟，后续会更快（GitHub Actions 缓存）

🔍 查看部署日志

在 GitHub 仓库点击 Actions 标签
选择最新的工作流运行
查看各步骤的详细日志

🆚 两种部署方式选择

使用 GitHub Actions：适合团队协作，代码推送即自动部署
使用 deploy_soul.py：适合本地快速测试，需要手动控制部署时机

两种方式可以并存，根据场景选择使用。

3.4 KiB Raw Permalink Blame History Unescape Escape