Hexo博客部署到轻量应用服务器全流程指南

一、部署前的核心准备

1.1 服务器选型与规格建议

轻量应用服务器（Lighthouse）作为部署Hexo博客的理想选择，需根据访问量预估选择配置。建议选择2核4G内存、50GB SSD硬盘的机型，可应对日均1000-5000PV的访问压力。需特别注意带宽选择，若预计图片资源较多，建议选择5Mbps以上带宽，避免加载卡顿。

1.2 系统环境配置要点

推荐使用CentOS 8或Ubuntu 20.04 LTS系统，这两个版本对Node.js和Nginx的支持最为稳定。部署前需完成基础环境配置：

# 更新系统软件包
sudo yum update -y          # CentOS
sudo apt update -y          # Ubuntu
# 安装必要工具链
sudo yum install -y git curl wget # CentOS
sudo apt install -y git curl wget # Ubuntu

二、核心部署流程详解

2.1 Node.js环境搭建

Hexo依赖Node.js运行环境，建议安装LTS版本（当前推荐18.x）：

# 使用nvm管理Node版本（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts
# 验证安装
node -v
npm -v

2.2 Hexo博客源码迁移

本地生成静态文件后，通过scp命令上传至服务器：

# 本地执行生成命令
hexo clean && hexo generate
# 上传public目录到服务器（示例路径）
scp -r ./public/* username@server_ip:/var/www/hexo

建议使用rsync替代scp实现增量同步：

rsync -avz --delete ./public/ username@server_ip:/var/www/hexo

2.3 Nginx反向代理配置

关键配置文件示例（/etc/nginx/conf.d/hexo.conf）：

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/hexo;
    index index.html;
    location / {
        try_files $uri $uri/ /index.html;
    }
    # 静态资源缓存配置
    location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
        expires 30d;
        add_header Cache-Control "public";
    }
}

配置完成后执行sudo nginx -t验证语法，重启服务：

sudo systemctl restart nginx
sudo systemctl enable nginx

三、自动化部署优化方案

3.1 Git Hook自动部署

创建裸仓库实现代码推送自动部署：

# 服务器端操作
mkdir -p /opt/hexo.git && cd /opt/hexo.git
git init --bare
# 创建post-receive钩子
cat > hooks/post-receive <<EOF
#!/bin/bash
TARGET="/var/www/hexo"
GIT_DIR="/opt/hexo.git"
BRANCH="master"
while read oldrev newrev ref
do
    if [[ \$ref =~ refs/heads/\$BRANCH ]];
    then
        echo "Ref \$ref received. Deploying ${BRANCH} branch to production..."
        git --work-tree=\$TARGET --git-dir=\$GIT_DIR checkout -f \$BRANCH
        # 触发Hexo生成（需提前安装hexo-cli）
        cd \$TARGET && hexo clean && hexo generate
    else
        echo "Ref \$ref skipped. No deployment performed."
    fi
done
EOF
chmod +x hooks/post-receive

3.2 CI/CD流水线构建

以GitHub Actions为例配置自动化部署：

name: Hexo Deploy
on:
  push:
    branches: [ main ]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Install Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '18'
    - name: Install Hexo
      run: npm install -g hexo-cli
    - name: Install Dependencies
      run: npm install
    - name: Generate Static Files
      run: hexo clean && hexo generate
    - name: Deploy to Server
      uses: appleboy/scp-action@master
      with:
        host: ${{ secrets.SERVER_IP }}
        username: ${{ secrets.SERVER_USER }}
        key: ${{ secrets.SSH_PRIVATE_KEY }}
        source: "public/*"
        target: "/var/www/hexo"
        strip_components: 1

四、安全加固与性能优化

4.1 安全防护措施

• 配置防火墙规则：

  sudo firewall-cmd --permanent --add-service=http
  sudo firewall-cmd --permanent --add-service=https
  sudo firewall-cmd --reload

• 禁用SSH密码登录，改用密钥认证
• 定期更新系统补丁：sudo yum update -y（CentOS）

4.2 性能优化方案

• 启用Gzip压缩：

  gzip on;
  gzip_types text/plain application/javascript text/css;

• 配置浏览器缓存：

  location ~* \.(js|css|png|jpg)$ {
    expires 1y;
    add_header Cache-Control "public";
  }

• 启用HTTP/2协议（需TLS证书）：

  listen 443 ssl http2;
  ssl_certificate /path/to/cert.pem;
  ssl_certificate_key /path/to/key.pem;

五、常见问题解决方案

5.1 403 Forbidden错误排查

1. 检查Nginx用户权限：sudo chown -R nginx:nginx /var/www/hexo
2. 验证SELinux状态：getenforce（如启用需执行setenforce 0测试）
3. 检查Nginx配置中的root路径是否正确

5.2 CSS/JS加载失败处理

1. 确认Hexo配置中的url和root参数正确：

   # _config.yml示例
   url: https://yourdomain.com
   root: /

2. 检查Nginx配置是否包含try_files指令

5.3 部署后更新不生效

1. 清除浏览器缓存或使用隐私模式访问
2. 验证Nginx是否重启：sudo systemctl status nginx
3. 检查文件同步是否完整：ls -lh /var/www/hexo

六、进阶部署建议

6.1 多环境管理策略

建议采用分支管理策略：

• main分支：生产环境
• develop分支：测试环境
• feature/*分支：开发环境

通过不同Nginx配置文件实现环境隔离：

# 测试环境配置示例
server {
    listen 8080;
    server_name test.yourdomain.com;
    root /var/www/hexo-test;
    ...
}

6.2 监控与日志分析

配置Nginx访问日志轮转：

# /etc/logrotate.d/nginx
/var/log/nginx/*.log {
    daily
    missingok
    rotate 14
    compress
    delaycompress
    notifempty
    create 0640 nginx adm
    sharedscripts
    postrotate
        [ -s /run/nginx.pid ] && kill -USR1 `cat /run/nginx.pid`
    endscript
}

通过以上完整流程，开发者可在2小时内完成Hexo博客从本地到轻量应用服务器的全量部署。建议定期执行hexo clean && hexo generate命令更新静态文件，并保持服务器系统与Hexo依赖库的版本更新，以确保最佳运行状态。