Hexo博客网站搭建教程【转载】

本文最后更新于 2026年4月8日 下午

AI AI 摘要
正在整理文章重点...

提示:本文原作者为比特零幺 https://www.bitzerone.com/,本人仅作转载,文章稍作精简后方便个人参阅

简介

快速搭建静态博客网站,专注于内容创作,简化搭建和更新流程。

技术说明

  • Node.js:JavaScript运行环境,npm是其包管理器
  • Hexo:快速、简洁的静态博客框架

1. 安装Node.js

  1. 访问Node.js官网下载LTS版本
  2. 安装完成后验证:
    1
    2
    node -v
    npm -v

2. 安装Hexo

  1. 全局安装Hexo CLI:

    1
    npm install -g hexo-cli
  2. 创建博客项目:

    1
    2
    3
    hexo init blog
    cd blog
    npm install
  3. 新建文章:

    1
    hexo new "我的第一篇文章"
  4. 生成和预览:

    1
    2
    hexo g  # 生成静态文件
    hexo s # 本地预览 (http://localhost:4000)

3. 部署到GitHub

3.1 创建GitHub仓库

  1. 仓库名必须为<用户名>.github.io(例如lishan666.github.io
  2. 选择Public仓库,不勾选README(会自动创建)

3.2 配置Git

  1. 安装Git:Git下载页面

  2. 配置用户信息:

    1
    2
    git config --global user.name "你的名字"
    git config --global user.email "你的邮箱"
  3. 生成SSH密钥:

    1
    ssh-keygen -t rsa -C "你的邮箱"
    • 按3次Enter键使用默认设置
    • ~/.ssh/id_rsa.pub内容添加到GitHub SSH Keys
  4. 测试连接:

    1
    ssh -T git@github.com

3.3 部署配置

  1. 安装部署插件:

    1
    npm install hexo-deployer-git --save
  2. 修改_config.yml

    1
    2
    3
    4
    deploy:
    type: git
    repository: git@github.com:用户名/用户名.github.io.git
    branch: main
  3. 发布文章:

    1
    hexo clean && hexo generate && hexo deploy

4. 部署到Gitee

  1. 仓库名格式:<用户名>.gitee.io
  2. 配置SSH密钥(同GitHub步骤)
  3. 修改_config.yml中的仓库地址:
    1
    repository: git@gitee.com:用户名/用户名.gitee.io.git

5. 部署到云服务器(简化版)

  1. 服务器配置:

    • 安装Nginx
    • 配置域名解析到服务器IP
  2. 服务器端配置:

    1
    git init --bare hexo.git

    创建hooks/post-receive

    1
    2
    3
    4
    #!/bin/bash
    GIT_DIR=/root/repo/hexo.git
    WORK_TREE=/www/hexo
    git --work-tree=$WORK_TREE --git-dir=$GIT_DIR checkout -f
  3. 修改_config.yml

    1
    2
    3
    4
    deploy:
    type: git
    repository: root@服务器IP:/root/repo/hexo.git
    branch: master
  4. 发布命令:

    1
    hexo clean && hexo generate && hexo deploy

6. 快速操作

  • 新建文章

    1
    hexo new "文章标题"
  • 更新并发布

    1
    hexo clean && hexo generate && hexo deploy

7. 常用插件

  • 图片支持(在Markdown中显示图片):
    1
    npm install hexo-asset-img --save

Hexo博客网站搭建教程【转载】
https://www.xxx.com/2023/01/01/node-hexo-build-blog/
作者
yrfg
发布于
2023年1月1日
更新于
2026年4月8日
许可协议