tencent cloud

文档反馈

配置 SSH 公钥

最后更新时间:2023-12-25 17:08:18
    本文为您详细介绍如何配置 SSH 公钥。

    进入项目

    1. 登录 CODING 控制台,单击团队域名进入 CODING 使用页面。
    2. 单击页面右上角的
    
    ,进入项目列表页面,单击项目图标进入目标项目。
    3. 选择左侧菜单代码仓库,进入代码仓库首页。
    4. 若左侧未显示代码仓库,需项目管理员前往项目设置 > 项目与成员 > 功能开关打开功能开关。

    功能介绍

    SSH 的全称为 Secure Shell 安全外壳协议,是一种加密的网络传输协议。它能够在公开的网络环境中提供安全的数据传输环境,通常用于登录远程主机与推拉代码。
    同样一个 SSH 公钥文件,如果添加至某一个代码仓库,则称为部署公钥,配置后默认拥有该项目的只读权限;如果添加至个人账户,称为账户 SSH 公钥,配置后拥有账户下所有项目的读写权限。同一个 SSH 公钥无法重复添加至代码仓库和个人账户。

    生成公钥

    本文使用 ssh-keygen 工具生成 SSH 公钥,执行命令:
    ssh-keygen -m PEM -t rsa -b 4096 -C "your.email@example.com" // 创建新的 SSH 私钥与公钥密钥对,输入您的邮箱作为标签
    Enter file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter] // 推荐使用默认地址
    Enter passphrase (empty for no passphrase): // 此处直接回车即可;若设置密码,则每次使用 SSH 方式推送代码时都会要求输入密码
    
    说明:
    若您需要使用多个 SSH 密钥对,在 Enter file in which to save the key 步骤时,输入一个新的文件名称就可以避免覆盖已有的密钥对。有关 SSH 更多信息可参见 维基百科
    成功之后显示如下信息:
    Your identification has been saved in /Users/you/.ssh/id_rsa.
    # Your public key has been saved in /Users/you/.ssh/id_rsa.pub.
    # The key fingerprint is:
    # 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your.email@example.com
    

    添加公钥

    您可以按需添加公钥至单个仓库或个人账户,相同的 SSH 公钥无法重复添加。

    关联公钥至单个代码仓库

    1. 打开上文中生成的密钥对的地址(通常为 ~/.ssh/)找到后缀为 pub 的公钥文件,使用 cat 命令输出所有内容并复制。
    
    2. 前往代码仓库的设置 > 部署公钥页面,单击添加部署公钥,粘贴复制的公钥全文。
    
    说明:
    部署公钥默认拥有该项目的只读权限。如果需要获取推送权限,请勾选部署公钥设置里的授予推送权限
    3. 完成后,在本地运行首次连接时的公钥认证命令: ssh -T git@e.coding.net
    

    关联公钥至个人账户

    1. 打开上文中生成的密钥对的地址(默认地址通常为 ~/.ssh/)找到后缀为 pub 的公钥文件,使用 cat 命令输出所有内容并复制。
    
    2. 登录 CODING,单击右上角个人头像进入个人账户设置 > SSH 公钥页面,然后单击新建公钥
    
    3. 根据提示粘贴已复制的公钥内容,按需填写公钥名称。
    4. 完成后,在本地运行首次连接时的公钥认证命令: ssh -T git@e.coding.net
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持