目前，GitLab 不支持直接安裝在 Windows 中，因此進(jìn)行這個教程之前，必須要先安裝好一個 Linux 操作系統(tǒng)。這個 Linux 操作系統(tǒng)可以安裝在虛擬機中，也可以安裝在真實的電腦中。關(guān)于這方面的內(nèi)容，可見筆者的其它博客：

VMware Workstation Pro 16 安裝教程：
https://blog.csdn.net/wangpaiblog/article/details/112152218?spm=1001.2014.3001.5502

Linux 操作系統(tǒng) CentOS Stream 安裝教程：
https://blog.csdn.net/wangpaiblog/article/details/119792728?spm=1001.2014.3001.5502

為了方便遠(yuǎn)程輸入命令、將文件加入到 Linux 操作系統(tǒng)中，最好還要在一臺 Windows 操作系統(tǒng)上面使用一種終端控制軟件，如 Xshell、Xftp 等。關(guān)于這方面的內(nèi)容，可見筆者的另一篇博客：

如何在 Windows 主機上訪問本地局域網(wǎng)中的 Linux 主機：
https://blog.csdn.net/wangpaiblog/article/details/120052152?spm=1001.2014.3001.5502

一般來說，安裝一個軟件有 3 種方法：離線安裝、在線安裝、免安裝。通常，離線安裝是最好的方法，同時也通常是筆者的首選，本文亦使用的是離線安裝的方法。

對于 Linux，這三種方法各有千秋。筆者分別試驗了這 3 種方法，但只給出離線安裝的方法。因為對于安裝來說，提供多種選擇實屬多余，還會增加讀者選擇上的負(fù)擔(dān)。

對于 Linux，離線安裝的好處與壞處分別為：

• 好處：除了第一次下載需要下載完整的安裝包之外，之后每次安裝都可無需聯(lián)網(wǎng)。這樣不僅節(jié)約了流量，而且無需擔(dān)心未來安裝包會失效。相對免安裝，安裝操作會在操作系統(tǒng)中注冊該軟件的信息，會安裝時會自動執(zhí)行某些操作，通常可以避免一些手動配置。
• 壞處：離線安裝無法自動安裝依賴。如果所要安裝的安裝包依賴其它安裝包，安裝者需要自己手動下載完所有的依賴安裝包。

由于 Linux 操作系統(tǒng)的種類繁多，因此首先要知道要安裝 Linux 操作系統(tǒng)的處理器架構(gòu)信息。以 CentOS 8 x86_64 為例，輸入以下命令：

可以看出，上述的關(guān)鍵信息為 x86_64。記住這一點，下面將會用上。

Linux 的 PMS 工具主流有兩種。

對于基于 Red Hat 的發(fā)行版，其 PMS 工具為 rpm，對應(yīng)的安裝命令為 yum。

對于基于 Debian 的發(fā)行版，其 PMS 工具為 dpkg，對應(yīng)的安裝命令為 aptitude。

筆者的操作系統(tǒng) CentOS 8 x86_64 屬于 Red Hat，將使用后綴為 rpm 的安裝包。如果讀者使用的操作系統(tǒng)為 Ubuntu，需要選擇后綴為 deb 的安裝包。如果讀者不知道如何分辨，可以輸入以下命令來驗證：

如果輸入 yum 之后，出現(xiàn)了一大串的說明文字，說明應(yīng)該使用后綴為 rpm 的安裝包。如果提示 yum 命令不存在，說明應(yīng)該使用后綴為 deb 的安裝包。當(dāng)然，讀者也可以通過輸入命令 aptitude 來進(jìn)行進(jìn)一步的驗證。

GitLab 有 CE 與 EE 兩種版本，其中，CE 指的是 Community Edition（社區(qū)版） ，EE 指的是 Enterprise Edition（企業(yè)版）。顯然，顧名思義，EE 是一種收費版。如果沒有特殊的需求，選擇哪個版本無關(guān)緊要。官方推薦安裝 EE 版，給出的理由是，安裝 EE 版本后，如果不想付費，可以不付費，只是會缺少相應(yīng)的功能。但如果安裝完 CE 版本后，又想安裝 EE 版本，還需要重新安裝（見 https://about.gitlab.com/install/ce-or-ee/）。這里，筆者安裝的是 EE 版。畢竟，國內(nèi)的環(huán)境良好，有很多途徑可以讓付費產(chǎn)品變成免費。

到官網(wǎng)中下載 GitLab，網(wǎng)址：https://packages.gitlab.com/gitlab/gitlab-ee

注意，這里要根據(jù)前面查看的 Linux 系統(tǒng)的信息來下載對應(yīng)的安裝包。此處筆者應(yīng)該選擇帶 x86、64、Linux 8 字樣的安裝包。

再次提醒，安裝包不要選錯了，選擇錯誤的安裝包在安裝后可能出現(xiàn)各種難解的問題。比方說，Centos Stream 與 Centos 不是同一種操作系統(tǒng)，而在筆者編寫本教程的時候，GitLab 并沒有為 Centos Stream 提供安裝包，所以如果操作系統(tǒng)是 Centos Stream，那目前是不能安裝 GitLab 的！

【提示】

