如何阻止Visual Studio Code添加通用Docker镜像仓库时自动追加"v2"路径后缀

根因说明 #

VS Code 内置/第三方容器扩展默认遵循OCI镜像仓库规范，会对所有配置的 registry 地址自动追加/v2/后缀适配标准API路径，而JFrog Container Registry的访问路径通常已经包含了实例、仓库层级信息，自动追加后缀后会生成不存在的路径，触发404响应。

修复步骤 #

方案一：修改Docker扩展配置（适用于用默认Docker扩展管理仓库的场景） #

• 打开VS Code设置面板：按Ctrl+,（Windows/Linux）或Cmd+,（macOS）
• 搜索配置项 docker.registryV2Paths，点击「编辑settings.json」进入自定义配置
• 在配置项中添加你的JFrog仓库地址，值设为false，示例：

"docker.registryV2Paths": {
    "https://<你的JFrog域名>/artifactory/<你的容器仓库名>": false
}

值为false即代表禁用该地址的/v2/自动追加逻辑

• 保存配置后重启VS Code Insiders，重新连接仓库即可生效

方案二：修改JFrog扩展配置（适用于安装了官方JFrog扩展的场景） #

• 打开JFrog扩展的「镜像仓库」管理页
• 找到对应已配置的JFrog仓库，点击编辑
• 取消勾选 自动适配OCI v2规范补全路径 选项，确认保存后重新连接即可

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