Mac/Linux/Windows如何从零开始搭建Hexo静态博客并部署到远程平台

有些网友反应，想看我的Hexo构建；那我就出一期教程吧(´▽｀)。

本文同步博客图文( ´▽｀)：https://www.mintimate.cn/2020/03/19/hexo

简介

目前，互联网资源的普及，已经可以让人人搭建一个个人博客了；这边就教大家怎么搭建Hexo并配置。大家可以参考Hexo官方文档和你所想部署的Hexo主题文档配合使用。持续更新～

Demo

最终效果：Mintimate's Blog

使用：Hexo+Fluid主题+部署在腾讯云静态托管

辅助搭建视频教程

原本我有在B站做视频，但是时间比较久。有时间重新做一下。旧的视频可以在我B站空间里看到：https://space.bilibili.com/355567627

前提

Windows端

安装：

1. Node.js
2. Git
3. 文本编辑软件(e.g. HBuilderX、vim等)

上述工具，如果不知道怎么安装；参考视频：https://www.bilibili.com/video/BV1FE411A7ob

Mac端

1. 安装Homebrew：Homebrew
2. 安装Node

使用Homebrew安装Node：

brew install node

Linux端

可以针对Linux，只需要可以使用yum、apt-get即可。

Linux (Ubuntu, Debian):

sudo apt-get install git-core
sudo apt-get install node

Linux (Fedora, Red Hat, CentOS)：

sudo yum install git-core
sudo yum install node

创建Hexo目录

Windows

Windows创建Hexo目录，再简单不过了；只需要在你知道的地方：右键鼠标-新建文件夹-重命名文件夹：

其中，文件夹命名随意；但是要知道路径；后期需要cmd或使用powershell等shell，切换进入文件夹内：

Mac

在你熟悉的电脑硬盘位置创建一个Hexo博客的文件夹（以后对Hexo的操作，均在文件夹内完成），并使用cd命令进入。如：

mintimate@MintimateMacBook-Pro ~ % pwd #查看当前Terminal所在位置
/Users/mintimate
mintimate@MintimateMacBook-Pro ~ % mkdir hexo #我创建一个叫hexo的空文件夹
mintimate@MintimateMacBook-Pro ~ % cd hexo #切换Terminal到刚刚创建的文件夹内
mintimate@MintimateMacBook-Pro Downloads % pwd
/Users/mintimate/hexo

Linux

Linux的操作和Mac相似，也是创建一个Hexo的文件夹，然后cd进入;以后Hexo操作，均在创建的文件夹内完成：

root@VM-4-13-ubuntu:/~$ pwd #查看当前Terminal所在位置
/
root@VM-4-13-ubuntu:/~$ mkdir hexo #我创建一个叫hexo的空文件夹
root@VM-4-13-ubuntu:/~$ cd hexo #切换Terminal到刚刚创建的文件夹内
root@VM-4-13-ubuntu:/hexo~$ pwd
/hexo

部署Hexo本地服务

使用Npm安装Hexo

因为Node里自带Npm，所以我们可以直接使用Npm；这一步，总的来说，就是：npm install -g hexo；为了方便国内用户，提前加了一步更换npm为腾讯云源，非大陆用户可以跳过，Windows用户打开cmd或powershell输入，Mac和Linux用户可以直接在Terminal内输入：

npm config set registry http://mirrors.cloud.tencent.com/npm/

Windows

在安装Node.js和Git以后，Windows用户打开cmd或powershell输入：

npm install -g hexo

Mac/Linux

终端输入：

npm install -g hexo

安装好以后，测试一下：

hexo

没有出现未知命令，说明安装成功。可以接下来操作了。

初始化Hexo

刚刚我们已经切换到Hexo目录，后续操作均在Hexo目录内进行。确保：

• Windows用户确保cmd或powershell运行目录在刚刚创建的的Hexo文件夹内；
• Mac或Linux用户确保Termminal运行目录在刚刚创建的的Hexo文件夹内；
• 注意⚠️：这个目录，日后就是是博客运行目录了。记得备份该文件夹。

在目录内初始化博客

初始化Hexo：

hexo init

构建Hexo

初始化Hexo后，其实Hexo就可以使用了；构建Hexo：

hexo g

