使用GitHub Actions实现Git推送自动部署到服务器

复制代码
将网站一键部署到服务器的方案很多,比如纯Shell脚本结合SSH、Jenkins等工具。本文将介绍如何利用GitHub Actions这一免费且轻量的CI/CD工具,实现代码推送后自动部署到云服务器。

之前一直在使用github的工作流,确实是一个比较好用的工具。

我之前用来构建公开静态文件仓库,让vercel来管理静态网站,这次我把所有的服务都迁移到了云服务器,所以所有的部署都需要重新调整一下。

还是老样子,先介绍一下我的场景和配置。

前置条件

  • 项目类型: 静态网站(示例使用Hexo)

  • 服务器环境: Linux系统(示例为Ubuntu)

服务器配置

1. 创建专用部署用户
复制代码
# 创建新用户
sudo adduser git --disabled-password
​
# 切换到该用户
sudo su - git
​
# 创建.ssh目录
mkdir -p ~/.ssh && chmod 700 ~/.ssh
2. 生成 SSH 密钥对
复制代码
# 在服务器生成密钥(也可本地生成后传公钥)
sudo ssh-keygen -t ed25519 -C "github-actions-deploy-key" -f ~/.ssh/github_actions
3. 配置授权公钥
复制代码
# 将公钥加入授权列表
sudo sh -c 'cat /home/git/.ssh/github_actions.pub >> /home/git/.ssh/authorized_keys'
​
# 设置权限
sudo chmod 600 ~/.ssh/authorized_keys
sudo chmod 644 ~/.ssh/github_actions.pub
4. 目标目录权限
复制代码
# 假设部署目录为 /var/www/blog
sudo mkdir -p /var/www/blog
sudo chown -R deployer:deployer /var/www/blog
5.获取private key
复制代码
sudo cat ~/.ssh/github_actions

正常情况会返回这样的文本:

复制代码
-----BEGIN OPENSSH PRIVATE KEY-----
-----END OPENSSH PRIVATE KEY-----
6.调整ssh配置
复制代码
/etc/ssh/sshd_config
复制代码
# 启用密钥认证
PubkeyAuthentication yes      
# 禁用密码登录
PasswordAuthentication no      
# 允许部署用户
AllowUsers deployer            
复制代码
sudo systemctl restart ssh
如果遇到权限问题
复制代码
# 切换到root再执行
chmod 700 ~git/.ssh
chmod 600 ~git/.ssh/authorized_keys
chown -R git:git ~git/.ssh
​
# 最后的路径调整成静态文件路径
sudo chown -R git:git /www/wwwroot
​
sudo setfacl -R -m u:git:rwx /www/wwwroot
sudo setfacl -Rd -m u:git:rwx /www/wwwroot

Github仓库配置

1. 添加仓库密钥

  1. 访问仓库 Settings > Secrets > Actions

  2. 点击 New repository secret

  3. 输入名称 SERVER_SSH_KEY,值粘贴前文获取的私钥内容

2. 配置工作流文件

创建 .github/workflows/deploy.yml 内容如下:

复制代码
name: Deploy Blog  # 工作流名称,显示在Actions面板

on: [push]  # 触发条件:任何git push操作

jobs:
  build:   # 任务ID,可自定义
    runs-on: ubuntu-latest  # 使用GitHub托管的Ubuntu运行器

    steps:
      - name: Checkout code  # 步骤1:拉取仓库代码
        uses: actions/checkout@v4  # 官方检出插件

      - name: Install and Build  # 步骤2:安装依赖并构建
        run: |                   # 多行命令执行器
          npm install
          npm run build

      - name: Deploy to Server  # 步骤3:部署到服务器
        uses: easingthemes/ssh-deploy@main  # 第三方SSH部署插件
        env:
          SSH_PRIVATE_KEY: ${{ secrets.SERVER_SSH_KEY }}  # 从仓库密钥读取私钥
          REMOTE_HOST: ""  # 服务器公网IP或域名
          REMOTE_USER: "git"  # 步骤1创建的用户
          SOURCE: "public/"  # 本地构建输出目录
          TARGET: "/www/wwwroot/guoshunfa.com"  # 服务器目标目录
          ARGS: "-avz --chown=git:git"  # rsync参数:归档模式/压缩/删除多余文件

到这所有的配置就结束了。

验证效果

  1. 本地修改后执行Git推送:

    复制代码
    git add .
    git commit -m "触发自动部署"
    git push origin main
  2. 登录GitHub仓库,进入 Actions 标签页查看执行状态

  3. 成功完成后,访问服务器目标目录确认文件更新

相关推荐
云资源服务商17 分钟前
解锁阿里云日志服务SLS:云时代的日志管理利器
服务器·阿里云·云计算
朱包林1 小时前
day45-nginx复杂跳转与https
linux·运维·服务器·网络·云计算
孞㐑¥3 小时前
Linux之Socket 编程 UDP
linux·服务器·c++·经验分享·笔记·网络协议·udp
DeepSeek-大模型系统教程3 小时前
推荐 7 个本周 yyds 的 GitHub 项目。
人工智能·ai·语言模型·大模型·github·ai大模型·大模型学习
GISer_Jing3 小时前
Git协作开发:feature分支、拉取最新并合并
大数据·git·elasticsearch
柳鲲鹏4 小时前
WINDOWS最快布署WEB服务器:apache2
服务器·前端·windows
ai小鬼头5 小时前
AIStarter最新版怎么卸载AI项目?一键删除操作指南(附路径设置技巧)
前端·后端·github
bcbobo21cn7 小时前
初步了解Linux etc/profile文件
linux·运维·服务器·shell·profile
wayuncn7 小时前
月付物理服务器租用平台-青蛙云
运维·服务器·服务器租用·服务器托管·物理机租用
望获linux7 小时前
【实时Linux实战系列】CPU 隔离与屏蔽技术
java·linux·运维·服务器·操作系统·开源软件·嵌入式软件