Debian12 + 宝塔面板 部署 Hexo 线上博客（零基础）

一、部署架构说明

采用本地写作 + 服务器托管静态文件最优方案：

  • 本地 Windows：写文章、编译生成静态文件

  • Debian 服务器 + 宝塔 Nginx：对外展示网站

服务器压力极小、最稳定、几乎零报错。

二、服务器前期准备

1. 服务器重装系统：Debian 12

2. 安全组放行端口：80、443、22、8888

三、安装宝塔面板

SSH 连接服务器，执行安装命令：

Text
1
curl -sS http://download.bt.cn/install/install-ubuntu_6.0.sh | sudo bash

安装完成保存：面板地址、账号、密码。

四、宝塔安装运行环境

软件商店只安装一个软件：Nginx

⚠️ Hexo 是静态博客，不需要 MySQL、PHP，装了只会占用资源。

五、创建博客站点

1. 网站 → 添加站点

2. 填写域名/服务器IP

3. 数据库选择：不创建数据库

4. 记录网站根目录，例如：/www/wwwroot/xxx

六、配置伪静态（解决首页空白、404）

站点设置 → 伪静态，填入 Hexo 专用规则：

Text
1
2
3
if (!-e $request_filename) {
    rewrite ^/(.*)$ /index.html break;
}

保存并重载 Nginx。

七、配置 HTTPS 证书

SSL → Let’s Encrypt 免费证书，开启强制 HTTPS，全站加密访问。

八、本地文件上传部署

本地写完文章后执行：

Text
1
hexo clean && hexo g

将本地 public 文件夹内所有内容上传覆盖服务器网站根目录。

✅ 正确结构：网站根目录直接有 index.html、css、js 文件夹

❌ 错误结构：网站根目录嵌套 public 文件夹

九、一键自动同步（免手动上传）

本地 GitBash 执行一键部署命令，替换为你的服务器IP和网站目录：

Text
1
hexo clean && hexo g && rsync -avz ./public/ root@服务器IP:/www/wwwroot/你的网站目录/

十、Hexo 文章规范（分类+标签+中文）

新建文章标准模板，直接复制使用：

Text
1
2
3
4
5
6
7
8
9
---
title: 文章标题
date: 2026-08-18 21:00:00
categories: 技术笔记
tags: [Hexo, Debian, 宝塔面板]
cover: https://picsum.photos/1200/600?random=101
---

正文内容在这里...

十一、常见问题排查

  • 首页空白：检查伪静态、文件上传结构、yml 语法

  • 页面英文：修改根目录 language: zh-CN

  • 更新不生效：执行 hexo clean 清理缓存

  • 禁止使用 hexo s 对外暴露服务，仅本地测试使用

(Note: May contain AI-generated content.)