# Blacksmith 的帳單和快取限制：怎麼收費、快取保留什麼，以及固定價格何時更便宜

> Blacksmith 依 Runner 規格按分鐘收費，每月有 3,000 免費 2 vCPU 分鐘，Docker 層快取和 sticky disk 每 GB 每月收 US$0.50。怎麼估算你自己的帳單、怎麼降低它，以及每月固定 $39 何時更便宜的算法。

Blacksmith 依 Runner 規格按分鐘收費。它每月的 3,000 免費分鐘是 2 vCPU 分鐘，所以 4 vCPU Runner 會以兩倍速度用掉它們。Docker 層快取和 sticky disk 另外計費，每 GB 每月 US$0.50。而且每個平行作業都按自己的分鐘數計費。大多數讓人意外的帳單，都是這三件事造成的。它的 Actions 快取免費，每個儲存庫每週 25 GB 以內，7 天沒用到的項目會被移除。

Skipbox 按機器定價，不是按分鐘：4 vCPU 每月 $39，分鐘數不限。機器是你帳號專屬的，在作業之間把 Docker 的層和套件快取留在磁碟上，沒有按 GB 收費。改一行 `runs-on: skipbox` 就好。在 4 vCPU 上每月超過大約 6,400 分鐘，它就比 Blacksmith 便宜。

- Blacksmith 4 vCPU 每月 20,000 分鐘：還沒算儲存費用就要 $148。Skipbox S：$39
- 沒有按 GB 計費：Docker 的層和套件快取都留在你機器的磁碟上
- 不論分鐘數多少，帳單都一樣；每多加一個方案，就能同時執行更多作業

**GitHub Actions 固定價格，分鐘數不限** Skipbox 在你的專屬機器上執行 GitHub Actions 作業：每月 $39，不論執行多少分鐘。Docker 層和相依套件快取在作業之間保留，下一個作業馬上就能開始。

4 vCPU Runner，每月 20,000 分鐘: GitHub $222 → Skipbox $39. 每月省下 $183.

換過來只要改一行：`runs-on: skipbox`。

