搭建Hexo博客
环境
> node -v
v16.15.0
> npm -v
8.5.5
安装Hexo CLI
# 在你的博客文件夹根目录下下执行
npm install -g hexo-cli
hexo init blogname
cd blogname
hexo s
# 打开http://localhost:4000 即可浏览
安装主题hexo-theme-bamboo
hexo-theme-bamboo
我们不使用npm安装，直接将主题download到themes文件夹下
github安装
git clone https://github.com/yuang01/hexo-theme-bamboo.git
gitee安装
git clone https://gitee.com/yuang01/hexo-theme-bamboo.git
修改hexo根目录下的站点配置文件_config.yml，把主题改为hexo-theme-bamboo，通过主题文件夹下的config.yml配置主题即可，然后在\themes\hexo-theme-bamboo\删除.git文件夹
然后根据https://yuang01.github.io/或者作者博客地址来配置对应的样式或者widget
修改博客名称等信息
在_config.yml和\themes\hexo-theme-bamboo\_config.yml中将自己博客名称、网址信息等进行替换
添加github action发布
1. 在github中创建自己的博客仓库
然后在Settings/Secrets/Actions中New repository secret , 其中docker信息是在阿里云容器仓库中创建了一个个人实例(创建之后需要去/个人实例/访问凭证设置固定密码)，当然，你也可以使用其他的docker仓库，不过第2步的Login to Aliyun Container Registry (ACR)需要进行修改
2. 设置Secrets
| Name | Value | 说明 | 举例 |
|---|---|---|---|
| DOCKER_USERNAME | your docker username | docker仓库登陆用户名 | spatxos |
| DOCKER_PASSWORD | your docker pwd | docker仓库固定密码 | spatxospwd |
| HOST | your server ip | 服务器IP | 101.10.11.121 |
| HOST_USERNAME | your server username | 服务器ssh登陆账户名 | spatxosdocker |
| HOST_PASSWORD | your server pwd | 服务器ssh登陆密码 | spatxosdockerpwd |
| HOST_PORT | your server ssh port | 服务器ssh端口 | 22 |
| DOCKER_REGISTRY | docker registry | docker仓库地址 | registry.cn-hongkong.aliyuncs.com |
| DOCKER_REGISTRY_REGION | docker registry region id | docker仓库区域id | cn-hongkong |
| CNBLOGS_ISDOWN | Whether to pull blogs from cnblogs | 本次执行是否从cnblogs拉取博客 | true或false |
| CNBLOGS_COOKIE | cnblogs of cookie | cnblogs的cookie | __gads=ID=bbfxxxxxxxxxx |
| BLOG_NAME | blog of name | 博客的名称，发布到docker或者服务器上创建的文件夹都将使用这个 | spatxos |
3. 在/.github/workflows/下添加一个yml文件，可以进行自定义
我写好了一个yml，是将hexo发布到阿里云的docker仓库，然后进行服务器部署，后期将会添加发布到github pages的yml
name: Build Docker Image
on:
push:
tags:
- "v*.*.*" # 后面每次更新提交，只有打上tag之后才会进行发布更新，减少actions执行次数
workflow_dispatch:
jobs:
build:
env:
CNBLOGS_ISDOWN: ${{secrets.CNBLOGS_ISDOWN}}
CNBLOGS_COOKIE: ${{secrets.CNBLOGS_COOKIE}}
runs-on: ubuntu-latest
steps:
- name: Checkout source
uses: actions/checkout@v2
with:
ref: master
- name: Setup Node.js
uses: actions/setup-node@v1
with:
node-version: '16.15.0'
- name: Set up Go 1.18.3
if: ${{ env.CNBLOGS_ISDOWN == 'true' }} # 是否从博客园下载，可通过更改CNBLOGS_ISDOWN的值进行提交时的下载控制
uses: actions/setup-go@v1
with:
go-version: 1.18.3
id: go
- name: Pull blogs from cnblogs
if: ${{ env.CNBLOGS_ISDOWN == 'true' }} # 是否从博客园下载，可通过更改CNBLOGS_ISDOWN的值进行提交时的下载控制
run: |
cd source/_posts/
echo $env.CNBLOGS_COOKIE |wc -L
echo ${{env.CNBLOGS_COOKIE}} |wc -L
go run downmyblogs.go -cookie ${{env.CNBLOGS_COOKIE}}
ls -la
- name: Setup Hexo
run: |
npm install hexo-cli -g
npm install hexo-generator-search --save
npm install hexo-generator-feed --save
npm i hexo-wordcount
npm install
# get image tag name
- name: Get Image Tag Name
run: |
if [ x${{ github.event.inputs.tag }} == x"" ]; then
echo "TAG_NAME=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
else
echo "TAG_NAME=${{ github.event.inputs.tag }}" >> $GITHUB_ENV
fi
- name: Login to Aliyun Container Registry (ACR)
uses: aliyun/acr-login@v1
with:
login-server: "${{ secrets.DOCKER_REGISTRY }}"
region-id: "${{ secrets.DOCKER_REGISTRY_REGION }}" # 3
username: "${{ secrets.DOCKER_USERNAME }}"
password: "${{ secrets.DOCKER_PASSWORD }}"
- name: Deploy and Build Image
run: |
hexo clean
hexo deploy
ls -la
pwd
docker build -t "${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}" -f Dockerfile .
- name: Push Image
run: |
docker images
docker push "${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}"
# Docker 自动部署
deploy-docker:
needs: [build]
name: Deploy Docker
runs-on: ubuntu-latest
steps:
# get image tag name
- name: Get Image Tag Name
run: |
if [ x${{ github.event.inputs.tag }} == x"" ]; then
echo "TAG_NAME=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
else
echo "TAG_NAME=${{ github.event.inputs.tag }}" >> $GITHUB_ENV
fi
- name: Deploy
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.HOST }} # 服务器ip
username: ${{ secrets.HOST_USERNAME }} # 服务器登录用户名
password: ${{ secrets.HOST_PASSWORD }} # 服务器登录密码
port: ${{ secrets.HOST_PORT }} # 服务器ssh端口
script: |
docker info
echo $(docker ps -aqf "name=${{secrets.BLOG_NAME}}-blog")
docker stop $(docker ps -aqf "name=${{secrets.BLOG_NAME}}-blog")
docker container rm ${{secrets.BLOG_NAME}}-blog
docker rmi ${{secrets.BLOG_NAME}}-blog
echo 查看是否成功删除${{secrets.BLOG_NAME}}-blog
docker ps -a
echo 从harbor拉取docker镜像
chmod 777 /root/${{secrets.BLOG_NAME}}-blog/html/
docker pull ${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}
docker tag ${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}} ${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}
docker run -it --rm -d -p 80:80 --name ${{secrets.BLOG_NAME}}-blog ${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog
docker cp ${{secrets.BLOG_NAME}}-blog:/usr/share/nginx/html /root/${{secrets.BLOG_NAME}}-blog/html
docker system prune -f
echo docker容器启动成功
另一种办法，直接fork
现在我已经把仓库创建好并且上传到了github，仓库地址https://github.com/spatxos/spatxos-blog，可以直接进行fork，然后去阿里云容器仓库中创建一个个人实例，购买或者使用一个云服务器，在github仓库中填写一下Secrets表格中Secrets即可
从博客园拉取之间创建的博客到新建的hexo
在Secrets表格中设置好CNBLOGS_ISDOWN是true，然后去登陆博客园，F12，随便找一个xhr类型的请求，查找对应的cookie，然后到/source/_posts下执行一下go run convertcnblogbookie.go -cookie "替换成你的cookie"将会获得一个输出的新cookie，将新的cookie作为CNBLOGS_COOKIE的value写入进去（github action中使用secrets时，不能包含某些特殊字符，否则会被截断，所以这次执行其实是对特殊字符的替换，后面拉取博客时再替换回来）
在每次执行提交时，将会把docker里面的hexo静态页面映射到服务器的/root/${{BLOG_NAME}}-blog/html文件夹下，首次拉取博客园的文章之后，如何博客园文章未进行更新，我们可以更改一下CNBLOGS_ISDOWN为false，那么就不会从博客园拉取了，原本的文件还会存在，不会进行覆盖
遇到的问题
1.阿里云登陆和docker push 时tag错误，问题描述参见docker tag error，解决办法参见GitHub Actions持续集成阿里云容器镜像服务（ACR），我后面这么写的
docker build -t "${{ secrets.DOCKER_REGISTRY }}/${{secrets.BLOG_NAME}}/${{secrets.BLOG_NAME}}-blog:${{env.TAG_NAME}}" -f Dockerfile .
2.go传入参数和secrets截断问题
go传入参数使用conf来做，secrets截断问题通过先替换掉会截断的字符，然后使用时替换回去