|中文网站|手机浏览
TIME 2026-11-23 06:22:32

GITHUB SSH密钥生成与连接指南

广告合作推广|优质广告位开放,欢迎商务咨询
站内搜索
 
友情链接
  • 暂无链接
首页 > 图文 > GitHub SSH Key设置
图文
GitHub SSH Key设置
发布时间:2026-11-22        浏览次数:1        返回列表

GitHub SSH Key设置是将本地电脑与GitHub账号建立安全连接的常用方法,适合刚开始使用Git、需要上传或下载代码的新手。完成设置后,使用SSH地址操作仓库时通常不必反复输入GitHub账号密码,也能减少因凭据配置错误导致的提交失败。

GitHub远程仓库连接教程

什么是GitHub SSH Key设置

SSH Key是一对用于身份验证的密钥,分为私钥和公钥。私钥保存在自己的电脑中,不能发送给他人;公钥则添加到GitHub账号。GitHub会通过这对密钥确认当前电脑是否有权限访问仓库。

与HTTPS方式相比,SSH更适合经常使用Git的开发者。需要注意的是,SSH Key验证的是电脑与GitHub账号之间的关系,并不会自动赋予账号访问所有仓库的权限,你仍然需要具备对应仓库的访问权限。

GitHub SSH Key设置新手入门教程

开始前请准备好以下内容:

  • 一个可以正常登录的GitHub账号;
  • 已经安装Git的Windows、macOS或Linux电脑;
  • 用于执行命令的终端工具,例如Git Bash、Terminal或PowerShell。

如果电脑中还没有Git,可以先安装Git,再打开终端输入git --version检查是否安装成功。

如何开始学习GitHub SSH Key设置

  1. 第一步:打开终端。Windows用户可以使用Git Bash,macOS和Linux用户可以打开系统自带的Terminal。
  2. 第二步:生成密钥。输入ssh-keygen -t ed25519 -C "你的GitHub邮箱"并按回车。提示保存位置时直接按回车可使用默认路径;出现密码短语提示时,可以设置一个额外密码,也可以直接按回车留空。
  3. 第三步:查看公钥。输入cat ~/.ssh/id_ed25519.pub。Windows Git Bash通常也支持该命令。如果提示文件不存在,请检查第二步是否生成成功。
  4. 第四步:复制终端中以ssh-ed25519开头的一整行内容,只复制公钥,不要复制私钥文件。
  5. 第五步:登录GitHub,进入头像菜单中的设置页面,找到SSH and GPG keys,点击New SSH key,填写名称,并将公钥粘贴到Key输入框后保存。
  6. 第六步:测试连接。在终端输入ssh -T [email protected]。首次连接可能会询问是否信任GitHub主机,确认指纹来源无误后输入yes。如果看到认证成功的提示,说明连接基本完成。

GitHub SSH Key设置实际操作方法

以下载一个仓库为例,在GitHub仓库页面点击Code,选择SSH并复制仓库地址。地址通常类似[email protected]:用户名/仓库名.git,然后在终端执行git clone 仓库地址。如果本地已有项目,也可以使用git remote set-url origin SSH地址将远程地址改为SSH格式。

之后进入项目目录,执行git pull或git push时,Git会通过已添加的密钥进行验证。若私钥设置了密码短语,系统可能在首次使用时要求输入一次。

学习GitHub SSH Key设置时常见的问题

  • Permission denied (publickey):通常表示公钥没有添加到正确的GitHub账号,或使用了错误的私钥。可重新检查账号、复制内容和密钥路径。
  • 找不到公钥文件:确认生成命令是否执行成功,并检查~/.ssh目录中是否存在id_ed25519.pub。
  • 仓库仍使用HTTPS地址:查看git remote -v,如果地址以https://开头,需要改成GitHub提供的SSH地址。
  • 已有旧密钥:不要随意删除原文件。可以保留旧密钥,并通过SSH配置文件为不同账号指定不同密钥。

学习GitHub SSH Key设置需要注意什么

  • 私钥文件不能上传到GitHub、网盘或发送给他人。
  • 公钥内容应完整复制,不能多复制空格或漏掉结尾字符。
  • 使用多个GitHub账号时,建议为不同账号创建不同密钥并配置别名。
  • 公共电脑或共享电脑不建议保存个人私钥。

总结

通过本文,你可以了解SSH密钥的作用,并完成生成密钥、添加公钥、测试连接和使用SSH仓库地址等步骤。设置完成后,建议继续学习Git的提交、分支、合并和远程协作命令,逐步建立完整的代码管理流程。