手把手教你玩轉 Gitea|在 Windows 系統上安裝 Gitea

Gitea 支持在 Windows 系統上安裝和使用 。Gitea 本身作為一個單體應用程序,即點即用,如需長期駐留作為后臺服務并開機運行就要依靠 Windows 服務工具 sc.exe 。
通過本文,你將學習到以下內容:

  • 安裝 Git for Windows
  • 注冊 Windows 服務
  • 啟用 Gitea 內置的 SSH 服務器
  • 編輯 Windows 防火墻
環境準備服務器配置本文所采用的服務器配置如下 , 建議內存最少在 4GB 以上 。OS 版本可以是 Windows 7/8/8.1/10/11 以及 Server 2012/2016/2019/2022 , 本文優先使用 Windows Server 2022 LTSC,其他系統版本操作類似 。
OSVersionCPURAMWindows ServerLTSC 20224 Core4GBGit for WindowsGitea 執行各項 Git 操作依賴的是背后的 git 命令行工具 , 因此在 Windows 平臺上你需要安裝最新的 Git for Windows
下載安裝包:https://gitforwindows.org
數據庫Gitea 支持的數據庫: SQLite、PostgreSQL、MySQL(MariaDB)、MSSQL
如果無特殊需求(例如集群化、高可用),建議一開始使用內置的 SQLite 作為數據庫搭建輕量級的 Gitea 服務器,數據直接存儲在文件中,備份遷移都更加方便 。
GiteaGitea 官網提供了預編譯的 Windows 平臺二進制程序 。
下載預編譯的二進制程序:https://dl.gitea.io/gitea/
進入下載頁面后,選擇適合你的 Windows 平臺的二進制程序 。
對于 Windows 而言 ,  windows-4.0-amd64 適用于 64 位操作系統,windows-4.0-386 即 32 位操作系統 。
另外,帶有 gogit-windows 名字的 Windows 版本程序使用了 gogit 用于解決在一部分在老舊版本的 Windows 上調用 git 后端導致的性能問題 , 但 gogit 本身也依賴后端的 git 程序,同時自身功能也有局限 。換句話說,如果你的 Gitea 運行良好,性能不錯,就不必嘗試這個版本了 。
安裝Git for Windows一般使用 Git for Windows 安裝包一步步安裝即可 。當然,你也要確保 git 命令始終在 Windows 環境變量 PATH 中 , 檢查辦法是通過終端執行 git 命令 。
PS C:\Users\Administrator> git --versiongit version 2.38.0.windows.1看到 git version 2.38.0.windows.1 說明程序調用成功,打印出了當前版本 。
如果出現沒有找到 Git 命令 , 那么打開,系統設置 - 環境變量 - 系統變量 - Path,手動添加 Git 程序目錄 , 例如 C:\Program Files\Git\cmd 。
手把手教你玩轉 Gitea|在 Windows 系統上安裝 Gitea

文章插圖
安裝 GiteaGitea 的安裝路徑可以自定義,比如使用 C:\gitea 。將前面準備好的二進制程序 (例如 gitea-1.17.2-windows-4.0-amd64.exe) 重命名并復制到 C:\gitea\gitea.exe 。雙擊可執行程序啟動 Gitea 。
手把手教你玩轉 Gitea|在 Windows 系統上安裝 Gitea

文章插圖
當你第一次運行 Gitea 時 , 你需要打開 http://localhost:3000 根據指引完成 Gitea 的初始化安裝 。這個步驟會創建配置文件并存儲到 C:\gitea\custom\conf\app.ini,稍后我們在注冊 Windows 服務時會用到 。
初始配置在 Windows 中 Gitea 的 RUN_USER (以用戶名運行)并不與 Windows 系統的賬戶系統關聯(這一點與 Linux 不同),因此你可以在此處填寫任意用戶名,推薦填寫 git 。
手把手教你玩轉 Gitea|在 Windows 系統上安裝 Gitea

文章插圖
最后,關閉 gitea.exe 窗口即結束 Gitea 主程序 , 也可以使用 Ctrl+C 結束 。
將 Gitea 注冊為 Windows 服務
  1. 請以管理員身份打開命令提示符 (CMD) , 然后運行以下命令:
sc create gitea start= auto binPath= "\"C:\gitea\gitea.exe\" web --config \"C:\gitea\custom\conf\app.ini\""
請注意 , start=binPath= 等號后面有空格
  1. 啟動服務
sc start gitea
  1. WIN + R打開運行窗口,輸入 services.msc 并啟動 Windows 服務管理工具 , 可以找到你剛新建的 Gitea 服務,單機右鍵可以選擇 啟用、停止 或更改 屬性 。

手把手教你玩轉 Gitea|在 Windows 系統上安裝 Gitea

文章插圖
如需刪除服務并重新創建,則使用 sc delete 命令 。
sc delete gitea配置啟用 Gitea 內置的 SSH 服務器一般情況下,Windows 系統無需額外安裝 OpenSSH 服務 。Gitea 內置了一個輕量級的 Go SSH 服務器 , 安裝好之后可以通過修改配置文件手動開啟 。

推薦閱讀