自建GitLab上传Docker镜像制品报413错误求助

可能的原因及解决方案 #

1. 检查GitLab Runner的制品上传大小限制 #

GitLab Runner本身有独立的上传大小限制，默认值可能低于2GB。修改Runner配置文件（通常路径为/etc/gitlab-runner/config.toml），在[[runners]]块下添加或调整：

[[runners]]
  # 保留原有其他配置
  artifacts_upload_max_size = 2048  # 单位：MB，对应2GB

修改后重启Runner服务：

gitlab-runner restart

2. 二次确认GitLab实例的制品大小限制 #

即便你已调整过，再次核对GitLab配置文件/etc/gitlab/gitlab.rb中的设置：

gitlab_rails['artifacts_max_size'] = 2048  # 单位MB

执行配置重载：

gitlab-ctl reconfigure

同时登录GitLab管理中心，进入设置 > 通用 > 制品存储，确认界面显示的最大制品大小为2GB。

3. 补全Nginx的请求体大小配置 #

确保client_max_body_size配置在正确的作用域内：

• 若使用GitLab自带Nginx，修改gitlab.rb：

  nginx['client_max_body_size'] = '2G'
  

  重载配置：gitlab-ctl reconfigure && gitlab-ctl restart nginx
• 若使用外部Nginx，在对应GitLab的server块或location块中添加：

  client_max_body_size 2G;
  

  重载Nginx：nginx -s reload

4. 验证镜像文件实际大小并压缩 #

用更精准的命令确认文件磁盘占用：

du -sh image/app_tag1.tar

若文件接近2GB，直接生成压缩版镜像文件降低体积，替换原docker save命令为：

docker save app_test:tag1 | gzip > image/app_tag1.tar.gz

5. 改用宿主机Docker构建（规避dind网络限制） #

docker:dind环境可能存在额外网络限制，尝试直接使用宿主机Docker：

1. 修改GitLab Runner的config.toml，在[runners.docker]块添加挂载：

   [runners.docker]
     # 保留原有其他配置
     volumes = ["/var/run/docker.sock:/var/run/docker.sock", "/cache"]
   

2. 更新gitlab-ci.yml，移除dind服务及相关变量：

   stages:
     - build
   build_image:
     stage: build
     only:
       - tags
     script:
       - echo "Building Docker image with tag tag1"
       - docker build -t app_test:tag1 .
       - mkdir image
       - docker save app_test:tag1 | gzip > image/app_tag1.tar.gz
       - ls -lh image/
       - docker rmi app_test:tag1
       - docker system prune -af
     artifacts:
       paths:
         - image
       expire_in: 2 day
   

6. 手动模拟上传验证 #

在Runner执行环境中，用curl手动上传文件到GitLab API，排查是否为纯大小限制问题：

curl --request POST \
  --header "PRIVATE-TOKEN: <你的GitLab访问令牌>" \
  --form "file=@image/app_tag1.tar" \
  "https://<你的GitLab地址>/api/v4/projects/<项目ID>/uploads"

若返回413，说明仍有未配置到位的大小限制；若成功，则问题出在Runner上传逻辑，可尝试更新Runner到最新版本。

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