版本控制在软件开发中至关重要，而 Git 是广泛使用的代码管理工具。有时，我们可能需要在多个平台 (如 GitHub、GitLab 和 Gitee) 上同步同一 Git 仓库，以便备份、协作等。
本文将带你玩转此操作，其中关键是“配置 SSH” 和“远程仓库”。首先，我们来讲述 SSH 的配置。
配置 SSH
为确保安全和简化登录，需配置 SSH 密钥。SSH 密钥是用于身份验证的安全方式，可免密访问远程 Git 仓库。
检查现有 SSH 密钥
在生成新的 SSH 密钥之前，应该检查本地电脑是否存在现有密钥。打开终端，输入一下命令以查看是否存在现有的 SSH 密钥。
ls -al ~/.ssh
此命令将列出 .ssh 目录中的所有文件（如果存在）。如果没有想要的，需要创建新的 SSH 密钥对。
生成新 SSH 密钥
在本地电脑上生成新的 SSH 密钥。 生成密钥后，可将公钥添加到 GitHub 等平台上的帐户中，以便通过 SSH 为 Git 操作启用身份验证。
打开终端输入一下命令，然后一路 Enter 键，完成密钥对的生成：
ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/id_github
在这个命令中：
-
ssh-keygen用于生成、管理和转换认证密钥的工具。 -
-t指定了密钥类型。ed25519是一种现代的、安全的公钥加密算法，被广泛认为是非常强大且高效的。与 RSA 和 DSA 密钥相比，它提供了更好的安全性和性能。 -
-C指定一个注释，通常是用户的电子邮件地址。 -
-f指定了密钥文件的保存位置和名称。默认情况下，ssh-keygen会生成名为id_rsa、id_ed25519等的文件，具体取决于所选的密钥类型。在这里，它将被保存为~/.ssh/id_github(私钥) 和~/.ssh/id_github.pub(公钥)。
相关链接：
- GitHub: 生成新 SSH 密钥
- GitLab: 生成 SSH 密钥对
- Gitee: 生成 SSH 公钥
编辑 ~/.ssh/config 文件
为了在一台电脑上配置多个平台的 SSH，你需要编辑 ~/.ssh/config 文件。以下是一个配置示例，分别配置了 GitHub、GitLab 和 Gitee 的 SSH：
# GitHub 配置
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_github
PreferredAuthentications publickey,password # 优先使用 SSH 公钥认证，然后再尝试用户名和密码认证
IdentitiesOnly yes
# GitLab 配置
Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/id_gitlab
PreferredAuthentications publickey # 仅使用 SSH 公钥认证
IdentitiesOnly yes
# Gitee 配置
Host gitee.com
HostName gitee.com
User git
IdentityFile ~/.ssh/id_gitee
PreferredAuthentications publickey # 仅使用 SSH 公钥认证
IdentitiesOnly yes
在这个配置中：
-
Host是你定义的别名，可以随意命名，但通常使用服务域名以方便记忆。 -
HostName是实际的服务域名。 -
User通常是git，因为这是大多数 Git 服务器的默认用户名。 -
IdentityFile指向你的私钥文件路径。 -
PreferredAuthentications指定 SSH 客户端在尝试身份验证时应优先考虑的认证方法列表。例如，你可以设置为只使用公钥认证，或者优先使用公钥认证，然后再尝试其他 (密码) 认证方式。 -
IdentitiesOnlyyes指示 SSH 只使用IdentityFile指定的身份进行认证，这有助于避免 SSH 代理或默认私钥的干扰。
新增 SSH 密钥到平台帐户
配置 ~/.ssh/config 文件完毕后，必须将 SSH 公钥添加到 GitHub、GitLab 和 Gitee，才能为帐户启用 SSH 访问。
相关链接：
测试 SSH 连接
设置 SSH 密钥并将其添加到 GitHub、GitLab 和 Gitee 后，可以测试连接。
测试 SSH 连接之前，应已完成以上所有步骤。
打开终端，输入以下命令：
ssh -T git@github.com # 测试 Github 的 SSH 连接
ssh -T git@gitlab.example.com # 测试 Gitlab 的 SSH 连接。注意：要将 gitlab.example.com 替换为你的实例 URL
ssh -T git@gitee.com # 测试 Gitee 的 SSH 连接
如果这是你第一次连接，你应该会看到类似以下消息，提示你需要验证平台主机的真实性：
> The authenticity of host ' (IP ADDRESS)' can't be established.
> ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
> Are you sure you want to continue connecting (yes/no)?
输入 yes，然后按 Enter。
> Hi USERNAME! You've successfully authenticated, but GitHub does not
> provide shell access.
添加成功后，就可以使用 SSH 协议访问这些平台了。例如，你可以使用 git clone git@github.com/username/repository.git 来克隆 GitHub 上的仓库，SSH 会根据 ~/.ssh/config 文件中的配置来选择合适的私钥进行身份验证。
相关链接：
我们为电脑配置完 SSH 后，接下来为本地 Git 仓库添加多个远程平台的仓库链接。
配置远程仓库
没有 Git 仓库
为 Git 仓库添加多个远程平台的仓库的前提是得有个本地 Git 仓库。如果你还没有，可以用以下命令初始化一个。
cd your_folder
git init --initial-branch=main
已经有 Git 仓库
如果你已经在其中一个平台上有个 Git 仓库，你可以使用以下命令将其克隆到本地。
git clone <远程仓库URL>
然后，cd 到新初始化、或者克隆下来的仓库目录，添加其他平台的远程仓库链接 🔗。
查看远程仓库
添加之前，我们先查看一下本地 Git 仓库是否有远程仓库的链接，在终端执行以下命令：
git remote -v
如果刚才是本地新初始化的 Git 仓库，不会有任何信息打印。但是，刚才是从远程平台克隆下来的，就会有以下信息打印。比如，我们是从 Github 克隆的。
origin git@github.com:liam-i/git-multi-platform-sync.git (fetch)
origin git@github.com:liam-i/git-multi-platform-sync.git (push)
删除远程仓库
为了明确指向多平台远程仓库，所以我们用以下命令删除不直观的 origin，稍后再添加一个具有明确指向性的别名。
git remote remove origin
添加远程仓库
为了将本地仓库与其他平台的远程仓库关联起来，需要执行以下命令为它们添加别名。
git remote add <别名> <远程仓库URL>
例如，你可以为 GitHub 仓库添加别名 github，为 GitLab 仓库添加别名 gitlab：
git remote add github git@github.com:liam-i/git-multi-platform-sync.git
git remote add gitlab ssh://git@gitlab.com:liam-i/git-multi-platform-sync.git
git remote add gitee git@gitee.com:liam-i/git-multi-platform-sync.git
添加完成后，我们再用 git remote -v 命令查看一下：
$ git remote -v
github git@github.com:liam-i/git-multi-platform-sync.git (fetch)
github git@github.com:liam-i/git-multi-platform-sync.git (push)
gitlab ssh://git@gitlab.com:liam-i/git-multi-platform-sync.git (fetch)
gitlab ssh://git@gitlab.com:liam-i/git-multi-platform-sync.git (push)
gitee git@gitee.com:liam-i/git-multi-platform-sync.git (fetch)
gitee git@gitee.com:liam-i/git-multi-platform-sync.git (push)
同步操作
推送代码
当你对本地仓库进行了修改，并提交了新的更改后，可以使用以下命令将这些更改推送到所有远程平台：
git push <别名> <分支名>
例如，将更改推送到 GitHub、GitLab 和 Gitee：
git push github main
git push gitlab main
git push gitee main
拉取代码
如果你想从某个远程仓库拉取最新的更改到本地，可以使用以下命令：
git pull <别名> <分支名>
例如，从 GitHub、GitLab 和 Gitee 拉取更改：
git pull github main
git pull gitlab main
git pull gitee main
注意：在拉取代码之前，请确保你在正确的分支上，并且本地仓库的工作目录是干净的。
管理与维护
为了保持多个平台上的仓库数据一致性，你需要定期进行同步操作。同时，当在多个平台上进行协作时，注意解决可能出现的冲突。要解决冲突可以使用 git merge 工具，并确保在推送更改之前测试代码的完整性。
关于更详细的 Git 操作指令请参考：
结语
看完这篇博客，你应该已经知道怎么在多个平台上玩转 Git 仓库同步了。同步时别忘了多留个心眼，还要时不时确认下各平台的数据是否都对得上。希望你用 Git 越来越 6！🤙🤙🤙
参考资料
- https://git-scm.com
- 通过 SSH 连接到 GitHub
- 使用 SSH 密钥与极狐GitLab 通信
- 为 Gitee 生成、添加 SSH 公钥
- Git 常用命令思维导图
- Git 一个先进的分布式版本控制系统
访问博址 liam-i.github.io 获取更佳阅读体验和最新内容。
网友评论