Docker部署GitLab编辑Runner时URL显示随机字符串问题咨询

问题根源 #

你看到的随机字符串是Docker容器的ID，本质是GitLab未被正确配置外部访问域名，导致系统内部生成链接时默认使用了容器自身的主机名，而非你设置的自定义域名。同时如果Runner是用这个容器内部地址注册的，自然会尝试访问这个无效的URL。

修复步骤 #

1. 配置GitLab的外部访问地址 #

不管是新启动容器还是修改已有容器，都必须指定external_url：

• 新启动容器时，通过环境变量指定：

docker run -d \
  --name gitlab \
  -p 443:443 -p 80:80 -p 22:22 \
  -e GITLAB_OMNIBUS_CONFIG="external_url 'https://your-domain.com';" \
  gitlab/gitlab-ce:latest

• 已有容器的话，进入容器修改配置文件：

docker exec -it gitlab bash

编辑/etc/gitlab/gitlab.rb，找到并设置：

external_url 'https://your-domain.com'

执行配置生效命令：

gitlab-ctl reconfigure

2. 更新Runner的注册地址 #

如果已经注册了Runner，需要修正它的配置：

• 打开Runner的配置文件（默认路径/etc/gitlab-runner/config.toml），把url字段改成你的自定义域名，比如https://your-domain.com/
• 重启Runner服务：

gitlab-runner restart

3. 清理无效Runner #

在GitLab后台删除之前用容器ID注册的无效Runner，重新用正确的域名注册新的Runner即可。

额外提醒 #

• 确保你的自定义域名已经正确解析到部署GitLab的服务器IP，服务器的80/443端口能正常访问
• 如果用HTTPS，记得给GitLab配置有效的SSL证书，避免后续访问出现证书错误

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