gerrit/配置SSH密钥指南.md

# Gerrit SSH 密钥配置指南

## 在 Windows 上配置 SSH 密钥

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

在 Git Bash 中执行：

```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：查看公钥内容

```bash
# 查看公钥（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（删除旧密钥）

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

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

### 步骤 5：测试 SSH 连接

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

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

### 步骤 6：配置 Git 使用 SSH

```bash
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：推送代码

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

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

## 完整操作流程

### 在 Git Bash 中执行：

```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:** 执行：
```bash
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:** 
```bash
ssh -p 29418 admin@101.43.95.130 gerrit version
```

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

## SSH vs HTTP 对比

### SSH 方式
- ✅ 更安全
- ✅ 不需要每次输入密码
- ✅ 支持更多 Gerrit 命令
- ❌ 需要配置密钥

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

## 验证配置

### 测试 SSH 连接

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

# 应该显示：
# gerrit version 3.9.0
```

### 测试 Git 推送

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

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