Jenkins推送Docker镜像至Docker Hub时权限拒绝问题求助

1. 检查镜像命名格式 #

Docker Hub的镜像必须遵循[Docker Hub用户名]/[镜像名]:[标签]的格式，比如myusername/myapp:v1。如果镜像名未带用户名前缀，推送时会默认指向官方公共库，必然会被权限拦截。

• 构建镜像时需指定正确命名：docker build -t your-dockerhub-username/your-image-name:tag .

2. 配置正确的Jenkins Docker登录凭证 #

不要在Jenkins脚本中明文执行docker login输入密码，建议用Jenkins凭证管理功能：

• 在Jenkins中添加用户名+密码类型凭证，用户名填Docker Hub账号，密码填Docker Hub的访问令牌（在Docker Hub账号设置中生成，比直接用账号密码更安全）
• 在Jenkins任务的Shell或Pipeline步骤中，通过凭证绑定自动登录：

  docker login -u ${DOCKER_USER} -p ${DOCKER_PWD}
  

  其中DOCKER_USER和DOCKER_PWD是绑定凭证后生成的环境变量

3. 确认Docker Hub仓库权限 #

• 若推送私有仓库，确保你的Docker Hub账号拥有该仓库的写入权限
• 若是新仓库，可先在Docker Hub手动创建，或确认账号拥有自动创建个人名下仓库的权限（默认账号具备该权限）

4. 验证本地登录有效性（排查用） #

在Jenkins服务器终端手动执行docker login，输入账号和令牌后尝试推送镜像：

• 若仍报错，说明是账号或仓库本身的权限问题，与Jenkins配置无关
• 若手动推送成功，说明Jenkins的凭证配置存在错误

5. 检查Jenkins用户的Docker权限 #

确保Jenkins运行用户（如jenkins用户）有权限访问Docker守护进程，将其加入docker用户组：

sudo usermod -aG docker jenkins

修改后重启Jenkins服务：sudo systemctl restart jenkins

内容的提问来源于stack exchange，提问作者Dhara Singh