# GitHub Actions 上的 Playwright：讓瀏覽器一直裝著，E2E 跑得更快

> GitHub Actions 上的 Playwright 就是 npm ci、npx playwright install --with-deps、npx playwright test。它很慢，是因為每個作業都在新的 VM 上重新安裝瀏覽器，而在私有儲存庫 2 核心的 ubuntu-latest 上只跑 1 個 worker。在 Skipbox 上，瀏覽器留在你的機器上，作業最多能拿到 16 vCPU，每月固定 $39：4 vCPU 每月 20,000 分鐘時，比 GitHub 每月少 $183。

你的 Playwright 測試套件在 GitHub Actions 上比在你的筆電上慢得多，而團隊每個 Pull Request 都在等那個慢的。差距的一部分是準備工作：每個作業在第一個測試之前，都要下載三個瀏覽器並安裝它們的系統套件。其餘的是核心數：在私有儲存庫的 `ubuntu-latest` 上，Playwright 只跑一個 worker。

Skipbox 在你帳號的專屬機器上執行同樣的工作流程，瀏覽器在作業之間一直裝著，作業最多能拿到 16 vCPU，每月固定 $39，分鐘數不限。換過去只要改一行 `runs-on: skipbox`。

- 瀏覽器留在你的機器上：不用每個作業都下載 `playwright install`，也沒有快取要管理
- 4、8 或 16 vCPU，Playwright 預設的 worker 數也跟著增加
- 4 vCPU 每月 20,000 分鐘：GitHub 上要 $222，Skipbox 上是 $39

**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-playwright-github-actions-zh-hant)

## Playwright 怎麼在 GitHub Actions 上執行

Playwright 自己的 CI 設定是一個作業裡的三個指令：`npm ci`、`npx playwright install --with-deps`（瀏覽器和它們需要的系統套件），以及 `npx playwright test`，測試失敗時也會把 HTML 報告上傳成 artifact。`npm init playwright@latest` 會把它寫進 `.github/workflows/playwright.yml`。

決定它速度的有兩件事：

| | GitHub 託管 Runner | Skipbox |
|---|---|---|
| 瀏覽器 | 每個作業都要下載並安裝。Playwright 建議不要快取它們，因為還原花的時間差不多 | 在作業之間一直裝在你的機器上 |
| Worker（預設：核心數的一半） | 在私有儲存庫 2 核心的 `ubuntu-latest` 上是 1 個 | 依標籤，是 4、8 或 16 vCPU 的一半 |

用 `--shard=1/4` 分片會把測試套件拆到多個作業上，但每個分片都要重複 `npm ci` 和瀏覽器安裝，而在按分鐘計費下，每個分片的準備工作都要再付一次錢。

## 慢的測試套件要花多少

端對端測試是合併前的最後一道檢查，所以整個團隊都在等它。一個 20 分鐘的測試套件，一天 30 次 Pull Request 推送，就是 10 小時的等待，而同一套測試循環對 staging 執行，就會整天都在跑。只在慢的 Runner 上出現的不穩定失敗，還要再加上重新執行。

在按分鐘計費下，這些分鐘每一分都要付錢：

| 每月分鐘數（4 vCPU） | GitHub | Skipbox S | 每月省下 |
|---|---|---|---|
| 10,000 | $102 | $39 | **$63** |
| 20,000 | $222 | $39 | **$183** |
| 30,000 | $342 | $39 | **$303** |
| 全天候運作 | $500.40 | $39 | **$461.40** |

