如何在VPS上搭建Hexo博客？_从环境配置到部署上线的完整指南

2025-11-08 18:40:09

阅读 3

如何在VPS上搭建Hexo博客？

# 在VPS上搭建Hexo博客的完整指南
Hexo是一个基于Node.js的静态博客框架，它能够将Markdown文档快速转换为静态网页。相比传统的动态博客，Hexo具有速度快、安全性高、部署简单等优势。

## 主要步骤概览

## 详细操作流程

### 步骤1：VPS环境准备
**操作说明**：在VPS上安装必要的软件环境，包括Node.js、Git和Nginx。
**使用工具提示**：使用SSH连接到VPS，通过包管理器安装所需软件。
```bash

# 连接到VPS
ssh root@your_server_ip

# 更新系统包
yum update -y # CentOS系统

# 或 apt update && apt upgrade -y # Ubuntu系统

# 安装Node.js（使用EPEL仓库）
yum install epel-release -y
yum install nodejs npm -y

# 安装Git
yum install git -y

# 安装Nginx
yum install nginx -y
```
**验证安装**：
```bash
node -v # 检查Node.js版本
npm -v # 检查npm版本
git --version # 检查Git版本
nginx -v # 检查Nginx版本
```

### 步骤2：SSH密钥配置
**操作说明**：配置SSH密钥登录，为后续Git推送做准备。
**使用工具提示**：在本地生成SSH密钥对，并将公钥添加到VPS。
```bash

# 在本地计算机生成SSH密钥
ssh-keygen -t rsa -C "your_email@example.com"

# 查看公钥内容
cat ~/.ssh/id_rsa.pub

# 在VPS上创建hexo用户并配置SSH
adduser hexo
su hexo
cd /home/hexo
mkdir .ssh
vim .ssh/authorized_keys
```

### 步骤3：Hexo本地安装
**操作说明**：在本地计算机上安装Hexo并初始化博客项目。
**使用工具提示**：确保本地已安装Node.js和Git环境。
```bash

# 安装Hexo命令行工具
npm install -g hexo-cli

# 初始化博客项目
hexo init my-blog
cd my-blog
npm install

# 测试本地运行
hexo server
```

### 步骤4：Git仓库设置
**操作说明**：在VPS上创建Git仓库并配置post-update钩子。
**使用工具提示**：钩子脚本用于自动更新Web服务器上的静态文件。
```bash

# 在VPS上创建Git仓库
mkdir /home/hexo/blog.git
cd /home/hexo/blog.git
git init --bare
```

### 步骤5：Nginx配置
**操作说明**：配置Nginx指向Hexo生成的静态文件目录。
**使用工具提示**：编辑Nginx配置文件，设置正确的根目录。
```bash

# 编辑Nginx配置文件
vim /etc/nginx/nginx.conf

# 在server块中添加以下配置
server {
listen 80;
server_name your_domain.com;
root /home/hexo/www; # 静态文件目录
index index.html;
}
```

### 步骤6：博客部署测试
**操作说明**：配置Hexo部署设置，推送文章到VPS并验证访问。
**使用工具提示**：编辑Hexo的_config.yml文件，设置正确的部署路径。
```bash

# 在本地Hexo项目的_config.yml中添加部署配置
deploy:
type: git
repo: hexo@your_server_ip:/home/hexo/blog.git
branch: master
```

## 常见问题及解决方案

问题	原因	解决方案
部署时出现”spawn failed”错误	1. 仓库地址配置错误2. SSH密钥未正确设置3. 权限问题	1. 检查_config.yml中的repository地址格式2. 确认本地SSH密钥已添加到VPS3. 检查文件权限设置
Nginx启动后显示默认页面	Nginx根目录配置错误	检查Nginx配置文件中的root路径，确保指向正确的静态文件目录
本地hexo server无法访问	端口被占用或防火墙阻止	1. 使用`hexo server -p 5000`指定其他端口2. 检查防火墙设置，开放相应端口
Git推送后网站未更新	post-update钩子未正确配置	1. 检查钩子脚本权限`chmod +x post-update`2. 确认钩子脚本中的路径正确
Node.js版本过低导致Hexo安装失败	系统默认安装的Node.js版本过旧	1. 使用nvm安装最新Node.js版本2. 手动下载并编译安装