「建站」02 Github & SSH & node 基本配置

Greetings! ¶

Yaho~ ふちゃんです！(> ▽ <) /~

想要制作一个个人博客网站，我们需要这些东西的帮助：

• Github：用来存储我们的网站的源代码（也有其他替代方案）
• SSH：用来连接我们的电脑和Github
• node：即Node.js用来运行Hexo（下一节会介绍）

我们将会在这一节中介绍如何使用对以上的3个工具进行基本配置。

0. Note! ¶

我会用<<>>来表示每个人情况不同的内容。（如每个人的路径与邮箱）

1. Prerequirements ¶

确保你已经在你的电脑上安装了git和ssh。

在你的终端中运行git和ssh。如果出现command not found之类的内容的话说明你还没有安装它们。对于我的系统（Linux Mint 21.1），我可以使用以下命令来安装它们：

sudo apt install git ssh

2. 定义git的用户名和邮箱与生成SSH密钥 ¶

2.1 定义git的用户名和邮箱 ¶

在terminal中运行以下命令来定义你的用户名和邮箱：

git config --global user.name <<你的用户名>>
git config --global user.email <<你的邮箱>>

否则你在使用git时会出现以下错误：

*** Please tell me who you are.

Run

  git config --global user.email "

  git config --global user.name "

to set your account's default identity.
Omit --global to set the identity only in this repository.

2.2 生成SSH密钥 ¶

• SSH密钥用于连接你的电脑和Github。

在terminal中运行以下命令来生成你的SSH密钥：

• 注意：你在这里输入的邮箱应该和你注册Github账号时使用的邮箱相同。

ssh-keygen -t rsa -C <<你的邮箱>>

其中：

• -t：指定密钥类型，这里我们使用rsa。
• -C：指定注释，这里我们使用你的邮箱。

然后按照提示来生成你的SSH密钥。（为了方便，你可以直接按Enter来使用默认值。但你也可以指定你的SSH密钥的路径、名称和密码。但一定要你记下来。）

之后你会得到两个文件：id_rsa和id_rsa.pub，它们分别代表你的私钥和公钥。你可以在你指定的路径中找到它们。（默认路径是~/.ssh/id_rsa和~/.ssh/id_rsa.pub）

3. 将SSH密钥添加到Github ¶

• 添加SSH密钥到Github的目的是为了让你的电脑和Github之间可以互相认证。

3.1 复制你的公钥 ¶

在terminal中运行以下命令：

cat <<你的公钥的路径>>

然后你会看到你的公钥的内容。复制它。

3.2 将你的公钥添加到Github ¶

进入Github -> Settings -> SSH and GPG keys -> New SSH key并粘贴你的公钥以添加它。

4. 测试你的SSH密钥 ¶

在terminal中运行以下命令：

ssh -T <<你的邮箱>>

如果你看到类似Hi <<你的用户名>>! You've successfully authenticated, but GitHub does not provide shell access.的内容，那么你已经成功地将你的SSH密钥添加到了Github。

• 如果你的terminal卡在这里，可能是因为网络不好。

• 不需要一直等下去，鬼知道网络什么时候能好。只要不报错，建议直接跳到下一步。

5. 创建一个新的仓库（有特殊命名要求） ¶

让我们在Github上创建一个新的仓库并将它命名为<<你的用户名>>.github.io。（建议先勾选Add a README file，之后的hexo deploy的流程会自动删除它的。）

• 非常重要：我们需要使用Github Page，所以
  1. 你的仓库的名字必须是<<你的用户名>>.github.io，不要使用其他名字。
  2. 这个仓库必须是公开的！
  3. 在仓库创建完毕后，你需要在仓库的Settings -> Pages中将Source设置为main，并点击Save。（有时会自动设置好，我们需要确认一下。）

6. 安装node ¶

• node用于运行Hexo。

这里我们有两种选择：

	优点	缺点
直接安装node	简单	无法自定义node的版本
使用nvm安装node	可以自定义node的版本	略显繁琐

如果只是想简单地使用Hexo的话，直接安装node即可。

6.1 直接安装node ¶

在terminal中运行以下命令：

sudo apt install nodejs

• 如果你已经使用nvm安装过node，那么这里没有提示node已安装是正常的。（因为apt和nvm没有共享安装信息）

然后运行以下命令来，根据是否输出版本号来判断是否安装成功：

node -v

6.2 使用nvm安装node ¶

• nvm即node version manager，用于管理node的版本。

我们可以按照nvm的官方文档来安装它。

大致过程是下载nvm -> 安装nvm -> 安装node。

6.2.1. 下载与安装nvm ¶

见官方文档中Install & Update Script一节。

• 具体命令以官方文档为准！！！

运行以下两个命令中的任一个来下载并安装nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

或者

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

6.2.2. 安装node ¶

见官方文档中Usage一节。

有多种方式安装node，这里我们使用最简单的一种即可：

nvm install node

安装完成后，运行以下命令来判断是否安装成功：

node -v

如果输出了版本号，那么说明安装成功。

6.2.3. 补充 ¶

如有需要，请参考官方文档来使用nvm。（Recommend）

Summary ¶

做到这里，我们已经完成了“基础设施建设”。

下一步我们就要开始使用Hexo来建立我们的博客网站啦！

Have fun! 😉

上一节： 「建站」01 准备工作 - 建立自己的博客网站

下一节： 「建站」03 使用Hexo初步创建博客网站与本地预览