本篇内容记录于安卓移动设备中使用Termux安装、配置Hexo,并实现静态托管与自动化部
署的参考示例。

准备工作

开始之前,请确保已准备好以下内容:

  • Termux (F-Droid或GitHub下载安装)
  • 域名 (可选)
  • GitHub账号
  • Cloudflare (可选)

安装必要环境

启动Termux应用后,请按顺序输入以下命令,以完成初始设置并安装所需的运行环境:

termux本身会触发系统弹窗,要求用户授权存储访问权限。如果没有需要执行termux-setup-storage指令后授权。还需要手动开启通知权限

  1. 更换软件源以免出现网络问题
1
2
termux-change-repo
# 先选 Single mirror → (选择清华源)Tsinghua 空格是选择回车是确认
  1. 更新Termux的包信息和版本
1
pkg update && pkg upgrade

若过程中出现提示,直接回车(默认)即可

  1. 安装nodejs
1
pkg install nodejs-lts -y
检查是否成功安装nodejs

Hexo安装与初始化

依次执行官方的安装操作

1
2
3
4
5
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

blog只是一个示例,你可以改成如demobolg myblog…等其它自定义名称

i/2026/01/14/xzpjr2-beg2.png

执行完成后会返回一个预览地址 http://localhost:4000/复制在浏览器打开,就能看见博客。

注意:若无法查看;在通知中获取唤醒锁或执行termux-wake-lock 另外可能需设置允许高耗电,忽略电池优化

命令预览

1
2
3
4
5
6
7
8
9
hexo clean    # 清理静态文件
hexo generate # 生成静态文件
hexo server # 开启本地预览
hexo deploy # 部署远程仓库

hexo cle # clean 的简写
hexo g # generate 的简写
hexo s # server 的简写
hexo d # deploy 的简写

文件夹结构

1
2
3
4
5
6
7
8
9
10
11
 .
├── _config.landscape.yml
├── _config.yml
├── db.json
├── node_modules
├── package-lock.json
├── package.json
├── scaffolds
├── source
├── themes
└── yarn.lock
  • _config.yml是hexo主配置内容,管理全局设置,部署等…
  • source是存放创建的文章和页面。
  • 然后是public,当用户执行hexo g后所生成的静态文件就存放在该目录下,编辑_config.yml可以自定义生成目录。
  • themes存放主题
  • 其余文件和目录是一些依赖和管理。

通过以上步骤,博客基础就算搭建完成。但目前还是只能在本地开发预览,可通过静态托管实现全网访问。

静态托管

前往GitHub官网,使用邮箱注册一个账户。

Git 安装

1
pkg install git -y

再执行两行命令配置Git用户信息(替换自己的邮箱和用户名)

1
2
git config --global user.name "用户名"
git config --global user.email "邮箱"

新建仓库

在GitHub主页点击New新建仓库
仓库名填写你创建时填写的用户名+github.io其他保持默认。

i/2026/01/14/xzpjqy-3nqg.png

完成后你会看到有SSH,HTTPS两种仓库地址,后面我们会使用到其中之一用于推送操作

用编辑器打开_config.yml文件

1
nano _config.yml

在开头部分找到url改成:

1
url: https://用户名/github.io

再找到deploy配置项,将其中的repo字段替换为你自己的仓库地址。完成后Ctrl + X + Y然后回车退出。

1
2
3
4
deploy:
type: git
repo: git@github.com:ametoyuki098/ametoyuki098.github.io.git
branch: main

安装部署插件

1
npm install hexo-deployer-git --save

这里使用ssh所以需申请密钥并添加公钥到GitHub。如果你使用的是https,则需要去GitHub申请一个身份令牌供推送使用。下面是两种方式的操作

安装OpenSSH:

1
pkg install openssh -y

生成密钥对

1
ssh-keygen -t ed25519 -C "GitHub绑定邮箱"

这里执行后会询问保存路径和密码保护,直接回车默认即可。

cat ~/.ssh/id_ed25519.pub执行此命令输出公钥至终端(复制输出的全部内容)

i/2026/01/14/y083ja-dq6t.png

GitHub网页右上角头像 → Settings(设置) → (左侧找到)SSH and GPG keys

点击 New SSH key 取一个标题,然后将刚刚复制的公钥粘贴并保存

i/2026/01/14/xzpjqx-tfex.png

ssh -T git@github.com该命令测试连接
首次执行会弹出提示,输入 yes 回车即可;若
输出:Hi ametoyuki098! You've successfully authenticated...说明配置成功

i/2026/01/14/xzpjqs-nf2s.png

GitHub右上角头像 → Settings → 左侧底部Developer settings → Personal access tokens → 选Token classic → 点击Generate new token(选择classic)

i/2026/01/14/xzpjqr-tkk3.png

勾选repo权限
最后上滑屏幕点击Generate token
按照以上步骤找到并申请身份令牌,
令牌创建成功只会显示一次,务必保存好

此时在进行hexo d推送操作,在输入用户名后提示输入密码便是此令牌,粘贴回车便可推送。

可以把令牌放入配置中,以免每一次推送都需要手动输入;编辑器打开nano _config.yml

1
2
3
4
deploy:
type: git
repo: https://<TOKEN>@github.com/<USERNAME>/<REPO>.git
branch: main

找到deploy配置项,在repo字段把<TOKEN>替换为你刚刚生成的令牌,<USERNAME> <RERO>替换成你的用户名和仓库名。

但是这种方式令牌是明文写在_config.yml中。推荐使用环境变量的方式写入:

