# Giới hạn dung lượng cache của GitHub Actions: vì sao cache bị loại bỏ, khôi phục chậm hoặc miss

> Actions cache của GitHub chứa 10 GB mỗi repository, xóa các mục lâu chưa được đọc nhất khi vượt mức, và bỏ mọi mục không dùng trong 7 ngày. Kể cả hit cũng là một lần tải về VM mới. Mỗi cách sửa tốn gì, và vì sao một runner giữ ổ đĩa khiến phần lớn cache trở nên thừa, với giá cố định $39 một tháng.

GitHub Actions cho mỗi repository 10 GB cache. Khi repository vượt mức đó, GitHub vẫn lưu mục mới và xóa các mục lâu chưa được đọc nhất cho đến khi về dưới giới hạn, và xóa mọi mục không job nào đọc trong 7 ngày. Một nhánh chỉ đọc được cache của chính nó và của nhánh mặc định, nên lần chạy đầu của nhánh mới thường miss. Và hit vẫn là một lần tải: mỗi job trên runner do GitHub host khởi đầu trên một VM mới, nên lại tải và giải nén archive. Bạn có thể nâng giới hạn, với $0,07 mỗi GB một tháng cho phần vượt 10 GB, và chỉnh key, nhưng lần tải vẫn còn đó.

Skipbox bỏ đi lần tải đó. Job của bạn chạy trên máy riêng của tài khoản bạn, được giữ lại giữa các job, nên cache của npm, pnpm, Gradle, Go và Cargo cùng Docker layer vẫn nằm trên ổ đĩa từ job trước (80 GB ở gói S, so với 14 GB trên runner của GitHub). Những gì actions/cache lưu nằm cạnh máy, nên khôi phục là một lần đọc tại chỗ. Đổi một dòng, `runs-on: skipbox`, với giá cố định $39 một tháng, không giới hạn phút.

- GitHub: 10 GB mỗi repository, mục không dùng trong 7 ngày bị xóa, hit nào cũng phải tải lại
- Skipbox: cache package và Docker layer nằm lại trên ổ đĩa của máy bạn, dung lượng cache ít nhất gấp 7 lần GitHub
- 20.000 phút mỗi tháng trên 4 vCPU: $222 trên GitHub, $39 trên Skipbox

**GitHub Actions giá cố định, không giới hạn phút** Skipbox chạy job GitHub Actions của bạn trên máy riêng dành cho bạn: $39 một tháng, dù bạn chạy bao nhiêu phút. Docker layer và cache dependency được giữ giữa các job, nên job tiếp theo khởi chạy ngay.

Runner 4 vCPU, 20.000 phút một tháng: GitHub $222 → Skipbox $39. Bạn tiết kiệm $183 mỗi tháng.

Chỉ cần đổi một dòng: `runs-on: skipbox`.

