Docker操作返回401未授权错误，请求排查权限问题

问题场景 #

在Ubuntu 20.04系统中执行以下操作时，均返回docker: you are not authorized to perform this operation: server returned 401.错误：

• 运行本地构建的镜像：docker run -d -p 80:80 --name mern-stack mern-image:1.1
• 添加Docker信任签名者：docker trust signer add --key miki.pub miki mern-image:1.1

已确认的前置信息：

• 当前用户已加入docker用户组，运行hello-world镜像无异常
• Notary server、signer相关容器均正常运行
• 执行调试命令docker -D run -d --name mern-stack mern-image:2.0时，发现请求root路径返回HTTP 401状态码
• 本地镜像identidock:latest的DockerVersion和Hostname字段为空

可能原因与排查步骤 #

1. 镜像仓库认证配置问题 #

如果mern-image关联私有镜像仓库，需检查本地Docker的仓库认证配置：

• 查看~/.docker/config.json文件，确认是否包含目标仓库的auth条目。若无，重新执行docker login <仓库地址>完成认证
• 若使用本地私有仓库，确认仓库的HTTP基本认证等机制是否配置正确，且Docker客户端已加载有效凭证

2. Notary信任配置异常 #

涉及docker trust命令时，需排查Notary的本地与服务端配置：

• 检查~/.docker/trust目录下的签名者密钥、仓库信任数据是否完整
• 执行docker trust inspect --pretty mern-image:1.1，查看镜像的信任状态，确认是否完成信任初始化
• 用curl直接请求Notary server接口（如curl -v https://<notary-server-url>/v2/），验证服务端是否返回401，排查服务端认证规则

3. 镜像元数据异常 #

identidock:latest元数据缺失，可能反映镜像构建过程存在问题，影响权限校验：

• 重新构建mern-image，检查Dockerfile是否存在基础镜像错误、构建步骤缺失等问题
• 执行docker inspect mern-image:1.1，查看该镜像的DockerVersion、Config等元数据字段是否完整
• 若镜像来自外部仓库，重新拉取并校验完整性：docker pull mern-image:1.1 --disable-content-trust=false

4. Docker Daemon配置限制 #

即使用户在docker组，Daemon的配置可能存在权限限制：

• 检查/etc/docker/daemon.json文件，确认是否启用了镜像信任、仓库访问限制等配置项（如"insecure-registries"、"trust"）
• 重启Docker Daemon：sudo systemctl restart docker，后重试相关命令
• 查看Daemon日志：journalctl -u docker.service -f，定位401错误的具体触发点

5. 用户权限细粒度问题 #

• 临时用sudo执行命令（如sudo docker run ...），若正常则说明当前用户的Docker权限存在细粒度限制
• 检查/etc/group文件，确认docker组包含当前用户，且用户已重新登录（加入组后需重新登录生效）

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