CentOS環境下GitLab使用常見問題解答

以下是CentOS環境下GitLab的常見問題及解決方案：

1. 依賴問題

   • 安裝時若提示缺少policycoreutils-python等依賴包，可通過yum install policycoreutils-python安裝。

2. 端口沖突

   • 若默認端口（如80、443）被占用，修改/etc/gitlab/gitlab.rb中external_url或對應服務端口（如unicorn['port']），然后執行gitlab-ctl reconfigure并重啟服務。
   • 查看端口占用情況：lsof -i :端口號，用kill -9 PID終止占用進程。

3. 防火墻設置

   • 確保開放HTTP（80）、HTTPS（443）、SSH（22）等端口：
     firewall-cmd --permanent --add-service=http/https/ssh --reload。

4. 內存不足

   • 若出現502錯誤或服務卡頓，需增加物理內存或配置swap分區（建議≥4GB）。

5. 配置文件錯誤

   • 修改/etc/gitlab/gitlab.rb后，需執行gitlab-ctl reconfigure使配置生效，重啟服務：gitlab-ctl restart。

6. 郵件發送失敗

   • 檢查/etc/gitlab/gitlab.rb中SMTP配置（如smtp_address、smtp_port、smtp_user_name等），確保賬號密碼正確，且端口未被防火墻攔截。

7. 訪問失敗

   • 檢查服務器網絡、防火墻及DNS解析，確保域名或IP可正常訪問。
   • 若使用HTTPS，確保證書配置正確，或臨時禁用SSL驗證（僅限測試環境）。

8. 性能問題

   • 優化配置：調整unicorn['worker_processes']（建議≤CPU核數），啟用緩存或升級硬件（如SSD存儲）。

9. SELinux問題

   • 若因SELinux導致服務異常，可臨時禁用：setenforce 0，并修改/etc/selinux/config永久生效。

日志排查：通過tail -f /var/log/gitlab/gitlab-ctl/production.log查看詳細錯誤信息。

如需進一步幫助，可參考GitLab官方文檔或社區論壇。