docker運行可登錄的gerrit容器及遇到問題解決方案
更新時間：2026年01月12日 10:42:04 作者：暴躁的魚
這篇文章給大家介紹docker運行可登錄的gerrit容器及遇到問題解決方案,本文給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友參考下吧
普通運行gerrit容器
常規(guī)運行gerrit容器發(fā)現(xiàn)根本沒辦法登錄
docker run -d --name gerrit \
-p 8082:8080 \
-p 29418:29418 \
-v /home/bing/docker/gerrit/data:/var/gerrit/review_site \
-v /home/bing/docker/gerrit/etc:/var/gerrit/etc \
-v /home/bing/docker/gerrit/git:/var/gerrit/git \
-v /home/bing/docker/gerrit/index:/var/gerrit/index \
-v /home/bing/docker/gerrit/cache:/var/gerrit/cache \
-v /home/bing/docker/gerrit/logs:/var/gerrit/logs \
-e GERRIT_INIT_ARGS="--install-plugin=download-commands"\
gerritcodereview/gerrit:latest登錄頁面報這個錯誤：
Configuration Error
Check the HTTP server's authentication settings.
The HTTP server did not provide the username in the Authorization header when it forwarded the request to Gerrit Code Review.
If the HTTP server is Apache HTTPd, check the proxy configuration includes an authorization directive with the proper location, ensuring it ends with '/':
<VirtualHost 10.211.55.6:8082>
ServerName 10.211.55.6
ProxyRequests Off
ProxyVia Off
ProxyPreserveHost On
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
<Location /login/>
AuthType Basic
AuthName "Gerrit Code Review"
Require valid-user
...
</Location>
AllowEncodedSlashes On
ProxyPass / http://.../ nodecode
</VirtualHost>這個錯誤非常明確，它揭示了問題的核心：
你的 Gerrit 配置了“HTTP 認證模式”，但你直接訪問了 Gerrit 容器，中間缺少了負責認證的“看門人”（Nginx 或 Apache）。
簡單來說：Gerrit 以為前面有個代理服務器（Nginx）已經(jīng)幫你驗證過身份了，并會把你的用戶名放在 HTTP Header 里傳過來。但實際上，你直接連上了 Gerrit，所以 Gerrit 拿不到用戶名，就報錯了。
你有兩個解決路徑，方案一最簡單（推薦），方案二是標準生產(chǎn)做法。
方案一：改用“開發(fā)模式”登錄（最快解決問題，推薦測試環(huán)境使用）
這種方式不需要 Nginx，也不需要復雜的認證配置。修改配置后，登錄頁面會變成一個文本框，你想登錄誰，輸入用戶名就直接以該身份登錄。
操作步驟：
1 進入容器修改配置文件：
# 假設你的容器名字叫 gerrit，如果是其他名字請自行替換 docker exec -it gerrit vi /var/gerrit/etc/gerrit.config
注：如果容器里沒有 vi 命令，可以使用 cat 查看后，在宿主機修改掛載的配置文件（如果你有掛載卷的話）
2 找到 [auth] 部分，修改為以下內容：
[auth]
type = DEVELOPMENT_BECOME_ANY_ACCOUNT
# 如果底下有 logoutUrl 這一行，建議注釋掉或者刪掉
# logoutUrl =
3 保存并退出（在 vi 編輯器中按 Esc，輸入 :wq 回車）。
4 重啟 Gerrit 容器使配置生效：
docker restart gerrit
5 驗證：再次訪問 http://10.211.55.6:8082/，點擊 Sign In 或 Login。
- 預期結果：頁面不再是報錯，而是出現(xiàn)一個輸入框 “Become any account”。你在里面輸入 admin（或任意用戶名），點擊登錄即可成功進入。
方案二：配置 Nginx 反向代理（標準生產(chǎn)做法）
如果你必須使用用戶名/密碼登錄（例如為了安全起見），并且保留 HTTP 認證模式，那你必須在 Gerrit 前面再加一個 Nginx 容器。
1 原理：
瀏覽器 -> (輸入密碼) -> Nginx (驗證通過) -> (把用戶名寫在 Header 里) -> Gerrit (讀取 Header，放行)
2 簡化版 Docker Compose 示例：
你需要創(chuàng)建一個 docker-compose.yml，包含 Gerrit 和 Nginx 兩個服務：
version: '3'
services:
gerrit:
image: gerritci/gerrit:latest
ports:
- "8081:8080" # 內部通訊端口，不對外開放
volumes:
- gerrit-volume:/var/gerrit
environment:
- CANONICAL_WEB_URL=http://10.211.55.6:8082/
nginx:
image: nginx:alpine
ports:
- "8082:80" # 對外訪問端口
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
# 下面這個 .htpasswd 文件需要用 htpasswd 工具生成，包含用戶名和加密密碼
- ./htpasswd:/etc/nginx/.htpasswd:ro
depends_on:
- gerrit
volumes:
gerrit-volume:3 Nginx 配置文件 (nginx.conf) 必須包含以下設置：
events {
worker_connections 1024;
}
http {
server {
listen 80;
server_name 10.211.55.6;
# 開啟基礎認證
auth_basic "Gerrit Code Review";
auth_basic_user_file /etc/nginx/.htpasswd;
location / {
# 反向代理到 Gerrit 容器
proxy_pass http://gerrit:8080;
# 關鍵設置：把 Nginx 認證后的用戶名傳給 Gerrit
# 默認 Gerrit 的 HTTP 認證模式也是看這個 header
proxy_set_header Authorization "";
proxy_set_header X-Remote-User $remote_user;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr;
}
}
}4 生成用戶賬戶密碼文件，htpasswd生成.htpasswd文件
這個工具的正確名稱是 htpasswd（注意中間沒有 w，且通常指 Apache HTTP Server 工具包中的工具）。它是用于管理存儲用戶名和密碼（Basic Auth 認證）文件的標準工具。
由于你是在 Docker 環(huán)境下部署 Gerrit 和 Nginx，我提供兩種方法來生成這個文件：
方法一：在你的宿主機上直接生成（標準方法）
如果你使用的是 Linux (Ubuntu/CentOS) 或 macOS，通常可以直接安裝并使用。
1. 安裝工具
- Ubuntu / Debian:
sudo apt-get update sudo apt-get install apache2-utils
- CentOS / RHEL:
sudo yum install httpd-tools
2. 生成 .htpasswd 文件
- 場景 A：創(chuàng)建新文件并添加第一個用戶（例如 admin）
# -c 表示創(chuàng)建文件 # admin 是用戶名 # 執(zhí)行后會提示你輸入兩次密碼 htpasswd -c .htpasswd admin
- 場景 B：在已有文件中添加第二個用戶（非常重要：不要加 -c?。?/strong>
注意：如果你在添加第二個用戶時使用了 -c 參數(shù)，會覆蓋并刪除之前生成的所有用戶！
# 沒有 -c，表示追加 htpasswd .htpasswd user2
- 場景 C：不生成本地文件，直接輸出加密后的字符串
如果你想把結果直接復制到 Docker Compose 的配置或 Kubernetes Secret 中：
# -n 表示不更新文件，直接輸出到屏幕 htpasswd -nb admin mypassword123 # 輸出結果類似：admin:$apr1$l3sxc1$W8wY8nG...
方法二：使用 Docker 容器生成（無需安裝額外工具，最推薦）
如果你不想在宿主機安裝 apache2-utils，可以直接起一個臨時的 Nginx 或 Apache 容器來幫你生成，用完即刪。
命令如下：
docker run --rm -v $(pwd):/app httpd:alpine htpasswd -bc /app/.htpasswd admin your_password
解釋：
- –rm: 容器運行完命令后自動刪除。
- -v $(pwd):/app: 把當前目錄掛載到容器內的 /app 目錄。
- httpd:alpine: 使用 Apache 的官方輕量鏡像（很小，下載快）。
- htpasswd -bc /app/.htpasswd admin your_password: 在容器內執(zhí)行生成命令，文件會保存在你當前目錄下的 .htpasswd 文件中。
執(zhí)行完后，你的當前目錄下就會有一個 .htpasswd 文件。
3. 如何在 Nginx 中使用這個文件
生成好文件后，假設你把它放在了 Nginx 配置目錄下（比如 /etc/nginx/.htpasswd），你需要修改 nginx.conf 指向它：
server {
listen 80;
server_name 10.211.55.6;
# 開啟認證
auth_basic "Gerrit Code Review";
# 指定剛才生成的文件路徑
auth_basic_user_file /etc/nginx/.htpasswd;
location / {
proxy_pass http://gerrit:8080;
# ... 其他配置
}
}常用參數(shù)速查表
- -c : Create a new file. (創(chuàng)建新文件，慎用，會覆蓋舊文件)
- -b : Batch mode. (命令行直接輸入密碼，不用交互式輸入)
- -n : Don’t update file; display results on stdout. (只打印結果，不存文件)
- -m : Force MD5 encryption of the password. (默認通常就是這個)
- -B : Force bcrypt encryption of the password. (更安全，但可能需要 Nginx 特定版本支持)
- -D : Delete user. (刪除用戶)
示例：一行命令創(chuàng)建文件并設置密碼（不交互）：
htpasswd -bc .htpasswd admin 123456
然后啟動：
docker-compose up -d
總結
- 如果你只是想快速搭建起來玩玩、測試功能：請使用 方案一。把 type 改為 DEVELOPMENT_BECOME_ANY_ACCOUNT，這是最快跳過當前報錯的方法。
- 如果你是在為公司搭建正式的服務器：請使用 方案二。引入 Nginx 做認證代理，這樣安全性更高，且符合 Gerrit 的標準部署架構。
到此這篇關于docker運行可登錄的gerrit容器及遇到問題解決方案的文章就介紹到這了,更多相關docker gerrit容器內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要介紹了Docker不同宿主機網(wǎng)絡打通的方案?,本方式使用docker?Swarm集群的方式創(chuàng)建overlay?網(wǎng)絡進行打通,需要的朋友可以參考下2024-08-08
這篇文章主要介紹了使用Docker構建企業(yè)級自定義鏡像的方法，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-05-05
文章簡要介紹了Harbor的部署與升級流程：包括安裝Docker、配置HTTPS、部署Harbor及測試；小版本升級需備份后替換；大版本升級則需額外注意兼容性,同樣執(zhí)行備份、替換和測試操作2025-09-09
如何解決Linux系統(tǒng)下Docker占滿分區(qū)的問題
本篇文章主要介紹了如何解決Linux系統(tǒng)下Docker占滿分區(qū)的問題。小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-07-07
這篇文章主要介紹了docker-compose中的環(huán)境變量問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-11-11
如何給一個正在運行的Docker容器動態(tài)添加Volume
這篇文章主要介紹了如何給一個正在運行的Docker容器動態(tài)添加Volume，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2019-03-03
Docker安裝部署Mysql8的過程(以作數(shù)據(jù)持久化)
這篇文章主要介紹了Docker安裝部署Mysql8(以作數(shù)據(jù)持久化),首先創(chuàng)建容器并進行持久化處理，接著配置遠程連接并嘗試，本文結合實例代碼給大家介紹的非常詳細，需要的朋友可以參考下2022-09-09
這篇文章主要介紹了docker在ubuntu14.04下的安裝步驟，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-06-06
docker在已有的tomcat鏡像上打新的鏡像的Dockerfile編寫說明介紹
這篇文章主要介紹了docker在已有的tomcat鏡像上打新的鏡像的Dockerfile編寫說明介紹,需要的朋友可以參考下2016-10-10
這篇文章主要介紹了Docker的基本命令使用筆記，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-06-06