会在当前目录下生成一个叫public的文件夹，这个文件夹就是根据你Hexo的配置，生成的HTML+CSS+JS的静态文件了。

启动Hexo内建服务器

其实，整个public文件就是一个博客了，但是我们还要部署Nginx等网络环境或者使用HBuilderX等根据，启动Web服务器才能用浏览器本地IP(即：127.0.0.1或localhost)加端口进行访问；为了减少麻烦，可以使用Hexo内建服务器：

hexo s

如果出现未知命令，先执行：

npm install hexo-server --save

执行完成后，再执行hexo s即可。

完成上述操作，你所使用的工具，进入交互模式，Terminal/cmd/powershell显示：

INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

这个时候。浏览器访问：127.0.0.1:4000或localhost:4000即可访问博客:

部署Hexo到远程平台

上诉操作，我们已经把Hexo部署在本地；接下来，我们来看看怎么部署到远程平台，部署到远程平台后，公网用户就可以访问了（也就是可以让你小伙伴通过浏览器访问到你的博客）。

部署Hexo到GitHub

GitHub创建仓库

到Github上创建仓库

注意：为了能通过 <你的 GitHub 用户名>.github.io 域名访问，你的仓库（repository） 应该直接命名为:

<你的 GitHub 用户名>.github.io

比如：你的用户名叫：Demo；

那么，你就创建一个仓库叫：Demo.github.io

本地安装hexo-deployer-git

hexo目录下，使用命令窗口/终端输入：

npm install hexo-deployer-git --save

图中Demo文件夹为Hexo目录

修改本地配置文件

打开hexo目录下的_config.yml文件，编辑（这边的可以用记事本、Xcode、HBuilderX），type后的' ',填'git'，然后补上其他内容：

部署

在hexo目录下命令窗口/终端输入

hexo d

会出现提示框：

输入Github 的账号密码即可。

访问博客

这个时候，浏览器打开：Demo.github.io

部署Hexo到Gitee

因为一些原因，国内用户访问GitHub经常会出现无法访问或访问过慢的问题；所以，部署到Gitee是一个不错的选择。但是需要注意：

Gitee无法自定义域名，也就是你无法绑定自己的域名；且后续官方开放域名绑定、解析，也需要备案域名，不如直接部署到个人服务器或静态托管。

创建仓库

首先访问：Gitee:https://gitee.com

创建自己的账号（可能需要实名哦），然后添加仓库，和GitHub规则一样，如果你想使用username.gitee.io来访问，那么创建的仓库名就以username.gitee.io来创建。如：

你的用户名：Demo

那么创建仓库名：Demo.gitee.io

开启Gitee Pages

访问刚刚搭建的仓库，选择Gitee Pages服务：

根据提示，开启即可。

设置本地Hexo配置

和刚刚GitHub部署一样，这里我们设置一下Hexo目录下的_config.yml文件，找到deploy字段，更改type和添加字段：

deploy:
  type: git
  repo: git@gitee.com:Demo/Demo.gitee.io.git
  branch: master

注意替换字段Demo

本地Deploy到仓库

完成上述操作后，我们就可以进行部署了。在Hexo目录下，terminal/cmd/powershell输入：

hexo d

之后会让你输入一次Gitee的秘密，输入后会推送本地public文件夹到Gitee仓库。你和小伙伴就可以通过浏览器进行访问。

部署Hexo到个人服务器

安装服务器依赖--Git

apt install git-core -y

配置服务器环境

创建空白 git 仓库，并且设置 git hook:

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

配置post-receive到服务器

在 /root/hexo.git/hooks 创建配置文件 post-receive，并且填写以下代码

