本文最后更新于 2023-05-14,文章内容可能已经过时。

现不推荐使用Gitee部署了,如果可以还是用回Github吧

为何不使用GitHub部署?

由于目前国内访问GitHub速度慢,还可能被墙,所以使用Gitee来构建个人博客。Gitee类似国内版的GitHub,访问速度有保证

环境要求

  • Git
  • Node.Js
  • Hexo框架

开始搭建

搭建环境

一. 安装 Node.Js

Node.js的官网:https://nodejs.org/zh-cn/

进入Node.js的 官网 下载长期支持版(也就是稳定版)

  1. 打开刚下载完的安装程序
    选择 Next(下一步)

  2. 勾选 I accept the terms in the License Agreement 然后继续 Next

  3. 选择安装路径我这里因为演示就选择默认的安装路径了 选择完安装路径之后继续 Next

  4. 到了这一步我们默认就好;继续 Next

  5. 这里我们选择 Install(安装)

  6. 这里我们选择

  7. 等待安装完成。

  8. 安装完成后选择 Finish 关闭安装程序

  9. 按快捷键 Win+R 打开运行 在运行里输入 cmd 然后回车

  10. 测试 Node.js 是否安装成功
    在命令行里输入

node -v

如能正常显示版本号就代表安装成功我这里安装的是15.6的版本所以显示的是15.6 你们的请根据实际情况只要能正常显示版本号就可以了。如出现 “node -v”不是内部或外部命令,也不是可运行的程序或批处理文件。就代表没有安装成功。请卸载之后重新安装

二. 安装 Git

  1. 进入 Git 的 官网 选择 Download 2.30.1 for Windows 下载Git安装程序

