SSH.md 13.7 KB
Newer Older
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
1
# SSH密钥[](#ssh "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
2

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
3
Git 是一个分布式版本控制系统,这意味着您可以在本地工作. 此外,您还可以将更改共享或"推送"到其他服务器. CODEChina 支持使用 SSH 密钥在 Git 及其服务器之间进行安全通信.
Lab机器人's avatar
readme  
Lab机器人 已提交
4

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
5
SSH 协议提供的这种安全机制,并允许您向 CODEChina 远程服务器进行身份验证,而无需每次都提供用户名或密码,我们推荐您使用这种方式来作为您推拉代码的凭据。
Lab机器人's avatar
readme  
Lab机器人 已提交
6

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
7
通过阅读本文档可以帮助您配置安全的 SSH 密钥,这些密钥可用于帮助保护与 CODEChina 代码仓库的安全连接。
Lab机器人's avatar
readme  
Lab机器人 已提交
8

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
9 10 11
*   如果您需要有关创建 SSH 密钥的信息,请从我们的[ SSH 密钥选项](#options-for-ssh-keys)开始
*   如果您有专用于 CODEChina 帐户的 SSH 密钥,则可能对[使用非默认 SSH 密钥对路径](#working-with-non-default-ssh-key-pair-paths)感兴趣
*   如果您已经有了 SSH 密钥对,则可以转到[将 SSH 密钥添加到 CODEChina 帐户的方法](#adding-an-ssh-key-to-your-gitlab-account) 
Lab机器人's avatar
readme  
Lab机器人 已提交
12

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
13
## 环境要求[](#requirements "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
14

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
15
为了支持 SSH,CODEChina 需要安装 OpenSSH 客户端,该客户端已预装在 GNU / Linux 和 macOS 上,但未预先安装在 Windows 上。
Lab机器人's avatar
readme  
Lab机器人 已提交
16

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
17
我们要求您使用 SSH 6.5 或更高版本,因为它不包括现在不安全的 MD5 签名。您可以通过下命令查看系统上安装的 SSH 版本:
Lab机器人's avatar
readme  
Lab机器人 已提交
18 19 20 21 22

```
ssh -V 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
23
## SSH 密钥选项[](#options-for-ssh-keys "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
24

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
25
CODEChina 支持使用 RSA,DSA,ECDSA 和 ED25519 密钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
26

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
27
**提示:**现有文档表明 ED25519 更安全,如果使用 RSA 密钥,则美国国家科学技术研究院[出版物 800-57 第 3 部分(PDF)](https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-57Pt3r1.pdf)建议密钥大小至少为 2048 位。
Lab机器人's avatar
readme  
Lab机器人 已提交
28

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
29
因此,我们主要介绍 ED25519 和 RSA 这两种密钥的使用方法。
Lab机器人's avatar
readme  
Lab机器人 已提交
30

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
31
## 查看现有的 SSH 密钥[](#review-existing-ssh-keys "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
32

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
33
如果您已有 SSH 密钥,则可以使用它们来与 CODEChina 的代码库进行连接。 默认情况下,Linux 和 macOS 系统上的 SSH 密钥存储在用户的主目录中的`.ssh/`子目录中,下表包括每种 SSH 密钥算法的默认文件名:
Lab机器人's avatar
readme  
Lab机器人 已提交
34

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
35
| 算法 | 公钥 | 私钥 |
Lab机器人's avatar
readme  
Lab机器人 已提交
36 37 38 39 40 41
| --- | --- | --- |
| ED25519(首选) | `id_ed25519.pub` | `id_ed25519` |
| RSA(至少 2048 位密钥大小) | `id_rsa.pub` | `id_rsa` |
| DSA(已弃用) | `id_dsa.pub` | `id_dsa` |
| ECDSA | `id_ecdsa.pub` | `id_ecdsa` |

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
42
有关建议,请查看[SSH 密钥的选项](#options-for-ssh-keys)
Lab机器人's avatar
readme  
Lab机器人 已提交
43

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
44
## 生成 SSH 密钥[](#generating-a-new-ssh-key-pair "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
45

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
46
SSH 密钥的生成方式如下:
Lab机器人's avatar
readme  
Lab机器人 已提交
47

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
48 49
*   ED25519 密钥,请查看[ED25519 SSH 密钥](#ed25519-ssh-keys)
*   RSA 密钥,请查看[RSA SSH 密钥](#rsa-ssh-keys) 
Lab机器人's avatar
readme  
Lab机器人 已提交
50 51 52

### ED25519 SSH keys[](#ed25519-ssh-keys "Permalink")

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
53
[Practical Cryptography With Go](https://leanpub.com/gocrypto/read#leanpub-auto-chapter-5-digital-signatures) 一书中表明 [ED25519](https://ed25519.cr.yp.to/) 密钥比 RSA 密钥更为安全。
Lab机器人's avatar
readme  
Lab机器人 已提交
54

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
55
2014年 OpenSSH 6.5 引入 ED25519 SSH 密钥后,当前任何操作系统都可用使用这种密钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
56 57 58 59 60 61 62

您可以使用以下命令创建和配置 ED25519 密钥:

```
ssh-keygen -t ed25519 -C "<comment>" 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
63
`-C`(例如带引号注释的电子邮件地址)是标记 SSH 密钥的可选方法。
Lab机器人's avatar
readme  
Lab机器人 已提交
64 65 66 67 68 69 70 71 72 73

您将看到类似于以下内容的响应:

```
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519): 
```

要获得指导,请继续执行[常见步骤](#common-steps-for-generating-an-ssh-key-pair) .

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
74
### RSA SSH 密钥[](#rsa-ssh-keys "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
75

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
76
如果您使用 RSA 密钥生成 SSH 密钥,则我们建议您至少使用 [ 2048 位](https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-57Pt3r1.pdf)的密钥大小. 默认情况下, `ssh-keygen`命令创建一个 1024 位 RSA 密钥.
Lab机器人's avatar
readme  
Lab机器人 已提交
77

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
78
您可以使用以下命令创建和配置 RSA 密钥,如果需要,可以生成建议的最小密钥大小`2048`
Lab机器人's avatar
readme  
Lab机器人 已提交
79 80 81 82 83

```
ssh-keygen -t rsa -b 2048 -C "email@example.com" 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
84
`-C`标志(例如带引号注释的电子邮件地址)是标记 SSH 密钥的可选方法。
Lab机器人's avatar
readme  
Lab机器人 已提交
85 86 87 88 89 90 91 92

您将看到类似于以下内容的响应:

```
Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa): 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
93
要获得指导,请继续执行[常见步骤](#common-steps-for-generating-an-ssh-key-pair)
Lab机器人's avatar
readme  
Lab机器人 已提交
94

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
95
**注意:**如果您使用 7.8 或更低版本的 OpenSSH,请参考与[编码](#rsa-keys-and-openssh-from-versions-65-to-78)相关的问题。
Lab机器人's avatar
readme  
Lab机器人 已提交
96

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
97
### SSH 密钥生成步骤[](#common-steps-for-generating-an-ssh-key-pair "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
98

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
99
无论是创建[ED25519](#ed25519-ssh-keys)还是创建[RSA](#rsa-ssh-keys)密钥,您都从`ssh-keygen`命令开始。此时,您将在命令行中看到以下消息(以 ED25519 密钥为例):
Lab机器人's avatar
readme  
Lab机器人 已提交
100 101 102 103 104 105

```
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa): 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
106
如果您还没有 SSH 密钥对并且也没有生成[部署密钥](#deploy-keys) ,您可以按照系统提示的建议选择 SSH 密钥存储的文件和目录,SSH 客户端将使用默认配置来生成您的 SSH 密钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
107

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
108
当然,您也可以将新生成的 SSH 密钥保存在其他位置。您可以选择要分配的目录和文件名,您还可以为专用的[特定主机](#working-with-non-default-ssh-key-pair-paths) 生成SSH 密钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
109

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
110
在选择 SSH 密钥的保存路径后,您可以为 SSH 密钥设置[密码](https://www.ssh.com/ssh/passphrase/)
Lab机器人's avatar
readme  
Lab机器人 已提交
111 112 113 114 115 116

```
Enter passphrase (empty for no passphrase):
Enter same passphrase again: 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
117
如果成功,您将看到有关`ssh-keygen`命令将标识和私钥保存在何处的确认信息。
Lab机器人's avatar
readme  
Lab机器人 已提交
118

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
119
如有需要,您也可以使用以下命令更新密码:
Lab机器人's avatar
readme  
Lab机器人 已提交
120 121 122 123 124

```
ssh-keygen -p -f /path/to/ssh_key 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
125
### OpenSSH 6.5 ~ 7.8 的 RSA 密钥[](#rsa-keys-and-openssh-from-versions-65-to-78 "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
126

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
127
在 OpenSSH 7.8 之前,RSA 密钥的默认公共密钥指纹基于 MD5,因此并不安全。
Lab机器人's avatar
readme  
Lab机器人 已提交
128

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
129
如果您的 OpenSSH 版本介于 6.5 至 7.8(含)之间,请使用`-o`选项运行`ssh-keygen` ,以更安全的 OpenSSH 格式保存您的 SSH 私钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
130

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
131
如果您已经具有可用于 CODEChina 的 RSA SSH 密钥,请考虑对其进行升级以使用更安全的密码加密格式。 您可以使用以下命令进行操作:
Lab机器人's avatar
readme  
Lab机器人 已提交
132 133 134 135 136 137 138 139 140 141 142

```
ssh-keygen -o -f ~/.ssh/id_rsa 
```

或者,您可以使用以下命令以更安全的加密格式生成新的 RSA 密钥:

```
ssh-keygen -o -t rsa -b 4096 -C "email@example.com" 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
143
**注意:**ED25519 已将密钥加密为更安全的 OpenSSH 格式。
Lab机器人's avatar
readme  
Lab机器人 已提交
144

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
145
## 在您的 CODEChina 账号中添加 SSH 密钥[](#adding-an-ssh-key-to-your-account "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
146

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
147
现在,您可以将创建好的 SSH 密钥复制到您的 CODEChina 帐户。您可以参考以下步骤:
Lab机器人's avatar
readme  
Lab机器人 已提交
148

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
149
1.  从以文本格式保存 SSH 密钥的位置复制您的**公共** SSH 密钥,以下命令可以将 ED25519 的信息保存到指定操作系统的剪贴板中:
Lab机器人's avatar
readme  
Lab机器人 已提交
150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168

    **macOS:**

    ```
    pbcopy < ~/.ssh/id_ed25519.pub 
    ```

    **Linux(需要 xclip 软件包):**

    ```
    xclip -sel clip < ~/.ssh/id_ed25519.pub 
    ```

    **Windows 上的 Git Bash:**

    ```
    cat ~/.ssh/id_ed25519.pub | clip 
    ```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
169
    如果您使用的是 RSA 密钥,相应地替换即可。
Lab机器人's avatar
readme  
Lab机器人 已提交
170

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
171
2.  打开`https://codechina.csdn.net`并登录
Lab机器人's avatar
readme  
Lab机器人 已提交
172
3.  选择右上角的头像,然后单击**设置**
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
173 174 175 176 177
4.  单击 **SSH 密钥**.
5.  将复制的公共密钥粘贴到**密钥**文本框中.
6.**标题**文本框中设置您密钥的名称,例如 *工作笔记本电脑**家用电脑* 
7.  在"过期于"中设置密钥的过期日期(可选)
8.  单击**添加密钥**按钮
Lab机器人's avatar
readme  
Lab机器人 已提交
178

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
179
按照上述步骤添加的 SSH 密钥即使"过期"后在工作流程中仍然有效,由于配置的到期日期信息并不包含在 SSH 密钥本身中,因此您仍然可以根据需要导出公共 SSH 密钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
180

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
181
**注意:**如果您手动复制了公共 SSH 密钥,请确保复制了整个密钥,以`ssh-ed25519` (或`ssh-rsa` )开头,并以您的电子邮件地址结尾。
Lab机器人's avatar
readme  
Lab机器人 已提交
182

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
183
## 测试 SSH 密钥是否能够正常工作[](#testing-that-everything-is-set-up-correctly "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
184

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
185
要测试是否正确添加了 SSH 密钥,可以在终端中运行以下命令:
Lab机器人's avatar
readme  
Lab机器人 已提交
186 187

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
188
ssh -T git@codechina.csdn.net
Lab机器人's avatar
readme  
Lab机器人 已提交
189 190
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
191
在您第一次通过 SSH 方式连接到 CODEChina的时候,将会询问您是否信任将要连接的 CODEChina host地址。当确认 `yes` 后,会将 CODEChina 作为已知主机添加到受信任的 hosts 地址中:
Lab机器人's avatar
readme  
Lab机器人 已提交
192 193

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
194
The authenticity of host 'codechina.csdn.net (121.36.6.22)' can't be established.
Lab机器人's avatar
readme  
Lab机器人 已提交
195 196
ECDSA key fingerprint is SHA256:HbW3g8zUjNSksFbqTiUWPWg2Bq1x8xdGUrliXFzSnUw.
Are you sure you want to continue connecting (yes/no)? yes
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
197
Warning: Permanently added 'codechina.csdn.net' (ECDSA) to the list of known hosts. 
Lab机器人's avatar
readme  
Lab机器人 已提交
198 199
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
200
一旦添加到已知主机列表中,将不再要求您再次验证 CODEChina 主机的真实性。 再次运行以上命令时,您将只收到*欢迎使用 CODEChina 的`@username` !* 信息。
Lab机器人's avatar
readme  
Lab机器人 已提交
201 202 203 204

如果未出现欢迎消息,则可以通过使用以下命令在详细模式下运行`ssh`来解决问题:

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
205
ssh -Tv git@codechina.csdn.net 
Lab机器人's avatar
readme  
Lab机器人 已提交
206 207
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
208
## 使用非默认路径的 SSH 密钥[](#working-with-non-default-ssh-key-pair-paths "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
209

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
210
如果您为 SSH 密钥对使用了非默认文件路径,请配置 SSH 客户端以指向 CODEChina 私有 SSH 密钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
211

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
212
可以运行以下命令进行配置:
Lab机器人's avatar
readme  
Lab机器人 已提交
213 214 215 216 217 218

```
eval $(ssh-agent -s)
ssh-add <path to private SSH key> 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
219
以上设置将会保存到`~/.ssh/config`文件中。以下是两个专用于 CODEChina 的 SSH 密钥示例:
Lab机器人's avatar
readme  
Lab机器人 已提交
220 221

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
222 223
# CODEChina
  Host codechina.csdn.net
Lab机器人's avatar
readme  
Lab机器人 已提交
224
  Preferredauthentications publickey
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
225
  IdentityFile ~/.ssh/codechina_rsa
Lab机器人's avatar
readme  
Lab机器人 已提交
226

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
227 228
# Github instance
  Host github.com
Lab机器人's avatar
readme  
Lab机器人 已提交
229
  Preferredauthentications publickey
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
230
  IdentityFile ~/.ssh/example_github_rsa 
Lab机器人's avatar
readme  
Lab机器人 已提交
231 232
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
233
公共 SSH 密钥对于 CODEChina 必须是唯一的,因为它们将绑定到您的账号中。 SSH 密钥是通过 SSH 推送代码时唯一的标识符,这是为什么它需要唯一地映射到单个用户的原因。
Lab机器人's avatar
readme  
Lab机器人 已提交
234

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
235
## 为项目设置 SSH 密钥[](#per-repository-ssh-keys "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
236

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
237
如果要根据正在使用的项目代码仓库使用不同的密钥,则可以在代码仓库中执行以下命令:
Lab机器人's avatar
readme  
Lab机器人 已提交
238 239 240 241 242

```
git config core.sshCommand "ssh -o IdentitiesOnly=yes -i ~/.ssh/private-key-filename-for-this-repository -F /dev/null" 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
243
这不使用 SSH 代理,并且至少需要 Git 2.10.
Lab机器人's avatar
readme  
Lab机器人 已提交
244

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
245
## 多账号设置[](#multiple-accounts-on-a-single-gitlab-instance "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
246

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
247
[为项目设置 SSH 密钥](#per-repository-ssh-keys)方法还适用于在 CODEChina 中使用多个账号的情况。
Lab机器人's avatar
readme  
Lab机器人 已提交
248

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
249
此外,您也可以直接在`~.ssh/config`为主机分配别名。 如果在`.ssh/config`中的`Host`块之外设置了`IdentityFile` ,则 SSH 和作为扩展的 Git 将无法登录. 这是 SSH 组装`IdentityFile`条目的方式,因此不能通过将`IdentitiesOnly`设置为`yes`来更改. `IdentityFile`条目应指向 SSH 密钥对的私钥。
Lab机器人's avatar
readme  
Lab机器人 已提交
250

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
251
**注意:**私钥和公钥应仅由用户读取,通过运行以下`chmod 0400 ~/.ssh/<example_ssh_key>`在 Linux 和 macOS 上完成此操作: `chmod 0400 ~/.ssh/<example_ssh_key>``chmod 0400 ~/.ssh/<example_sh_key.pub>`
Lab机器人's avatar
readme  
Lab机器人 已提交
252 253

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
254 255
# User1 Account Identity Host <user_1.codechina.csdn.net>
  Hostname codechina.csdn.net
Lab机器人's avatar
readme  
Lab机器人 已提交
256 257 258
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/<example_ssh_key1>

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
259 260
# User2 Account Identity Host <user_2.codechina.csdn.net>
  Hostname codechina.csdn.net
Lab机器人's avatar
readme  
Lab机器人 已提交
261 262 263 264
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/<example_ssh_key2> 
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
265
**注意:**为提高效率和透明度,示例`Host`别名定义为`user_1.codechina.csdn.net``user_2.codechina.csdn.net` 。 高级配置难以维护,使用这种别名在使用其他工具(如`git remote`子命令)时会更容易理解。 SSH 可以将任何字符串理解为`Host`别名,因此`Tanuki1``Tanuki2`尽管提供了很少的上下文指向它们,也可以使用.
Lab机器人's avatar
readme  
Lab机器人 已提交
266

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
267
克隆`CODEChina`代码仓库通常如下所示:
Lab机器人's avatar
readme  
Lab机器人 已提交
268 269

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
270
git clone git@gcodechina.csdn.net:repo-org/repo.git 
Lab机器人's avatar
readme  
Lab机器人 已提交
271 272
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
273
要为`user_1`克隆它,请将`codechina.csdn.net`替换为 SSH 别名`user_1.codechina.csdn.net`
Lab机器人's avatar
readme  
Lab机器人 已提交
274 275

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
276
git clone git@<user_1.codechina.csdn.net>:repo-org/repo.git 
Lab机器人's avatar
readme  
Lab机器人 已提交
277 278
```

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
279
使用`git remote`命令可以修复以前克隆的代码仓库。
Lab机器人's avatar
readme  
Lab机器人 已提交
280

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
281
以下的示例假定远程代码仓库被别名为`origin`
Lab机器人's avatar
readme  
Lab机器人 已提交
282 283

```
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
284
git remote set-url origin git@<user_1.codechina.csdn.net>:repo-org/repo.git 
Lab机器人's avatar
readme  
Lab机器人 已提交
285 286 287 288 289 290
```

### Eclipse[](#eclipse "Permalink")

如果使用的是[EGit](https://www.eclipse.org/egit/) ,则可以[将 SSH 密钥添加到 Eclipse](https://wiki.eclipse.org/EGit/User_Guide#Eclipse_SSH_Configuration) .

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
291
### Windows系统[](#options-for-microsoft-windows "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
292

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
293
如果您运行的是 Windows 10, [适用于 Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10)[Windows 子系统(WSL)](https://docs.microsoft.com/en-us/windows/wsl/install-win10)及其最新的[WSL 2](https://docs.microsoft.com/en-us/windows/wsl/install-win10#update-to-wsl-2)版本,则支持安装不同的 Linux 发行版,其中包括 Git 和 SSH 客户端。
Lab机器人's avatar
readme  
Lab机器人 已提交
294

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
295
对于当前版本的 Windows,您还可以通过[Git for Windows](https://gitforwindows.org)安装 Git 和 SSH 客户端。
Lab机器人's avatar
readme  
Lab机器人 已提交
296 297 298 299 300 301

替代工具包括:

*   [Cygwin](https://www.cygwin.com)
*   [PuttyGen](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
302
## 故障排除[](#troubleshooting "Permalink")
Lab机器人's avatar
readme  
Lab机器人 已提交
303

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
304
如果在 Git Clone 上,系统会提示您输入密码,例如`git@codechina.csdn.net's password:`,则表明您的 SSH 设置有问题。
Lab机器人's avatar
readme  
Lab机器人 已提交
305

Lab机器人's avatar
ssh doc  
Lab机器人 已提交
306
*   确保您正确地生成了 SSH 密钥,并将公共 SSH 密钥添加到了您 CODEChina 账号的 SSH 密钥中
Lab机器人's avatar
readme  
Lab机器人 已提交
307
*   尝试使用`ssh-agent`手动注册您的私有 SSH 密钥,如本文档前面所述
Lab机器人's avatar
ssh doc  
Lab机器人 已提交
308
*   尝试通过运行`ssh -Tv git@codechina.csdn.net`调试连接