Mac Big Sur部署GitLab Docker镜像无法访问gitlab.example.com

关于Gitaly日志警告的说明 #

你看到的Gitaly日志里的unix socket连接警告是启动阶段的临时问题：Gitaly主进程先尝试连接ruby子进程的socket，但此时ruby子进程还未启动，后续日志已经显示spawned ruby进程，并且gitaly.socket已经正常监听，所以这个警告不是导致无法访问的原因，可以忽略。

排查访问问题的具体步骤 #

• 测试本地连通性与报错详情
  在Mac终端执行以下命令，获取更详细的访问报错：

  curl -v https://gitlab.example.com
  # 同时测试HTTP，看是否有跳转
  curl -v http://gitlab.example.com
  

  如果是SSL证书错误（浏览器提示不安全），这是GitLab自动生成的自签名证书被浏览器拦截导致的；如果是连接超时，再检查端口和防火墙。

• 处理SSL证书问题
  GitLab配置HTTPS后会自动生成自签名证书，浏览器默认不信任：

  1. 从容器内导出证书到本地：

     docker cp gitlab:/etc/gitlab/trusted-certs/gitlab.example.com.crt ~/Desktop/
     

  2. 在Mac的“钥匙串访问”中导入该证书，设置为“始终信任”，然后重启浏览器。
  3. 或者临时修改docker-compose.yml中的external_url为HTTP，先验证服务是否能正常访问：

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

     修改后重启容器：docker-compose down && docker-compose up -d

• 验证hosts配置生效
  执行以下命令确认域名解析正确：

  ping gitlab.example.com
  

  如果返回的不是192.168.31.182，说明hosts未生效：

  1. 确认修改的是Mac系统的/etc/hosts文件（路径正确）
  2. 刷新DNS缓存：

     sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
     

• 检查端口与防火墙

  1. 确认Mac防火墙是否拦截了443/80端口：可以临时关闭“系统偏好设置-安全性与隐私-防火墙”测试
  2. 确认容器端口映射正常：docker ps显示0.0.0.0:443->443/tcp，说明端口已正确映射

• 检查容器内服务状态
  进入容器查看GitLab内部服务是否正常运行：

  docker exec -it gitlab bash
  # 查看所有服务状态
  gitlab-ctl status
  # 查看nginx访问日志，确认是否收到请求
  tail -f /var/log/gitlab/nginx/gitlab_access.log
  

  如果nginx服务未运行，执行gitlab-ctl restart nginx重启，同时查看错误日志/var/log/gitlab/nginx/gitlab_error.log排查问题。

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