GitLab操作触发500错误，本地网络请求受限无法通过UI配置解决

核心解决方案 #

GitLab执行删除项目、权限调整等操作时，内部会触发本地网络请求，这类请求默认被安全策略拦截导致500错误；而通过UI修改“允许本地网络请求”的操作本身也会触发同类请求，因此陷入死循环。直接通过GitLab Omnibus配置文件修改权限，绕开UI操作即可解决问题。

操作步骤 #

1. 进入GitLab容器

   docker exec -it <你的GitLab容器名称/ID> /bin/bash
   

2. 编辑GitLab核心配置文件
   打开/etc/gitlab/gitlab.rb进行编辑：

   vi /etc/gitlab/gitlab.rb
   

3. 添加本地网络访问权限配置
   在配置文件中添加以下内容，允许本地网络出站请求：

   # 全局允许本地网络出站请求
   gitlab_rails['outbound_local_network_access'] = true
   
   # 可选：精细控制允许的IP网段（比如你的Docker桥接网络段）
   # gitlab_rails['outbound_local_network_whitelist'] = ['127.0.0.0/8', '172.17.0.0/16']
   

4. 修正现有配置中的错误
   检查并修复你提供的配置里的两处问题：

   • 将中文单引号替换为英文引号，且external_url应使用HTTPS（NGINX Proxy Manager已处理TLS）：

     external_url "https://url.com"
     

   • 修正real_ip_recursive的拼写错误：

     nginx['real_ip_recursive'] = true
     

5. 重新配置并重启GitLab

   gitlab-ctl reconfigure
   gitlab-ctl restart
   

原理说明 #

GitLab的部分核心操作会触发内部服务请求，这些请求指向容器内部或Docker桥接网络的本地地址，默认被安全策略拦截导致500错误。直接通过配置文件开启本地网络访问权限，无需经过UI操作，即可打破死循环并解决核心问题。

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