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

所需工具

• Node.js
• Git

---

安装Hexo

1. 安装完所需工具后，依次查询各工具的版本号

   node -v #查看node版本
   
   npm -v #查看npm版本
   
   git -v #查看git版本

2. 安装hexo

   npm install -g hexo-cli

3. 查看hexo的版本

   hexo -v #查看hexo版本

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

搭建本地博客

在本地磁盘新建一个Blog文件夹，进入该目录，打开CMD，依次执行以下命令。

hexo init #初始化本地博客

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

搭建在线博客

本教程使用Github来搭建在线博客，当然也可以使用云服务器和线上域名来搭建，具体操作方法可以Bing一下。

1. 创建远程访问仓库：
   登录Github官网，新建一个Repositories，在Repository name中输入：Your_Github_Name.github.io，点击Create repository即可。

2. 安装Hexo的Git部署工具

   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远程网页显示分支
   浏览器打开步骤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) ↩