310 lines
9.1 KiB
Plaintext
310 lines
9.1 KiB
Plaintext
|
================================================================================
|
|||
|
|
Gerrit 问题解决方案文档
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
文档名称：Gerrit 登录和推送问题解决方案
|
|||
|
|
创建日期：2025-12-15
|
|||
|
|
适用版本：Gerrit 3.3.8
|
|||
|
|
服务器地址：http://101.43.95.130:8080
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
一、登录问题解决方案
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
问题现象：
|
|||
|
|
----------
|
|||
|
|
- 点击 Account ID 登录后，界面仍然显示 "ANONYMOUS"（匿名用户）
|
|||
|
|
- 服务器端登录成功（日志显示账户ID），但浏览器界面显示匿名
|
|||
|
|
|
|||
|
|
问题根源：
|
|||
|
|
----------
|
|||
|
|
这是浏览器的 Cookie 安全策略导致的。现代浏览器（Chrome/Edge/Firefox）对
|
|||
|
|
Cookie 有严格的安全限制，特别是 SameSite 属性。
|
|||
|
|
|
|||
|
|
解决方案：
|
|||
|
|
----------
|
|||
|
|
|
|||
|
|
【方案一】修改 Chrome 浏览器的 SameSite 标志（推荐）
|
|||
|
|
|
|||
|
|
1. 在 Chrome 地址栏输入：chrome://flags/
|
|||
|
|
2. 在搜索框输入：SameSite
|
|||
|
|
3. 找到以下选项并修改：
|
|||
|
|
- "SameSite by default cookies" → 设置为 Disabled
|
|||
|
|
- "Cookies without SameSite must be secure" → 设置为 Disabled
|
|||
|
|
4. 点击右下角的"重新启动"按钮
|
|||
|
|
5. 清除浏览器 Cookie（Ctrl+Shift+Delete，选择"所有时间"，清除 Cookie）
|
|||
|
|
6. 重新访问：http://101.43.95.130:8080
|
|||
|
|
7. 点击 Account ID 登录
|
|||
|
|
|
|||
|
|
【方案二】修改 Firefox 浏览器的配置
|
|||
|
|
|
|||
|
|
1. 在 Firefox 地址栏输入：about:config
|
|||
|
|
2. 点击"接受风险并继续"
|
|||
|
|
3. 在搜索框输入：network.cookie.sameSite.noneRequiresSecure
|
|||
|
|
4. 双击该选项，将值改为 false
|
|||
|
|
5. 重启 Firefox
|
|||
|
|
6. 清除浏览器 Cookie
|
|||
|
|
7. 重新访问：http://101.43.95.130:8080
|
|||
|
|
8. 点击 Account ID 登录
|
|||
|
|
|
|||
|
|
【方案三】服务器端配置（已完成）
|
|||
|
|
|
|||
|
|
服务器端已配置：
|
|||
|
|
- cookieSecure = false（允许 HTTP 使用 Cookie）
|
|||
|
|
- cookieSameSite = LAX（允许跨站 Cookie）
|
|||
|
|
- canonicalWebUrl = http://101.43.95.130:8080/（正确的访问地址）
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
二、代码推送问题解决方案
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
问题现象：
|
|||
|
|
----------
|
|||
|
|
- HTTP 推送失败：remote: Unauthorized
|
|||
|
|
- SSH 推送失败：Permission denied (publickey) 或 no mutual signature algorithm
|
|||
|
|
|
|||
|
|
问题根源：
|
|||
|
|
----------
|
|||
|
|
1. HTTP 认证：DEVELOPMENT_BECOME_ANY_ACCOUNT 模式对 HTTP Basic 认证支持有限
|
|||
|
|
2. SSH 认证：OpenSSH 10.0 默认禁用了某些旧的签名算法（如 RSA-SHA1），
|
|||
|
|
而 Gerrit 3.3.8 使用的 Apache SSHD 可能不支持新的签名算法
|
|||
|
|
|
|||
|
|
解决方案：
|
|||
|
|
----------
|
|||
|
|
|
|||
|
|
【步骤一】配置 SSH 密钥
|
|||
|
|
|
|||
|
|
1. 生成 SSH 密钥（如果还没有）：
|
|||
|
|
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
|||
|
|
|
|||
|
|
2. 查看公钥内容：
|
|||
|
|
cat ~/.ssh/id_rsa.pub
|
|||
|
|
# Windows Git Bash 使用：
|
|||
|
|
type ~/.ssh/id_rsa.pub
|
|||
|
|
|
|||
|
|
3. 将公钥添加到 Gerrit：
|
|||
|
|
- 访问：http://101.43.95.130:8080/#/settings/ssh-keys
|
|||
|
|
- 在 "New SSH key" 输入框中粘贴完整公钥
|
|||
|
|
- 点击 "Add" 保存
|
|||
|
|
|
|||
|
|
【步骤二】创建 SSH 配置文件（解决签名算法问题）
|
|||
|
|
|
|||
|
|
在本地电脑上创建 SSH 配置文件：
|
|||
|
|
|
|||
|
|
1. 创建配置文件：
|
|||
|
|
mkdir -p ~/.ssh
|
|||
|
|
cat > ~/.ssh/config << 'EOF'
|
|||
|
|
Host 101.43.95.130
|
|||
|
|
Port 29418
|
|||
|
|
PubkeyAcceptedKeyTypes +ssh-rsa
|
|||
|
|
PubkeyAcceptedAlgorithms +ssh-rsa
|
|||
|
|
EOF
|
|||
|
|
|
|||
|
|
2. 设置正确的权限：
|
|||
|
|
chmod 600 ~/.ssh/config
|
|||
|
|
|
|||
|
|
3. 验证配置：
|
|||
|
|
cat ~/.ssh/config
|
|||
|
|
|
|||
|
|
【步骤三】测试 SSH 连接
|
|||
|
|
|
|||
|
|
ssh -p 29418 renjianbo@101.43.95.130 gerrit version
|
|||
|
|
|
|||
|
|
如果成功，会显示：gerrit version 3.3.8
|
|||
|
|
|
|||
|
|
【步骤四】配置 Git 使用 SSH
|
|||
|
|
|
|||
|
|
1. 删除 HTTP 远程仓库：
|
|||
|
|
git remote remove origin
|
|||
|
|
|
|||
|
|
2. 添加 SSH 远程仓库：
|
|||
|
|
git remote add origin ssh://renjianbo@101.43.95.130:29418/test-project
|
|||
|
|
|
|||
|
|
3. 验证远程仓库配置：
|
|||
|
|
git remote -v
|
|||
|
|
|
|||
|
|
【步骤五】注册邮箱地址
|
|||
|
|
|
|||
|
|
1. 访问：http://101.43.95.130:8080/#/settings/email-addresses
|
|||
|
|
2. 在 "New Email Address" 输入框中输入您的邮箱地址
|
|||
|
|
3. 点击 "Add" 按钮
|
|||
|
|
4. 如果需要验证，按提示完成验证
|
|||
|
|
|
|||
|
|
【步骤六】安装 commit-msg hook（添加 Change-Id）
|
|||
|
|
|
|||
|
|
1. 下载 commit-msg hook：
|
|||
|
|
cd /d/ttt/test-project
|
|||
|
|
mkdir -p .git/hooks
|
|||
|
|
curl -o .git/hooks/commit-msg http://101.43.95.130:8080/tools/hooks/commit-msg
|
|||
|
|
chmod +x .git/hooks/commit-msg
|
|||
|
|
|
|||
|
|
2. 修改最后一次提交（添加 Change-Id）：
|
|||
|
|
git commit --amend --no-edit
|
|||
|
|
|
|||
|
|
【步骤七】推送代码
|
|||
|
|
|
|||
|
|
git push origin HEAD:refs/for/master
|
|||
|
|
|
|||
|
|
推送成功后，Gerrit 会返回变更 URL，例如：
|
|||
|
|
remote: http://101.43.95.130:8080/c/test-project/+/1 [NEW]
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
三、防火墙配置（如果 SSH 连接超时）
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
如果 SSH 连接超时（Connection timed out），需要配置防火墙：
|
|||
|
|
|
|||
|
|
【云服务器】
|
|||
|
|
|
|||
|
|
1. 登录云控制台（阿里云、腾讯云等）
|
|||
|
|
2. 找到安全组配置
|
|||
|
|
3. 添加入站规则：
|
|||
|
|
- 协议：TCP
|
|||
|
|
- 端口：29418
|
|||
|
|
- 源：0.0.0.0/0（或您的 IP）
|
|||
|
|
4. 保存规则
|
|||
|
|
|
|||
|
|
【本地服务器】
|
|||
|
|
|
|||
|
|
sudo firewall-cmd --permanent --add-port=29418/tcp
|
|||
|
|
sudo firewall-cmd --reload
|
|||
|
|
sudo firewall-cmd --list-ports | grep 29418
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
四、完整操作流程示例
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
【首次设置】
|
|||
|
|
|
|||
|
|
1. 配置 SSH 密钥和配置文件（见上述步骤一、二）
|
|||
|
|
|
|||
|
|
2. 克隆项目：
|
|||
|
|
git clone ssh://renjianbo@101.43.95.130:29418/test-project
|
|||
|
|
cd test-project
|
|||
|
|
|
|||
|
|
3. 安装 commit-msg hook：
|
|||
|
|
mkdir -p .git/hooks
|
|||
|
|
curl -o .git/hooks/commit-msg http://101.43.95.130:8080/tools/hooks/commit-msg
|
|||
|
|
chmod +x .git/hooks/commit-msg
|
|||
|
|
|
|||
|
|
4. 配置 Git 用户信息：
|
|||
|
|
git config user.name "Your Name"
|
|||
|
|
git config user.email "your_email@example.com"
|
|||
|
|
|
|||
|
|
【日常开发流程】
|
|||
|
|
|
|||
|
|
1. 修改代码
|
|||
|
|
2. 提交代码：
|
|||
|
|
git add .
|
|||
|
|
git commit -m "Your commit message"
|
|||
|
|
3. 推送代码评审：
|
|||
|
|
git push origin HEAD:refs/for/master
|
|||
|
|
4. 在 Gerrit Web 界面进行评审
|
|||
|
|
5. 如果有修改意见，修改后重新推送：
|
|||
|
|
git commit --amend
|
|||
|
|
git push origin HEAD:refs/for/master
|
|||
|
|
6. 合并后，更新本地仓库：
|
|||
|
|
git checkout master
|
|||
|
|
git pull origin master
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
五、常见问题排查
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
【问题1】SSH 连接超时
|
|||
|
|
|
|||
|
|
检查项：
|
|||
|
|
- 防火墙是否开放 29418 端口
|
|||
|
|
- 云服务器安全组是否配置正确
|
|||
|
|
- Gerrit SSH 服务是否运行：bin/gerrit.sh status
|
|||
|
|
|
|||
|
|
【问题2】SSH 认证失败（Permission denied）
|
|||
|
|
|
|||
|
|
检查项：
|
|||
|
|
- 公钥是否已添加到 Gerrit
|
|||
|
|
- SSH 配置文件是否正确
|
|||
|
|
- 用户名是否正确（Settings → Profile）
|
|||
|
|
|
|||
|
|
【问题3】缺少 Change-Id
|
|||
|
|
|
|||
|
|
解决：
|
|||
|
|
- 安装 commit-msg hook（见步骤六）
|
|||
|
|
- 使用 git commit --amend --no-edit 修改提交
|
|||
|
|
|
|||
|
|
【问题4】邮箱地址未注册
|
|||
|
|
|
|||
|
|
解决：
|
|||
|
|
- 访问 Settings → Email Addresses
|
|||
|
|
- 添加您的邮箱地址
|
|||
|
|
|
|||
|
|
【问题5】HTTP 推送失败
|
|||
|
|
|
|||
|
|
解决：
|
|||
|
|
- 使用 SSH 方式推送（推荐）
|
|||
|
|
- 或配置 gitBasicAuth = true（服务器端已配置）
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
六、服务器端配置摘要
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
当前服务器配置（/home/renjianbo/gerrit_install/review_site/etc/gerrit.config）：
|
|||
|
|
|
|||
|
|
[gerrit]
|
|||
|
|
basePath = git
|
|||
|
|
canonicalWebUrl = http://101.43.95.130:8080/
|
|||
|
|
serverId = fab2bec9-a17c-434d-9a25-76a7f2675339
|
|||
|
|
|
|||
|
|
[database]
|
|||
|
|
type = h2
|
|||
|
|
database = db/ReviewDB
|
|||
|
|
|
|||
|
|
[auth]
|
|||
|
|
type = DEVELOPMENT_BECOME_ANY_ACCOUNT
|
|||
|
|
gitBasicAuth = true
|
|||
|
|
|
|||
|
|
[sshd]
|
|||
|
|
listenAddress = *:29418
|
|||
|
|
|
|||
|
|
[httpd]
|
|||
|
|
listenUrl = http://*:8080/
|
|||
|
|
cookieSecure = false
|
|||
|
|
cookieSameSite = LAX
|
|||
|
|
cookiePath = /
|
|||
|
|
|
|||
|
|
[cache]
|
|||
|
|
directory = cache
|
|||
|
|
|
|||
|
|
[index]
|
|||
|
|
type = LUCENE
|
|||
|
|
|
|||
|
|
[receive]
|
|||
|
|
enableSignedPush = false
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
七、重要提示
|
|||
|
|
================================================================================
|
|||
|
|
|
|||
|
|
1. SSH 方式比 HTTP 更可靠，强烈推荐使用 SSH 推送代码
|
|||
|
|
|
|||
|
|
2. 安装 commit-msg hook 后，以后的所有提交都会自动包含 Change-Id
|
|||
|
|
|
|||
|
|
3. 创建 SSH 配置文件后，以后可以直接使用 git push，不需要每次都
|
|||
|
|
输入长命令
|
|||
|
|
|
|||
|
|
4. 如果遇到问题，查看服务器日志：
|
|||
|
|
cd /home/renjianbo/gerrit_install/review_site
|
|||
|
|
tail -f logs/httpd_log
|
|||
|
|
tail -f logs/sshd_log
|
|||
|
|
|
|||
|
|
5. 常用链接：
|
|||
|
|
- Gerrit 主页：http://101.43.95.130:8080
|
|||
|
|
- 所有变更：http://101.43.95.130:8080/#/q/status:open
|
|||
|
|
- 我的变更：http://101.43.95.130:8080/#/q/owner:renjianbo
|
|||
|
|
- SSH Keys：http://101.43.95.130:8080/#/settings/ssh-keys
|
|||
|
|
- Email 地址：http://101.43.95.130:8080/#/settings/email-addresses
|
|||
|
|
|
|||
|
|
================================================================================
|
|||
|
|
文档结束
|
|||
|
|
================================================================================
|
|||
|
|
|