萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Windows 平台搭建 Git 伺服器:使用 GitBlit 圖文完整教學

GitBlit 是純 Java 編寫的 Git 伺服器,支援 Windows/Linux/macOS,提供 Web 管理介面、REST API、權限控制,適合中小團隊內網搭建私有 Git 服務。本文記錄 Windows 環境下從零部署全過程。

前置需求

  • Windows Server / Windows 10 (64 位建議)
  • 安裝 Java JDK 8+ (GitBlit 1.6+ 需 Java 8)
  • 防火牆開放 HTTP (預設 8080) 與 HTTPS (預設 8443) 埠口

步驟 1:安裝 Java JDK 並配置環境變數

  1. 下載 JDK (如 jdk-8uXXX-windows-x64.exe) 並安裝,假設路徑 D:\Program Files\Java\jdk1.8.0_XXX。
  2. 右鍵「此電腦」→ 屬性 → 進階系統設定 → 環境變數 → 系統變數 新增/編輯:
變數名變數值
JAVA_HOMED:\Program Files\Java\jdk1.8.0_XXX
CLASSPATH.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
Path在現有值末尾追加 %JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
  1. 驗證:cmd → java -version、javac -version 顯示版本號即成功。
Java 下載頁
配置 JAVA_HOME
驗證 java 版本

步驟 2:下載並解壓 GitBlit

  1. 官網下載 gitblit-1.x.x.zip (或 .tar.gz)。
  2. 解壓至任意目錄,如 D:\Git\Gitblit-1.6.0。無需安裝,綠色免安裝。
GitBlit 下載
解壓目錄

步驟 3:建立資料儲存目錄

建議獨立磁碟/分區,如 D:\GitData\repositories。
此目錄將存放所有 Git 倉庫裸倉庫、用戶資料、索引等。

建立資料目錄

步驟 4:配置 gitblit.properties

編輯 D:\Git\Gitblit-1.6.0\data\gitblit.properties (記事本開啟),核心修改:

屬性建議值說明
git.repositoriesFolderD:/GitData/repositories倉庫儲存根目錄 (正斜線或雙反斜線)
server.httpPort8080HTTP 埠,避開 80 避免衝突
server.httpBindInterface0.0.0.0監聽所有網卡 IP,或指定具體內網 IP
server.httpsBindInterfacelocalhostHTTPS 僅本地回環 (生產建議配合反向代理終止 SSL)
server.storePasswordsInPlainTextfalse密碼加密儲存 (預設 true,建議改 false)
配置 repositoriesFolder
配置 httpPort

步驟 5:啟動測試

  1. 雙擊 gitblit.cmd (或 CMD 執行),控制台顯示啟動日誌,無錯誤即成功。
  2. 瀏覽器訪問 https://<ServerIP>:8080,預設帳號/密碼 admin / admin,**首次登入請立即修改密碼**。
啟動成功日誌
Web 登入頁

步驟 6:註冊為 Windows 服務 (開機自啟、後台運行)

  1. 編輯 D:\Git\Gitblit-1.6.0\installService.cmd (記事本):
@echo off
set ARCH=amd64          :: 64位系統用 amd64,32位用 x86
set CD=D:\Git\Gitblit-1.6.0   :: 你的 GitBlit 解壓目錄
set StartParams=        :: 啟動參數留空即可
:: 其餘保持預設
編輯 installService.cmd
  1. **以管理員身分執行 CMD**,切換至 GitBlit 目錄,執行:
    installService.cmd
  2. 服務名稱預設為 Gitblit,可在 services.msc 中查看、設定「自動啟動」。
以管理員身分執行
服務列表

常見問題與優化

  • 中文檔名亂碼: GitBlit 預設 UTF-8,Windows 檔案系統編碼問題可在 gitblit.properties 設 server.encoding=UTF-8 並確保 Java 環境支援。
  • 大檔案推送失敗: 調整 git.maxFileSize、http.maxRequestSize (單位 Bytes)。
  • 反向代理 (Nginx/IIS) 終止 SSL: 將 GitBlit 綁定 127.0.0.1:8080,Nginx 監聽 443 轉發,配置 proxy_set_header X-Forwarded-Proto https。
  • 備份策略: 定期備份 git.repositoriesFolder 整個目錄 (含 users.conf, settings.conf)。
copyright © 萬盛學電腦網 all rights reserved