Giới hạn tốc độ trên GitLab.com đang thay đổi

GitLab.com lưu trữ hàng triệu dự án cho các nhóm mọi quy mô cần một nền tảng đáng tin cậy. Nhu cầu đang tăng nhanh và chúng tôi dự báo tải trên nền tảng sẽ tăng lên nhiều lần trong năm nay. Giới hạn có thể dự đoán được là điều giữ cho GitLab.com luôn nhanh cho mọi người dùng trên đó, bao gồm cả các khối lượng công việc tự động hóa và agent mà các đội đang xây dựng trên nền tảng.

Để duy trì điều đó khi chúng tôi mở rộng, chúng tôi cập nhật cách hoạt động của giới hạn tần suất (rate limits). Bắt đầu từ ngày 19 tháng 10 năm 2026, các giới hạn trên GitLab.com sẽ được điều chỉnh theo hạng mục đăng ký của bạn. Tài khoản Free và các yêu cầu không xác thực áp dụng trước, vào ngày 19 tháng 10. Premium và Ultimate sẽ áp dụng vào tháng 1 năm 2027.

What is changing

Giới hạn được căn chỉnh theo gói đăng ký của bạn. Các gói đăng ký Free, Premium và Ultimate sẽ có giới hạn riêng, áp dụng theo từng người dùng và từng group cấp cao nhất (top-level group). Gói Free có hiệu lực từ ngày 19/10; Premium và Ultimate từ tháng 1/2027.

Đăng nhập giúp bạn có đầy đủ hạn mức. Một yêu cầu đã xác thực được chi phối bởi gói đăng ký của bạn như mô tả bên dưới. Yêu cầu gửi đến không kèm thông tin xác thực sẽ nhận hạn mức 60 yêu cầu mỗi giờ theo địa chỉ IP.

Các giới hạn theo gói được công bố trong tài liệu về giới hạn tần suất.

What happens on October 19

Sẽ có hai cửa sổ xem trước dành cho lưu lượng Free và lưu lượng không xác thực, vào ngày 7 và ngày 14 tháng 10, từ 15:00 đến 19:00 UTC. Các yêu cầu của người dùng đã đăng nhập thuộc Premium và Ultimate không bị ảnh hưởng, vì các giới hạn đó không thay đổi cho tới tháng 1. Các yêu cầu không xác thực bị giới hạn bất kể nguồn gốc, bao gồm cả việc tự động hóa chạy với tài khoản trả phí nhưng không có thông tin xác thực. Một cửa sổ xem trước (kỹ sư gọi là brownout) là một khoảng thời gian ngắn, được lập kế hoạch, nơi chúng tôi bật các giới hạn mới rồi tắt trở lại. Không có thay đổi nào khác về dịch vụ khi cửa sổ chạy. Mục tiêu là cho bạn cái nhìn thực tế về cách khối lượng công việc của bạn hoạt động dưới các giới hạn mới, vài tuần trước khi chúng trở thành bắt buộc.

Vào ngày 19 tháng 10 các giới hạn mới chính thức có hiệu lực.

Chúng tôi thiết lập các giới hạn này bằng cách dựa trên cách GitLab.com được sử dụng thực tế. Hầu hết người dùng đã nằm trong các giới hạn mới và sẽ không nhận thấy thay đổi. Chúng tôi cũng so sánh với mức mà các nền tảng tương tự cho phép. Hạn mức Free và phần cho phép ẩn danh phù hợp với chuẩn mực ngành, trong khi Premium và Ultimate hào phóng hơn — ở mức mà các nền tảng khác dành cho hạng doanh nghiệp hoặc không công bố.

If you’re close to a limit

Nếu bạn thấy mình sắp chạm tới giới hạn, hãy xác thực các yêu cầu của bạn. Thường đó là thay đổi nhỏ: Sử dụng personal access token, token OAuth, hoặc token công việc CI/CD đều chuyển một yêu cầu khỏi hạn mức ẩn danh 60 yêu cầu/giờ sang hạn mức của gói bạn, vốn lớn hơn nhiều.

Tiếp theo, xem lại cách bạn gọi API. Gom nhóm (batching), lưu đệm (caching) và phân trang (pagination) rất hữu ích, và polling liên tục sẽ nhanh chóng sử dụng hết hạn mức của bạn. Khi bạn vượt giới hạn, bạn sẽ nhận được mã HTTP 429 kèm header Retry-After cho biết phải chờ bao lâu, nên một client biết đọc header phản hồi của chính nó sẽ tự điều chỉnh được phần lớn. Lùi bước theo cấp số nhân (exponential backoff) giúp phục hồi nhanh hơn so với thử lại ngay lập tức.

