GitHub 项目部署方法与流程详解

GitHub项目部署有五种常用方式：一、GitHub Pages托管静态网站；二、Vercel部署前端框架项目；三、Heroku部署Node.js或Python后端；四、GitHub Actions自动部署到云服务器；五、Docker+GHCR构建镜像并运行。

如果您拥有一个 GitHub 项目并希望对外提供可访问的服务，需将代码从仓库转移到运行环境并启动服务。以下是实现该项目部署的常用流程与方式：

一、使用 GitHub Pages 部署静态网站

GitHub Pages 专为托管静态内容（HTML、CSS、JavaScript）设计，无需服务器配置，直接通过 GitHub 仓库启用即可发布。

1、进入 GitHub 仓库主页，点击 Settings 选项卡。

2、在左侧菜单中选择 Pages。

3、在 Branch 区域选择部署源分支（如 main 或 gh-pages）及根目录（/）或 /docs 文件夹。

4、点击 Save，页面顶部将显示已发布的 URL，格式为 https://<用户名>.github.io/<仓库名>。

二、通过 Vercel 部署前端项目

Vercel 支持自动拉取 GitHub 仓库、构建并部署现代前端框架（如 React、Vue、Next.js），且提供免费域名和 HTTPS。

1、访问 vercel.com 并使用 GitHub 账号登录。

2、点击 Add New Project，选择目标 GitHub 仓库。

3、确认框架预设（如未识别，手动设置 Build Command 为 npm run build，Output Directory 为 dist 或 build）。

4、点击 Deploy，完成后获取分配的 vercel.app 域名。

三、使用 Heroku 部署 Node.js 或 Python 应用

Heroku 提供容器化运行时环境，支持通过 Git 推送自动部署，适用于轻量级后端服务。

1、在项目根目录创建 Procfile 文件，内容为 web: node app.js 或 web: python app.py。

2、安装 Heroku CLI，执行 heroku login 并登录账号。

3、运行 heroku create 创建新应用，获得远程 Git 地址。

4、执行 git push heroku main 将代码推送到 Heroku 远程仓库。

5、运行 heroku open 打开已部署的应用，URL 形如 https://.herokuapp.com。

四、借助 GitHub Actions 自动部署到云服务器

通过 GitHub Actions 工作流，在代码推送后自动 SSH 登录目标服务器，拉取最新代码并重启服务。

1、在项目根目录新建 .github/workflows/deploy.yml 文件。

2、在文件中配置 on.push 触发器，并使用 actions/checkout@v4 拉取代码。

3、使用 webfactory/ssh-action@v0.7.0 执行远程命令，包括 git pull、npm install、pm2 restart app。

4、将服务器私钥以 GitHub Secrets 形式存为 DEPLOY_KEY，确保密钥不暴露在工作流中。

5、提交并推送该文件，后续向 main 分支推送即触发部署流程，目标服务器上服务将自动更新。

五、使用 Docker + GitHub Container Registry 托管镜像

将应用构建成 Docker 镜像并推送至 GitHub Container Registry（GHCR），再在任意支持 Docker 的主机上拉取运行。

1、在项目根目录编写 Dockerfile，定义基础镜像、依赖安装、代码复制与启动命令。

2、在 .github/workflows/publish.yml 中配置构建步骤：使用 docker/build-push-action@v5 构建并推送镜像至 ghcr.io/<用户名>/<仓库名>。

3、在推送成功后，登录目标服务器，执行 docker pull ghcr.io/<用户名>/<仓库名>:latest。

4、运行 docker run -d -p 3000:3000 --name myapp ghcr.io/<用户名>/<仓库名>:latest 启动容器。