【Git】在 Windows 和 Linux 上配置 SSH 密钥并初始化 Git 项目

配置 SSH 密钥以便与远程服务器安全连接是开发者必备的技能。在这篇博客中，我们将详细介绍如何在 Windows 和 Linux 平台上配置 SSH 密钥，并完成 Git 项目的初始化。

一、在 Windows 上配置 SSH 密钥

1. 生成 SSH 密钥对

1. 打开 Git Bash:

   • 通过开始菜单搜索 “Git Bash” 打开它。

2. 生成新的 SSH 密钥:

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

   • 将 "your_email@example.com" 替换为你的电子邮件地址。

3. 保存密钥:

   • 按提示选择密钥保存路径（默认路径是 C:\Users\your_username\.ssh\id_rsa），并设置一个 passphrase（可以留空）。

4. 查看生成的公钥:

   cat ~/.ssh/id_rsa.pub
   

   • 复制输出的公钥内容。

5. 将公钥添加到远程服务器:

   • 登录到你的远程服务账户（如 GitHub, GitLab 等）。
   • 找到 “SSH Keys” 或 “Deploy Keys” 部分，添加新的 SSH 密钥，将之前复制的公钥粘贴到指定位置。

2. 测试 SSH 连接

ssh -T git@github.com

• 替换 github.com 为你的远程服务器地址。如果连接成功，你应该会看到一条欢迎消息。

常见问题及解决方法

• “Permission denied (publickey)” 错误:

  • 确保公钥已正确添加到远程服务器。
  • 确保 ssh-agent 正在运行，并且密钥已添加：

    eval "$(ssh-agent -s)"
    ssh-add ~/.ssh/id_rsa
    

• “Could not resolve hostname” 错误:

  • 检查远程服务器地址是否正确。

---

二、在 Linux 上配置 SSH 密钥

1. 生成 SSH 密钥对

1. 打开终端:

   • 使用你喜欢的终端工具（如 GNOME Terminal, Konsole 等）。

2. 生成新的 SSH 密钥:

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

   • 将 "your_email@example.com" 替换为你的电子邮件地址。

3. 保存密钥:

   • 按提示选择密钥保存路径（默认路径是 ~/.ssh/id_rsa），并设置一个 passphrase（可以留空）。

4. 查看生成的公钥:

   cat ~/.ssh/id_rsa.pub
   

   • 复制输出的公钥内容。

5. 将公钥添加到远程服务器:

   • 登录到你的远程服务账户（如 GitHub, GitLab 等）。
   • 找到 “SSH Keys” 或 “Deploy Keys” 部分，添加新的 SSH 密钥，将之前复制的公钥粘贴到指定位置。

2. 测试 SSH 连接

ssh -T git@github.com

• 替换 github.com 为你的远程服务器地址。如果连接成功，你应该会看到一条欢迎消息。

常见问题及解决方法

• “Permission denied (publickey)” 错误:

  • 确保公钥已正确添加到远程服务器。
  • 确保 ssh-agent 正在运行，并且密钥已添加：

    eval "$(ssh-agent -s)"
    ssh-add ~/.ssh/id_rsa
    

• “Could not resolve hostname” 错误:

  • 检查远程服务器地址是否正确。

• 权限错误:

  • 确保 SSH 密钥文件的权限设置正确：

    chmod 600 ~/.ssh/id_rsa
    chmod 644 ~/.ssh/id_rsa.pub
    

测试 SSH 连接问题参考

测试您的 SSH 连接
错误：权限被拒绝（公钥）

---

三、初始化新 Git 项目

1. 创建一个新的 Git 仓库

mkdir my_project
cd my_project
git init

2. 添加远程仓库

git remote add origin git@github.com:username/repository.git

• 替换 username/repository.git 为你的 GitHub 账户名和仓库名。

3. 添加和提交文件

echo "# My Project" > README.md
git add README.md
git commit -m "Initial commit"

4. 推送到远程仓库

git push -u origin master

---

以上就是在 Windows 和 Linux 系统上配置 SSH 密钥和初始化 Git 项目的步骤。希望这篇博客对你有所帮助。如果在过程中遇到问题，请检查 SSH 配置和密钥设置，确保它们正确无误。

---