将 GitHub 仓库同步到个人服务器

将 GitHub 仓库同步到个人服务器

引用

CSDN

1.

https://blog.csdn.net/u010066597/article/details/141573167

本文将详细介绍如何将GitHub仓库同步到个人服务器。通过使用rsync和GitHub Actions，可以实现快速高效的部署方案。

场景

把本地项目推送到GitHub仓库后，如果想部署到服务器上，可以尝试此方案：

• 我的博客是Hugo搭建的，每次更新文章会手动推送到GitHub仓库，
• 然后利用Actions脚本自动推送到CF或者Vercel
• 之前我写过一篇将Hugo博客搬迁到服务器的步骤有些繁琐，
• 本次方案快速高效（推荐）

方案

使用rsync，配置Actions脚本

小站demo: https://blog.taoshuge.eu.org/

安装 rsync

登录远程服务器，键入以下命令来完成 rsync 的安装：

sudo apt install rsync

安装成功会显示git的版本号：

rsync --version

显示：

rsync version 3.2.3 protocol version 31

新建 rsync 用户

出于安全的原因考虑，我们一般不会使用root来运行同步功能，因此，需要创建一个 rsync 用户来执行同步。

登录远程服务器，键入以下命令：

sudo adduser rsyncer

创建用户的途中会要求输入用户密码，这个密码请务必记住，切换到这个用户时需要，其它配置使用默认值直接回车就行。

本地生成 SSH key

在你的电脑上生成一个 Key 对，其中一个扩展名是.pub，是公钥。假设分别命名为：

id_rsa
和
id_rsa.pub

ssh-keygen -q -t rsa -b 4096 -C "阿弥托福" -N "" -f ~/.ssh/id_rsa

查看并复制公钥内容

cat ~/.ssh/id_rsa.pub

把 SSH 公钥添加到远程服务器

登录你的服务器，逐个输入以下代码

su rsyncer  # 要输入密码
cd ~
mkdir -p www .ssh
chmod 700 .ssh
touch .ssh/authorized_keys
chmod 600 .ssh/authorized_keys
vim .ssh/authorized_keys  # 用文本编辑器打开 `id_rsa.pub`，复制所有内容到这个文件里

注意：.ssh的权限必须是700，authorized_keys的权限必须是600

修改 SSH 默认配置

以下内容一般不用修改，如果同步有问题再来修改。

vim /etc/ssh/sshd_config

移除前面的注释，若没有则在最后添加

RSAAuthentication yes
PubkeyAuthentication yes
AuthorizedKeysFile  .ssh/authorized_keys

修改保存后重启sshd服务

systemctl restart sshd.service

设置Git仓库（重点）

打开仓库设置，按下图把相关设置加入 secrets，
地址：https://github.com/用户名/仓库名/settings/secrets/actions

解读：

HONGKONG_PRIVATE_KEY  ：你电脑上的id_rsa私钥内容
HONGKONG_SERVER_IP : 你的服务器IP地址
HONGKONG_USERNAME  ：rsyncer  #用户名就是前面新建的rsyncer用户
HONGKONG_WWW_PATH  ：www   #就是服务器同步的目录为www

修改自动化 Actions 脚本

• rsync命令实现增量同步, --delete参数表示会删除远程文件夹中本地不存在的文件
• -a是复合参数, 可复制本地文件的全部属性至远程, -v会显示具体同步的文件信息
• exclude中的文件夹路径是相对于本地同步文件夹而言, 即
  "public/.git"
• 注意：
  -p 5522
  是服务器的ssh端口，如果不是22，记得修改
  把以下内容加入脚本，脚本目录：
  .github\workflows\main.yml

- name: webfactory/ssh-agent
  uses: webfactory/ssh-agent@v0.7.0
  with:
    ssh-private-key: ${{ secrets.HONGKONG_PRIVATE_KEY }}
- name: Publish blog to remote vps
  run: |
    rsync -av -e "ssh -o StrictHostKeyChecking=no -p 5522" --delete --exclude={'.git/','.github/','.user.ini'} public/ ${{ secrets.HONGKONG_USERNAME }}@${{ secrets.HONGKONG_SERVER_IP }}:${{ secrets.HONGKONG_WWW_PATH }}

完整hugo脚本：

name: Auto Deploy hugo
on:
  push:
    branches:
- main # 更新触发的分支
jobs:
  build-deploy:
    runs-on: ubuntu-20.04
    env:
      FORCE_JAVASCRIPT_ACTIONS_TO_NODE20: true # ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION: true
    steps:
- name: Check out repository code
        uses: actions/checkout@v4
        with:
           submodules: recursive # Fetch Hugo themes (true OR recursive)
           fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
- name: Setup hugo
        uses: peaceiris/actions-hugo@v3.0.0
        with:
          hugo-version: "0.127.0"
          extended: true # 设置是否需要 extended 版本
- name: Cache resources # 缓存 resource 文件加快生成速度
        uses: actions/cache@v3
        with:
         path: resources
         key: ${{ runner.os }}-hugocache-${{ hashFiles('content/**/*') }}
         restore-keys: ${{ runner.os }}-hugocache-
- name: Build Hugo static files # 部署静态资源
        run: hugo --gc --minify
- name: Deploy to Github Pages  # 部署到Github Pages页面
        uses: peaceiris/actions-gh-pages@v3
        with:
          personal_token: ${{ secrets.PERSONAL_TOKEN }} # 两个仓库请使用 deploy_key
          external_repository: woniu336/woniu336.github.io  # 如果在同一个仓库请注释
          publish_dir: ./public # hugo 生成到 public 作为跟目录
          publish_branch: main # Github Pages 所在分支
          commit_message: ${{ github.event.head_commit.message }}
- name: webfactory/ssh-agent
        uses: webfactory/ssh-agent@v0.7.0
        with:
          ssh-private-key: ${{ secrets.HONGKONG_PRIVATE_KEY }}
- name: Publish blog to remote vps
        run: |
          rsync -av -e "ssh -o StrictHostKeyChecking=no -p 5522" --delete --exclude={'.git/','.github/','.user.ini'} public/ ${{ secrets.HONGKONG_USERNAME }}@${{ secrets.HONGKONG_SERVER_IP }}:${{ secrets.HONGKONG_WWW_PATH }}

完结~