详细教程：从零开始在 Linux（Ubuntu）上安装 Node.js + npm → 安装 Hexo → 部署 Hexo 博客

目标：在本地完成一个可通过公网访问的 Hexo 博客
前置条件：

• 一台拥有 root 或 sudo 权限的 Linux 服务器（或本地虚拟机）
• 服务器能够联网（用于安装软件包）
• 具备基本的命令行操作经验

---

目录

1. 安装 Node.js 与 npm
2. 验证 Node.js 与 npm
3. 全局安装 Hexo CLI
4. 创建并初始化 Hexo 项目
5. 本地预览 Hexo 博客

---

1. 安装 Node.js 与 npm（官方推荐方式）

以下以 VMware Ubuntu 24.04 为例。

# 更新系统软件包索引，确保 apt 源是最新的
root@ubuntu24:~# apt update

# 安装 Node.js 和 npm（Ubuntu 官方仓库中的版本）
root@ubuntu24:~# apt install nodejs npm

---

2. 验证 Node.js 与 npm

# 查看 Node.js 版本
root@ubuntu24:~# node -v
v18.19.1

# 查看 npm 版本
root@ubuntu24:~# npm -v
9.2.0

如果成功输出版本号，即表示 Node.js 和 npm 安装成功。

---

3. 全局安装 Hexo CLI

3.1 环境准备

# 创建项目目录，-p 参数会自动创建所有不存在的父目录（如 /data/codes）
root@ubuntu24:~# mkdir /data/codes/hexo_project -p

# 切换到刚创建的项目目录
root@ubuntu24:~# cd /data/codes/hexo_project/

# 设置 npm 全局镜像源为淘宝镜像（国内加速，显著提升包下载速度）
root@ubuntu24:/data/codes/hexo_project# npm config set registry https://registry.npmmirror.com

3.2 安装 Hexo CLI

# 全局安装 hexo-cli 命令行工具（后续用于初始化和管理博客）
root@ubuntu24:/data/codes/hexo_project# npm install -g hexo-cli

---

4. 创建并初始化 Hexo 项目

4.1 初始化博客目录

# 使用 hexo init 初始化一个名为 myblogs 的完整博客项目（会自动从 GitHub 拉取模板）
root@ubuntu24:/data/codes/hexo_project# hexo init myblogs

# 进入博客项目根目录
root@ubuntu24:/data/codes/hexo_project# cd myblogs

# 安装项目本地依赖（根据 package.json 自动安装所有需要的 npm 包）
root@ubuntu24:/data/codes/hexo_project/myblogs# npm install

4.2 （可选）升级 Node.js 到 v20.19.0

当 hexo-cli 或某些插件提示 引擎不兼容（Engine Strict） 时执行以下步骤：

# 全局安装 n 工具（Node.js 版本管理器）
root@ubuntu24:/data/codes/hexo_project/myblogs# npm install -g n

# 使用 n 安装并切换到 Node.js v20.19.0（需要 root 权限）
root@ubuntu24:/data/codes/hexo_project/myblogs# sudo n 20.19.0

# 刷新当前 shell 的命令缓存，使新版本的 node 立即生效
root@ubuntu24:/data/codes/hexo_project/myblogs# hash -r

# 验证 Node.js 是否升级成功
root@ubuntu24:/data/codes/hexo_project/myblogs# node -v
v20.19.0

# 重新安装依赖，确保所有包与新版本 Node.js 兼容
root@ubuntu24:/data/codes/hexo_project/myblogs# npm install

---

5. 本地预览 Hexo 博客

# 启动 Hexo 内置开发服务器（默认监听 4000 端口）
root@ubuntu24:/data/codes/hexo_project/myblogs# hexo server

启动成功后终端会显示：

INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

在浏览器中访问 http://<服务器IP>:4000，例如：

http://10.0.0.13:4000

说明：10.0.0.13 为当前服务器或虚拟机的内网 IP 地址
可通过以下命令查看：ip a

看到 Hexo 默认主题页面（Landscape 主题）即表示本地部署成功！