文档首页/ 代码托管 CodeArts Repo/ 用户指南/ 环境和个人配置/ 配置SSH密钥
更新时间：2024-11-19 GMT+08:00
查看PDF
分享

配置SSH密钥

  1. 运行Git Bash，先检查本地是否已生成过SSH密钥。请在Git Bash中执行如下命令： 

    cat ~/.ssh/id_rsa.pub
    • 如果提示“No such file or directory”，说明您这台计算机没生成过SSH密钥，请继续执行2。
    • 如果返回以ssh-rsa开头的字符串，说明您这台计算机已经生成过SSH密钥，如果想使用已经生成的密钥请直接跳到3，如果想重新生成密钥，请从2向下执行。

  2. 生成SSH密钥。在Git Bash中生成密钥的命令如下： 

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

    其中，-t rsa表示生成的是RSA类型密钥，-b 4096是密钥长度（该长度的RSA密钥更具安全性），-C your_email@example.com表示在生成的公钥文件中添加注释，方便识别这个密钥对的用途。

    如果选择ED25519算法，在Git Bash中生成密钥的命令如下：

    ssh-keygen -t ed25519 -b 521 -C your_email@example.com

    其中，-t ed25519表示生成的是ED25519类型密钥，-b 521是密钥长度（该长度的ED25519密钥更具安全性），-C your_email@example.com表示在生成的公钥文件中添加注释，方便识别这个密钥对的用途。

    输入生成密钥的命令后，直接回车，密钥会默认存储到~/.ssh/id_rsa路径下，对应的公钥文件为~/.ssh/id_rsa.pub。

  3. 复制SSH公钥到剪切板。请根据您的操作系统，选择相应的执行命令，将SSH公钥复制到您的剪切板。

    • Windows： 
      clip < ~/.ssh/id_rsa.pub
    • Mac： 
      pbcopy < ~/.ssh/id_rsa.pub
    • Linux (xclip required): 
      xclip -sel clip < ~/.ssh/id_rsa.pub

  4. 登录并进入Repo的代码仓库列表页，单击右上角昵称，选择“个人设置” > “代码托管” > “SSH密钥”，进入配置SSH密钥页面。

    也可以在Repo的代码仓库列表页，单击右上角“设置我的SSH密钥”，进入配置SSH密钥页面。

  5. 在“标题”中为您的新密钥起一个名称，将您在3中复制的SSH公钥粘贴进“密钥”中，单击确定后，弹出页面“密钥已设置成功，单击 立即返回，无操作3S后自动跳转”，表示密钥设置成功。
  • 在一台电脑上配置了SSH密钥并添加公钥到CodeArts Repo中后，所有该账号下的代码仓库与这台电脑之间都可以使用该SSH密钥进行连接；而不同的用户通常使用不同的电脑。因此，在使用SSH方式连接CodeArts Repo之前，每个用户都需要在自己的电脑上配置各自的SSH密钥。
  • 在配置SSH密钥时，提示：“此密钥已存在，请重新生成密钥”，表示该密钥在该账号或者其它账户下被添加过。解决办法：可参考如上操作步骤，在本地重新生成一次SSH密钥，再把生成的密钥配置到CodeArts Repo。

配置SSH操作视频

本视频介绍配置SSH密钥。

父主题： 环境和个人配置