#!/bin/bash
GIT_REPO=/root/hexo.git  #git仓库
TMP_GIT_CLONE=/tmp/hexo
PUBLIC_WWW=/var/www/html #网站目录
rm -rf ${TMP_GIT_CLONE}
git clone $GIT_REPO $TMP_GIT_CLONE
rm -rf ${PUBLIC_WWW}/*
cp -rf ${TMP_GIT_CLONE}/* ${PUBLIC_WWW}

赋予post-receive脚本的执行权限

cd /root/hexo.git/hooks
chmod +x post-receive

本地安装hexo-deployer-git

hexo目录下，使用命令窗口/终端输入：

npm install hexo-deployer-git --save

图中Demo文件夹为hexo目录

配置本地 _config.yml

修改deploy选项：

deploy:
  type: git
  message: update
  repo: root@IP:/root/hexo.git
  branch: master

这个时候，输入

hexo d

即可把本地的Hexo，传入服务器上了。记得用nginx映射Hexo的网站目录嗷。

部署Hexo到腾讯云静态托管

部署到腾讯云静态托管，好处：

• 拥有CDN加速，国内和国外访问极速快
• 相对于服务器，价格更便宜
• 自己域名没有备案，可以使用腾讯云提供的临时域名

其缺点有：

• 临时域名有访问限制
• 绑定自己的域名，域名需要备案
• 相对于在GitHub和Gitee上部署，这个方法需要一定开支

虽然需要钱，但是开支很低。如果你是图床和博客分离，50篇博文的Hexo博客，不到30M，所以基本只有流量费用。流量费用，流量费是阶梯收费，正常一个月不到5元。

申请静态网站托管

首先，我们访问腾讯云静态托管

在选择了静态托管后，进入控制台

获取并辅助环境id:

假设：你的环境id是blogger-000

推送本地博客到静态托管

推送很简单，在本地使用：

hexo g

生成博客后，在Hexo目录下，生成public文件夹。进入这个文件夹，并执行tcb命令:

cd public
tcb hosting deploy -e blogger-000

注意替换blogger-000为你自己的环境id。

这样，就把本地Hexo文件推送到腾讯云静态托管内。具体腾讯tcb命令使用，可以参考腾讯云官方文档

访问静态托管博客

根据你设置的自定义域名或默认域名即可访问：

注意：默认域名有访问限制，建议使用自定义域名。

使用Hexo写博客

使用Hexo博客引擎写博客很简单。简单来讲：创建新文章文件-使用Markdown语法编写文件-Hexo博客引擎编译-部署。

建议配合Hexo官方文档-写作一同查阅配置。

创建新文章文件

在Hexo目录下，使用terminal/cmd/powershell输入：

hexo new "New"

就创建了一篇新的博文，博文名字为New，所以实际写博客过程中，大家记得替换New为自己博客文章文件，该值决定最后Hexo编译后.html文件名。所以尽量使用英文创建。

在Hexo目录下的source-_posts文件夹内，就会出现刚刚创建的文章：New.md。

使用Markdown语法编写文件

为什么后缀名是.md？其实这是明示，该文件为Markdown语法文件。感觉Markdown语法，进行文章书写。

如果你不了解Markdown语法，可以花2分钟，了解学习一下

Hexo博客引擎编译

在写完博文后（.md文件），回到Hexo目录，使用terminal/cmd/powershell输入：

hexo g

即可编译完成，如果有错误，可以再尝试输入：

hexo clean
hexo g

如果还是出现错误，通常是设置的Hexo出现错误，需要检查自己设置。

Hexo进一步配置

建议配合：

• Hexo官方基础配置文档：https://hexo.io/zh-cn/docs/configuration

Hexo通用配置

我这里指的通用配置，指的是Hexo目录下_config.yml文件。最基础的：

# Site
title: Hexo
subtitle: ''
description: ''
keywords:
author: John Doe
language: en
timezone: ''

因为官方文档详细，不再赘述

Hexo使用主题

官方主题，总是无法满足大众需求。为此，可以使用第三方的主题。使用很简单，在安装好主题情况下，修改_config.yml内的：

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: landscape

landscape为自己安装的主题即可。推荐主题：

• Next Hexo主题：Hexo界的网红主题
• Fluid Hexo主题：国人开发的强大主题

以安装Next为例：

前往 NexT 版本 [发布页面[(https://github.com/iissnan/hexo-theme-next/releases) 。

选择你所需要的版本，下载 Download 区域下的 Source Code (zip) 到本地。例如，下载 v0.4.0 版本：

解压所下载的压缩包至站点的 themes 目录下， 并将 解压后的文件夹名称（hexo-theme-next-0.4.0）更改为 next:

最后，与前文Hexo 主题启用的模式一样。 当 克隆/下载 完成后，打开站点配置文件（_config.yml）， 找到 theme 字段，并将其值更改为 next：

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

之后在Hexo目录下，terminal/cmd/powershell启动hexo s即可看到效果。