第四期：Qexo 一个美观、强大的在线静态博客管理器

Limin2024-11-242024-11-24

我的电报群和频道

实时交流电报群：点击加入
官方发布频道：点击关注

前言

Hexo 是一款快速、高效的静态博客框架。通过 Markdown 语法，只需几秒便可生成高质量的静态网页。

最近，我成功实现了在多设备间灵活管理博客并发布内容。一位网友提到 Qexo，一个为 Hexo 增加后台功能的工具，它让发布博客变得像发微博一样简单。深入了解后，我发现它非常强大，不仅可以用手机随时随地发表文章，还极大提升了操作便捷性。

尽管安装过程中遇到了一些问题，但最终都顺利解决。我将整理经验分享，希望能帮助更多人。

Qexo 简介

Qexo 是一个快速、美观且功能丰富的在线 Hexo 管理器，支持通过 Vercel 免费部署，仅需配置一个数据库即可使用。

主要功能

自定义图床上传图片
在线编辑与页面管理
开放 API 接口
自动检查更新并一键更新
快速管理友情链接
短文分享（类似微博功能）
自动填充文章模板

项目地址：Qexo 官方文档

一、配置 GitHub 自动化部署

1. 获取 GitHub Token

打开 Personal settings -> Developer settings -> Personal access tokens
设置权限为 repo 和 public repo

图示1

保存生成的 Token（丢失后无法恢复，只能重新生成）
在博客代码仓库的 Secrets 中添加名为 PERSONAL_TOKEN 的变量，后续步骤将用到。

2. 创建 GitHub Actions

在博客仓库页面，点击 Actions。
选择 Set up a workflow yourself。

输入以下 YAML 配置并点击 Start commit ：

name: Deploy Hexo to GitHub Pages

on:
  push:
    branches:
      - master # 或你使用的默认分支名称

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout blog source
        uses: actions/checkout@v2
        with:
          path: blog

      - name: Set up Node.js
        uses: actions/setup-node@v1
        with:
          node-version: "16" # 设置 Node.js 版本

      - name: Cache dependencies
        uses: actions/cache@v2
        with:
          path: node_modules
          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
          restore-keys: |
            ${{ runner.os }}-node-

      - name: Install dependencies
        run: npm install
        working-directory: ./blog

      - name: Install Hexo CLI
        run: npm install -g hexo-cli
        working-directory: ./blog

      - name: Generate static pages
        run: hexo generate
        working-directory: ./blog

      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          personal_token: ${{ secrets.PERSONAL_TOKEN }}
          publish_dir: ./blog/public
          external_repository: username/username.github.io # 更改为你的 GitHub Pages 仓库, username 是你的用户名
          publish_branch: main # GitHub Pages 分支