Hexo搭建教程

nodejs安装

#1. 下载 Node.js 16 的二进制包 wget https://nodejs.org/dist/v16.20.2/node-v16.20.2-linux-x64.tar.xz #2. 解压并安装 tar -xvf node-v16.20.2-linux-x64.tar.xz mv node-v16.20.2-linux-x64 /usr/local/node #3. 添加环境变量 echo 'export PATH=/usr/local/node/bin:$PATH' > /etc/profile.d/nodejs.sh source /etc/profile.d/nodejs.sh #4. 验证 node -v

安装git

# CentOS 7/8/Stream 通用 yum install -y git # 验证 git --version

宝塔安装

url=https://download.bt.cn/install/install_panel.sh;if [ -f /usr/bin/curl ];then curl -sSO $url;else wget -O install_panel.sh $url;fi;bash install_panel.sh ssl251104

hexo部署

# 全局安装 Hexo npm install -g hexo-cli # 验证 hexo -v

# 进入宝塔默认网站目录 cd /www/wwwroot # 创建博客文件夹并初始化 hexo init myblog cd myblog # 安装依赖 npm install # 生成静态页面（会在 myblog 下创建 public 文件夹） hexo generate #修改权限给宝塔 chown -R www:www /www/wwwroot/myblog

宝塔面板配置

添加站点

• 宝塔 → 网站 → 添加站点
• 域名：你的域名（或服务器 IP）
• 根目录：/www/wwwroot/myblog/public（⚠️必须是 public 子目录）
• PHP 版本：纯静态

访问测试

• 浏览器访问你的域名，应该能看到 Hexo 默认页面

安知鱼主题部署

cd /www/wwwroot/myblog/themes git clone https://github.com/next-theme/hexo-theme-next.git

# 编辑站点配置文件 vim /www/wwwroot/myblog/_config.yml

找到theme:这一行（大概在底部），改为：

theme: next # 原来的 landscape 可以注释掉或删掉 保存退出（:wq）

安装主题依赖并生成

cd /www/wwwroot/myblog # 安装主题可能需要的依赖 npm install # 清理缓存并重新生成（必须执行） hexo clean hexo generate # 修正权限 chown -R www:www /www/wwwroot/myblog/public

hexo clean的过程中会出现由于.user.ini被锁定，导致删除不掉

# 1. 解锁 .user.ini（必须！） chattr -i /www/wwwroot/myblog/public/.user.ini # 2. 现在可以成功 clean 了 hexo clean # 3. 重新生成 hexo generate

注意：如果Pug 模板没有被渲染，浏览器直接显示了 Pug 源码。说明hexo-renderer-pug没有正常工作。

cd /www/wwwroot/myblog # 1. 强制重新安装 Pug 渲染器（关键！） npm uninstall hexo-renderer-pug npm install hexo-renderer-pug --save # 2. 同时确保 Stylus 渲染器也安装 npm install hexo-renderer-stylus --save # 3. 清理并重新生成 hexo clean hexo generate

最后刷新网站主题就切换成功了