为何运行Docker镜像时出现401未授权错误？

问题详情 #

Dockerfile内容：

FROM openjdk:8-jdk-alpine

WORKDIR /opt/app

COPY target/pichk-0.0.1-SNAPSHOT.jar /opt/app/

CMD ["java","-jar","pichk-0.0.1-SNAPSHOT.jar"]
EXPOSE 8090

执行命令：

docker run -p 8090:8090 pichk:001

报错信息：

docker: you are not authorized to perform this operation: server returned 401.

附加信息：

• target目录权限：

  drwxrwxr-x   9 miki miki  4096 Jan  4 13:59 target/
  

• docker inspect片段：

  "ContainerConfig": {
      "Hostname": "a85050e37362",
      "Domainname": "",
      "User": "",
  }
  

可能的原因 #

• 镜像仓库认证缺失/过期：如果pichk:001是私有仓库中的镜像，你的Docker客户端没有配置该仓库的有效认证信息，或者之前的认证令牌已过期，导致拉取镜像时触发401校验失败。即使镜像已经本地存在，部分配置下Docker仍会尝试与仓库交互验证权限。
• 本地Docker用户权限不足：执行命令的当前用户未加入docker用户组，无法正常访问Docker守护进程，这种情况下也可能返回类似的权限错误（部分环境下会以401形式呈现）。
• 镜像仓库地址或代理配置错误：如果配置了错误的镜像仓库源，或者代理服务器要求认证但未正确配置，请求被拦截后返回401错误。
• Docker守护进程的权限策略限制：Docker守护进程配置了严格的访问控制（比如TLS认证），当前客户端未携带合法的证书或密钥，导致操作被拒绝返回401。

内容的提问来源于stack exchange，提问作者Richard Rublev