hexo 服务器部署

• Hexo 博客部署到 Linux 服务器 + Nginx
  • 第一步：服务器准备
    • 1. 安装 Nginx
    • 2. 创建网站目录
    • 3. 配置 Nginx
  • 第二步：服务器配置 Git 自动部署
    • 1. 安装 Git（服务器端）
    • 2. 创建裸仓库
    • 3. 设置自动部署脚本
  • 第三步：本地配置 Hexo 的 Git 部署
    • 1. 修改本地 Hexo 的 _config.yml
    • 2. 安装 Hexo Git 部署插件
  • 第四步：部署流程
    • 1. 本地生成静态文件
    • 2. 推送到服务器
  • 第五步（可选）：配置 SSH 免密登录
    • 本地生成 SSH 密钥
    • 上传公钥到服务器
  • 第六步：访问你的博客
  • 常见问题解决

Hexo 博客部署到 Linux 服务器 + Nginx

第一步：服务器准备

适用系统： Debian/Ubuntu 等类 Unix 系统

1. 安装 Nginx

sudo apt update
sudo apt install nginx -y

2. 创建网站目录

sudo mkdir -p /var/www/hexo
sudo chown -R $USER:$USER /var/www/hexo

3. 配置 Nginx

编辑默认配置文件：

sudo nano /etc/nginx/sites-available/default

替换 server 内容为：

server {
    listen 80;
    server_name _;  # 可改成你的域名

    root /var/www/hexo;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

测试配置并重启：

sudo nginx -t
sudo systemctl restart nginx

---

第二步：服务器配置 Git 自动部署

1. 安装 Git（服务器端）

sudo apt install git -y

2. 创建裸仓库

mkdir -p ~/hexo.git && cd ~/hexo.git
git init --bare

3. 设置自动部署脚本

编辑钩子脚本：

nano ~/hexo.git/hooks/post-receive

写入内容：

#!/bin/bash
git --work-tree=/var/www/hexo --git-dir=/home/$USER/hexo.git checkout -f

然后：

chmod +x ~/hexo.git/hooks/post-receive

---

第三步：本地配置 Hexo 的 Git 部署

1. 修改本地 Hexo 的 _config.yml

deploy:
  type: git
  repo: youruser@your.server.ip:/home/youruser/hexo.git
  branch: master

2. 安装 Hexo Git 部署插件

npm install hexo-deployer-git --save

---

第四步：部署流程

1. 本地生成静态文件

hexo clean && hexo generate

2. 推送到服务器

hexo deploy

---

第五步（可选）：配置 SSH 免密登录

本地生成 SSH 密钥

ssh-keygen -t rsa

上传公钥到服务器

ssh-copy-id youruser@your.server.ip

---

第六步：访问你的博客

打开浏览器访问：

http://your.server.ip

或者绑定域名后访问你的域名。

---

常见问题解决

• 403 Forbidden：

  • 确认 /var/www/hexo 有 index.html

  • 设置权限：

    sudo chmod -R 755 /var/www/hexo

• 无法写入 /var/www/hexo：

  sudo chown -R youruser:youruser /var/www/hexo