SSH Shell中docker-compose拉取GitLab镜像遇访问禁止错误求助

核心原因 #

新SSH Shell环境下，运行systemctl服务的用户未完成私有GitLab容器仓库的Docker登录认证，导致拉取镜像时权限被拒。Docker的登录认证信息与用户上下文绑定，不同用户的认证文件相互独立。

解决步骤 #

• 步骤1：正确完成Docker登录私有GitLab仓库
  在当前SSH Shell执行登录命令，注意GitLab私有仓库需使用个人访问令牌而非账号密码（令牌需开启read_registry权限）：

  docker login server:port
  

  执行后按提示输入GitLab用户名和个人访问令牌，登录成功后Docker会将认证信息存储在当前用户的~/.docker/config.json文件中。

• 步骤2：确保Systemctl运行用户能访问认证信息
  Systemctl默认以root用户运行服务，若你当前登录的是非root用户，需将认证文件复制到root用户的Docker配置目录：

  sudo cp ~/.docker/config.json /root/.docker/
  sudo chown root:root /root/.docker/config.json
  

  或者直接切换到root用户（su - root），重新执行一次docker login server:port完成登录。

• 步骤3：修正Docker-Compose.yml的错误写法
  你之前尝试的image: docker login ...属于格式错误，image字段仅需填写镜像地址，正确写法保持初始配置即可：

  app:
      image: server:port/path/respository/image:tag
  

• 步骤4：验证认证有效性
  切换到Systemctl运行服务的用户（如root），手动拉取镜像测试：

  docker pull server:port/path/respository/image:tag
  

  若拉取成功，再启动systemctl服务：

  systemctl start docker-compose@your-service-name.service
  

额外提示 #

• 若需长期持久化认证，可将config.json文件配置到服务的环境变量或挂载路径中，但优先保证运行服务的用户拥有合法的认证文件。
• 检查GitLab个人访问令牌的权限，确保包含read_registry，否则即使登录成功也无法拉取镜像。

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