[開始 7 天免費試用](https://app.skipbox.dev/sign-in?ref=g-blacksmith-bill-and-cache-limits-zh-hant)

## Blacksmith 怎麼計費

依 Blacksmith 的[價格頁面](https://www.blacksmith.sh/pricing)和[執行個體類型](https://docs.blacksmith.sh/blacksmith-runners/overview)文件，兩者都在 2026 年 11 月 13 日讀取：

| Runner | 每分鐘 |
|---|---|
| Ubuntu x64，2 vCPU | US$0.004 |
| Ubuntu x64，4 vCPU | US$0.008 |
| Ubuntu x64，8 vCPU | US$0.016 |
| Ubuntu x64，16 vCPU | US$0.032 |
| Ubuntu x64，32 vCPU | US$0.064 |

- **免費分鐘數：** 每個組織每月 3000 分鐘的 x64 2vCPU 免費分鐘。較大的 Runner 會按比例用掉它們：在 4vCPU Runner 上跑 10 分鐘的作業，會用掉相當於 20 分鐘的 2vCPU 分鐘。所以不論規格，免費分鐘數都值 US$12，在 4 vCPU 上撐 1,500 分鐘。
- **儲存附加費：** Docker 層快取和 sticky disk 每 GB 每月加收 US$0.50。它的 CLI 從每小時的儲存計費帳本讀取儲存量，所以快取存在幾個小時，就計費幾個小時。固定 IP 每個每月加收 US$100。
- **免費的部分：** Actions 快取（使用它的快取不另收費），以及 Docker 容器快取（拉取的映像檔；容器快取使用的儲存空間不計費）。

## 為什麼帳單比計畫的高

- **免費分鐘數會隨 Runner 縮水。** 3,000 分鐘聽起來像一個小團隊一個月的量。在 4 vCPU 上只有 1,500 分鐘；在 8 vCPU 上只有 750 分鐘。
- **儲存另外計費。** 每個 Docker `cache-key` 都有自己的 sticky disk（[Docker 建置](https://docs.blacksmith.sh/blacksmith-caching/docker-builds)），每個 sticky disk 都按 GB 計費。十個映像檔各有 20 GB 的層快取，就是 200 GB，每月 US$100，還沒算任何一分鐘。
- **每個平行作業都計費。** 32 個分片就是 32 台 Runner 同時計費，帳單沒有上限。每個分片、每條矩陣、每次重新執行和每次代理推送，都是分鐘數。
- **警示只是一封信。** Blacksmith 的[設定](https://docs.blacksmith.sh/introduction/settings)說明的是 Spending Alerts：支出超過門檻時，Blacksmith 會寄信通知。文件沒有描述任何停止機制。

## 估算你自己的帳單

每個 Runner 規格的當月帳單和總額（每個規格的分鐘數乘以該規格的費率後加總，減去免費分鐘數的 US$12，再加上每 GB 每月的儲存量乘以 US$0.50）：

```text
bill = Σ (minutes × that size's rate) − $12 (the free minutes) + GB-months of storage × $0.50
```

Blacksmith 的 CLI 會給出每一部分（[用量和費用報告](https://docs.blacksmith.sh/blacksmith-cli/usage)）：

```bash
blacksmith usage --since 30d --breakdown-by runner_type,repo   # billable minutes and estimated cost
blacksmith usage storage --since 30d --breakdown-by repo,type   # GB, GB-hours and storage cost
```

控制台的 **Usage & Billing** 頁面也有同樣的明細。以 4 vCPU Runner 來說，只算分鐘數：

| 每月分鐘數（4 vCPU） | Blacksmith，未含儲存 | Skipbox S |
|---|---|---|
| 10,000 | $68 | $39 |
| 20,000 | $148 | $39 |
| 30,000 | $228 | $39 |
| 一直在忙 | $333.60 | $39 |

[首頁的費用試算](https://skipbox.dev/?vs=blacksmith&ref=g-blacksmith-bill-and-cache-limits-zh-hant#cost)會用你自己的分鐘數和規格比較這兩者。

## Blacksmith 的快取限制

依它的 [Actions 快取](https://docs.blacksmith.sh/blacksmith-caching/dependencies-actions)、[Docker 建置](https://docs.blacksmith.sh/blacksmith-caching/docker-builds)和 [sticky disk](https://docs.blacksmith.sh/blacksmith-caching/dependencies-sticky-disks) 文件，2026 年 11 月 13 日讀取：

| 快取 | 容量 | 移除規則 | 費用 |
|---|---|---|---|
| Actions 快取（`actions/cache`、`setup-*`） | 每個儲存庫每週 25 GB | 最後一次存取超過 7 天、最久沒用的項目 | 免費 |
| Docker 層快取（`useblacksmith/setup-docker-builder`） | 文件中沒有上限 | cache-key 的磁碟 7 天沒有建置就移除；BuildKit 會丟掉 8 天沒用的層 | 每 GB 每月 US$0.50 |
| Sticky disk（`useblacksmith/stickydisk`） | 每個作業最多 5 個 | 7 天沒有作業掛載就移除 | 每 GB 每月 US$0.50 |

快取在 Blacksmith 上仍然沒命中的原因：

- **有些快取不用它。** Rust 的 `sccache` 和 `docker/build-push-action` 裡的 GitHub Actions 快取選項，仍然會被導向 GitHub 的後端，而那裡每個儲存庫只有 10 GB。
- **項目預設限於所屬的分支**，和 GitHub 一樣。一個分支無法讀取同層其他分支的項目。控制台裡有一個設定可以關掉這個限制。
- **不常執行的作業會失去快取。** 每週執行不到一次的工作流程，會發現它的項目和磁碟都被移除了，只能冷啟動。
- **共用一個 cache-key 的不相關映像檔會互相擠掉。** Blacksmith 的文件說，這樣可能比完全不快取還慢；請讓每個 Dockerfile 有自己的 key。

## 怎麼降低 Blacksmith 帳單

降得最多的方法，是不再按分鐘付費：超過下一節的損益兩平點，固定價格的機器就更便宜，帳單也不再變動。留在 Blacksmith 上的話：

1. **取消被取代的執行。** 以 Pull Request 為 key、加上 `cancel-in-progress: true` 的 `concurrency`，就不用再為被新推送取代的執行付錢。
2. **刪除過時的儲存。** 用 `blacksmith stickydisk list` 或在 **Storage → Sticky Disks** 列出 sticky disk，刪掉沒有作業需要的。
3. **每個 Dockerfile 一個 cache-key，** 讓快取不會互相擠掉，害你多花一次重建。

## 固定價格何時更便宜

Skipbox 以月為單位為機器定價。Blacksmith 以分鐘定價。兩條線交叉的位置，依各自的價格算出（固定價格加上 US$12 的免費分鐘數，再除以 Blacksmith 的每分鐘費率）：

```text
break-even minutes = (flat price + $12 of free minutes) ÷ Blacksmith's per-minute rate
```

| Skipbox 方案 | 每月 | 對比的 Blacksmith | 超過多少就比 Blacksmith 便宜 |
|---|---|---|---|
| S，4 vCPU | $39 | 4 vCPU，US$0.008 | 每月大約 6,400 分鐘 |
| M，8 vCPU | $79 | 8 vCPU，US$0.016 | 每月大約 5,700 分鐘 |
| L，16 vCPU | $149 | 16 vCPU，US$0.032 | 每月大約 5,100 分鐘 |

儲存費用會讓這條線再往下移：在 Blacksmith 上，每 10 GB 的 Docker 層快取每月多 US$5，而在 Skipbox 上，它就在機器的磁碟上（S 有 80 GB）。

超過損益兩平點，固定價格就是比較便宜的那一個，帳單也不再變動。方案可以加總：想同時執行幾個 4 vCPU 的作業，就持有幾個 S。

## 換過去只要改一行

```yaml
jobs:
  build:
    runs-on: skipbox # was blacksmith-4vcpu-ubuntu-2404
    steps:
      - uses: actions/checkout@v4
      - uses: docker/setup-buildx-action@v4 # was useblacksmith/setup-docker-builder
      - uses: docker/build-push-action@v7 # was useblacksmith/build-push-action
        with:
          push: true
          tags: user/app:latest
```

1. 使用 GitHub 登入 Skipbox。
2. 安裝 Skipbox GitHub App，並選擇儲存庫，公開或私有都可以。
3. 修改 `runs-on` 並推送。

8 vCPU 的作業改用 `skipbox-8x16`，16 vCPU 的作業改用 `skipbox-16x32`。`actions/cache` 和 `setup-*` 照樣能用。原本放在 `useblacksmith/stickydisk` 裡的東西，例如 `~/.npm` 或 `node_modules`，上一個作業留下來後就還在磁碟上。詳情請見 [Docker 層快取指南](https://skipbox.dev/zh-hant/guides/docker-layer-cache-github-actions)，[Blacksmith 替代方案](https://skipbox.dev/zh-hant/compare/blacksmith-alternatives)頁面則並排比較了各家服務。

## 安全性

- 你的機器只執行你帳號的作業，絕不執行其他公司的作業。
- 每個作業結束後，Runner 的憑證、程序和容器都會被清除。開啟「每個作業都用新 VM」，每個作業就會用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在全新的 VM 上執行，可以讀取你的快取但不能修改。

詳情請見[作業隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 用一個 Blacksmith 作業試試看

試用不需信用卡，為期 7 天或 3,000 作業分鐘。把一個 Blacksmith 作業改成 `runs-on: skipbox`，執行兩次，再把第二次執行和當月帳單，與 Blacksmith 的用量報告比較。

## 常見問題

### 我們為了更快的 CI 換到 Blacksmith，但每月帳單比預期高很多。為什麼？

通常是三件事。3,000 免費分鐘是 2 vCPU 分鐘，所以在 4 vCPU Runner 上只撐 1,500 分鐘，在 8 vCPU 上只撐 750 分鐘。Docker 層快取和 sticky disk 依儲存量計費，每 GB 每月 US$0.50，另外加在分鐘數上。而且分片的測試套件、矩陣建置和代理的推送，每一個都按自己的分鐘數計費。執行 blacksmith usage --since 30d --breakdown-by runner_type,repo 和 blacksmith usage storage，就能看出是哪一個。

### Blacksmith 怎麼計費？

依 Runner 規格按分鐘計費。它的價格頁面（2026 年 11 月 13 日讀取）列出 Ubuntu x64 2 vCPU 每分鐘 US$0.004，4 vCPU US$0.008，8 vCPU US$0.016，16 vCPU US$0.032，32 vCPU US$0.064，每個組織每月有 3,000 免費分鐘，以 2 vCPU 分鐘計算。Docker 層快取和 sticky disk 每 GB 每月 US$0.50，固定 IP 每個每月 US$100。它的 Actions 快取不另收費。

### Blacksmith 的快取有哪些限制？

它的 Actions 快取每個儲存庫每週提供 25 GB 的免費儲存空間，最後一次存取超過 7 天的項目會被移除。項目預設限於所屬的分支。Rust 的 sccache 和 docker/build-push-action 的 GitHub Actions 快取仍然會送到 GitHub 的後端。Docker 層快取和 sticky disk 在它的文件裡沒有容量上限，但按 GB 計費，7 天沒有使用就會被刪除。

### Blacksmith 的快取不夠大，還是一直沒命中，怎麼辦？

把作業放在會保留磁碟的機器上執行。在 Skipbox 上，Docker 的層和套件快取在作業之間都留在你帳號的專屬機器上，沒有按 GB 計費，下一個作業開始時它們就已經在那裡。

### 固定價格什麼時候比 Blacksmith 便宜？

當每月分鐘數超過損益兩平點時。Skipbox 的 S 方案（4 vCPU）每月 $39；Blacksmith 的 4 vCPU Runner 在每月大約 6,400 分鐘時就達到這個金額，還沒算任何儲存費用。M 對 8 vCPU 的損益兩平點大約是 5,700 分鐘，L 對 16 vCPU 大約是 5,100 分鐘。方案可以加總：想同時執行幾個作業，就持有幾個方案。

### 可以在 Blacksmith 上設定硬性的支出上限嗎？

它的設定文件說明的是 Spending Alerts：你設定每月門檻，支出超過時 Blacksmith 會寄信到帳號的主要信箱。文件描述的是一封信，不是停止。要一個不會變動的價格，就需要按機器定價的方案：在 Skipbox 上，不論跑多少分鐘，帳單都是方案的價格，每多加一個方案，就能同時執行更多作業。

### 怎麼把作業從 Blacksmith 移到 Skipbox？

安裝 Skipbox GitHub App，把 runs-on 從 blacksmith-4vcpu-ubuntu-2404 之類的標籤改成 skipbox，然後推送。使用 Blacksmith 自家 Action 的步驟（useblacksmith/setup-docker-builder、build-push-action、stickydisk），原樣改回 docker/setup-buildx-action 和 docker/build-push-action；你的機器會在作業之間保留層。

更新於 2026-11-19 · https://skipbox.dev/zh-hant/guides/blacksmith-bill-and-cache-limits
