解决 GitLab external_url 修改无效的问题：保留数据重新生成配置
目录
解决 GitLab external_url 修改无效的问题：保留数据重新生成配置
背景
问题原因
解决方案 B：删除旧配置，重新生成（保留数据）
操作步骤
1. 停止容器
2. 删除旧配置文件
3. 启动容器
验证
适用场景
注意事项
总结
解决 GitLab external_url 修改无效的问题：保留数据重新生成配置
背景
在使用 Docker Compose 部署 GitLab CE 时，我们通常通过 GITLAB_OMNIBUS_CONFIG 来配置 external_url，用于指定 Web 访问和项目 Clone 的 URL。
然而，在修改 IP 或域名后，很多人会遇到一个问题：
即使更新了
docker-compose.yml中的external_url，项目页面仍然显示旧的 Clone 地址！
这通常发生在 GitLab 已经初始化过，并挂载了持久化配置卷的情况下。
问题原因
-
GitLab 初始化机制
-
第一次启动时，
GITLAB_OMNIBUS_CONFIG的内容会写入/etc/gitlab/gitlab.rb。 -
之后再改
docker-compose.yml，不会重新写入，GitLab 会继续用旧的配置文件。
-
-
卷挂载的影响
-
部署时一般会挂载
./config:/etc/gitlab，./data:/var/opt/gitlab等目录。 -
旧的
gitlab.rb被持久化，后续改external_url环境变量不会覆盖它。
-
-
表现
-
Web 界面 Clone 地址不变
-
grep external_url /etc/gitlab/gitlab.rb看不到新的 URL -
即使重启容器，依然是老地址
-
解决方案 B：删除旧配置，重新生成（保留数据）
如果你的目标是：
-
保留原有仓库和数据
-
快速切换到新的 external_url
那么可以采用删除配置目录（不删除数据目录）的方式，让 GitLab 重新生成配置文件。
操作步骤
1. 停止容器
docker-compose down
2. 删除旧配置文件
只删除 ./config 目录（配置文件），保留 ./data（仓库数据）和 ./logs：
rm -rf ./config/*
3. 启动容器
docker-compose up -d
首次启动时，GitLab 会根据 docker-compose.yml 中的 GITLAB_OMNIBUS_CONFIG 重新生成新的 /etc/gitlab/gitlab.rb 文件，并写入新的 external_url。
验证
-
进入容器查看配置文件：
docker exec -it gitlab grep external_url /etc/gitlab/gitlab.rb
应看到新的地址，例如：
external_url 'http://8.153.203.253:8929'
-
刷新 GitLab Web 页面，进入项目，Clone with HTTP 地址应已更新为新 URL。
适用场景
-
更换了服务器 IP/域名
-
修改
external_url后无法生效 -
希望保留原有数据（项目、用户、issue 等）
-
不想手动编辑
gitlab.rb
注意事项
-
删除
./config只会重置配置，不会删除仓库和数据，但操作前建议备份。 -
如果你还想切换端口或域名，记得同步修改
docker-compose.yml中的external_url。 -
若需要更复杂的配置（如 SSH、反向代理），可在生成的新
gitlab.rb中手动追加配置后gitlab-ctl reconfigure。
总结
通过删除旧配置目录，让 GitLab 重新初始化配置文件，可以快速解决 external_url 修改无效的问题，并且不会影响已有的数据和仓库。这个方法简单直接，非常适合中小规模自建 GitLab 环境。