15分鐘爲自己架設優雅如Github的代碼倉庫

作爲一個老司機，怎能沒有自己的私人代碼倉庫？

前言

Github大家都熟悉。

除了開源的項目外，有時候，大家也會把自己或團隊、公司的項目傳到Github的私有倉庫裏，把Github當成自己的私人Git Server。

但是，用Github會有一些問題：

1. Github從國內訪問不是很穩定，有時候會很慢，很影響使用；
2. Github畢竟是個商業運作的網站，有些規則未來是否會變，不得而知；
3. 一般我們放到私有倉庫的項目，不會做很仔細的清理，代碼中的密鑰、服務器地址、帳號，就那樣寫在那裏。一旦這個庫被公開，這些信息會成爲生產系統最大的漏洞。

第三點尤其重要。回想一下，前幾天Github私有倉庫被黑客攻破的事，會影響到您、或您的團隊嗎？

 

所以，我們希望有一個自己的Git Server，

1. 能滿足Git管理代碼的需要，這是最基本的；
2. 能像Github一樣，有一個完整的BS架構的管理界面（我喜歡那個界面，而且很熟悉）;
3. 最好是全部可控的，是自己搭建的Git Server。

 

今天給大家介紹的，叫Gitea，是我自己用的完全類似Github的Git Server。

    爲了防止不提供原網址的轉載，特在這裏加上原文鏈接：https://www.cnblogs.com/tiger-wang/p/12925099.html

一、Gitea

先看一下Gitea運行後的樣子：

【圖片1】

是不是很熟悉？

 

Gitea是一個開源社區驅動的代碼託管解決方案，使用Go作爲後端語言，並形成一個可執行的程序。它可以支持x86、x64，以及ARM和PowerPC，換句話說，你可以裝到你喜歡和需要的任何操作系統上。

Gitea的官網：https://gitea.io

Gitea最新版本的下載地址：https://dl.gitea.io/gitea

 

在Gitea的官網上，可以找到從安裝到使用的全部幫助。而這篇文章，是根據我自己的經驗以及刨過的坑，一步步教大家完成一個Gitea的完整搭建及配置調整。

二、安裝前的準備

Gitea運行需要兩個外部系統：數據庫和Git客戶端。

第一部分：數據庫

Gitea需要數據庫支持。

Gitea的代碼倉庫，是以文件的形式存放的。數據庫用來記錄相關的版本、設置及各種pull&commit信息。

Gitea支持PostgreSQL、MySQL、SQLite和MS SQL，從使用效果上沒什麼區別。

如果你本身有這些數據庫，那可以跳過這一步。

如果沒有，可以裝一個SQLite，方便，也簡單。

 

爲了方便大家使用，我會分Windows和Linux兩條線的安裝來寫。

兩個系統安裝的意義在於：Windows是大多數人開發用的平臺，可以裝一個給自己的代碼用；而Linux是服務器的平臺，可以裝一個給團隊用。

1. Windows安裝SQLite

SQLite官網：https://sqlite.org

SQLite最新版本下載地址：https://sqlite.org/download.html

Windows下安裝SQLite，只需要從官網上下載：https://sqlite.org/2020/sqlite-dll-win64-x64-3310100.zip就行。下載完成後，解壓到一個目錄，比方：D:\Program Files\SQLite3。

然後，我們需要把這個目錄加到環境變量Path中。在Windows中，按WIN+R打開運行，輸入sysdm.cpl打開系統屬性，進到高級->環境變量，在系統變量中，編輯Path，在變量值的最後加入;D:\Program Files\SQLite3即可。

 

就這麼簡單，SQLite在Windows下安裝完成。

 

當然，這個安裝完成的是應用系統使用SQLite的支持。如果你想管理SQLite，或看看數據庫裏有什麼內容，可以多下載一個：https://sqlite.org/2020/sqlite-tools-win32-x86-3310100.zip，下載完，也是解壓到D:\Program Files\SQLite3目錄下，就可以了。使用時，在命令行輸入：

> sqlite3 your_path/your_database_file_name
SQLite version 3.31.1 2020-01-27 19:55:54
Enter ".help" for usage hints.
sqlite>

如果沒看到這個，說明Path沒啓用。退出重登一下Windows就好。

2. Linux安裝SQLite

Linux下安裝SQLite，可以從下載頁下載源代碼自行編譯，也可以直接下載編譯好的二進制包。當然還可以更簡單的從包源安裝：

# apt-get install sqlite3

SQLite在Linux下也安裝完成。

第二部分：Git客戶端

Gitea運行還需要Git客戶端。可以使用任何Git客戶端。如果已經安裝了，可以跳過下面這一步。

 

1. Windows安裝Git客戶端

Git官網：https://gitforwindows.org

官網進去後，有一個大大的Download按鈕，用力點下去，就開始下載。

下載完成後，是個可執行的安裝文件。運行安裝文件，即可完成Git客戶端的安裝。

安裝完成後，也需要在環境變量中設置Path，加進去Git命令的運行目錄。Git運行目錄是Git安裝目錄下的bin目錄。

2. Linux安裝Git客戶端

大多數情況下，Linux下會自帶Git客戶端，可以檢查一下：

# git --version

如果已安裝，會返回版本信息。

如果沒有安裝，使用包管理裝一個

# apt-get install git

