first commit

配置SSH密钥指南.md

@@ -0,0 +1,195 @@
+# 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
+```
+
+如果成功，应该能看到推送进度和成功消息。
+