ssh_config

Author: xzh2004

docs/.vitepress/config/zh.ts

@@ -64,6 +64,7 @@ function sidebarGuide(): DefaultTheme.Sidebar {
       text: '附录',
       items: [
         { text: '提问的艺术', link: '/appendix/how-to-ask' },
+        { text: 'SSH 配置指南', link: '/appendix/ssh配置指南' },
       ]
     },
     {

docs/appendix/remote_explorer.png

@@ -0,0 +1,110 @@
+# SSH 配置指南
+
+本指南将帮助使用 macOS 系统的同学完成 SSH 密钥对的生成与配置，并连接到本课程提供的服务器环境进行实验。
+
+## 1. SSH 简介
+
+SSH（Secure Shell）是一种加密的网络传输协议，可以在不安全的网络中为网络服务提供安全的传输环境。通过 SSH，您可以安全地连接到远程服务器并执行命令。
+
+> [!tip]
+>
+> **为什么需要 SSH 密钥？**
+>
+> - **安全性**：相比密码登录，SSH 密钥更加安全
+> - **便利性**：配置完成后无需每次输入密码
+> - **自动化**：支持脚本自动化操作
+
+如果你好奇密钥是如何工作的，可以参考[这篇文章](https://www.ruanyifeng.com/blog/2011/08/what_is_a_digital_signature.html)   。
+
+## 2. 生成 SSH 密钥对
+
+### 检查现有密钥
+
+在生成新密钥之前，先检查是否已经存在 SSH 密钥：
+
+```bash
+# 在终端输入以下命令
+ls -la ~/.ssh
+```
+
+如果目录不存在或为空，说明您还没有 SSH 密钥，可以继续下面的步骤。
+
+> [!tip]
+>
+>如果您有 `id_rsa` 和 `id_rsa.pub` 文件，说明您已经有 SSH 密钥对了。可以移步到配置服务器连接。
+
+### 生成新的密钥对
+
+在终端中输入以下命令生成 SSH 密钥对：
+
+```bash
+# 在终端输入，替换自己的邮箱地址
+ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
+```
+
+执行上述命令后，系统会提示您进行一系列配置：
+
+   ```bash
+   # 连按三个回车即可
+   Enter file in which to save the key (/Users/yourusername/.ssh/id_rsa):
+   Enter passphrase (empty for no passphrase):
+   Enter same passphrase again:
+   ```
+
+### 验证密钥生成
+
+密钥生成完成后，您可以查看生成的文件：
+
+```bash
+ls -la ~/.ssh
+```
+
+您应该能看到以下文件：
+
+- `id_rsa`：私钥文件（请妥善保管，不要泄露）
+- `id_rsa.pub`：公钥文件（可以安全地分享给服务器）
+
+查看公钥内容：
+
+```bash
+cat ~/.ssh/id_rsa.pub
+```
+
+观察到输出为：`ssh-rsa xxxxxxxxxxxxxxx = xxxxx@xxxx.xx` 即正确
+
+## 3. 将服务器与 VS Code 连接
+
+### 在 VS Code 中，安装对应拓展
+
+   ![remote_explorer](remote_explorer.png)
+
+### 配置文件
+
+- 在左侧找到形如电脑的图标
+- 点击SSH旁边的齿轮
+- 进入默认配置文件
+
+![ssh_config](ssh_config2.png)
+
+### 连接服务器
+
+- 点击SSH旁边的加号，新建远程
+- 在图中所示方框中输入以下命令连接到服务器：
+
+```bash
+ssh root@服务器地址 -p 端口号
+```
+
+   ![ssh_server](ssh_server2.png)
+
+   首次连接时，系统会显示服务器的指纹信息并询问是否信任：
+
+   ```bash
+   The authenticity of host 'xxxxxxx' can't be established.
+   ECDSA key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
+   Are you sure you want to continue connecting (yes/no/[fingerprint])?
+   ```
+
+   输入 `yes` 并按回车键继续。
+
+   如果配置正确，您应该能够成功登录到服务器而无需输入密码。