gerrit/配置SSH密钥指南.md

Gerrit SSH 密钥配置指南

在 Windows 上配置 SSH 密钥

步骤 1：生成 SSH 密钥（如果还没有）

在 Git Bash 中执行：

# 检查是否已有 SSH 密钥
ls -la ~/.ssh

# 如果没有 id_rsa 或 id_ed25519，生成新密钥
ssh-keygen -t ed25519 -C "your_email@example.com"

# 或者使用 RSA（如果 ed25519 不支持）
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

提示：

• 按回车使用默认路径：/c/Users/Administrator/.ssh/id_ed25519
• 可以设置密码（推荐）或直接回车留空

步骤 2：查看公钥内容

# 查看公钥（ed25519）
cat ~/.ssh/id_ed25519.pub

# 或（RSA）
cat ~/.ssh/id_rsa.pub

复制整个公钥内容（从 ssh-ed25519 或 ssh-rsa 开始到邮箱结束）

步骤 3：将公钥添加到 Gerrit

1. 登录 Gerrit

   • 访问：http://101.43.95.130:8080
   • 使用您的账号登录

2. 进入 SSH 公钥设置

   • 点击右上角用户名 → "Settings"
   • 或直接访问：http://101.43.95.130:8080/#/settings/ssh-keys

3. 添加 SSH 公钥

   • 点击 "Add Key" 或 "+" 按钮
   • 粘贴刚才复制的公钥内容
   • 点击 "Add" 保存

步骤 4：修复 known_hosts（删除旧密钥）

# 删除旧的 Gerrit 主机密钥
ssh-keygen -R [101.43.95.130]:29418

# 或者手动编辑 known_hosts 文件
# 删除包含 101.43.95.130:29418 的行
notepad ~/.ssh/known_hosts

步骤 5：测试 SSH 连接

# 测试 SSH 连接（会提示接受新密钥）
ssh -p 29418 admin@101.43.95.130

# 输入 yes 接受新的主机密钥
# 如果配置正确，应该能看到 Gerrit 命令提示符

步骤 6：配置 Git 使用 SSH

cd /d/zhini/zhini_im

# 删除旧的 HTTP 远程仓库
git remote remove gerrit

# 添加 SSH 远程仓库
git remote add gerrit ssh://admin@101.43.95.130:29418/zhini_im

# 验证
git remote -v

步骤 7：推送代码

# 推送代码
git push gerrit HEAD:refs/heads/master

# 或推送到评审队列
git push gerrit HEAD:refs/for/master

完整操作流程

在 Git Bash 中执行：

# 1. 生成 SSH 密钥（如果还没有）
ssh-keygen -t ed25519 -C "admin@example.com"
# 按回车使用默认路径和密码

# 2. 查看公钥
cat ~/.ssh/id_ed25519.pub

# 3. 复制公钥内容，然后：
#    - 访问 http://101.43.95.130:8080/#/settings/ssh-keys
#    - 点击 "Add Key"
#    - 粘贴公钥
#    - 保存

# 4. 删除旧的 known_hosts 条目
ssh-keygen -R [101.43.95.130]:29418

# 5. 测试 SSH 连接
ssh -p 29418 admin@101.43.95.130
# 输入 yes 接受新密钥
# 如果成功，输入 exit 退出

# 6. 配置 Git 远程仓库
cd /d/zhini/zhini_im
git remote remove gerrit
git remote add gerrit ssh://admin@101.43.95.130:29418/zhini_im

# 7. 推送代码
git push gerrit HEAD:refs/heads/master

常见问题

Q: 提示 "Permission denied (publickey)"？

A: 可能的原因：

1. 公钥未添加到 Gerrit → 检查 Settings → SSH Keys
2. 用户名错误 → 使用注册时的用户名
3. 密钥路径不对 → 检查 ~/.ssh/ 目录

Q: 提示 "Host key verification failed"？

A: 执行：

ssh-keygen -R [101.43.95.130]:29418
ssh -p 29418 admin@101.43.95.130  # 接受新密钥

Q: 如何查看已添加的 SSH 密钥？

A: 访问：http://101.43.95.130:8080/#/settings/ssh-keys

Q: 如何测试 SSH 连接？

A:

ssh -p 29418 admin@101.43.95.130 gerrit version

如果配置正确，应该显示 Gerrit 版本信息。

SSH vs HTTP 对比

SSH 方式

• ✅ 更安全
• ✅ 不需要每次输入密码
• ✅ 支持更多 Gerrit 命令
• ❌ 需要配置密钥

HTTP 方式

• ✅ 配置简单
• ✅ 不需要密钥
• ❌ 每次推送可能需要认证（开发模式下不需要）

验证配置

测试 SSH 连接

# 测试连接
ssh -p 29418 admin@101.43.95.130 gerrit version

# 应该显示：
# gerrit version 3.9.0

测试 Git 推送

cd /d/zhini/zhini_im
git push gerrit HEAD:refs/heads/master

如果成功，应该能看到推送进度和成功消息。