镜像与仓库

镜像决定应用运行的程序及默认启动方式。先从镜像发布者的文档确认标签、监听端口、数据目录和必需环境变量，再填写应用配置。

镜像名称

不填写 https:// 前缀。仓库路径使用符合界面校验的名称；当前输入不接受 @sha256:... 摘要引用。部署重要业务时，优先使用能明确区分发布版本的标签。

平台不会持续轮询仓库，自动把同名标签的新镜像发布到应用。仓库中覆盖旧标签也不会自动改变已经运行的容器。

私有仓库认证

创建或编辑应用，打开镜像设置，填写仓库用户名和密码或访问令牌。优先使用只具有拉取权限的专用凭据。

平台不会在读取应用信息时回显密码。当前界面在用户名非空时要求填写密码或令牌：如果只是查看已有认证，关闭编辑框即可；需要更换认证时，重新填写用户名和令牌并确认。

在未修改凭据且仓库作用域不变时，已有凭据可以保留。切换到不同仓库后不要假定旧凭据仍有效，应按新仓库重新配置。清除认证前先确认镜像确实允许匿名拉取。

更新镜像

只保存未变化的镜像字符串不会强制重部署。需要重新创建容器时使用更新与重启中的重启操作；要确保发布版本可追踪，仍应使用新的版本标签。

拉取失败排查

不要把仓库密码写入镜像名称、环境变量示例或共享故障截图。公开镜像使用方式可参考 Nginx 官方镜像。