環境準備
站點伺服器：ubuntu server 22 LST , RAM 4G +(不然很可能502)
個人PC：Vscode , git , xshell遠端工具
站點伺服器雲伺服器，實體機子均可。再次動用家裡的NAS-unraid開了一臺ubuntu 虛擬機器，虛擬機器用任意linux發行最新版本均可。
搭建開始
上一篇文章分享了hexo部落格站點的搭建，但是苦於github在偉大的牆外，時不時會給你來個失聯，又不太想頻繁動用神秘力量，所以目標盯上了gitlab，準備藉著本地環境做一個私有化版本管理。為什麼不選gitee呢，因為適用要申請，我懶得填我郵箱等他回覆
前期準備
安裝ubuntu沒啥特別要講的，就有幾點注意下，
- 沒特殊需求，別裝輕量版，輕量版很多包都要後下載
- 網路配置裡subnet不是填子網掩碼，是填寫的子網網段，例如ip地址是
192.168.199.100/24，subnet就填寫192.168.199.0/24 - 安裝系統會要求建立個人賬號，該賬號為特權使用者
- 安裝過程中會可以直接更換源的地址，建議安裝過程中直接換成國內映象源。如果忘記更換，可參考該網站清華映象源說明文件https://mirror.tuna.tsinghua.edu.cn/help/ubuntu/
安裝完系統後，vnc登陸到後臺，先修改源映象下載地址並更新軟體包，速度依據網速而定
$ sudo apt update
$ sudo apt upgrade -y
由於ubuntu為了安全，預設禁用了root使用者的ssh直連，並且密碼和自建的個人賬號不一樣，需要更換
$ sudo passwd root
然後修改一下ssh的配置檔案，找到#PermitRootLogin prohibit-password，將取消註釋，按如下填寫
$ vi /etc/ssh/sshd_config
#...
PermitRootLogin yes
#...
配置檔案儲存後，重啟ssh服務
$ sudo systemctl restart ssh.service
隨後，在個人PC上就可以直接用root遠端ssh了
部署私有化gitlab
本來是直接參考官網的安裝步驟的，但有些東西說的很含糊，直接無腦跟著教程走一遍直接報錯無法啟動，參考網上分享的經驗帖，整合了一下才將gitlab搭建完成。
前期準備
按照gitlab官網ubuntu安裝的教程，先安裝依賴
$ sudo apt-get install -y curl openssh-server ca-certificates tzdata perl
本地離線gitlab，postfix服務就不用裝了，直接下一步下載本體
$ curl -fsSL https://packages.gitlab.cn/repository/raw/scripts/setup.sh | /bin/bash
下一步官網教程就很耐人尋味了，如果你需要使用域名進行訪問，那麼至少要確保本機能夠使用這個域名訪問，公網你申請域名、備案、做公網dns就可以了。本篇描述的是區域網內，而且一般情況下區域網內不會單獨設定一臺dns伺服器。
先修改主機名，以及host檔案資訊
$ sudo hostnameclt set-hostname gitlab.example.com
$ vi /etc/hosts
#...
xxx.xxx.xxx.xxx gitlab.example.com
#...
然後測試一下這個域名是否指向你裝置的ip，如果對了的話就沒問題
這裡注意一下，如果所處的區域網能夠訪問外網，需要確認一下這個域名是不是本來就存在的，如果本來就存在會有影響
$ host gitlab.example.com
# gitlab.example.com has address xxx.xxx.xxx.xxx
自發ssl證書（可選）
預先建立gitlab目錄，建立私有金鑰
$ mkdir -p /etc/gitlab/ssl
$ openssl genrsa -out "/etc/gitlab/ssl/gitlab.example.com.key" 2048
建立私有證書，資訊隨便填寫就行，或者如下填寫(其中填寫的密碼等會會用到，記得保留)
$ cd /etc/gitlab/ssl
$ openssl req -new -key "/etc/gitlab/ssl/gitlab.example.com.key" -out "/etc/gitlab/ssl/gitlab.example.com.csr"
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [XX]:CN CN #國家
State or Province Name (full name) []:SX SX #省份
Locality Name (eg, city) [Default City]:XA XA #城市
Organization Name (eg, company) [Default Company Ltd]: #空格
Organizational Unit Name (eg, section) []: #空格
Common Name (eg, your name or your server's hostname) []:gitlab.example.com
Email Address []:123456@qq.com #郵箱地址
Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:123456 # 密碼
An optional company name []: #空格
ssl金鑰和證書都建立好以後，利用兩者建立crt簽署證書
$ openssl x509 -req -days 365 -in "/etc/gitlab/ssl/gitlab.example.com.csr" -signkey "/etc/gitlab/ssl/gitlab.example.com.key" -out "/etc/gitlab/ssl/gitlab.example.com.crt"
Signature ok
subject=/C=CN/ST=SX/L=XA/O=Default Company Ltd/CN=gitlab.example.com/emailAddress=123456@qq.com
Getting Private key
利用openssl簽署pem證書，並修改剛剛建立的證書許可權
$ openssl dhparam -out /etc/gitlab/ssl/dhparams.pem 2048
Generating DH parameters, 2048 bit long safe prime, generator 2
This is going to take a long time
..............................+..............................................................................................................................................................................................................................+.+..........................................................+...........................................................................................................................................+...........................................................................................................................................................................................................................................................+.....................................................................................+.........................................
$ chmod 600 * /etc/gitlab/ssl/
開始安裝gitlab
前面準備工作完成後，回到官方文件進行gitlab快速安裝，這裡的EXTERNAL_URL就是前面配置的域名資訊，如果配置了ssl證書，可以直接填寫https協議。
這條命令理論上也可以直接使用ip地址去訪問，因為這一步安裝時間比較長，就沒進行測試。
$ sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-jh
等待比較長一段時間，過程中可能會卡在ruby_block[wait for logrotate service socket]這裡一直不動。直接CTRL+C或者CTRL+Z直接強制中斷，然後重啟服務sudo systemctl restart gitlab-runsvdir
執行完成後，重置配置gitlab-ctl reconfigure
等待重置後，因為剛剛執行的命令是快速安裝，抹蜜是隨機生成的，會存放在/etc/gitlab/initial_root_password目錄中，該檔案會在24小時後自動刪除
訪問https://gitlab.example.com進到gitlab登陸頁面後，使用root賬號以及上述檔案中的密碼進行登陸，就成功進入到gitlab管理員後臺頁面了。
frp內網對映
本次使用的是櫻花對映SakuraFrp進行內網穿透，如果有其他內網穿透工具原理相通。
地址：https://www.natfrp.com/，該平臺主要用在遊戲小型伺服器開服對映
使用者註冊略過，該平臺使用節點需要進行實名驗證（一個身份證只能用於一個賬號，而且會拉取支付寶進行人臉識別認證），如有建站需求，還需要額外進行網站備案的驗證。
實名驗證完成後，部分節點才能進行使用。一般情況下不需要氪金，普通使用者組就夠用了，10Mbps，按每月訪問流量進行計算的，每天簽到均可拿流量。
登陸後點服務-隧道列表，建立一個隧道。因為是普通使用者，滿載和無許可權就不要選了，這些節點基本夠用了，隨便選擇一個。
隧道型別選擇https或者http建站隧道，ip地址可以就填寫127.0.0.1，或者寫內網ip也行，埠選擇gitlab的443，如果說有購買過域名的，將域名填寫進去。
因為之前本片是區域網搭建，直接不用建站節點也能訪問，雖然有機率被查然後隧道禁掉。本片提到的內網對映僅用於臨時測試與技術學習，建站請符合規定，進行站點備案。選擇udp節點，隧道型別選擇tcp隧道，本地ip和埠同上127.0.0.1:443，遠端埠為對映後的埠，如果不填寫會隨機生成，其他留空。
建立完成後會彈出配置檔案資訊，其中內容只要關注-f xxxxx:xxxx這行內容即可。
回到gitlab伺服器上，確認處理器架構。
一般都是顯示
amd64，即x86_64，詳細可參考https://doc.natfrp.com/frpc/usage.html
$ uname -m
amd64
確定了伺服器的架構後，回到櫻花對映網站，選擇服務-軟體下載，並將對應作業系統、
處理器架構的客戶端下載連結複製。再回到gitlab伺服器上，
$ cd /usr/local/bin
$ wget -O frpc <剛剛複製的下載地址>
# 如果上面的命令報錯，請嘗試這條:
$ curl -Lo frpc <剛剛複製的下載地址>
修改檔案許可權並校驗檔案是否傳輸正確，櫻花對映網站下載頁面有提供md5資訊
$ chmod 755 /usr/local/bin/frpc
$ md5sum /usr/local/bin/frpc
檢查完成後，執行如下命令檢視frpc版本。
$ frpc -v
0.45.0-sakura-2.3
如正常返回版本資訊，則說明客戶端安裝完成，簡單進行臨時測試直接將前面提到的配置檔案的-f xxxx:xxxx作為引數執行即可
$ frpc -f xxxx:xxxx
執行後，會列印日誌資訊顯示可以使用的域名/ip以及埠，該地址和所建立的隧道繫結，只要隧道資訊沒有變更，該地址不會修改。
但是該方法，遠端視窗關閉以後就會對映就會終止，可採用下面的命令，遠端視窗關閉也不受影響
$ nohup frpc -f xxxx:xxxx &
gitlab訪問與維護
新註冊的使用者註冊後無法直接登入到平臺，需要管理員登陸後臺進行批准才能授權登陸。
由於自建的gitlab站點ssl證書是自籤的，git通常是無法認證ssl證書，因此需要將該檢查關閉，為減小安全風險，可就對該專案內配置資訊生效
$ git config –local http.sslVerify false
$ git config –local https.sslVerify false
資料備份與恢復（未完待更，2023/2/28）
因為我本地有nas的原因，我可以直接建立一個nfs空間進行虛機資料的備份，gitlab本身也自帶備份功能，不需要像其他linux裝置整盤備份那麼佔用空間。
建立備份目錄，檢測遠端nfs伺服器掛載目錄，並將該目錄掛載到本地。檢視本地目錄有遠端nfs掛載說明已經掛載到指定目錄了。
$ mkdir -p /backup
$ showmount -e xxx.xxx.xxx.xxx
Export list for xxx.xxx.xxx.xxx:
/mnt/user/system-backup *
$ mount xxx.xxx.xxx.xxx:/mnt/user/system-backup /backup
$ df -h
檔案系統 容量 已用 可用 已用% 掛載點
devtmpfs 888M 0 888M 0% /dev
tmpfs 907M 0 907M 0% /dev/shm
tmpfs 907M 8.6M 898M 1% /run
tmpfs 907M 0 907M 0% /sys/fs/cgroup
/dev/mapper/xxxx 30G 3.9G 27G 13% /
/dev/mapper/xxxx 50G 2.2G 48G 5% /data
/dev/mapper/xxxx 15G 140M 15G 1% /home
/dev/sda1 1014M 283M 732M 28% /boot
tmpfs 79M 0 79M 0% /run/user/0
xxx.xxx.xxx.xxx:/mnt/user/system-backup 8.7T 349G 8.3T 4% /backup
frp內網對映後
在內網訪問的時候，可選用ssh協議或者https協議進行程式碼進行版本管理。但是進行內網對映後需要修改資訊，因為製作了443埠的對映，因此ssh協議就無法使用了。原則上也可以再申請一個隧道把ssh協議打通
之前訪問的地址是https://gitlab.example.com/xxx/xxx.git，由於埠對映的原因，需要去訪問https://<櫻花對映地址>:<櫻花對映埠>/xxx/xxx.git進行管理，可臨時新增一個倉庫源
$ cd <專案目錄>
$ git remote add gitlab-local-frpc https://<櫻花對映地址>:<櫻花對映埠>/xxx/xxx.git
$ git pull gitlab-local-frpc main
進行賬號認證後，即可順利訪問到gitlab目標倉庫。
最後編輯時間 2023/03/01 23:25
References:
- gitlab本地環境搭建
Gitlab搭建詳細步驟：https://blog.csdn.net/qq_15290209/article/details/126230624
Gitlab官方搭建文件：https://docs.gitlab.cn/omnibus/installation/index.html
Gitlab官方使用文件：https://gitlab.cn/install/
公司內網安裝gitlab (1. 安裝時卡在ruby_block[wait for logrotate service socket] action run ,2.安裝之後訪問報502)：https://blog.csdn.net/pcc945/article/details/123180611 - 內網對映
櫻花對映官方使用文件：https://doc.natfrp.com/frpc/usage.html - 擴充
Linux的nfs服務：https://blog.csdn.net/m0_71521555/article/details/125904597
gitlab官方備份與恢復文件：https://docs.gitlab.cn/jh/raketasks/backup_restore.html#%E5%A4%87%E4%BB%BD%E5%92%8C%E6%81%A2%E5%A4%8D%E6%9E%81%E7%8B%90gitlab