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

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

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

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

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

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

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

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

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

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

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

Linux 的 PMS 工具主流有兩種。

對于基于 Red Hat 的發行版，其 PMS 工具為 rpm，對應的安裝命令為 yum。

對于基于 Debian 的發行版，其 PMS 工具為 dpkg，對應的安裝命令為 aptitude。

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

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

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

到官網中下載 GitLab，網址：https://packages.gitlab.com/gitlab/gitlab-ee

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

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

【提示】

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

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

（注意：雖然這是離線安裝包，但安裝時并非完全不需要網絡。在初次安裝時，操作系統可能會首先對軟件倉庫進行更新，此過程需要聯網。）

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

在修改前，如果因為好奇等原因已經啟動了 GitLab 服務，則需要使用如下命令關閉 GitLab 服務。

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

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

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

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

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

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

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

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

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

現在到任一能訪問到該 Linux 服務器的瀏覽器中輸入如下網址，應該就可以訪問 GitLab 網頁端了。

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

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

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

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

【注意】

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

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

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

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

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

停止 GitLab 服務。

卸載 GitLab。（卸載這種操作有風險，可能導致再次安裝時永遠失敗，請三思后行）

查看與 GitLab 相關的進程。

根據 PID，殺死那個有很多省略號的進程。

其中，進程 PID 號 要換成實際的值。

刪除與 GitLab 相關的文件

刪除以下的 Linux 用戶：（此操作可能有風險，謹慎使用）

卸載完重啟 Linux。