GitLab CI配置：如何设置镜像默认端口5000以省略端口填写？

1. 能否设置默认端口5000，无需手动添加？ #

可以，推荐两种方案：

• 反向代理+Registry URL配置：通过Nginx等反向代理工具，将域名server的80/443端口流量转发到GitLab Registry的5000端口。之后在GitLab管理后台（Admin Area > Settings > Repository）中，把Container registry URL设置为https://server（或http://server，视是否启用HTTPS而定）。这样CI脚本里直接写server/image:tag就能自动解析到正确的5000端口。
• Runner脚本替换（临时方案）：在GitLab Runner的config.toml配置文件中，给目标Runner添加pre_build_script，自动替换镜像名中的域名部分：

  [[runners]]
    name = "本地Docker Runner"
    url = "https://server/"
    token = "你的Runner令牌"
    executor = "docker"
    pre_build_script = "sed -i 's|image: server/|image: server:5000/|' .gitlab-ci.yml"
  

  这种方式属于临时 workaround，优先推荐第一种反向代理方案。

2. 问题是否源于未启用Registry的SSH访问？ #

不是。这个问题的本质是Docker的镜像拉取规则：对于不带端口的域名，Docker默认尝试用443（HTTPS）或80（HTTP）端口访问镜像仓库，而你的GitLab Registry默认监听5000端口，所以必须显式指定端口才能连接。这和Registry的SSH访问完全无关——SSH访问只是镜像推送/拉取的一种身份验证方式，不影响端口的默认解析逻辑。

3. 启用SSH访问后，Runner会默认用443端口解决问题吗？ #

不会。启用Registry的SSH访问后，镜像拉取地址会变成ssh://git@server/image:tag，此时SSH协议默认使用22端口，而非443。这不仅解决不了端口问题，还需要额外配置SSH密钥、Runner的权限等，反而增加复杂度，不建议用这种方式解决当前问题。

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