超详细！Windows 和 Linux 安装 Hexo 博客避坑指南，搭配免备案香港服务器轻松上线

Windows安装教程

安装教程（Windows端不建议使用Cmd终端，建议使用类Unix的Git）

1. 安装 Node.js

   • 首先，需要在电脑上安装 Node.js。Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，Hexo 依赖它来运行。

   • 前往Node.js 官方网站，根据自己的操作系统下载相应的安装包进行安装。安装过程中可以选择默认设置一路点击 “下一步”。安装完成后，在命令行中输入node -v和npm -v，如果能输出版本号，则说明安装成功。

2. 安装 Git

   • Git 是一个分布式版本控制系统，用于管理 Hexo 项目的版本和与远程仓库进行交互。

   • 访问Git 官方网站下载适合你操作系统的安装程序。安装时可以选择默认选项，不过在一些选项上可以根据自己的需求进行设置，比如选择是否将 Git 添加到系统环境变量等，一般默认设置就能满足大多数需求。安装完成后，在命令行中输入git --version，若能显示出版本信息，则表示安装成功。

3. 创建博客目录

   • 在你希望存放博客文件的地方，比如D:\hexo或~/Documents/hexo（Windows 和 Linux/macOS 系统分别对应的路径示例），创建一个文件夹，用于存放 Hexo 博客的所有文件。

4. 初始化 Hexo 项目
   
   (Windows端建议Windows11或Windows10)

   • 打开命令行工具，切换到刚才创建的博客目录。例如在 Windows 系统中，可以使用cd D:\hexo命令进入该目录。
   • 执行npm install -g hexo-cli命令，全局安装 Hexo 命令行工具。安装完成后，执行hexo init命令初始化 Hexo 项目。这会在当前目录下生成一系列 Hexo 项目所需的文件和文件夹，包括node_modules（存放项目依赖的模块）、public（用于存放生成的静态网页文件）、scaffolds（模板文件目录）、source（存放博客文章等源文件的目录）以及package.json（项目配置文件）等。（写文章还是用typecho好用）

5. 安装依赖

   • 在项目目录下执行npm install命令，安装 Hexo 项目所需的各种依赖包。这些依赖包包括用于生成静态网页的工具、主题相关的组件等。

6. 启动本地服务器

   • 执行hexo server或hexo s命令启动本地服务器。默认情况下，Hexo 会在http://localhost:4000端口上运行服务器。此时，打开浏览器，访问该地址，就可以看到默认的 Hexo 博客页面，说明 Hexo 博客已经安装成功并可以正常运行。

Linux安装

还在为搭建个人博客繁琐的备案流程头疼？还在为服务器配置复杂而烦恼？本文将手把手教你在 Linux 服务器上快速搭建 Hexo 博客，无需生成静态文件，直接本地部署并配置反向代理。同时，向你推荐一款超好用的香港服务器，免备案、高速稳定，让你的博客轻松上线！

准备工作

购买香港服务器：推荐雨云-香港服务器，免备案，低月租，高配置，实用实惠，即买即用，节省大量时间与精力。服务器网络环境优越，采用专线，延迟如下：

能保障博客快速稳定访问，轻松应对各种流量情况，让你的博客访问流畅无阻。

连接服务器：使用 SSH 工具（如 Putty、Xshell）连接到你的 Linux 服务器。例如，在终端中输入以下命令（假设服务器 IP 为192.168.1.100，用户名your_username）：

1

ssh your_username@192.168.1.100

输入密码后即可成功连接。

安装 Node.js 和 npm

Hexo 基于 Node.js 运行，所以需要先安装 Node.js 和 npm（Node.js 包管理器）。

1
2
3
4
5
6
7

# 更新系统软件包列表
sudo apt update
# 安装Node.js和npm（适用于Debian/Ubuntu系统）
sudo apt install nodejs npm
# 检查Node.js和npm版本，确认安装成功
node -v
npm -v

安装 Hexo

全局安装 Hexo-cli：使用 npm 全局安装 Hexo 命令行工具。

1

npm install -g hexo-cli

初始化 Hexo 博客：在服务器上选择一个目录作为博客根目录（例如/var/www/hexoblog），进入该目录并初始化 Hexo。

1
2
3

mkdir /var/www/hexoblog
cd /var/www/hexoblog
hexo init

安装依赖：在博客根目录下安装 Hexo 所需的依赖包。

1

npm install

本地部署 Hexo

在/var/www/hexoblog目录下的_config.yml文件中，找到server配置项，修改为如下内容，开启本地服务：

1
2
3
4

server:
  port: 4000
  host: 0.0.0.0
  enable_ipv6: false

然后在终端中运行以下命令启动 Hexo 服务：

1

hexo server

此时，在浏览器中输入服务器IP:4000，就能看到 Hexo 博客的默认页面。

配置反向代理（以 Nginx 为例）

安装 Nginx：

1

sudo apt install nginx

配置 Nginx 反向代理：创建一个新的 Nginx 配置文件，例如/etc/nginx/sites-available/hexoblog，内容如下：

1
2
3
4
5
6
7
8
9
10
11
12

server {
    listen 80;
    server_name your_domain.com; # 替换为你的域名或服务器IP

    location / {
        proxy_pass http://127.0.0.1:4000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

启用配置：创建符号链接，启用刚才创建的配置文件，并重启 Nginx 服务。

1
2

sudo ln -s /etc/nginx/sites-available/hexoblog /etc/nginx/sites-enabled/
sudo systemctl restart nginx

现在，通过域名或服务器 IP 就能直接访问你的 Hexo 博客啦！

再次推荐雨云 香港服务器，免备案的特性让你无需等待漫长的审核流程，快速搭建并上线你的博客。优质的网络资源和稳定的性能，为你的博客提供坚实保障。快来体验吧！