Debian上GitLab故障排查方法
使用gitlab-ctl命令查看GitLab各组件（如rails、nginx、postgresql、sidekiq等）的运行状态，确认服务是否正常启动。若服务未运行或处于异常状态，可通过gitlab-ctl restart重启服务，或针对特定组件（如gitlab-ctl restart gitlab-rails）重启。
日志是故障排查的核心依据，GitLab的日志文件集中存储在/var/log/gitlab目录下，常用日志及查看方式如下：
sudo gitlab-ctl tail（支持动态刷新，快速定位实时错误）；sudo gitlab-ctl tail gitlab-rails（查看Rails应用日志，包含请求、数据库操作等）、sudo gitlab-ctl tail nginx/gitlab_error.log（查看Nginx错误日志，解决HTTP请求问题）；sudo tail -f /var/log/gitlab/gitlab-rails/production.log（查看Rails生产日志，记录用户操作、SQL查询等）、sudo tail -f /var/log/gitlab/nginx/error.log（查看Nginx错误日志）。GitLab的主配置文件为/etc/gitlab/gitlab.rb（如external_url设置、数据库连接、邮件服务器配置等），自定义配置需通过sudo gitlab-ctl reconfigure命令重新加载，使配置生效。同时，检查/etc/gitlab/gitlab-secrets.json（包含加密密钥、数据库密码等敏感信息）是否丢失或损坏，避免因配置错误导致服务异常。
GitLab对系统资源要求较高，需通过以下命令检查资源使用情况：
top（查看CPU、内存占用排名）、htop（更直观的资源监控）；df -h（查看磁盘使用率，若/var/opt/gitlab分区空间不足，需清理日志或扩容）；sudo fallocate -l 2G /swapfile创建Swap分区（2GB以上），缓解内存压力。确保服务器网络正常，GitLab所需端口（默认80、443、22）未被占用：
ping <目标IP>（检查服务器是否能访问外部网络）；sudo netstat -tulnp | grep ':80\|:443\|:22'（查看端口是否被其他进程占用，若有则停止占用进程或修改GitLab端口）；sudo ufw allow 80/tcp、sudo ufw allow 443/tcp、sudo ufw allow 22/tcp开放端口，然后sudo ufw reload生效。GitLab依赖PostgreSQL数据库，若出现数据库连接错误（如could not connect to server），可通过以下步骤解决：
sudo gitlab-rake gitlab:check SANITIZE=true（检查数据库配置是否正确，包括主机、端口、用户名、密码）；sudo systemctl status postgresql（确保PostgreSQL服务运行）；sudo tail -f /var/log/gitlab/postgresql/postgresql-<version>-main.log（定位数据库错误原因，如权限问题、表损坏）。ps aux | grep unicorn），增加unicorn worker数量（修改/etc/gitlab/gitlab.rb中的unicorn['worker_processes']），或启用Swap分区。sudo gitlab-rake "gitlab:password:reset[root]"命令重置root用户密码（需输入新密码）。git pull origin <branch>），再推送（git push origin <branch>）。旧版本可能存在已知bug，通过以下命令更新GitLab：
sudo apt-get update；sudo apt-get install gitlab-ce（自动升级到最新稳定版）；sudo gitlab-ctl reconfigure（应用新配置）、sudo gitlab-ctl restart（重启服务）。