基本使用
gogs是自包含的程序,把包含gogs的壓縮包解壓後,無需安裝,可直接執行。
命令行中輸入
gogs web
可以啓動gogs服務,首次啓動會自動引導到初始化配置頁面,按需配置即可。
自定義配置的存儲位置爲 custom/conf/app.ini
,可按需配置修改。
配置HTTPS
在 custom/conf/app.ini 文件中修改(新增)配置選項
[server]
PROTOCOL = https
CERT_FILE = custom/https/cert.pem
KEY_FILE = custom/https/key.pem
如果gogs用了構建標籤 cert,則可以直接用於生成自簽名證書
gogs cert -ca=true -duration=8760h0m0s -host=myhost.example.com
自簽名證書無法提交
如果使用了自簽名證書走https協議,提交的時候則會出現錯誤提示
fatal: unable to access 'http:.git/': SSL certificate problem: self signed certificate
這個錯誤和gogs沒多大關係,在配置本地git禁用sslVerify
git config --global http.sslVerify false
內網環境部署
將 Gogs 運行於內網環境,可修改(新增)配置選項
[server]
OFFLINE_MODE = true
這將使Gogs運行於離線模式,一些需要訪問互聯網的操作將不會被觸發,避免網絡超時,響應緩慢。
Windows服務
gogs如果使用了minwinsvc標籤構建,則可直接作爲Windows服務使用
sc create GogsGit start= auto binPath= "\"D:\important!!!\gogs\gogs.exe\" web --config \"D:\important!!!\gogs\custom\conf\app.ini\""
除了自帶的支持外,也可以使用通用的NSSM程序創建gogs服務。
Windows服務的路徑問題
配置文件中如果是用了相對路徑,比如
[database]
PATH = data/gogs.db
在普通啓動模式下是能正常運行,但在服務模式下卻不能正常訪問已有數據,這是因爲在服務程序的相對路徑並不是exe的路徑,而是服務控制程序的路徑
C:\Windows\system32
在配置文件中使用絕對路徑可解決該問題。