通过Github搭建在线Hexo博客网站

所需工具

• Node.js
• Git

---

安装Hexo

1. 安装完所需工具后，打开CMD，依次查询工具的版本号：

node -v #查看node版本

npm -v #查看npm版本

git -v #查看git版本

---

2. 安装hexo，在CMD窗口中输入：

npm install -g hexo-cli

3. 等待安装完成后，输入以下命令查看hexo的版本：

hexo -v #查看hexo版本

• 此处大概率会显示查询不到版本号，需要手动添加hexo的目录到环境变量中，我的nodejs安装在D盘，所以hexo的安装目录在D:\nodejs\node_global，只需要把这个路径添加到Windows的环境变量中即可。

---

搭建本地博客

1. 在本地新建一个Blog文件夹，在该目录下右键，打开CMD，依次输入：

hexo init #初始化本地博客

hexo s #开启本地服务，就可以在浏览器中输入http://localhost:4000/，即可查看本地博客

---

使用Github搭建在线博客网站

1. 创建远程访问仓库：

登录Github官网，新建一个Repositories，在Repository name中输入：Your_Github_Name.github,io，点击Create repository即可。

2. 安装Hexo的Git部署工具，在CMD中输入：

npm install --save hexo-deployer-git

3. 安装完成后，打开博客根目录的_config.yml，拉到最下面，修改最后几行为：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: #你的Github仓库地址
  branch: master

4. 将本地博客部署到Github上，实现远程访问：

hexo d

期间可能需要输入你的Github用户名和密码，输入后即可将本地博客同步到Github

5. 修改Github远程网页显示分支：

访问你的Github仓库，点击步骤1新建的远程访问仓库，点击上方选项卡中的Settings，在左侧选项卡中，点击Pages，在Source下点击Branch:main选项框，选择master分支，点击右侧Save按钮即可。

完成上述步骤，即可实现远程访问博客，博客地址为：https://Your_Github_Name.github.io

6. 解决hexo d部署网站时git报错

报错信息：^{[1] [2]}

Permission denied (publickey).  
fatal: Could not read from remote repository.  
Please make sure you have the correct access rights

解决步骤：
打开 Git Bash ，执行：

ssh-keygen -t rsa -C "xxx@example.com"

xxx@example.com改成Github的邮箱地址；

第一步会询问你给密钥起什么名字，然后会让输入密钥的密码，可以都不填，直接回车。

ssh-agent -s

ssh-add ~/.ssh/id_rsa

默认名称为id_rsa，如果刚刚生成密钥时改了名，请修改成对应的名称。

执行后可能会报错：
Could not open a connection to your authentication agent

修复该问题执行如下命令：

ssh-agent bash

打开C盘目录：C:\Users\UserName\.ssh，里面会有一个公钥文件：id_rsa.pub，使用记事本打开，复制里面的所有内容，打开Github官网并登录，点击Settings > SSH and GPG keys > New SSH key，Title随便起个名称，Key type选择Authentication Key，在Key输入框中输入刚刚复制的内容，点击Add SSH key即可。

此时回到Git Bash中，输入以下命令测试是否成功连接：

ssh -T git@github.com

此时控制台输出：Hi dongxunz! You've successfully authenticated, but GitHub does not provide shell access.表示已经成功。

补充内容

每次修改本地博客后，需要先执行hexo cl清理一下本地缓存，然后使用hexo g重新生成博客网页文件，生成后输入hexo s在浏览器中查看修改是否正常，确认无误后，使用hexo d同步到Github，即可完成同步。

特别鸣谢

1. 【新手坑】GitHub常见问题解决「Permission denied (publickey)」 ↩
2. 解决git@github.com: Permission denied (publickey) ↩