GitLab Omnibus Docker启动循环问题排查与修复求助

先别急，这种启动循环问题大多和Registry的配置冲突、服务依赖失败或者权限问题有关，咱们一步步来排查：

1. 先拿到关键日志（别只看访问日志） #

你之前说只找到访问日志，那得先搞定GitLab核心服务的日志，这是定位问题的关键：

• 实时查看容器的所有启动日志：docker logs -f gitlab，启动循环时会直接显示服务启动失败的具体报错，比如Registry无法初始化、数据库连接异常、权限不足等。
• 进入容器查看Registry专属日志：

  docker exec -it gitlab bash
  cat /var/log/gitlab/registry/registry.log
  

  这里会精准显示Registry服务启动失败的原因，比如配置文件格式错误、端口被占用、存储目录权限不匹配。
• 同时检查GitLab Rails的初始化日志，看看有没有Registry相关的加载错误：

  cat /var/log/gitlab/gitlab-rails/production.log
  

2. 检查Registry配置与反向代理的冲突 #

因为你用Apache反向代理、未启用GitLab自身HTTPS，这里很容易出现配置矛盾：

• 打开容器内的/etc/gitlab/gitlab.rb配置文件，重点核对以下项：
  • external_url必须设为外部访问的HTTPS地址：external_url 'https://example.com'
  • 告诉GitLab内部用HTTP通信（反向代理已经处理了HTTPS）：gitlab_rails['gitlab_https'] = false
  • 如果你关闭了GitLab自带的Nginx（因为用Apache），要确保Registry直接监听容器内端口：

    nginx['enable'] = false
    registry['enable'] = true
    registry['listen_address'] = '0.0.0.0:5000'  # 让Registry监听容器内5000端口
    registry_nginx['enable'] = false  # 关掉Registry自带的Nginx
    

  • 如果Registry用同域名访问（比如https://example.com/v2/），还要在Apache配置里添加对/v2/路径的反向代理，指向容器的5000端口：

    ProxyPass /v2/ http://localhost:5000/v2/
    ProxyPassReverse /v2/ http://localhost:5000/v2/
    

  • 如果你用单独的Registry域名（比如https://registry.example.com），要配置registry_external_url 'https://registry.example.com'，同时Apache要对应做该域名的反向代理到容器5000端口。

3. 验证Registry服务的基础可用性 #

启动循环可能是因为Registry服务根本起不来，你可以手动在容器内测试：

• 进入容器后，尝试单独启动Registry服务：gitlab-ctl start registry，看有没有明确的报错提示。
• 测试Registry端口是否正常响应：curl http://localhost:5000/v2/，正常情况下会返回{}或者401未授权（需要登录），如果返回连接失败，说明Registry没启动成功。

4. 检查存储目录权限 #

Registry需要读写专属的存储目录，权限不对会直接导致启动失败：

• 进入容器，查看Registry存储目录的权限：

  ls -ld /var/opt/gitlab/registry
  

  正确的所有者应该是gitlab-registry:gitlab-registry，如果不是，手动修复：

  chown -R gitlab-registry:gitlab-registry /var/opt/gitlab/registry
  

  修复后重新执行gitlab-ctl reconfigure。

5. 检查Docker资源限制 #

GitLab（加上Registry）对内存要求不低，如果容器内存限制太少，会导致OOM（内存溢出）强制重启：

• 查看容器的内存使用情况：docker stats gitlab，如果内存使用率接近100%，说明内存不够，需要增加容器的内存限制（比如启动容器时加--memory 4g参数）。

6. 重置配置（如果快照恢复无效） #

如果恢复旧配置快照还是不行，可能是数据卷里的自动生成配置文件已经损坏，试试分步重置：

• 先备份当前的gitlab.rb和数据卷内容。
• 把gitlab.rb改回启用Registry之前的状态，然后执行：

  docker exec -it gitlab gitlab-ctl reconfigure
  docker exec -it gitlab gitlab-ctl restart
  

  确认GitLab能正常启动后，再逐步添加Registry的配置，每次修改后执行reconfigure，观察是否还会触发启动循环。

内容的提问来源于stack exchange，提问作者Maximilian