[Bắt đầu dùng thử miễn phí 7 ngày](https://app.skipbox.dev/sign-in?ref=g-github-actions-cache-size-limit-vi)

## Quy tắc cache của GitHub

Theo [tài liệu tham khảo dependency caching](https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching), [Actions billing](https://docs.github.com/en/billing/concepts/product-billing/github-actions) và changelog về [cache vượt 10 GB](https://github.blog/changelog/2025-11-20-github-actions-cache-size-can-now-exceed-10-gb-per-repository/) của GitHub:

| Quy tắc | GitHub làm gì |
|---|---|
| Dung lượng | Mặc định 10 GB mỗi repository, mọi nhánh và workflow dùng chung |
| Vượt dung lượng | Lưu mục mới, rồi xóa các mục theo lần truy cập cuối, cũ nhất trước, cho đến khi repository về dưới giới hạn. Việc loại bỏ chạy mỗi giờ |
| Mục không dùng | Xóa mọi mục không được đọc trong hơn 7 ngày |
| Giới hạn lớn hơn | Trên tài khoản Pro, Team hoặc Enterprise, admin có thể nâng dung lượng và số ngày. Vượt 10 GB, $0,07 mỗi GB một tháng, theo đỉnh của từng giờ. Chạm ngân sách thì cache chuyển sang chỉ đọc cho đến chu kỳ thanh toán sau |
| Nhánh | Một lần chạy khôi phục cache từ nhánh của nó và nhánh mặc định; lần chạy của pull request còn từ nhánh base. Không bao giờ từ nhánh ngang hàng hay nhánh con |
| Pull request | Cache của pull request gắn với merge ref của nó: chỉ các lần chạy lại của pull request đó đọc được |
| Mục | Không sửa được. Key đã tồn tại thì không được lưu lại |
| Hit | `cache-hit` chỉ là `true` khi `key` khớp chính xác; khớp qua `restore-keys` là `false` |
| Tốc độ | Tối đa 200 lượt tải lên và 1.500 lượt tải về mỗi phút cho mỗi repository |

## Vì sao cache bị loại bỏ

Một 10 GB chứa mọi thứ repository lưu. Mỗi nhánh và mỗi pull request lưu mục riêng. Một matrix ba phiên bản Node trên hai hệ điều hành lưu sáu mục. Build cache `type=gha` của Docker cũng rơi vào cùng 10 GB đó. Khi số lần lưu trong ngày cộng lại vượt giới hạn, mỗi lần lưu mới lại xóa một mục cũ hơn, thường là đúng mục mà job sau cần. GitHub gọi đây là cache thrashing.

Để xem thứ gì chiếm chỗ, liệt kê các mục theo dung lượng:

```bash
gh cache list --sort size_in_bytes --limit 20
```

Trang Actions › Caches của repository cho thấy cùng thông tin, kèm nhánh và lần dùng cuối của mỗi mục.

## Vì sao khôi phục chậm

Cache hit trên runner do GitHub host là một lần tải về VM mới, rồi giải nén. Thời gian tăng theo archive, nên một cache đã phình lên vài GB có thể mất lâu ngang lần cài mà nó định bỏ qua. Lần tải bị treo sẽ bị cắt bởi segment timeout của actions/cache, mặc định 10 phút (`SEGMENT_DOWNLOAD_TIMEOUT_MINS`).

Phần lớn thiết lập cũng khôi phục ít hơn người ta nghĩ. Input `cache:` của [setup-node](https://github.com/actions/setup-node) lưu cache tải xuống của trình quản lý package, không phải `node_modules`: sau khi khôi phục, `npm ci` vẫn cài mọi package. Cache pip của setup-python cũng vậy: các file tải về quay lại, môi trường vẫn phải cài lại.

## Vì sao cache miss

- **Key đã đổi.** Key có `hashFiles('**/package-lock.json')` miss ở mỗi lần lockfile đổi. `restore-keys` cho khớp một phần, và khi đó `cache-hit` là `false`.
- **Nhánh mới.** Nó đọc được cache của nhánh mặc định, không đọc được của nhánh feature khác. Nếu nhánh mặc định chưa từng chạy workflow, thì không có gì để đọc.
- **Bị loại bỏ.** Giới hạn dung lượng hoặc 7 ngày đã lấy nó đi.
- **Nó chưa bao giờ được lưu.** Mục không sửa được, nên key đã có thì không bao giờ được lưu lại, và nội dung được cache cũ đúng bằng lần lưu đầu tiên. Pull request từ fork có thể còn không được phép lưu.

**Chuyển file cho job sau trong cùng một lần chạy** là một công cụ khác. Cache dành cho lần chạy sau; kết quả build mà một job sau của cùng workflow cần thì đi qua `actions/upload-artifact` và `actions/download-artifact`. Artifact có kho lưu trữ riêng, ngoài 10 GB, và cũng là một lần tải về VM mới.

## Mỗi cách sửa tốn gì trên runner của GitHub

- **Nâng giới hạn.** Ít bị loại bỏ hơn, với $0,07 mỗi GB một tháng cho phần vượt 10 GB (ví dụ của chính GitHub: 200 GB dùng hết là $13,30 một tháng), trên tài khoản Pro, Team hoặc Enterprise. Khôi phục vẫn là tải về, và cache lớn hơn thì tải lâu hơn.
- **Lưu ít hơn.** Cache `~/.npm` hoặc pnpm store, không cache `node_modules` hay kết quả build. Chỉ lưu trên nhánh mặc định, với `actions/cache/restore` ở mọi job và `actions/cache/save` ở một job. Cách này tốn thời gian của bạn, và cache nhỏ hơn thì khôi phục được ít hơn.
- **Sửa key.** Đặt key theo lockfile, thêm `restore-keys`, và chạy workflow ở các lần push lên nhánh mặc định để nhánh mới có gì mà đọc.
- **Một self-hosted runner giữ ổ đĩa.** Không phải tải, không có 10 GB. Bạn tự vận hành máy: cập nhật hệ điều hành, dọn dẹp giữa các job mà không xóa cache, và sửa khi nó hỏng.

## Khi cách sửa là một cái máy giữ ổ đĩa

Cache tồn tại vì cái máy hay quên. Runner do GitHub host là một VM mới cho mỗi job, nên job lưu trạng thái vào kho của GitHub rồi lần sau lấy về. Trên một cái máy được giữ lại, trạng thái đó đã nằm trên ổ đĩa: cache của trình quản lý package, tool cache, Docker image và build cache, cả kết quả build.

Khác biệt hiện rõ trong CI của các dự án thật, từ [các lần chúng tôi chạy chính job của họ](https://skipbox.dev/vi/guides/rust-cache-slow-rust-ci):

- **astro (Node.js, Turborepo):** 528 giây trên GitHub, 30 giây trên máy riêng của Skipbox, nơi giữ cache của turbo, nên các lần chạy warm phát lại 40 task build thay vì chạy chúng.
- **helix (Rust):** step toolchain và cache mất 9-10 giây trên máy riêng, so với 41-46 giây trên GitHub.
- **tauri (Rust):** 246 giây trên GitHub, 53 giây trên máy riêng, với `target/` được giữ giữa các job.

## Skipbox giữ cache trên máy của bạn

Mỗi gói đi kèm máy riêng của tài khoản bạn, được giữ lại giữa các job:

- **Cache package nằm lại trên ổ đĩa:** `~/.npm`, pnpm store, `~/.cache` của từng tool, và cache của Go, Gradle, Cargo và Maven, cùng các tool mà `setup-*` đã cài. Không có gì phải khôi phục.
- **Docker image, layer và build cache cũng được giữ.** `docker build` dùng lại layer của lần build trước ([Docker layer cache](https://skipbox.dev/vi/guides/docker-layer-cache-github-actions)).
- **actions/cache, setup-* và rust-cache không cần sửa gì.** Những gì chúng lưu nằm cạnh máy thay vì trong kho của GitHub, với nhiều chỗ hơn 10 GB mỗi repository của GitHub, và khôi phục là đọc tại chỗ.
- **Ổ đĩa không có hạn 7 ngày.** Không gì bị xóa cho đến khi ổ đĩa gần đầy sau một job; khi đó thứ lâu chưa dùng nhất bị xóa trước.

Dung lượng cache ít nhất gấp 7 lần GitHub trên gói S. Job chọn kích thước bằng nhãn:

| Nhãn | Máy | Ổ đĩa | Gói |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 80 GB | S, $39 một tháng |
| `skipbox-8x16` | 8 vCPU · 16 GB | 160 GB | M, $79 một tháng |
| `skipbox-16x32` | 16 vCPU · 32 GB | 320 GB | L, $149 một tháng |

`ubuntu-latest` của repository riêng tư có 2 CPU, 8 GB và 14 GB SSD. Trên Skipbox không giới hạn phút. Ở mức 20.000 phút mỗi tháng trên 4 vCPU, GitHub tính $222; Skipbox S là $39, ít hơn $183.

## Chuyển sang chỉ cần một dòng

```yaml
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
```

1. Đăng nhập Skipbox bằng GitHub.
2. Cài ứng dụng GitHub của Skipbox và chọn các repository.
3. Đổi `runs-on` rồi push.

Giữ nguyên các step cache của bạn. Lần chạy thứ hai tìm thấy cache của lần chạy đầu trên máy.

## Bảo mật

- Máy chỉ thuộc về tài khoản của bạn. Không có job của công ty nào khác chạy trên đó.
- Sau mỗi job, thông tin xác thực, tiến trình và container của runner bị xóa. Bật VM mới cho mỗi job thì mỗi job chạy trên một máy mới.
- Code từ người không có quyền ghi (chẳng hạn pull request từ fork) chạy trên một VM mới, đọc được cache của bạn nhưng không sửa được.

Chi tiết có trong [cách các job được cách ly](https://docs.skipbox.dev/vi/isolation).

## Thử trên job có cache hay miss

Dùng thử miễn phí trong 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Chuyển job đó sang `runs-on: skipbox`, chạy hai lần, và đặt các step khôi phục và cài đặt của lần chạy thứ hai cạnh số liệu của GitHub.

## Câu hỏi thường gặp

### Giới hạn dung lượng cache của GitHub Actions là bao nhiêu?

Mặc định 10 GB mỗi repository, cho mọi nhánh và workflow cộng lại. Vượt mức đó, GitHub vẫn lưu mục mới và xóa các mục theo lần truy cập cuối, cũ nhất trước, cho đến khi repository về dưới giới hạn. Mục nào không job nào đọc trong 7 ngày bị xóa bất kể dung lượng. Trên tài khoản Pro, Team hoặc Enterprise, admin có thể nâng giới hạn và số ngày; dung lượng vượt 10 GB tính $0,07 mỗi GB một tháng, đo theo đỉnh của từng giờ, và khi chạm ngân sách, cache chuyển sang chỉ đọc cho đến chu kỳ thanh toán sau.

### Vì sao cache GitHub Actions của tôi hay bị loại bỏ như vậy?

Vì mọi thứ trong repository dùng chung một 10 GB: mỗi nhánh, mỗi pull request, mỗi job matrix và mỗi hệ điều hành đều lưu mục riêng, và Docker cache type=gha cũng rơi vào cùng chỗ. Khi số lần lưu trong ngày cộng lại vượt giới hạn, mỗi lần lưu lại xóa một mục cũ hơn, và job sau miss đúng mục nó cần. GitHub gọi đây là cache thrashing. Liệt kê các mục theo dung lượng (gh cache list --sort size_in_bytes) để xem thứ gì chiếm chỗ.

### Vì sao khôi phục cache mất lâu ngang cài từ đầu?

Vì hit vẫn là một lần tải. Mỗi job trên runner do GitHub host khởi đầu trên một VM mới, nên actions/cache lần nào cũng tải archive về và giải nén, và cache càng lớn càng lâu. Cache của setup-node mang về cache tải xuống của trình quản lý package, không phải node_modules, nên npm ci vẫn cài mọi package sau khi khôi phục. Trên một runner giữ ổ đĩa, cache đã nằm sẵn và không có gì phải tải.

### Vì sao actions/cache miss trên nhánh mới?

Một lần chạy khôi phục được cache từ nhánh của nó và từ nhánh mặc định, và lần chạy của pull request còn từ nhánh base. Nó không đọc được cache của nhánh ngang hàng. Vì vậy lần chạy đầu của nhánh feature chỉ hit nếu nhánh mặc định đã lưu key đó. Hãy chạy workflow ở các lần push lên nhánh mặc định để nó lưu, và thêm restore-keys để khớp một phần; cache-hit chỉ là true khi key khớp chính xác.

### Skipbox giữ bao nhiêu Actions cache?

Nhiều hơn 10 GB mỗi repository của GitHub, đặt cạnh máy của bạn thay vì trong kho lưu trữ của GitHub. Trên máy cloud, những gì job lưu bằng actions/cache, setup-* và rust-cache nằm lại trên chính ổ đĩa của máy, tới một nửa ổ đĩa đó (80 GB ở S, 160 GB ở M, 320 GB ở L); trên host của Skipbox, cache của host giữ 20 GB mỗi repository. Dù ở đâu, một mục được giữ 7 ngày kể từ lần dùng cuối, theo quy tắc nhánh của GitHub. Cache package và Docker layer không đi qua đó: chúng nằm thẳng trên ổ đĩa.

### Điều gì xóa cache trên máy Skipbox?

Giữa các job thì không gì cả: cache nằm lại trên máy, và chỉ khi một job để ổ đĩa gần đầy thì thứ lâu chưa dùng nhất mới bị xóa trước. Máy khởi đầu sạch khi đặt lại: khi bạn nhấn Đặt lại máy, khi image của máy được cập nhật (ít nhất mỗi tháng một lần), khi máy không qua kiểm tra tình trạng sau một job, và khi một job chạm giới hạn 6 giờ. Máy bị xóa cùng ổ đĩa khi gói kết thúc.

### Thử thì tốn bao nhiêu?

Không tốn gì. Dùng thử kéo dài 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Chuyển job có cache hay miss hoặc khôi phục chậm sang runs-on: skipbox, chạy hai lần, rồi so các step khôi phục và cài đặt của lần chạy thứ hai với GitHub.

Cập nhật ngày 2026-11-16 · https://skipbox.dev/vi/guides/github-actions-cache-size-limit