三、安裝Gitea

安裝Gitea我也分Windows和Linux兩條線來寫。因爲Linux和Windows系統權限的管理方式不一樣，所以安裝過程會有一些不同。

 

1. Windows安裝

下載for Windows的最新版1.11.5：https://dl.gitea.io/gitea/1.11.5/gitea-1.11.5-windows-4.0-amd64.exe。

把下載下來的文件改成名，叫gitea.exe，然後放到一個目錄，比方D:\gitea目錄下，安裝就完成了。

 

Gitea在Windows上可以直接運行，也可以加爲Service。

我們先直接運行試試：

> d:\gitea\gitea.exe web
cmd/web.go:107:runWeb() [I] Starting Gitea on PID: 5840

這就算啓動了。

當然，這只是個檢查。正式運行時，我們還是需要把它加到Service裏運行。按WIN+R，打開運行，輸入命令：

sc create gitea start= auto binPath= "\"d:\gitea\gitea.exe\" web --config \"d:\gitea\custom\conf\app.ini\""

點確定，就加到Windows服務裏了。

接下來，啓動服務gitea，就完成了。

 

2. Linux安裝

下載for Linux的最新版1.11.5：

# wget -O gitea https://dl.gitea.io/gitea/1.11.5/gitea-1.11.5-linux-amd64

下載完成後，把gitea移到/usr/local/bin目錄，並改爲可執行。

# mv gitea /usr/local/bin
# chmod +x gitea

Gitea也就算是安裝完成了。

 

下面建幾個Gitea的數據目錄：

# mkdir /var/lib/gitea
# mkdir /var/lib/gitea/{custom,data,log}
# mkdir /etc/gitea

目錄的位置，文章中就採用Gitea推薦的位置了。實際安裝時可以自己定義。

其中：

/var/lib/gitea是存放倉庫相關文件的目錄

/etc/gitea是存放配置文件app.ini的目錄

 

爲了服務器的安全，我們還需要做一點技術處理：創建一個系統用戶git，

# adduser git --system --shell /bin/bash --group --disabled-password --home /home/git

把上面建立的幾個目錄給到git用戶：

# chown -R git:git /var/lib/gitea
# chown git:git /var/gitea

 

Gitea在Linux上需要以Service的方式運行。

把以下配置保存到文件gitea.service：

[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
After=network.target

[Service]
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

修改gitea.service爲可執行，並複製到/etc/systemd/system目錄：

# chmod +x gitea.service
# mv gitea.service /etc/systemd/system
# systemctl enable gitea.service

 

最後一步，啓動Service：

# systemctl start gitea.service

完成。

四、設置Gitea

安裝完成並運行啓動後，我們需要對Gitea進行配置。

Gitea默認運行在3000端口上。所以，在瀏覽器打開：http://your_gitea_server_ip:3000，看到一個漂亮的界面，就說明安裝正確，連上服務器了。

 

1. 配置服務器

從界面右上角註冊或登錄點進去，會看到一個很長的表格，別慌，我一個一個說。

• 數據庫設置

先選擇數據庫類型。如果是用原有的數據庫，相關的參數需要填進去。我們安裝用的Sqlite3，所以選擇這個。下面會有一個數據庫路徑，這個不需要改，就用默認的。在Windows下，Gitea會自己在運行目錄下建立目錄和數據文件；Linux下我們是預先建立好的。

當然如果你有某種習慣，可以隨便改，不過要注意，Windows下不存在問題，Linux下需要注意目錄的權限。這個權限會跟着下面「以用戶名運行」參數來設置。如果要修改，先看看下面的說法。

• 一般設置

這裏面：

站點名稱，你的站點你自己起名嘍；

倉庫根目錄，跟上面數據庫文件路徑一樣，有默認位置，自己決定要不要改；

LFS根目錄，跟倉庫一樣，用來存放大文件，

以用戶名運行，這個要注意：Windows下面是SYSTEM，是服務的運行帳號，所以，如果要改，需要同步修改服務的運行帳號；Linux下面，是git，就是上文Linux安裝的部分裏，建立的那個系統帳號，同時，也是建立的幾個目錄的所有人。所以，在Linux下，所有跟文件目錄有關係的地方，如果需要修改，要同時把目錄的權限改成這個用戶。

其它參數都好理解，不詳細寫了。

• 服務和第三方服務設置

禁止用戶自助註冊，含義寫的很明確。通常會禁掉。

啓用頁面訪問限制，這個參數是決定這個網站是公開的還是私有的。如果這個外人像瀏覽Github一樣訪問你的這個倉庫，可以勾選上。

• 管理員帳號設置

這個網站，第一個註冊的帳號，會自動成爲管理員。在上面禁止註冊後，需要這個管理員來建立用戶帳號。

 

搞定上面的設置後，點最下面的立即安裝，配置也完成了。

五、升級

Gitea社區很活躍，版本迭代很快。

有新版本時，先下載新版本的Gitea，然後停掉服務，覆蓋舊的Gitea程序，再啓動服務。搞定。

 

嗯，接下來，Enjoy your private Github !!!

 

---

 

微信公衆號：老王Plus 掃描二維碼，關注個人公衆號，可以第一時間得到最新的個人文章和內容推送 本文版權歸作者所有，轉載請保留此聲明和原文鏈接