??GitLab 官網(wǎng)中已經(jīng)給出了 GitLab 安裝配置的參考教程，鏈接：https://about.gitlab.com/install/#centos-8

下載完成之后，可以使用 Xftp 將安裝包置入 Linux 操作系統(tǒng)中。然后進(jìn)行該安裝包目錄，輸入以下命令進(jìn)行安裝：

（注意：雖然這是離線安裝包，但安裝時并非完全不需要網(wǎng)絡(luò)。在初次安裝時，操作系統(tǒng)可能會首先對軟件倉庫進(jìn)行更新，此過程需要聯(lián)網(wǎng)。）

設(shè)置 GitLab 網(wǎng)頁客戶端網(wǎng)址。網(wǎng)址應(yīng)該由 IP 與端口號組成。IP 是 GitLab 所在的 Linux 服務(wù)器的 IP。端口號可任意想一個不會與已有的端口號相沖突的端口號。應(yīng)在文件 gitlab.rb 中設(shè)置這個信息。文件 gitlab.rb 在目錄 /etc/gitlab 中。修改文件 gitlab.rb 的方法有很多，可以直接用 Xftp 將打開此文件進(jìn)行修改。

在修改前，如果因為好奇等原因已經(jīng)啟動了 GitLab 服務(wù)，則需要使用如下命令關(guān)閉 GitLab 服務(wù)。

在文件 gitlab.rb 中的 external_url 一行上添加如下代碼。如果沒有 external_url 這一行，那就新加這一行。

其中，ip地址、端口號 要換成實際的值。

在防火墻中對外開啟此端口。

其中，端口號 要換成上面設(shè)置的實際值。

設(shè)置 GitLab 的數(shù)據(jù)存放路徑。此處如果不設(shè)置，則默認(rèn)路徑為 /var/opt/gitlab/git-data/。修改的方法是在文件 gitlab.rb 編寫如下代碼：（注意：在修改路徑前，要將原 GitLab 的數(shù)據(jù)存放目錄下的文件拷貝到新目錄中。）

其中，自定義的 GitLab 倉庫儲存路徑 要改成實際的值。

使用如下命令使上面的配置生效。

如果曾經(jīng)多次反復(fù)卸載過 GitLab，而且沒有卸載干凈，則此過程很容易卡住。需要中斷操作然后將 GitLab 卸載干凈再來進(jìn)行此操作。

如果是第一次配置，則執(zhí)行完上述命令之后，GitLab 服務(wù)會自動設(shè)置成開機啟動且馬上會啟動。如果沒有 GitLab 服務(wù)沒有啟動，也可以使用如下命令。

現(xiàn)在到任一能訪問到該 Linux 服務(wù)器的瀏覽器中輸入如下網(wǎng)址，應(yīng)該就可以訪問 GitLab 網(wǎng)頁端了。

其中，ip地址、端口號 要換成實際的值。

此時應(yīng)該看到的是 GitLab 登錄界面。在 GitLab 第一次初始化時，會自動生成一個管理員賬戶。其中，該賬戶的用戶名為 root，密碼在一個自動生成的文件 /etc/gitlab/initial_root_password 中（密碼不會含空格），且會在 24 小時后自動被刪除。

現(xiàn)在要做的是，先備份上述的文件 initial_root_password，然后登錄管理員賬戶修改管理員密碼。新密碼長度不能小于 8 位。

如果更喜歡中文，GitLab 提供了中文界面，可按下圖所示設(shè)置。設(shè)置完成之后，刷新界面即可生效。

【注意】

??有的人使用嘗試對 GitLab 進(jìn)行漢化（https://gitlab.com/xhang/gitlab）。建議不要這樣做，此漢化有風(fēng)險，如果操作不當(dāng)有可能會破壞 GitLab 的程序，使之無法使用。此過程不可逆，請謹(jǐn)慎操作。

上面的登錄界面還可以用于注冊新用戶。不過，新用戶注冊完成之后需要管理員審批。如果不需要審批功能，可以登錄管理員賬戶將其關(guān)閉。

如果想要向 GitLab 上傳推送文件，這需要向 GitLab 添加公鑰，這方面的內(nèi)容與 GitHub 等網(wǎng)站相同，可見筆者的另一篇博客：

Git、TortoiseGit、GitHub、Gitee、GitLab 安裝與入門使用：
https://blog.csdn.net/wangpaiblog/article/details/121278972

如果不小心破壞了 GitLab 的運行環(huán)境而又無法修復(fù)，這就需要重裝 GitLab。在卸載前，注意要備份 GitLab 中倉庫的數(shù)據(jù)文件。徹底卸載 GitLab 的流程如下。

停止 GitLab 服務(wù)。

卸載 GitLab。（卸載這種操作有風(fēng)險，可能導(dǎo)致再次安裝時永遠(yuǎn)失敗，請三思后行）

查看與 GitLab 相關(guān)的進(jìn)程。

根據(jù) PID，殺死那個有很多省略號的進(jìn)程。

其中，進(jìn)程 PID 號 要換成實際的值。

刪除與 GitLab 相關(guān)的文件

刪除以下的 Linux 用戶：（此操作可能有風(fēng)險，謹(jǐn)慎使用）

卸載完重啟 Linux。