Hexo GitHub设置

引言

这篇将介绍如何将自己的Hexo 博客，推送到Github 上供外网访问。 当然有条件的同学可以自己搭建服务器将Hexo生成的静态文件直接FTP部署到服务器上即可。

GitHub设置

• 创建Repository

  注册账号，然后创建Repository，仓库名称必须是 your_user_name.github.io，这里我的Github用户名是 luoyedemeng ,则仓库名称是 luoyedemeng.github.io。

  

• 创建SSH Keys

  打开Mac terminal,输入下面 command

  $ ls -al ~/.ssh

  如果出现下图中的id_rsa.pub/id_ecdsa.pub/id_ed25519.pub 任何一个说明你电脑已有公钥，可跳过下面创建SSH的步骤

  

  如果提示 no such file or directory说明你是第一次使用git，需要创建SSH，按照下面步骤继续操作

  输入下面command ,邮箱是你github email地址

  $ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

  接下来的所有输入默认直接 Press Enter即可

  $ ssh-keygen -t rsa -C "你的邮箱地址"
  Generating public/private rsa key pair.
  Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回车>
  Enter passphrase (empty for no passphrase):<输入加密串><如不想设置密码可直接回车表示为空>
  Enter same passphrase again:<再次输入加密串><接着回车确认>
  Your identification has been saved in /Users/你的名字/.ssh/id_rsa).
  Your public key has been saved in /Users/你的名字/.ssh/id_rsa.pub.
  The key fingerprint is:
  43:c5:5b:5f:b1:f1:50:43:ad:20:a6:92:6a:1f:9a:3a "你的邮箱地址"

  最后出现类似长方形的字符画即表示成功，接下来将生成好的SSH Key添加进GitHub。

• 配置SSH Keys

  打开本地刚生成的.ssh/id_rsa.pub，默认目录：/Users/your_user_directory/.ssh/id_rsa ，如果你生成SSH Key时自定义了路径，请到相应的目录下。

  如果在目录下找不到文件夹，请显示隐藏文件夹即可。快捷键：command+shift+.

  准确复制文件中所有内容，进入github主页，点击右上角头像进入settings，选择SSH and GPG keys，再点击New SSH Key。将内容复制进key，title可以为空。最后Add SSH key。

  输入下面command 测试是否成功

  $ ssh -T git@GitHub.com

  出现下面内容，则说明SSH Keys配置成功了！

  The authenticity of host 'GitHub.com (207.97.227.239)' can't be established.
  RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
  Are you sure you want to continue connecting (yes/no)?<输入yes>
  Hi kerryli1007! You've successfully authenticated, but GitHub does not provide shell access.

参考链接：Connecting to Github with SSH 参考博客

设置推送到GitHub

修改 MyHexoBlog目录下的 _config.yml文件，查询找到 deploy 配置如下：

deploy:
  type: git
  repo: git@github.com:user_name/user_name.github.io.git  # user_name是你github 用户名
  branch: master

修改后保存，然后执行command 安装部署插件（参考问题1）

$ npm install hexo-deployer-git --save

再执行配置命令hexo deploy就可以在浏览器中打开链接http://user_name.github.io/ 就可以看到自己的博客了。（参考问题2）

相关命令

每次部署可以按以下步骤来执行：

$ hexo clean
$ hexo g
$ hexo deploy

其他一些常用命令

$ hexo new"postName" #新建文章
$ hexo new page"pageName" #新建页面
$ hexo generate #生成静态页面至public目录
$ hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
$ hexo deploy #将.deploy目录部署到GitHub
$ hexo help # 查看帮助
$ hexo version #查看Hexo的版本

设置自己的域名

在Hexo的source目录下添加CNAME文件，没有任何后缀，在文件中填写要绑定的域名，如www.user_name.net。
然后设置域名解析，添加解析设置，纪录类型为CNAME,主机纪录www，解析线路为默认，然后纪录值填写github项目名称，如user_name.github.io，保存。
在Hexo中重新部署生成即可用自己的域名访问博客了。

也可以不用上述操作，添加解析设置时，选择记录类型为A(执行IP地址)。

参考地址： 域名绑定

出现问题

1. 安装Deployer插件时up主这边报错，提示 No Xcode or CLT version detected !

   

   执行以下Command 安装

   $ sudo rm -rf $(xcode-select -print-path)
   $ xcode-select --install

   会弹出下载安装向导，点击安装即可。

   安装完成后再执行 npm install hexo-deployer-git --save，显示安装成功。

   

2. 执行hexo deploy 部署时报错 fatal: The remote end hung up unexpectedly

   

   是由于上传大小超过了git的限制。

   我们找到 /Users/your_user_directory/your_blog_name/.deploy_git/.git/config添加下图内容进去，保存。（command+shift+. 显示隐藏文件夹）

   

   参考：地址

   再执行 hexo deploy,显示成功。

   

打赏