1
2
3
4
deploy:
type: git
repo: https://$GITHUB_TOKEN@github.com/<USERNAME>/<RERO>.git
branch: main

<USERNAME> <RERO>修改成你自己的用户名和仓库名。

终端执行这个命令设置环境变量

1
echo 'export GITHUB_TOKEN=你的token' >> ~/.bashrc

主题

本次演示仅以Butterfly主题为例,更多的主题样式可以查看Hexo主题预览

此处简要介绍两种安装方式(npm 与 Git),不过为保持后续流程一致,建议使用 npm 安装。

使用npm

1
npm install hexo-theme-butterfly

使用Git

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

安装渲染插件

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

配置

编辑博客主目录下_config.yml文件,找到theme字段并修改为:

1
theme: butterfly

执行以下命令,就能在本地看见主题效果

1
hexo cle && hexo g && hexo s

为了后续配置方便,需要把主题的配置文件复制到博客根目录并改名为_config.butterfly.yml。 根据安装方式执行对应命令(请确保你处在博客根目录)

1
cp node_modules/hexo-theme-butterfly/_config.yml ./_config.butterfly.yml
1
cp themes/butterfly/_config.yml ./_config.butterfly.yml

你可以尝试用编辑器打开_config.butterfly.yml这个文件,并找到index_img字段修改为:

1
2
index_img: https://87c80b6.webp.li/i/2025/04/11/13d
xcy-x7.jpg

当再执行hexo cle && hexo g && hexo s主页被设置成一张图片

这是butterfly主题的基本安装。而配置说明,根据选择的主题阅读相应的文档说明。

自动部署:GitHub Actions

在本节步骤操作之前,请确保你已经按照以上内容成功搭建博客,并且能使用username.github.io访问到自己的博客网站

Github Actions 简介

Actions的核心作用,是让你能直接在GitHub代码仓库中自动化实现完整的 CI/CD(持续集成、持续交付与部署)流程。参考说明

以此教程举例,当使用Actions后,我们只需要将配置好的源码推送到目标仓库,GitHub就会自动触发构建并部署。这样一来,就不必在本地反复执行“一键三连命令”
更重要的是,它大大增加了跨设备和无环境的便捷性:你即使没有本地开发环境,只用浏览器也能对文章进行编辑。

申请令牌

i/2026/01/14/xzpjqp-yefx.png

取一个备注,选择No expiration 不过期,勾选repo 将生成的令牌复制下来备用

创建仓库&配置 Secrets

该仓库用于存放博客源码;仓库名随意,可见性选择私人(Private)

i/2026/01/14/y0nya8-by6h.png

在刚刚新建的仓库中点击Settings

i/2026/01/14/xzpjqh-m3t7.png

Name填写:DEPLOYTOKEN
将刚刚复制的令牌值粘贴到Secret最后点击保存。

创建 workflow 文件

回到终端,在你的博客根目录分别执行这两行命令

1
2
mkdir -p .github/workflows
touch .github/workflows/deploy.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
name: Hexo Blog CI/CD

on:
push:
branches: [main, master]
paths:
- '**/*.json'
- '**/*.yml'
- 'source/**'
- '_config.yml'
- '.github/workflows/**'

jobs:
build-deploy:
runs-on: ubuntu-latest
env:
TZ: Asia/Shanghai
timeout-minutes: 15

permissions:
contents: write

steps:
- uses: actions/checkout@v4
with:
submodules: recursive

- uses: actions/setup-node@v4
with:
node-version: '22'
cache: 'npm'

- name: Install dependencies
run: npm ci

- name: Build blog
run: |
npx hexo clean
npx hexo generate

- name: Deploy to external repo main branch
uses: peaceiris/actions-gh-pages@v4.0.0
with:
personal_token: ${{ secrets.DEPLOYTOKEN }}
publish_dir: ./public

# 要部署到的目标仓库(格式:用户名/仓库名)
external_repository:

publish_branch: main
commit_message: "feat: Blog deployed via GH Actions [skip ci]"

- name: Success notification
run: echo "🎉 Blog deployed successfully!"

复制上面的配置内容并放入deploy.yml

1
nano .github/workflows/deploy.yml

在其中找到external_repository字段,根据注释修改成你自己的。最后保存退出

推送触发

确保只push需要的内容。根目录编辑nano .gitignore,内容如下

1
2
3
4
5
6
7
8
9
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
_multiconfig.yml
_config.landscape.yml

还是在你的博客根目录依次执行Git命令

1
2
3
4
5
6
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:ametoyuki098/Lopez.git
git push -u origin main

这些命令与仓库地址可以在你刚刚创建的仓库主页中看到。

i/2026/01/14/y0yvyw-45n0.png

git push...执行后,去仓库点击Actions就能看见正在运行的工作流;等变成绿色说明成功完成。

访问username.github.io

新建一篇文章,并重新推送;验证是否触发自动部署

  1. 输入 hexo new "文章名称"
  2. git add . 重新添加暂存
  3. git commit -m "填写备注信息"
  4. 推送GitHub仓库:git push

稍等一会后重新访问username.github.io 查看是否有新建文章。

补充说明…

在主题部分我推荐npm;因其版本控制与管理的便捷,且更佳适配本环节。

对于未提供npm包或更偏向于用git。这里建议尝试子模块,后续使用要优于直接clone

1
git submodule add -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

后续拉取及更新主题使用以下命令

1
2
3
git submodule update --remote themes/butterfly

git clone --recurse-submodules <仓库地址>