在公网vps服务器上部署自己的博客#

前言#

反向代理、https证书申请等问题将不在本博客中介绍.

我使用的博客是astro模版的,因此以astro模版为例

环境准备#

在服务器上要准备一个node.js和pnpm的环境. 本机能够通过公钥认证的方式能够连接上vps服务器.

服务器上的准备#

创建git仓库#

在服务器上选一个位置(为了符合FHS规范,最好就放在/var/www/下)下,创建一个git仓库blog.git

1
cd /var/www/blog.git
2
git init --bare
3
git config --bool core.bare true
4
git branch -m main. # 因为我在本地使用的就是main作为默认分支
5
# OPTIONAL: git config --global init.defaultBranch main
6
touch hooks/post-receive
7
chmod +x hooks/post-receive

配置git-hook自动化脚本#

接下来使用自己熟悉的文本编辑器编辑hooks/post-receive文件

1
#!/bin/bash
2

3
# 把pnpm和node所在的路径添加到环境变量中
4
export PATH=/root/.nvm/versions/node/v22.17.1/bin:$PATH
5

6
TARGET="/var/www/html" # ngingx/caddy所指向的网页的根目录,index.html所在的目录
7
GIT_DIR="/var/www/blog.git" # 用来当作git仓库的目录
8
WORK_TREE="/var/www/blog-deploy"
9

10
mkdir -p $WORK_TREE
11

12
git --work-tree=$WORK_TREE --git-dir=$GIT_DIR checkout -f
13

14
cd $WORK_TREE
15
# 保险起见,使用完整路径来使用pnpm
16
/root/.nvm/versions/node/v22.17.1/bin/pnpm install
17
/root/.nvm/versions/node/v22.17.1/bin/pnpm build
18

19
mkdir -p $TARGET
20
# 使用rsync来复制文件,减少不必要的重复覆盖,也能够自动删除不再存在的文件
21
rsync -av --delete $WORK_TREE/dist/ $TARGET/ || exit 1

其中尤其重要的是,hooks中的脚本,它的默认执行环境和当前用户(不管是root还是普通用户)是不一致的,因此如果使用的是nodejs官网上提供的安装方式,把node和pnpm安装到的变量是/root/.nvm中或者其它位置,不是对所有用户都一致可见的路径中,在执行post-receive的时候是没有办法执行的pnpm命令的!

本机上的准备#

添加远程仓库#

把vps上的git仓库作为一个远程仓库添加到本地仓库中

1
git remote add blog [email protected]:/var/www/blog.git

在这里远程仓库使用的名称为blog,这样的话,正常的推送到github的时候就可以继续使用origin

推送到vps服务器上#

1
git push blog main

把本地的main分支推送到远程,可以在输出中看到,当文件上传完以后,post-receive脚本被自动执行.并且对应的脚本执行时候的输出会在本地展示,输出的每行前面会有remote:标识.

没有遇到报错就说明成功了

更新博客的最新版本代码#

该博客是使用的是fuwari blog的框架搭建的博客，目前还在积极维护中。前端时间在push到github上的时候，github actions自动检查失败。推测是本地的代码部分不符合linter或者其它的要求，所以需要更新代码部分，同时保留我自己的posts。

准备#

为了数据安全，在进行之后的操作前，首先把本地的所有要保存的修改commit，并切换到新的分支，做接下来的修改。

1
git add .
2
git commit -m "commit before merging from fuwari upstream"
3
git checkout -b dev

合并上游代码#

首先添加fuwari的上游github仓库的最新代码

1
git remote add fuwari https://github.com/saicaca/fuwari
2
git fetch fuwari

一口气都合并到当前dev分支中

1
git merge fuwari/main --allow-unrelated-historyies -X theirs

接下来就可以看到有新增文件和修改的文件。此时自己逐个选择需要恢复的文件，使用命令

1
git checkout HEAD~1 -- <文件路径1> <文件路径2> ...

就可以把要自己版本的博客内容文件恢复回来。

合并回自己的main分支#

建议首先在本地编译并检查一下当前的效果是否正确，是否把要保留的本地文件都全部选择对了。然后仍然在dev分支中，add并提交这些修改的文件

1
git add <修改了的文件>
2
git commit -m "merge latest code from upstream"

然后切换回main分支并合并dev分支

1
git checkout main
2
git merge dev
3
git push origin main

等待github action自检成功并没有问题，就说明成功了。

可能可以使用的方法（未测试）#

创建/编辑.gitattributes文件

1
# files that always use local version
2
src/content/posts/ merge=ours
3
src/config.ts merge=ours
4

5
# other files use default merge strategy
6
* merge=normal

定义合并驱动

1
git config merge.ours.driver true

合并

1
git merge fuwari/main --allow-unrelated-histories