CentOS下GitLab的故障排查

使用gitlab-ctl status命令查看GitLab各组件（如unicorn、nginx、postgresql等）的运行状态。若服务未运行，可通过gitlab-ctl start启动所有组件；若部分组件异常，可单独重启（如gitlab-ctl restart unicorn）。

GitLab日志集中存储在/var/log/gitlab目录下，涵盖应用、Nginx、数据库、Redis等组件。常用命令：

实时查看所有服务日志：sudo gitlab-ctl tail
查看特定组件日志（如Nginx错误日志）：sudo gitlab-ctl tail nginx/gitlab_error.log
查看Rails应用日志（定位业务逻辑错误）：tail -f /var/log/gitlab/gitlab-rails/production.log
日志中的错误信息（如“Connection refused”“Permission denied”）是排查的关键线索。

GitLab依赖PostgreSQL（数据库）、Redis（缓存）、Nginx（Web服务）等组件，需确保它们均正常运行：

检查PostgreSQL状态：sudo systemctl status postgresql
检查Redis状态：sudo systemctl status redis
检查Nginx状态：sudo systemctl status nginx
若服务未启动，使用sudo systemctl start <服务名>启动，并设置为开机自启（sudo systemctl enable <服务名>）。

GitLab默认使用以下端口：

HTTP：80（或自定义，如8080）
HTTPS：443
SSH：22（或自定义，如2222）
需确保这些端口未被其他服务占用（lsof -i :端口号），并通过防火墙开放：
```
sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --permanent --add-service=https sudo firewall-cmd --permanent --add-service=ssh sudo firewall-cmd --reload 
```
若使用SELinux，需调整上下文（sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/log/gitlab(/.*)?"，sudo restorecon -Rv /var/log/gitlab）。

GitLab主配置文件为/etc/gitlab/gitlab.rb，需检查以下关键配置：

external_url：设置为服务器公网IP或域名（如http://192.168.1.100），修改后需运行sudo gitlab-ctl reconfigure使配置生效。
数据库连接（若使用外部数据库）：确保gitlab_rails['db_host']、gitlab_rails['db_username']、gitlab_rails['db_password']等参数正确。
邮件服务（若开启注册/密码重置）：配置SMTP参数（如gitlab_rails['smtp_address']、gitlab_rails['smtp_port']）。

GitLab对资源要求较高，需确保：

内存：至少4GB（推荐8GB以上），若内存不足，可通过free -h查看内存使用，关闭不必要的服务或增加Swap分区。
磁盘空间：根分区（/）和/var/opt/gitlab（数据目录）需有足够空间（推荐至少100GB），使用df -h检查，清理无用文件（如/tmp目录）。

502 Bad Gateway：通常因Nginx与GitLab通信失败，需检查Nginx配置（/etc/gitlab/nginx/conf/gitlab-http.conf）中的upstream地址是否正确，或重启Nginx（gitlab-ctl restart nginx）。
SSL连接错误：确保GitLab证书有效（如自签名证书需导入客户端信任库），或更新Git版本（旧版本可能不支持新SSL协议）。
数据库连接失败：检查PostgreSQL服务是否运行，pg_hba.conf是否允许GitLab用户访问（如添加host all all 127.0.0.1/32 md5），并重启PostgreSQL。

若以上步骤无法解决，建议查阅GitLab官方文档（https://docs.gitlab.com/ee/install/centos.html）或社区论坛（https://forum.gitlab.com/），获取针对性解决方案。对于复杂问题，可联系GitLab官方支持（需企业版订阅）。

最新问答