🧰 环境准备

确保你的 Linux 系统已安装以下软件：

  • Git（版本控制工具）
  • Node.js 和 npm（Hexo 依赖）
  • OpenSSH（用于生成 SSH 密钥和远程连接）

在 Arch Linux 上安装

sudo pacman -S git nodejs npm openssh

在 Debian / Ubuntu 上安装

sudo apt update
sudo apt install git nodejs npm openssh

✅ 安装完成后，可使用以下命令确认是否安装成功：

git -v
node -v
npm -v

💻 本地部署 Hexo

安装 Hexo 命令行工具

sudo npm install -g hexo-cli

初始化博客项目

hexo init blog
cd blog

本地预览博客

hexo clean && hexo s

浏览器访问：http://localhost:4000

🎨 安装并配置主题

克隆主题 — 以 Reimu 为例

git clone https://github.com/D-Sketon/hexo-theme-reimu themes/reimu

修改站点配置文件 _config.yml

theme: reimu

language: [zh-CN, en]
i18n:
  type: [page, post]
  generator: [archive, category, tag, index]

title: 网站标题
keywords: 搜索引擎关键词
author: 作者
url: 连接地址

启用搜索功能

在 themes/reimu/_config.yml 中修改：

algolia_search:
  enable: true

修改页脚信息

在 themes/reimu/_config.yml 中修改：

footer:
  since: 2018
  busuanzi: false

启用RSS

npm install hexo-generator-feed --save

配置多语言支持（可选）

安装插件

npm install hexo-generator-i18n --save

修改 _config.yml

language: [zh-CN, en]
i18n:
  type: [page, post]
  generator: [archive, category, tag, index]

每篇文章添加 lang 字段：

title: Hello World
date: 2025-05-25
lang: en
title: 你好，世界
date: 2025-05-25
lang: zh-CN

重新生成并预览

hexo clean && hexo g && hexo s

搜索引擎收录与 SEO 优化（可选）

安装插件

npm install hexo-generator-sitemap --save

修改 _config.yml

## Sitemap Generator
sitemap:
  path: sitemap.xml

登录网站管理员工具并添加网站地图 sitemap.xml

必应
yandex
谷歌
如果谷歌无法读取可尝试 //sitemap.xml/

👤 配置 GitHub 仓库

创建 GitHub 仓库

  • 登录 GitHub，点击右上角头像 > Repositories > New
  • 仓库命名格式：你的用户名.github.io
    例如用户名为 233，则仓库名为 233.github.io

🔐 配置 SSH 密钥

生成 SSH 密钥

ssh-keygen -t rsa -C "你的GitHub邮箱"

一路回车，使用默认路径和空密码。

复制公钥内容

cat ~/.ssh/id_rsa.pub

添加到 GitHub

测试连接

ssh -T git@github.com

若成功，会显示欢迎语句。

⚙️ 配置 Git 用户信息

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

🚀 配置 Hexo 部署到 GitHub Pages

安装部署插件

npm install hexo-deployer-git --save

修改 _config.yml 部署配置

deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

🔁 注意：若仓库使用 master 分支，请将 branch: main 改为 branch: master

📤 发布博客到 GitHub Pages

执行以下命令：

hexo clean && hexo d
  • hexo clean：清理缓存
  • hexo g 或 hexo generate：生成静态文件
  • hexo d 或 hexo deploy：部署到 GitHub 仓库

🌐 访问博客

打开浏览器，访问：

https://你的用户名.github.io

🌍 配置自定义域名（可选）

创建 CNAME 文件

在 Hexo 项目 source 目录下新建 CNAME 文件，写入你的域名（不加 http/https）：

www.example.com

在域名服务商后台设置 CNAME 记录

添加 CNAME 解析记录，指向：

你的用户名.github.io

🔒 配置 HTTPS（推荐）

推荐使用 Cloudflare 免费提供 CDN 和 HTTPS：

  1. 注册并添加站点至 Cloudflare
  2. 将域名 DNS 指向 Cloudflare 提供的 NS 服务器
  3. 在 Cloudflare 面板开启 “Always Use HTTPS”

⌨️ 附录：常用 Hexo 命令速查表

命令 功能
hexo new <title> 新建文章
hexo clean 清理缓存
hexo g 或 hexo generate 生成静态文件
hexo s 或 hexo server 启动本地预览服务
hexo d 或 hexo deploy 部署到远程仓库