GitHub 的金額已扣除 GitHub Team 的內含用量。把你自己的分鐘數填進[首頁的費用試算](https://skipbox.dev/?ref=g-playwright-github-actions-zh-hant#cost)。

E2E 的分鐘數成長得最快。程式設計代理隨時都在開 Pull Request，每一個都會跑測試套件，而以前每晚跑一次 E2E 的團隊，現在每次推送都跑。

## 自己讓它變快

在 GitHub 託管 Runner 上，常見的清單是：

- 把測試套件分片到矩陣上，再在最後一個作業合併 blob 報告
- 提高逾時，因為 2 核心的 Runner 渲染得比筆電慢
- 改用 Playwright 的 Docker 映像檔，並讓它的 tag 和你的 Playwright 版本保持一致
- 按分鐘付費使用大型 Runner，或自己跑一台自架 Runner，並讓它的瀏覽器、套件和作業系統保持最新

每一步都是要你負責的更多 YAML，以及要付的更多分鐘數。Skipbox 把瀏覽器留在磁碟上，並把核心給作業。

## Skipbox 給你的測試套件什麼

**一直裝著的瀏覽器。** 每個方案都附有一台你帳號專屬、在作業之間保留下來的機器。下一個作業開始時，`~/.cache/ms-playwright` 裡的 Playwright 瀏覽器、npm 的快取和你的 Docker 映像檔都已經在磁碟上，所以 `npx playwright install --with-deps` 會在那裡找到它們。

**隨規格增加的 worker。** 依標籤選擇規格。vCPU 越多，預設的 worker 越多；記憶體越多，能同時開的瀏覽器越多：

| 標籤 | 機器 | 價格 |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 每月 $39（S） |
| `skipbox-8x16` | 8 vCPU · 16 GB | 每月 $79（M） |
| `skipbox-16x32` | 16 vCPU · 32 GB | 每月 $149（L） |

**分鐘數不限。** 分片、重試和重新執行都不會改變帳單，而 Skipbox 的作業不用 GitHub 分鐘數，所以 GitHub 預算絕不會讓它們停下來。

**沒有東西要維護。** 映像檔是 Ubuntu 24.04，有免密碼的 `sudo`，以及 Playwright 瀏覽器需要的系統函式庫。Skipbox 負責更新它、在每個作業後清理環境，並重建健康檢查失敗的機器。

## 換過去只要改一行

```yaml
name: Playwright Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v6
        with:
          node-version: lts/*
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx playwright test
      - uses: actions/upload-artifact@v5
        if: "!cancelled()"
        with:
          name: playwright-report
          path: playwright-report/
```

1. 使用 GitHub 登入 Skipbox。
2. 安裝 Skipbox GitHub App，並選擇儲存庫。
3. 修改 `runs-on` 並推送。

## 安全性

- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後，Runner 的憑證、程序和容器都會被清除。瀏覽器和快取會留下來。從 2026 年 11 月 13 日起，你的 checkout 和它的建置輸出（Cargo 的 `target/`）會留在你的專屬機器上，供之後的作業使用；開啟「每個作業都用新 VM」，每個作業就會用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在全新、用完即丟的機器上執行。

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

## 試試看

試用免費，為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。把 Playwright 作業改成 `runs-on: skipbox`，執行兩次，再把第二次執行的步驟時間和 GitHub 上的比較。

## 常見問題

### 怎麼在 GitHub Actions 中執行 Playwright 測試？

在一個作業裡：npm ci、npx playwright install --with-deps、npx playwright test，再在一個測試失敗時也會執行的步驟中，把 playwright-report 資料夾上傳成 artifact。npm init playwright@latest 會替你寫好這個工作流程。要在 Skipbox 上執行，把 runs-on 改成 skipbox。

### 為什麼 Playwright 測試在 GitHub Actions 上很慢？

有兩個原因。每個作業都從新的 VM 開始，所以在第一個測試之前，要下載 Chromium、Firefox 和 WebKit，並安裝它們的系統套件。而 Playwright 預設的 worker 數是 CPU 核心數的一半，在私有儲存庫 2 核心的 ubuntu-latest 上就是 1 個 worker。Skipbox 在作業之間把瀏覽器留在你的機器上，並給作業 4、8 或 16 vCPU。

### GitHub Actions 上應該快取 Playwright 的瀏覽器嗎？

在從新 VM 開始的 Runner 上，Playwright 建議不要：還原快取花的時間和下載瀏覽器差不多，而且在 Linux 上，系統套件無法快取。在 Skipbox 上沒有東西需要快取。瀏覽器留在你機器上的 ~/.cache/ms-playwright，下一個作業就會在那裡找到它們。

### Playwright 在 GitHub Actions 上用幾個 worker？

預設是機器邏輯 CPU 核心數的一半：在私有儲存庫有 2 顆 CPU 的 ubuntu-latest 上是 1 個。每個 worker 驅動自己的瀏覽器，所以更多 worker 需要更多核心和更多記憶體。在 Skipbox 上，runs-on: skipbox-8x16 給你 8 vCPU 和 16 GB。

### 可以在 Skipbox 上免費試用 Playwright 嗎？

可以。試用為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡，在 4 vCPU 和 16 GB 上執行。把 Playwright 作業的 runs-on 改成 skipbox，執行兩次。

更新於 2026-11-11 · https://skipbox.dev/zh-hant/guides/playwright-github-actions
