goland 不支持自动推送镜像到私有仓库，仅能配置 registry 凭据辅助拉取；推送需手动执行 docker push 或由 ci/cd 触发，且必须完成 docker login、insecure-registries 配置及正确 tag 镜像。
GoLand 本身不支持“自动推送”镜像到私有仓库——它只负责配置 registry 凭据和辅助拉取，推送动作仍需手动执行 docker push 或由 CI/CD 脚本触发。 真正能实现“自动”的环节在构建流程里（比如 Makefile、Shell 脚本或 GitHub Actions），GoLand 的作用是让这些操作更顺滑：提前配好 registry 地址和登录态，避免每次 docker push 都卡在认证或地址写错上。
GoLand 中添加私有 registry 配置项
GoLand 的 Docker 集成插件默认启用，但 registry 列表为空。你需要显式添加私有仓库地址和凭据，否则它连 docker pull 都会失败（尤其在 Service 工具窗口里点“Pull image”时）。
- 打开 Settings / Preferences → Tools → Docker → Registries
- 点击
+添加新 registry -
Registry type 选
Docker V2（适用于 Harbor、自建 registry、阿里云 ACR 等所有符合 v2 API 的仓库） -
Registry URL 填完整地址，例如：
harbor.example.com或localhost:5000（不要带http://或https://） - 用户名密码按实际填写；若为本地
registry:2（无认证），可留空或填test/test（取决于你启动时是否挂载了 auth 配置）
⚠️ 注意：Generic 类型虽然也能加，但 GoLand 不支持在 UI 中浏览或拉取镜像，仅可用于后台命令调用——不如直接选 Docker V2 稳定。
为什么配置完 registry 还 push 失败？常见三类原因
即使 GoLand 里填对了地址和账号，docker push 仍可能失败。根本原因是：GoLand 的 registry 配置 ≠ Docker CLI 的运行时状态。两者认证机制不共享。
-
未在终端执行
docker login：GoLand 的凭据只用于其内部 UI 操作（如 Pull），Docker 守护进程仍需独立登录。必须在 Shell 中运行docker login harbor.example.com并输密码 -
HTTP 仓库没配
insecure-registries：若用localhost:5000这类 HTTP 地址，Docker 默认拒绝通信。需编辑/etc/docker/daemon.json，加入：{"insecure-registries": ["localhost:5000"]}，再sudo systemctl restart docker -
镜像 tag 缺少仓库前缀：GoLand 不会帮你重打 tag。你必须手动运行
docker tag myapp:v1.2 harbor.example.com/dev/myapp:v1.2，否则docker push myapp:v1.2会默认往 Docker Hub 推，报unauthorized: authentication required
在 GoLand 里触发推送的实用方式
GoLand 没有“一键 Push”按钮，但可以通过外部工具集成把 docker push 命令绑定到快捷键或右键菜单，省去切终端的步骤。
- 进入 Settings / Preferences → Tools → External Tools
- 点击
+新增工具，填入：- Name：Push to Harbor
-
Program：
docker -
Arguments：
push $ProjectFileDir$/harbor.example.com/dev/myapp:$Time$（建议用变量动态拼 tag，或先写死测试） -
Working directory：
$ProjectFileDir$
- 保存后，在项目根目录右键就能看到该菜单项，点击即执行推送
⚠️ 注意：这个命令依赖你已提前 docker tag 好，且 docker login 成功。GoLand 只是外壳，底层仍是 Docker CLI 在跑。
真正容易被忽略的是：GoLand 配置 registry 后，它不会、也不能代替你处理 daemon.json 里的 insecure-registries、镜像重 tag、以及 docker login 的 session 生命周期。这三个点任何一个断掉，推送就卡住——而错误提示往往只显示 “unauthorized” 或 “no basic auth credentials”，看不出根源在哪。