注意:由于国内访问GIt官网的下载速度奇慢,所以这里我推荐使用淘宝镜像进行下载 (点我下载
从哪下载安装包看你个人的选择如果你愿意一直等那你可以选择从官网下载,我个人比较推荐使用国内的淘宝镜像源。

下载完成后打开安装程序 我们默认一直 Next 就好 所有的东西都不用修改

详细的安装步骤你们可以看这里:https://www.cnblogs.com/xueweisuoyong/p/11914045.html 他的版本是2.24.0.2 安装过程都大同小异。

三. 创建Gitee账户

Gitee官网: https://gitee.com/

注册过程我就不放图了;注册的姓名我建议使用全英文,姓名你可以随意起的但你一定要记住你起了什么姓名,建议不要使用自己的真实信息。

注册完成之后进入设置,添加邮箱

添加完邮箱之后在下面把主邮箱跟提交邮箱都设置成你刚刚添加的如下图所示

修改完成了之后你会在你添加的邮箱旁边看到 主邮箱提交邮箱两个标志

四. 使用Git创建SSH-RSA密钥然后复制到自己的Gitee里

  1. 在桌面空白的地方右键你会看到一个叫 Git Bash Here 点击打开它,如果你的右键菜单中没有那你也可以进入Git的安装目录里找到一个叫 git-bash.exe 的程序打开它也是一样的。

注意:.exe为程序的后缀名,我这里是安装在D盘,请根据你的实际情况查找你的路径

  1. 打开Git之后输入以下内容
ssh-keygen -t rsa -C “你刚刚在Gitee添加的邮箱地址“

然后会提示

Creates a new ssh key using the provided email # Generating public/private rsa key pair.
这个的意思是:使用你提供的电子邮件创建新的ssh密钥 #生成公共/私有rsa密钥对。
 
Enter file in which to save the key (/home/you/.ssh/id_rsa):
这个的意思是:保存密钥的文件(/home/you/.ssh/id\u rsa)

我们可以直接Enter(回车)就行。然后,会提示你输入密码,如下: 这个密码可以选择输入也可以不输入,如果输入了请务必记住你的密钥密码。

注:输入密码的过程中不会显示的,光标也不会移动,你以为没有输实际上已经输入了,你输入完直接回车即可

Enter passphrase (empty for no passphrase): [Type a passphrase]
这里我们因为演示就直接回车不输入密码
如果你输入了密码会提示你再次输入密码进行验证,如下;如果没有输入密码就不会提示下面这一行

Enter same passphrase again: [Type passphrase again]

等待一小会你就会看到类似以下内容

  1. 我们在存的路径里用记事本打开 id_rsa.pub 如下图所示,

  2. 然后我们将里面的内容 全部 复制到Gitee的SSH公钥里

五.安装Hexo框架

  1. 使用 Win+R 打开运行窗口输入 cmd

  2. 打开cmd后输入以下命令进行安装,下载过程可能会比较慢。请耐心等待 也可以使用淘宝的镜像源,具体方法请自行Google/Bing,我这里就直接使用官方的源。

npm install hexo-cli -g
  1. 安装完成之后你也可以输入命令来查看是否安装成功
hexo -v

如出现以下内容,说明安装成功。

六. 创建hexo文件夹

这里开始就正式部署了,不用害怕错了,错了大不了把整一个文件夹删了重新来。

  1. 在电脑任意地方创建hexo文件夹(文件夹名可随意起,最好是英文的,我这里就叫bolg) 我这里就直接在 D盘 根目录里创建这个文件夹我们在D盘的地址栏内输入 cmd 然后回车如下图

  2. 打开 cmd 之后输入命令进行安装

注:blog 是文件夹的名称 这里你们可以随意修改但建议是全英文的。

hexo init blog
  1. 安装完成之后使用命令进入到刚刚创建的文件夹里,如下图,如返回 D:\你的文件夹名称> 就代表成功进入
cd blog
  1. 然后继续使用命令来安装hexo的依赖,
npm install
  1. 依赖安装完成之后即可运行hexo进行测试。
hexo s

hexo server

注意:在Hexo运行的过程中cmd命令窗不能关闭 要一直运行着不然是无法访问的

  1. 当你在浏览器中看到这个页面说明你的本地博客已经成功搭建了。我们在CMD命令窗里按Ctrl+C或直接关闭掉命令窗,停止运行。

七、创建仓库

  1. 修改个人空间地址 进入设置页面 修改一个你自己喜欢的用户名(这里不能使用中文)。

  2. 创建的仓库名建议跟你的Gitee账户的用户名一致,这样子部署的才会是在域名的根目录上而不是在二级目录上(用户名就是你刚才修改的那个)(因为我这里已经创建过一个仓库了所以我这里就创建一个名叫CS的仓库你们就正常的创建即可)。

  3. 创建完之后理论上它会不会自动跳转到仓库里,如果没自动跳转那你就在上方点击我的然后选择相应的仓库,进入仓库之后你们会看到仓库未初始化,我们到 管理 里面进行仓库的初始化。(初始化完成后我们回到 代码)

八、修改config.yml文件并做首次推送。

  1. 在博客的根目录里找到 _config.yml 文件右键使用文本编辑器打开如 (EditPlus, Visual Studio Code)等,如果没有这些软件你可以去下载一个或者简单粗暴直接使用记事本打开(TXT),我这里还是建议大家使用文本编辑器。这里为了迎合小白就使用TXT打开了。

  2. 打开之后找到并修改以下内容。

# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title:  # 这个是页面标题
subtitle: # 这个是页面副标题
description:  # 这个是百度等搜索引擎的介绍
keywords:  # 这个是百度等搜索引擎的搜索关键字
author:  # 这个是该文章的作者
language: zh-CN  # 这个是博客的语言
timezone: 'Asia/Shanghai'  # 这个是时区  我这里输入的是亚洲/上海

# 以上内容都可自定义

然后我们修改推送地址

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git  # 这个是推送方式我们在这里输入 git
  repo: # 这个是仓库的地址我们可以在仓库的左上角有一个 克隆/下载 点击之后选择HTTPS然后在地址后面有一个复制,复制了之后粘贴到这里。
  #注:地址后面的那个.git 须要保留不能删除
  branch: master  # 这个是分支,可以在仓库的左测找到。

如下:

修改完以上信息之后我们保存并使用命令推送到仓库里。

在博客根目录的空白地方右键,选择 Git Bash Here

然后在命令窗内输入以下内容,然后回车

hexo cl && hexo g && hexo d 

这些命令分别是 清理缓存、生成缓存、推送到仓库 ,前面两步的作用就是刷新他的内容 后面一步就是推送到仓库 “&&” 这个是连接符 用来将多个命令连接起来的用的 ,回车运行之后正常的话会弹出来一个窗口让你输入Gitee的账号密码,你输入就可以了 ,账号我建议你们使用邮箱 不要使用手机号码 有时候会出错。输入完账号密码之后回车它会再次运行当你看到以下信息之后说明已经推送成功了,你可以到仓库里刷新页面就可以看到有文件了。

然后我们去到 服务 选择 Gitee Pages 进行部署

部署完成之后会自动给你分配一个地址(如下)

我们吧这个地址复制到 config.yml 文件的以下地方

# URL
## If your site is put in a subdirectory, set url as 'http://example.com/child' and root as '/child/'
url:   # 这里输入Gitee给你分配的地址,https://也不能删除
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:
pretty_urls:
  trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
  trailing_html: true # Set to false to remove trailing '.html' from permalinks

再重新使用命令推送一次

hexo cl && hexo g && hexo d 

推送成功之后我们在Gitee里刷新一下仓库然后进入到 Gitee Pages 里选择更新。等它更新完成之后就可以在使用它给你分配的域名访问了。

<完>