Skip to main content

Docker

簡介

Dockerfile.jammy 可以用於在 Docker 環境中執行 Playwright 程式碼。此映像包含 Playwright 瀏覽器瀏覽器系統相依性。Playwright 套件/相依套件不包含在映像中,應該單獨安裝。

使用方式

此 Docker 映像檔已發佈至 Microsoft Artifact Registry

info

此 Docker 映像僅供測試和開發用途。建議不要使用此 Docker 映像訪問不受信任的網站。

拉取映像檔

docker pull mcr.microsoft.com/playwright/python:v1.46.0-noble

執行該映像檔

預設情況下,Docker 映像將使用 root 用戶來執行瀏覽器。這將停用 Chromium 沙盒,因為 root 無法使用沙盒。如果你執行受信任的程式碼(例如,端到端測試)並且想避免管理單獨用戶的麻煩,那麼 root 用戶可能沒問題。對於網頁抓取或爬行,我們建議在 Docker 容器內建立一個單獨的用戶並使用 seccomp 配置檔。

端到端測試

在受信任的網站上,你可以避免建立一個單獨的使用者並使用 root,因為你信任將在瀏覽器上執行的程式碼。

docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.46.0-noble /bin/bash

爬取和抓取

在不受信任的網站上,建議使用單獨的使用者來啟動瀏覽器,並結合 seccomp 配置檔。在容器內或如果您使用 Docker 映像作為基礎映像,您必須使用 adduser 來實現。

docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/python:v1.46.0-noble /bin/bash

seccomp_profile.json 是在沙盒中執行 Chromium 所需的。這是一個預設 Docker seccomp profile 並具有額外的使用者名稱空間複製權限:

{
"comment": "Allow create user namespaces",
"names": [
"clone",
"setns",
"unshare"
],
"action": "SCMP_ACT_ALLOW",
"args": [],
"includes": {},
"excludes": {}
}
note

建議在使用 Chrome 時使用 --ipc=hostDocker docs)。沒有這個標誌,Chrome 可能會耗盡記憶體。

在 CI 上使用

請參閱我們的 持續整合指南 以獲取範例配置。

圖片標籤

請參見[所有可用的映像標籤]。

我們目前發佈帶有以下標籤的圖片:

  • :v1.46.0 - Playwright v1.46.0 發佈基於 Ubuntu 24.04 LTS (Noble Numbat) 的 docker 映像。
  • :v1.46.0-noble - Playwright v1.46.0 發佈基於 Ubuntu 24.04 LTS (Noble Numbat) 的 docker 映像。
  • :v1.46.0-jammy - Playwright v1.46.0 發佈基於 Ubuntu 22.04 LTS (Jammy Jellyfish) 的 docker 映像。
  • :v1.46.0-focal - Playwright v1.46.0 發佈基於 Ubuntu 20.04 LTS (Focal Fossa) 的 docker 映像。
note

建議盡可能將 Docker 映像檔固定到特定版本。如果 Docker 映像檔中的 Playwright 版本與專案/測試中的版本不匹配,Playwright 將無法找到瀏覽器可執行檔。

基礎映像檔

我們目前根據以下 Ubuntu 版本發佈映像:

  • Ubuntu 24.04 LTS (Noble Numbat), image tags include noble
  • Ubuntu 22.04 LTS (Jammy Jellyfish), image tags include jammy
  • Ubuntu 20.04 LTS (Focal Fossa), image tags include focal

Alpine

Firefox 和 WebKit 的瀏覽器建構是為 glibc 函式庫建構的。不支援基於 musl 標準函式庫的 Alpine Linux 和其他發行版。

建立你自己的影像

要在 Docker 中執行 Playwright,你需要安裝 Python、Playwright browsersbrowser system dependencies。請參閱以下 Dockerfile:

FROM python:3.12-bookworm

RUN pip install playwright==@1.46.0 && \
playwright install --with-deps