Vercel 容器镜像仓库现支持 2 GB 压缩镜像层
内容提要
Vercel容器镜像仓库现支持单层最大2GB的压缩镜像层（原为500MB），镜像总大小上限仍为15GB。支持docker push/pull/tag等标准工作流，推送时自动创建仓库。仓库可设为公开供所有Vercel团队只读拉取，或通过仪表板及CLI共享给最多100个指定团队。Vercel Sandbox所用镜像即由普通公开仓库提供。可通过Vercel CLI v58.3.0及以上版本的vercel vcr命令管理，并支持GitHub OIDC登录CI流程，无需长期凭证。
延伸解读
单层上限提升的实际影响
压缩镜像层上限从500MB提高到2GB，意味着包含大型依赖或二进制文件的层不再需要拆分或压缩到500MB以下。但总镜像大小仍限制在15GB，因此对于层数较多的大镜像，仍需注意总体积。这一调整主要方便了单层体积较大的场景，而非整体镜像规模的突破。
公开仓库与Sandbox镜像的关系
Vercel Sandbox所使用的托管镜像正是通过普通公开仓库提供的，任何团队都可以用同样的公开仓库功能来托管自己的镜像。这说明公开仓库并非特殊通道，而是平台自身也在使用的标准能力。读者可以据此判断公开仓库的稳定性和适用范围，但需注意公开意味着所有Vercel团队可只读拉取。
CI登录方式的变化
通过GitHub Actions使用GitHub OIDC登录，不再需要长期有效的仓库凭证。这减少了凭证泄露的风险，也简化了CI配置。但该方式依赖GitHub OIDC，若CI环境不是GitHub Actions，则需另寻认证方式。同时，CLI版本需不低于v58.3.0才能使用vercel vcr命令管理仓库。
推送后优化失败的处理
推送镜像后若后台优化失败，仪表板会显示错误状态，重新推送同一镜像即可重试转换。这提示读者在推送后应检查仪表板状态，而不是仅凭推送成功就认为镜像可用。该机制提供了简单的重试路径，但并未说明失败原因或自动重试，因此需要人工关注。
Q&A
Vercel 容器镜像仓库现在支持多大的压缩镜像层？
Vercel 容器镜像仓库现在支持单层最大 2 GB 的压缩镜像层，之前是 500 MB。镜像总大小上限仍为 15 GB。
如何将镜像推送到 Vercel 容器镜像仓库？
可以使用标准的 docker push 命令推送镜像，例如：docker buildx build --push -t vcr.vercel.com/team/project/repository:tag .。推送镜像时会自动创建仓库。
Vercel 容器镜像仓库的共享和公开访问如何设置？
仓库可以设为公开，供所有 Vercel 团队只读拉取；也可以通过仪表板或 vercel vcr permissions 命令共享给最多 100 个指定团队。
Vercel Sandbox 使用的镜像来自哪里？
Vercel Sandbox 使用的镜像由普通的公开仓库提供，这些仓库使用任何团队都可以使用的公开仓库功能构建。
如何管理 Vercel 容器镜像仓库？
可以使用 Vercel CLI v58.3.0 或更高版本中的 vercel vcr 命令来管理仓库、镜像和标签。
如何在 CI 中登录 Vercel 容器镜像仓库？
在 GitHub Actions 中，可以使用 vercel/vcr-action/login 动作通过 GitHub OIDC 登录，无需长期凭证。
如果镜像后台优化失败怎么办？
如果推送的镜像后台优化失败，仪表板中会显示错误状态，再次推送同一镜像即可重试转换。
