系统基础依赖安装(先执行)

我的版本是Ubuntu 26.04 LTS，打算使用NVM安装Hexo 8。

1
2
3
4
5
#查看linux版本
uname -a 
cat /etc/os-release
lsb_release -a
hostnamectl
1
2
3
4
5
6
7
8
# 更新软件源 
sudo apt update && sudo apt upgrade -y 
# 安装 curl、git（Hexo与NVM必需） 
sudo apt install curl git -y

# 验证版本 
node -v 
npm -v

安装NVM(Node 版本管理器)

1
2
3
4
5
6
7
8
9
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash 

# 加载nvm到当前终端 
export NVM_DIR="$HOME/.nvm" 
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" 
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" 

# 永久生效（下次ssh自动加载） 
source ~/.bashrc

安装Node.js 20 LTS(适配 Hexo8)

Node18/20 需要 glibc2.28，16 是最后兼容 2.27 的稳定版，跑 Hexo 完全够用：

1
2
3
4
5
6
7
8
9
10
# 安装最新LTS Node20 
nvm install --lts 
# 设为当前会话使用 
nvm use lts/* 
# 设为新开终端默认Node版本（永久生效） 
nvm alias default lts/*

# 验证 
node -v 
npm -v

npm国内镜像加速(解决安装慢)

1
npm config set registry https://registry.npmmirror.com npm config get registry

全局安装Hexo命令行工具hexo-cli

1
2
npm install -g hexo-cli
hexo -v

初始化Hexo博客站点

1
2
3
4
mkdir -p /home/blog
cd /home/blog
hexo init
npm install

解决新开SSH终端 hexo: command not found

1
2
3
4
5
cat >> ~/.bashrc <<'EOF' 
export NVM_DIR="$HOME/.nvm" 
[ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh" 
EOF
source ~/.bashrc

Hexo基础操作命令

  • source/_posts：写文章
  • themes：博客主题
  • public：hexo g 生成静态网页，Nginx 托管这个文件夹

测试构建（确认无报错）

1
2
3
4
# 清理旧文件 + 生成静态页面
hexo clean && hexo generate
# 查看首页是否生成（不能为空文件）
ls -lh public/index.html

Hexo 日常操作命令（无界面服务器专用）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 进入博客目录
cd /home/blog

# 新建文章
hexo new "Linux Nginx部署Hexo教程"

# 清理缓存 + 重新生成静态页面（更新博客必执行）
hexo clean && hexo generate

# 本地预览（4000端口，仅测试用）
hexo server
nohup hexo server &

# 安装主题示例
git clone https://github.com/xxx/xxx-theme themes/xxx
# 修改_config.yml里theme: xxx切换主题

Butterfly主题安装

Butterfly 文檔(一) 快速開始 | Butterfly