使用 Vercel 免费部署 hexo 静态博客
安装 Hexo#
- 参考官方文档 文档 | Hexo
- 理论上只要做好 “概述” 和 “建站” 两个步骤就可以了
- 安装主题:见后文
建立 GitHub 远程仓库#
- 在 GitHub 中新建一个 repo,名字随意,其他的设置不用改,可以设为私有
- 在账户设置里生成一个 Personal access token,妥善保管。
建立本地 git 仓库,并推送到 GitHub#
- 进入 hexo 根目录
# 新建git仓库
git init
git add .
git commit -m "first commit"
git branch -M main
# 连接到github,例子:https://github.com/<用户名>/<仓库名>.git
git remote add origin <你的远程仓库地址>
# 设置储存账号密码,去掉 --global 参数可以只对当前参数保存
git config --global credential.helper store
git push -u origin main
# 会要求输入账号密码,注意密码是之前生成的Personal access token,而不是 github 账户的密码
使用 vercel 部署#
- 用 GitHub 账户登陆 vercel.com
- 选择从 GitHub 新增项目,选择刚建立的 repo
- 会自动识别为 hexo 项目,设置什么都不用改,直接确定就好
- 然后就可以用 vercel 提供的域名访问了,也可以使用自己的域名
- 本地的项目有更改的话,
git add .
,git commit
,git push
后 vercel 会自动更新
注意事项#
关于主题#
- 直接
git clone
和git submodule add
各有优劣,可以了解后自行选择
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
# 或者
git submodule add https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
关于文件名#
- 如果是从其他地方粘贴过来的 md 文件,记得把文件名里的特殊字符去掉,不然虽然本地能跑起来,在 vercel 上会 404
- 如果是
hexo new
的文件,会发现即使有特殊字符,也会在文件名里被自动去掉(Front-matter 中不受影响),所以可以大胆使用特殊字符