如何调试debian gitlab

调试 Debian 上的 GitLab 通常需要从日志、服务状态、配置、系统资源几个层面入手。下面给你一套比较系统的方法，适合自建（Omnibus）GitLab。

一、先看服务整体状态

sudo gitlab-ctl status

正常应看到 run 状态的服务，例如：

• nginx
• unicorn / puma
• sidekiq
• postgresql
• redis
• gitaly

如果有 down，再单独看日志。

二、查看日志（最重要）

1. 综合日志

sudo gitlab-ctl tail

实时查看所有组件日志（Ctrl+C 退出）。

2. 指定组件

sudo gitlab-ctl tail nginx
sudo gitlab-ctl tail puma
sudo gitlab-ctl tail sidekiq
sudo gitlab-ctl tail gitaly

3. 系统日志

journalctl -u gitlab-runsvdir

三、检查配置是否正确

1. 查看当前配置

sudo gitlab-rake gitlab:env:info

2. 检查配置语法

sudo gitlab-ctl reconfigure

如果有报错，会直接显示问题位置（最常见是 /etc/gitlab/gitlab.rb）。

3. 常见问题配置

• 外部 URL：

external_url 'http://gitlab.example.com'

• 端口冲突（如 80/443/8080）

四、常见故障与调试方法

1. 页面打不开（502）

可能原因：

• Puma / Unicorn 没起来
• 内存不足（OOM）
• 端口被占用

检查：

free -h
sudo gitlab-ctl tail puma

2. Git 操作慢 / 失败

sudo gitlab-ctl tail gitaly

3. 邮件发不出去

sudo gitlab-rake gitlab:incoming_email:check
sudo gitlab-rake gitlab:test_email[user@example.com]

4. 数据库问题

sudo gitlab-psql

或：

sudo gitlab-ctl tail postgresql

五、进入 Rails 控制台调试

sudo gitlab-rails console

例如：

User.find_by(username: 'root')
Project.last

六、性能与资源排查

top
htop
df -h
du -sh /var/opt/gitlab

GitLab 对内存要求较高（建议 ≥ 4GB）。

七、启用 debug 日志（进阶）

在 /etc/gitlab/gitlab.rb：

gitaly['log_level'] = 'debug'
puma['log_level'] = 'debug'

然后：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

八、官方自检工具

sudo gitlab-rake gitlab:check

如果你能告诉我：

• GitLab 安装方式（Omnibus / Docker / 源码）
• 具体现象（打不开 / 报错 / 某个功能异常）
• 相关日志片段

我可以给你更针对性的调试方案。