[Docker] Docker Hub 사용 및 제한 정책

ㅁ 들어가며

Docker Hub의 사용 정책이 2025년 3월 1일부터 변경되어 사용에 제한이 주어진다. 서비스 품질 유지를 위해 제한을 두거나 추가 요금을 부과할 수 있게 하였다.

 

ㅁDocker Hub 계정 유형별 제한 사항

Docker Hub는 사용자 유형에 따라 다양한 제한을 두고 있다.

계정 유형	월간 Pull 횟수	시간당 Pull 제한	공개 저장소	비공개 저장소	비공개 저장소 용량
Business	100만	무제한	무제한	무제한	최대 500 GB
Team	10만	무제한	무제한	무제한	최대 50 GB
Pro	2.5만	무제한	무제한	무제한	최대 5 GB
Personal	해당 없음	40	무제한	최대 1개	최대 2 GB
비인증 사용자	해당 없음	IP당 10	해당 없음	해당 없음	해당 없음

 

ㅁ 공정 사용 정책

  Docker는 플랫폼의 안정적인 운영을 위해 '공정 사용 정책'을 시행하고 있다. 과도한 데이터 전송, Pull 빈도, 또는 데이터 저장은 서비스 품질 유지를 위해 제한되거나 추가 요금이 부과될 수 있다.

 

ㅁ 남용 방지 제한

  Docker Hub는 애플리케이션과 인프라 보호를 위해 남용 방지 제한을 두고 있다. 이 제한은 웹 페이지, API, 이미지 Pull 등 모든 Hub 관련 요청에 적용된다. IPv4 주소 또는 IPv6 /64 서브넷 당 적용되며, 일반적으로 분당 수천 건의 요청으로 제한된다.

 

ㅁ 제한 메시지

 제한 메시지에는 Pull 제한과 남용 방지 제한이 있는데, 이는 서로 다른 개념이다. 남용 방지 제한은 간단한 '429 Too Many Requests' 응답을 반환하지만, Pull 제한은 더 자세한 오류 메시지를 제공한다.

 

ㅁ 요금 부과

2024년 12월 10일부터 2025년 2월 28일까지는 Docker Hub Pull이나 저장소 사용에 대한 요금이 부과되지 않는다.

 

ㅁ 마무리

  Docker Hub의 사용에 제한이 생겨서 사용에 주의가 필요하다. 안정적인 서비스를 위해 방만한 사용은 자제해야하고, 또한 제한은 필요하다. 새로운 정책에 따라 필요하다면 적절한 계정 유형으로 전환하는 것이 좋을 것이다.

 

ㅁ 함께 보면 좋은 사이트

ㅇ https://docs.docker.com/docker-hub/usage/