Hexo搭建笔记(Termux)
本篇内容记录于安卓移动设备中使用Termux安装、配置Hexo,并实现静态托管与自动化部
署的参考示例。
准备工作
开始之前,请确保已准备好以下内容:
安装必要环境
启动Termux应用后,请按顺序输入以下命令,以完成初始设置并安装所需的运行环境:
termux本身会触发系统弹窗,要求用户授权存储访问权限。如果没有需要执行termux-setup-storage指令后授权。还需要手动开启通知权限
- 更换软件源以免出现网络问题
1 | termux-change-repo |
- 更新Termux的包信息和版本
1 | pkg update && pkg upgrade |
若过程中出现提示,直接回车(默认)即可
- 安装nodejs
1 | pkg install nodejs-lts -y |
检查是否成功安装nodejs
Hexo安装与初始化
依次执行官方的安装操作
1 | npm install hexo-cli -g |
blog只是一个示例,你可以改成如demobolg myblog…等其它自定义名称
执行完成后会返回一个预览地址 http://localhost:4000/复制在浏览器打开,就能看见博客。
注意:若无法查看;在通知中获取唤醒锁或执行termux-wake-lock 另外可能需设置允许高耗电,忽略电池优化
命令预览
1 | hexo clean # 清理静态文件 |
文件夹结构
1 | . |
_config.yml是hexo主配置内容,管理全局设置,部署等…source是存放创建的文章和页面。- 然后是
public,当用户执行hexo g后所生成的静态文件就存放在该目录下,编辑_config.yml可以自定义生成目录。 - themes存放主题
- 其余文件和目录是一些依赖和管理。
通过以上步骤,博客基础就算搭建完成。但目前还是只能在本地开发预览,可通过静态托管实现全网访问。
静态托管
前往GitHub官网,使用邮箱注册一个账户。
Git 安装
1 | pkg install git -y |
再执行两行命令配置Git用户信息(替换自己的邮箱和用户名)
1 | git config --global user.name "用户名" |
新建仓库
在GitHub主页点击New新建仓库
仓库名填写你创建时填写的用户名+github.io其他保持默认。
完成后你会看到有SSH,HTTPS两种仓库地址,后面我们会使用到其中之一用于推送操作
用编辑器打开_config.yml文件
1 | nano _config.yml |
在开头部分找到url改成:
1 | url: https://用户名/github.io |
再找到deploy配置项,将其中的repo字段替换为你自己的仓库地址。完成后Ctrl + X + Y然后回车退出。
1 | deploy: |
安装部署插件
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执行此命令输出公钥至终端(复制输出的全部内容)
GitHub网页右上角头像 → Settings(设置) → (左侧找到)SSH and GPG keys
点击 New SSH key 取一个标题,然后将刚刚复制的公钥粘贴并保存
ssh -T git@github.com该命令测试连接
首次执行会弹出提示,输入 yes 回车即可;若
输出:Hi ametoyuki098! You've successfully authenticated...说明配置成功
GitHub右上角头像 → Settings → 左侧底部Developer settings → Personal access tokens → 选Token classic → 点击Generate new token(选择classic)
勾选repo权限
最后上滑屏幕点击Generate token
按照以上步骤找到并申请身份令牌,
令牌创建成功只会显示一次,务必保存好
此时在进行hexo d推送操作,在输入用户名后提示输入密码便是此令牌,粘贴回车便可推送。
可以把令牌放入配置中,以免每一次推送都需要手动输入;编辑器打开nano _config.yml
1 | deploy: |
找到deploy配置项,在repo字段把<TOKEN>替换为你刚刚生成的令牌,<USERNAME> <RERO>替换成你的用户名和仓库名。
但是这种方式令牌是明文写在_config.yml中。推荐使用环境变量的方式写入:
1 | deploy: |
<USERNAME> <RERO>修改成你自己的用户名和仓库名。
终端执行这个命令设置环境变量
1 | echo 'export GITHUB_TOKEN=你的token' >> ~/.bashrc |
如成功推送,届时你可以访问https://username.github.io(username更换为你自己的用户名)
主题
此处简要介绍两种安装方式(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 | index_img: https://87c80b6.webp.li/i/2025/04/11/13d |
当再执行hexo cle && hexo g && hexo s主页被设置成一张图片
这是butterfly主题的基本安装。而配置说明,根据选择的主题阅读相应的文档说明。
自动部署:GitHub Actions
在本节步骤操作之前,请确保你已经按照以上内容成功搭建博客,并且能使用username.github.io访问到自己的博客网站
Github Actions 简介
Actions的核心作用,是让你能直接在GitHub代码仓库中自动化实现完整的 CI/CD(持续集成、持续交付与部署)流程。参考说明
以此教程举例,当使用Actions后,我们只需要将配置好的源码推送到目标仓库,GitHub就会自动触发构建并部署。这样一来,就不必在本地反复执行“一键三连命令”
更重要的是,它大大增加了跨设备和无环境的便捷性:你即使没有本地开发环境,只用浏览器也能对文章进行编辑。
申请令牌
graph TD
%% 类定义:低饱和色+圆润边角,区分节点类型
classDef startNode fill:#e8f5e9, color:#2e7d32, stroke:#4caf50, stroke-width:2px, rx:8, ry:8, fontSize:13px
classDef processNode fill:#e3f2fd, color:#1565c0, stroke:#2196f3, stroke-width:2px, rx:8, ry:8, fontSize:13px
classDef endNode fill:#fff3e0, color:#e65100, stroke:#ff9800, stroke-width:2px, rx:8, ry:8, fontSize:13px
%% 主流程
A[👤 点击 GitHub 右上角头像] --> B[⚙️ Settings<br>设置]
B --> C[🔧 Developer settings<br>开发者设置]
C --> D[🔑 Personal access tokens<br>个人访问令牌]
D --> E[✨ Generate new token<br>生成新令牌]
%% 右侧提示(通过虚线连接D)
D -.-> F[❗ 请选择 “Classic Token(经典)”<br>不要选 fine-grained]
%% 应用样式类
class A startNode
class B,C,D processNode
class F processNode
class E endNode
%% 连线样式:主流程实线、F为虚线
linkStyle 0 stroke:#4caf50, stroke-width:1.5px, stroke-opacity:0.8
linkStyle 1 stroke:#2196f3, stroke-width:1.5px, stroke-opacity:0.8
linkStyle 2 stroke:#2196f3, stroke-width:1.5px, stroke-opacity:0.8
linkStyle 3 stroke:#2196f3, stroke-width:1.5px, stroke-opacity:0.8
linkStyle 4 stroke:#2196f3, stroke-width:1.5px, stroke-opacity:0.8, stroke-dasharray: 5 5
取一个备注,选择No expiration 不过期,勾选repo 将生成的令牌复制下来备用
创建仓库&配置 Secrets
该仓库用于存放博客源码;仓库名随意,可见性选择私人(Private)
在刚刚新建的仓库中点击Settings
Name填写:DEPLOYTOKEN
将刚刚复制的令牌值粘贴到Secret最后点击保存。
创建 workflow 文件
回到终端,在你的博客根目录分别执行这两行命令
1 | mkdir -p .github/workflows |
1 | name: Hexo Blog CI/CD |
复制上面的配置内容并放入deploy.yml
1 | nano .github/workflows/deploy.yml |
在其中找到external_repository字段,根据注释修改成你自己的。最后保存退出
推送触发
确保只push需要的内容。根目录编辑nano .gitignore,内容如下
1 | .DS_Store |
还是在你的博客根目录依次执行Git命令
1 | git init |
这些命令与仓库地址可以在你刚刚创建的仓库主页中看到。
git push...执行后,去仓库点击Actions就能看见正在运行的工作流;等变成绿色说明成功完成。
访问username.github.io
新建一篇文章,并重新推送;验证是否触发自动部署
- 输入
hexo new "文章名称" git add .重新添加暂存git commit -m "填写备注信息"- 推送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 | git submodule update --remote themes/butterfly |












