一、部署架构说明采用本地写作 + 服务器托管静态文件最优方案:
本地 Windows:写文章、编译生成静态文件
Debian 服务器 + 宝塔 Nginx:对外展示网站
服务器压力极小、最稳定、几乎零报错。
二、服务器前期准备1. 服务器重装系统:Debian 12
2. 安全组放行端口:80、443、22、8888
三、安装宝塔面板SSH 连接服务器,执行安装命令:
Text1curl -sS http://download.bt.cn/install/install-ubuntu_6.0.sh | sudo bash
安装完成保存:面板地址、账号、密码。
四、宝塔安装运行环境软件商店只安装一个软件:Nginx
⚠️ Hexo 是静态博客,不需要 MySQL、PHP,装了只会占用资源。
五、创建博客站点1. 网站 → 添加站点
2. 填写域名/服务器IP
3. 数据库选择:不创建数据库
4. 记录网站根目录,例如:/www/wwwroot/xxx
六、配置伪静态(解决首页空白、404)站点设置 → 伪静态,填入 Hexo 专用规则:
Text123if (!-e ...
一、前言很多新手搭建 Hexo 博客第一步就踩坑:环境装错、版本不对、页面空白、中文乱码。本文带你在 Windows 系统搭建稳定、无报错、适合长期写博客的 Hexo 本地写作环境,搭配 MarkText 编辑器,全程傻瓜式操作。
二、必备环境安装(仅两个)Hexo 只依赖 Git + Node.js,不需要 PHP、数据库。
1. 安装 Node.js(必装)推荐稳定版本:Node.js 18.x LTS(不要用 22.x 新版,大量主题报错、页面空白)
安装注意:全程默认下一步,勾选 Add to PATH 自动配置环境变量。
安装完成 CMD 验证:
Text12node -vnpm -v
2. 安装 Git默认下一步安装即可,用于后续同步文件、部署博客。
三、安装 Hexo 核心框架打开 CMD / Git Bash,全局安装 Hexo 脚手架:
Text1npm install -g hexo-cli
验证是否安装成功:
Text1hexo -v
四、初始化本地博客文件夹找一个纯英文路径文件夹(不要中文、不要空格),执行:
Text123hexo init m ...

