docker login没生效，大概率是~/.docker/config.json文件异常：需检查是否存在、权限是否为600、内容是否含有效auths字段，且registry地址必须与docker pull镜像全名完全匹配。
docker login 没生效？检查 ~/.docker/config.json 是否被覆盖或损坏
执行 docker login 后仍报 unauthorized: authentication required，大概率是 ~/.docker/config.json 文件异常。Docker CLI 读取该文件获取认证凭据，但它极易被误删、权限错误或格式破坏。
- 运行
ls -l ~/.docker/config.json确认文件存在且权限为600（否则 Docker 会忽略） - 用
cat ~/.docker/config.json查看内容是否包含有效auths字段；若为空、只有{}或含非法 JSON，说明登录未写入成功 - 常见干扰源：CI/CD 脚本中误执行
rm -rf ~/.docker、多用户共享环境覆盖配置、凭证助手（如docker-credential-desktop）崩溃后残留空文件 - 临时修复：手动重建该文件（注意 base64 编码），但更推荐重新
docker login registry.example.com并立即验证cat ~/.docker/config.json | jq '.auths'
镜像拉取时提示 pull access denied，但已 login？确认 registry 地址完全匹配
Docker 认证凭据按 registry 域名精确匹配，registry.example.com 和 https://registry.example.com 被视为两个不同仓库，凭据不互通。
Text To Image
下载
一款AI图像与设计工具，主要用于将文本渲染为图片并返回临时本地文件路径，支持可选的 data URI。适用于 Clawhub 或 Codex，用于将纯文本或带样式的文本进行转换，适合需要提升相关任务效率的用户。
- 检查
docker pull命令中的镜像全名：必须与docker login的目标地址**完全一致**（不含协议头、端口需显式写出） - 例如：若登录的是
registry.example.com:5000，则镜像必须写成registry.example.com:5000/myapp:v1，而非myapp:v1或https://registry.example.com:5000/myapp:v1 - 运行
docker info | grep -A 5 "Registry:"可查看当前默认 registry 配置，避免混淆 - 私有仓库若启用了子路径（如
registry.example.com/v2），实际认证仍以根域名registry.example.com为准
Kubernetes 中 ImagePullBackOff，Secret 创建对了但没生效？验证 imagePullSecrets 引用路径
在 Pod 或 ServiceAccount 中声明 imagePullSecrets 是常见操作，但容易因命名、作用域或字段位置错误导致凭据未加载。
- Secret 必须与 Pod **在同一 namespace**；跨 namespace 需复制 Secret 或改用 ServiceAccount 绑定
- 检查 Pod spec 中
imagePullSecrets字段是否位于正确层级：spec.imagePullSecrets（不是spec.containers[0].env下） - ServiceAccount 关联 Secret 后，Pod 必须显式指定
serviceAccountName，否则不会继承凭据 - 用
kubectl get secret regcred -o yaml确认 Secret 类型为kubernetes.io/dockerconfigjson，且.data.".dockerconfigjson"字段 Base64 解码后含正确 registry 条目
CI/CD 流水线里凭据突然失效？避免硬编码，优先使用短期 token
流水线中长期复用静态用户名密码，极易因过期、轮换或权限变更引发拉取失败，且排查困难。
- 禁用
docker login -u xxx -p yyy方式，改用 token 登录：docker login -u <token-user> -p <short-lived-token> registry.example.com</short-lived-token></token-user> - Harbor/AWS ECR 等平台支持生成 1 小时有效期的 robot account token 或 ECR token，配合 CI 变量注入更安全
- GitLab CI 中可利用
CI_REGISTRY_TOKEN自动注入，无需额外 login 步骤 - 若必须用静态凭据，确保 CI job 执行前先运行
docker logout && docker login清除旧状态，避免缓存干扰
docker info | grep -i cred 确认当前生效的凭据存储机制。
