在本地安装 git 工具后配置 git 的用户名和邮箱,这个用户名和邮箱与 GitHub 或 GitLab 无关,命令如下:
git config --global user.name "Your Name" git config --global user.email "Your Email"克隆一个新的远程仓库
首先在 GitHub/GitLab/Gitee 等远程仓库上新建一个项目,然后可以通过 HTTPs Clone 一个远程仓库,也可以使用 SSH 的方式克隆,先以 HTTPs 为例:
git clone <仓库地址> cd <项目目录> # 创建 EADME 文件并推送到远程仓库 touch README.md git add README.md git commit -m "add README" git push -u origin master
推送成功后在远程仓库刷新页面,就可以看到推送上去的 README.md 文件了。
推送本地现有的项目# 进入项目目录 cd <项目目录> git init # 连接远程仓库 git remote add origin <远程仓库地址> # 推送 git add . git commit -m "Initial commit" git push -u origin master推送现有的 Git 仓库
cd <项目目录> git remote rename origin old-origin git remote add origin <远程仓库地址> git push -u origin --all git push -u origin --tags配置 SSH 密钥
本地生成 SSH key 需要安装 OpenSSH客户端,如果你使用的是 MacOS/Linux/Gnu 等操作系统就不需要再单独安装,因为这些系统已经预安装了该客户端,但是Windows上没有,推荐先安装 git 工具,然后在 Git Bash 中就可以使用 ssh 命令了,可以通过以下命令查看系统中是否安装了 SSH 客户端:
# V 是大写字母 ssh -V
常见的 SSH 密码类型有 RSA,DSA,ECDSA,ED25519等。
现有文档表明 ED25519 更安全,如果使用 RSA 密钥,则美国国家科学技术研究院出版物 800-57 第 3 部分(PDF)建议密钥大小至少为 2048 位。
这里我们主要介绍 ED25519 和 RSA 这两种密码的使用方法。
生成 ED25519 SSH keys执行命令:
ssh-keygen -t ed25519 -C ""
-C 是标记 SSH 密钥的可选方法,例如带引号注释的电子邮箱地址,这里可以根据你当前所使用的远程仓库名称标记,例如:“myname@github.com”
执行上面命令后,会看到类似于一下内容的响应:
$ ssh-keygen -t ed25519 -C "panya@codechina.com" Generating public/private ed25519 key pair. Enter file in which to save the key (/c/Users/mac/.ssh/id_ed25519):
可以输入ssh keys文件生成的具体位置,如果使用提示的默认路径,直接按回车即可,然后又会提示以下内容:
Enter passphrase (empty for no passphrase):
提示输入密码,如果不需要设置密码,直接按回车,然后又会提示以下内容:
Enter same passphrase again:
再次确认密码,如果没有设置密码直接按回车,接下来会看到:
此时,就可以在指定的文件中看到生成的密钥了
如有需要,也可以使用以下命令更新密码:
ssh-keygen -p -f /path/to/ssh_key生成 RSA 密钥
命令:
ssh-keygen -t rsa -b 2048 -C "email@example.com"
无论是创建ED25519还是创建RSA密钥,都从ssh-keygen命令开始。此时,将在命令行中看到以下消息
Generating public/private ed25519 key pair. Enter file in which to save the key (/home/user/.ssh/id_rsa):
剩下的步骤,可以参考上面的 ED25519 SSH keys 的生成步骤。
在 GitHub/GitLab/Gitee 账号中添加 SSH 密钥第1步:复制 SSH keys 公钥
密钥生成完成以后,将创建好的 SSH 密钥复制到剪贴板中,需要以文本格式保存 SSH 密钥,推荐使用命令的方式复制,以 ED25519 为例:
# macOS pbcopy < ~/.ssh/id_ed25519.pub # Linux(需要 xclip 软件包) xclip -sel clip < ~/.ssh/id_ed25519.pub # Windows 上的 Git Bash cat ~/.ssh/id_ed25519.pub | clip
如果你使用的是 RSA 密钥,相应地替换即可。
第2步:打开远程仓库并登录
- github地址:https://github.com/
- gitee地址:https://gitee.com/
第3步:设置 SSH 密钥
登录成功后,点击头像,然后点击设置,点击 “SSH 密钥”按钮,将复制的公钥粘贴到密钥文本框中,设置密钥的过期日期,然后再点击“添加密钥”按钮即可。
要测试是否正确添加了 SSH 密钥,可以在终端中运行以下命令:
# github ssh -T git@github.com # gitee ssh -T git@gitee.com # gitlab ssh -T
在您第一次通过 SSH 方式连接到远程仓库的时候,将会询问您是否信任将要连接的仓库host地址。当确认 yes 后,会将远程仓库地址作为已知主机添加到受信任的 hosts 地址中:
Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added <远程仓库地址> to the list of known hosts.
如果未出现欢迎消息,则可以通过使用以下命令在详细模式下运行ssh来解决问题:
ssh -Tv
到此,SSH keys 就配置完成了。



