속도 제한
GitLab v19.6Offering: GitLab Self-Managed, GitLab Dedicated
요약
For GitLab.com, see GitLab.com-specific rate limits. For GitLab Dedicated, see Authenticated user rate limits. 속도 제한은 웹 애플리케이션의 보안과 내구성을 개선하기 위해 흔히 쓰이는 기법입니다.
For GitLab.com, see GitLab.com-specific rate limits.
For GitLab Dedicated, see Authenticated user rate limits.
속도 제한은 웹 애플리케이션의 보안과 내구성을 개선하기 위해 흔히 쓰이는 기법입니다.
예를 들어 간단한 스크립트만으로도 매초 수천 건의 웹 요청을 보낼 수 있습니다. 이러한 요청은 다음과 같을 수 있습니다.
- 악의적인 요청.
- 무관심한 요청.
- 단순한 버그로 인한 요청.
애플리케이션과 인프라가 이러한 부하를 감당하지 못할 수 있습니다. 자세한 내용은 서비스 거부 공격(Denial-of-service attack)을 참고합니다. 대부분의 경우 단일 IP 주소에서 오는 요청 속도를 제한하는 것으로 완화할 수 있습니다.
대부분의 무차별 대입 공격(brute-force attack)도 속도 제한으로 유사하게 완화됩니다.
API 요청에 대한 속도 제한은 프론트엔드가 보내는 요청에는 영향을 주지 않습니다. 이러한 요청은 항상 웹 트래픽으로 집계되기 때문입니다.
설정 옵션#
대부분의 속도 제한은 Admin 영역에서 설정할 수 있습니다. 일부는 API 또는 Rails 콘솔을 통해서만 설정할 수 있으며, GitLab Pages 속도 제한은 설정 파일에서 설정합니다.
Admin 영역#
인스턴스의 Admin 영역에서 다음 속도 제한을 설정할 수 있습니다.
- API 속도 제한
- 콘텐츠 생성 속도 제한
- Git 작업 속도 제한
- GitLab Orbit 속도 제한
- 가져오기 및 내보내기 속도 제한
- 인시던트 관리 속도 제한
- Pages 도메인 속도 제한
- 파이프라인 생성 속도 제한
- 보호된 경로
- 원시 엔드포인트 속도 제한
- 사용자 및 IP 속도 제한
- 웹훅 작업 속도 제한
API 및 Rails 콘솔#
애플리케이션 설정 API로 다음 속도 제한을 설정할 수 있습니다.
- 자동 완성 사용자 속도 제한
- AI action(
ai_action_api_rate_limit): 인증된 사용자 1명당 8시간마다 160회 호출. GraphQLaiAction뮤테이션에 적용됩니다. - 태그 생성 속도 제한(
tags_create_limit): 프로젝트 1개당 30분마다 100회 요청. 태그 생성용 REST API 엔드포인트, GraphQLtagCreate뮤테이션, UI 에서의 태그 생성,/tag퀵 액션에 적용됩니다. - CSV 가져오기 속도 제한(
issuable_csv_import_limit): 인증된 사용자 1명당 1시간마다 20회 가져오기. UI와workItemsCsvImportGraphQL 뮤테이션을 통해 CSV에서 이슈, 작업 항목, 요구 사항을 가져오는 작업에 적용됩니다. 제한은 이들 사이에서 공유됩니다. GitLab 19.6에서issuable_csv_import_rate_limit라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 작업 항목 이동 및 복제 속도 제한(
work_item_move_limit): 인증된 사용자 1명당 1분마다 30회 요청. UI에서 이슈와 작업 항목을 이동하고 복제하는 작업, 이슈 이동 및 이슈 복제용 REST API 엔드포인트,issueMove및workItemBulkMoveGraphQL 뮤테이션,/move및/clone퀵 액션, Slackissue move명령에 적용됩니다. 제한은 이들 사이에서 공유됩니다. 일괄 이동은 항목마다 1회 요청으로 계산되며, 제한보다 많은 항목을 일괄 이동하는 요청은 거부됩니다. 이슈와 함께 이동되는 하위 항목도 항목마다 1회 요청으로 계산됩니다. 다른 이유로 실패한 단일 이슈의 이동과 복제도 계산됩니다. GitLab 19.6에서work_item_move_rate_limit_enforce라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 요청이 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 하위 항목 추가 속도 제한(
work_item_hierarchy_add_children_limit): 인증된 사용자 1명당 1분마다 하위 항목 300개. 상위 작업 항목 또는 에픽에서 하위 항목을 추가하는 작업에 적용됩니다.workItemHierarchyAddChildrenItemsGraphQL 뮤테이션,workItemUpdateGraphQL 뮤테이션의childrenIds,/add_child퀵 액션, 이슈를 에픽에 할당하고 하위 에픽을 할당하는 REST API 엔드포인트가 해당됩니다. 제한은 이들 사이에서 공유됩니다. 요청의 각 하위 항목이 제한에 포함되며, 요청이 제한을 초과하게 되면 하위 항목이 하나도 추가되지 않습니다. 하위 작업 항목에서 상위 항목을 설정하는 경우에는 적용되지 않습니다. GitLab 19.6에서work_item_hierarchy_add_children_limits라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. 기능 플래그가 비활성화된 동안에는 제한을 초과한 요청이 기록되지만 차단되지는 않습니다. - 레이블 삭제 속도 제한(
label_delete_limit): 인증된 사용자 1명당 1분마다 120회 요청. UI에서 프로젝트 및 그룹 레이블을 삭제하는 작업과 프로젝트 레이블 삭제 및 그룹 레이블 삭제용 REST API 엔드포인트에 적용됩니다. 제한은 이들 사이에서 공유됩니다. GitLab 19.6에서label_delete_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 삭제가 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - Pages 배포 쿼리 속도 제한
(
pages_deployments_api_limit): 인증된 사용자 1명당 1분마다 2,000회 확인(resolution). 인증되지 않은 요청은 IP 주소당 1분마다 2,000회 확인으로 제한됩니다.Project와Namespace의 GraphQLpagesDeployments필드에 적용됩니다. 이 필드를 확인할 때마다 1회로 계산되므로, 프로젝트 100개의 배포를 반환하는 쿼리는 100회로 계산됩니다. GitLab 19.6에서pages_deployments_api_rate_limit라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 요청이 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 이슈, 에픽, 작업 항목 업데이트 속도 제한(
work_item_update_limit): 인증된 사용자 1명당 1분마다 1,000회 업데이트. UI의 페이지, 보드, 퀵 액션에서 이슈, 에픽, 작업 항목을 업데이트하는 작업, 이슈 업데이트, 이슈 순서 변경, 이슈 시간 추적, 에픽 업데이트, 이슈 또는 하위 에픽을 에픽에 할당하는 REST API 엔드포인트, 그리고updateIssue,workItemUpdate,updateEpic,issueSet뮤테이션,issueMoveList를 포함해 이들을 업데이트하는 GraphQL 뮤테이션에 적용됩니다. 제한은 이들 사이에서 공유됩니다. 일괄 편집은 항목마다 1회 업데이트로 계산되며, 제한보다 많은 항목을 일괄 편집하는 요청은 거부됩니다. GitLab 19.6에서work_item_update_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 기능 플래그가 비활성화된 동안에는 제한을 초과한 업데이트가 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 에픽 보드 이동 속도 제한(
epic_move_list_limit): 인증된 사용자 1명당 1분마다 200회 이동.epicMoveListGraphQL 뮤테이션에 적용되며, 요청의 각 별칭이 계산됩니다. GitLab 19.6에서epic_move_list_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 이동이 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 상호 참조 속도 제한(
cross_reference_checks_limit): 사용자 1명당 1분마다 참조 800개. 설명이나 코멘트를 저장하면 GitLab은 참조하는 각 항목에 "mentioned in" 노트를 추가합니다. GitLab이 확인하는 각 참조가 제한에 포함됩니다. 커밋은 제한에 포함되지 않습니다. 사용자가 제한을 초과하면 저장은 성공하지만 GitLab은 해당 저장에 대해 "mentioned in" 노트를 추가하지 않습니다. 푸시된 커밋을 포함해 각 저장은 최대 150개의 참조를 확인합니다. 저장에 더 많은 참조가 있으면 GitLab은 작업 항목과 이슈를 먼저 확인한 다음 머지 리퀘스트, 커밋, 에픽을 확인합니다. 내부 사용자와 복합 ID가 있는 서비스 계정은 프로젝트 또는 그룹마다 별도의 제한이 있습니다. 프로젝트 및 그룹 액세스 토큰 사용자는 다른 사용자와 마찬가지로 제한이 하나입니다. GitLab 19.6에서enforce_cross_reference_limits라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 마일스톤 삭제 속도 제한(
milestone_destroy_limit): 인증된 사용자 1명당 1분마다 10회 요청. UI와 프로젝트 및 그룹 마일스톤 API에서 이슈와 머지 리퀘스트가 10개를 초과하는 프로젝트 또는 그룹 마일스톤을 삭제하는 작업에 적용됩니다. 더 작은 마일스톤의 삭제는 제한되지 않습니다. GitLab 19.6에서milestone_destroy_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 삭제가 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 리포지터리 아카이브 속도 제한
(
project_repositories_archive_limit,project_repositories_archive_unauthenticated_limit): 인증된 사용자 1명당 모든 프로젝트에 걸쳐 1분마다 200회 요청. 인증되지 않은 요청은 IP 주소당 1분마다 100회 요청으로 제한됩니다. UI 또는 API를 통해 리포지터리 아카이브를 다운로드하는 작업에 적용됩니다.archive_rate_limit기능 플래그가 필요합니다. GitLab 19.6에서cross_project_archive_rate_limit라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 요청이 기록되지만 차단되지는 않습니다. - 파일 blame 조회 속도 제한
(
project_repositories_blame_limit,project_repositories_blame_unauthenticated_limit): 사용자와 프로젝트마다 1분에 400회 요청. 인증되지 않은 요청은 IP 주소당 1분마다 400회 요청으로 제한됩니다. 파일 blame용 REST API 엔드포인트와 UI의 blame 보기가 사용하는RepositoryBlob의 GraphQLblame필드에 적용됩니다. - 리포지터리 커밋 목록 속도 제한
(
project_repository_commits_api_limit): 인증된 사용자 1명당 또는 인증되지 않은 요청의 경우 IP 주소당 1분마다 통계가 포함된 커밋 5,000개.with_stats또는all매개변수를 사용할 때 리포지터리 커밋 목록 조회용 REST API 엔드포인트에 적용됩니다.with_stats요청은 반환된 커밋 수만큼 계산되며,all매개변수를 사용하는 요청은3만큼 더 계산됩니다. GitLab 19.6에서rate_limit_project_repository_commits_api라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - 할 일 항목 목록 속도 제한(
todos_list_api_limit): 인증된 사용자 1명당 1분마다 300회 요청. 할 일 항목 목록 조회용 REST API 엔드포인트에 적용됩니다. GitLab 19.6에서todos_list_api_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 보호된 브랜치 쓰기 속도 제한(
protected_branch_write_limit): 최상위 그룹 또는 개인 네임스페이스마다 사용자 1명당 1시간에 5,000회 요청. 사용자가 UI, 프로젝트 또는 그룹 REST API,branchRuleCreate및branchRuleDeleteGraphQL 뮤테이션으로 브랜치를 보호하거나 보호 해제할 때 적용됩니다. 보호와 보호 해제 동작은 제한을 공유합니다. 기존 보호된 브랜치의 변경은 제한에 포함되지 않습니다. GitLab 19.6에서protected_branch_write_rate_limit_enforce라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 GitLab이 제한을 초과한 요청을 계산하지만 거부하지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - Markdown 업로드 속도 제한
(
markdown_upload_limit_megabytes_per_day): 사용자 1명당 업로드한 파일 10,240 MB. 자정이 아니라 사용자의 첫 업로드부터 시작하는 24시간 구간 기준입니다. 인증되지 않은 업로드는 IP 주소마다 제한됩니다. UI에서 개인 스니펫과 악용 신고를 포함해 Markdown에 사용할 파일을 업로드하는 작업, 프로젝트 및 그룹용 REST API, GraphQLuploadCreate뮤테이션에 적용됩니다. GitLab 19.6에서markdown_uploads_rate_limit_enforce라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 위키 페이지 읽기 속도 제한
(
wiki_read_request_limit_unauthenticated): 프로젝트 또는 그룹 위키마다 1분에 500회 요청이며, 인증되지 않은 모든 사용자가 공유합니다. UI의 위키 페이지와 프로젝트 및 그룹 위키 페이지를 나열하고 조회하는 REST API 엔드포인트에 적용됩니다. GitLab 19.6에서wiki_read_unauthenticated_rate_limit_enforce라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - GitLab Credits 사용량 속도 제한
(
subscription_usage_per_minute_limit,subscription_usage_per_hour_limit,subscription_usage_per_day_limit): 인증된 사용자 1명당 1분마다 300회, 1시간마다 10,000회, 1일마다 40,000회 요청. 하나의 제한을 공유하는 GraphQLsubscriptionUsage및trialUsage필드에 적용됩니다. GitLab 19.6에서enforce_subscription_usage_rate_limits라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab Credits 예산 상한 속도 제한
(
budget_cap_update_per_minute_limit,budget_cap_update_per_hour_limit,budget_cap_update_per_day_limit): 인증된 사용자 1명당 1분마다 뮤테이션 호출 150회, 1시간마다 1,000회, 1일마다 20,000회. 하나의 제한을 공유하는 GraphQLupsertUserBudgetCapOverrides및upsertFlatUserCap뮤테이션에 적용됩니다. GitLab 19.6에서enforce_budget_cap_rate_limits라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab Credits 사용자 사용량 속도 제한
(
credits_usage_per_minute_limit,credits_usage_per_hour_limit,credits_usage_per_day_limit): 인증된 사용자 1명당 1분마다 60회, 1시간마다 300회, 1일마다 3,000회 요청.currentUser의 GraphQLcreditsUsage필드에 적용됩니다. GitLab 19.6에서enforce_credits_usage_rate_limits라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. - 머지 리퀘스트 리베이스 속도 제한(
merge_requests_rebase_limit): 인증된 사용자 1명당 1분마다 30회 요청. 머지 리퀘스트 리베이스용 REST API 엔드포인트, UI에서의 리베이스,/rebase퀵 액션에 적용됩니다. 제한은 이들 사이에서 공유됩니다. GitLab 19.6에서merge_requests_rebase_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 머지 리퀘스트 diff 리소스 속도 제한
(
merge_request_diff_resources_request_limit): 인증된 사용자 1명당 또는 인증되지 않은 요청의 경우 IP 주소당 1분마다 360회 요청. 머지 리퀘스트의 Changes 탭이 로드하는diffs_stream,diffs_stats,diff_files_metadata에 적용됩니다. 세 가지는 하나의 제한을 공유합니다. GitLab 19.6에서merge_request_diff_resources_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 요청이 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다. - 머지 리퀘스트 변경 사항 속도 제한
(
merge_request_diffs_page_request_limit): 인증된 사용자 1명당 또는 인증되지 않은 요청의 경우 IP 주소당 1분마다 120회 요청. UI에서 머지 리퀘스트의 Changes 탭을 로드하는 작업에 적용됩니다. GitLab 19.6에서merge_request_diffs_page_rate_limit라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다. 플래그가 비활성화된 동안에는 제한을 초과한 요청이 기록되지만 차단되지는 않습니다. 이 설정은 베타이며 예고 없이 변경되거나 제거될 수 있습니다.
플랜 한도 API 또는 Rails 콘솔로 다음 속도 제한을 설정할 수 있습니다.
설정 파일#
다음 속도 제한은 설치본의 설정 파일에서만 설정할 수 있습니다. 예를 들어
Linux 패키지 설치본에서는 /etc/gitlab/gitlab.rb 입니다.
설정 불가능한 한도#
일부 속도 제한은 설정할 수 없습니다. 이러한 한도 목록은 설정 불가능한 속도 제한을 참고합니다.
차단 및 정지#
일부 보호 기능은 요청 속도를 늦추는 대신 일정 기간 동안 클라이언트를 차단합니다. 자세한 내용은 악용 및 인증 실패 차단을 참고합니다.