Nâng cấp lên Premium hoặc Ultimate cũng tăng giới hạn, theo từng người dùng và từng top-level group.

Nếu bạn cần giới hạn cao hơn một cách liên tục, chúng tôi đang triển khai phương án mua thêm dung lượng vượt trên giới hạn tiêu chuẩn của các gói, chi tiết sẽ được công bố vào cuối năm. Nếu điều đó phù hợp với bạn, hãy liên hệ đội tài khoản của bạn hoặc gửi email tới limits@gitlab.com và cho biết nhu cầu cụ thể.

What changes and what doesn’t

Những giới hạn này được đặt ra để không một khối lượng công việc đơn lẻ nào làm chậm nền tảng cho mọi người khác. Công việc đăng nhập thông thường không phải là mục tiêu, và với hầu hết người dùng, một ngày làm việc bình thường trông giống hệt như trước. Duyệt UI, làm việc trong trình soạn thảo của bạn, push/pull với git, và chạy CI/CD trong giới hạn của gói vẫn hoạt động như hiện nay. Một số tác vụ tự động hóa nặng và một vài khối lượng Free sẽ chạm tới trần mới.

Những điều không thay đổi:

• Bạn luôn có thể truy cập và xuất dữ liệu, kho lưu trữ của chính bạn.
• Giới hạn của GitLab Self-Managed và GitLab Dedicated vẫn do nhà vận hành của bạn quản lý. Đây chỉ là thay đổi cho GitLab.com.
• Chúng tôi sẽ thông báo cho bạn trước khi thực hiện các thay đổi bổ sung.

Lưu ý: Hãy đảm bảo xác thực các yêu cầu tới GitLab.com để nhận hạn mức cao hơn.

FAQ

Làm sao biết điều này có ảnh hưởng tới tôi không?
So sánh phút bận rộn nhất của bạn với các giới hạn đã công bố cho gói của bạn. Hầu hết khách hàng không ở gần giới hạn. Tín hiệu nhanh nhất lúc này là header RateLimit-Remaining trên phản hồi API của bạn, cho biết còn bao nhiêu trong cửa sổ hiện tại, và chúng tôi đang xây dựng một chế độ xem trong sản phẩm để hiển thị mức sử dụng so với giới hạn gói sẽ phát hành vào cuối năm.

Dự án công khai và bận rộn của tôi thì sao? Tôi có lựa chọn nào?
Có ba hành động hữu ích. Yêu cầu tự động gọi tới dự án của bạn hãy đăng nhập, điều này chuyển chúng sang hạn mức của riêng dự án/thành viên thay vì hạn mức ẩn danh. Đặt dự án ở chế độ private nếu lưu lượng không đến từ đối tượng khán giả bạn hướng tới, điều này ngăn các gọi ẩn danh tiếp cận. Hoặc nâng cấp lên Premium hoặc Ultimate để có hạn mức cao hơn nhiều.

Nếu tôi là thành viên của nhiều top-level group thì sao?
Hạn mức người dùng của bạn sẽ là cấp đăng ký cao nhất mà bạn có quyền truy cập. Nếu bạn là thành viên của một group Ultimate, bạn sẽ được hưởng hạn mức Ultimate.

Khi tôi chạm giới hạn sẽ xảy ra gì?
Bạn sẽ nhận được 429 Too Many Requests kèm các header RateLimit-* và một header Retry-After. Hãy chờ theo khoảng thời gian được chỉ định rồi thử lại.

Tích hợp của tôi thực sự không thể xác thực. Phải làm sao?
Hãy liên hệ với chúng tôi tại limits@gitlab.com. Có những mẫu ẩn danh hợp lệ, ví dụ một biểu tượng trạng thái công khai (public status badge). Nếu bạn lo ngại một tích hợp do bạn sở hữu có thể bị ảnh hưởng, hãy liên hệ với chúng tôi.

Điều này có áp dụng cho GitLab Self-Managed hoặc GitLab Dedicated không?
Không. Đây chỉ là thay đổi cho GitLab.com.

Additional resources

Nếu bạn muốn được tư vấn chi tiết về tác động đến hệ thống của bạn hoặc cần hỗ trợ triển khai các giải pháp xác thực, tối ưu hoá gọi API và quản lý giới hạn, hãy liên hệ Softribution để được tư vấn chuyên sâu hoặc mua giải pháp phù hợp với nhu cầu của bạn.