Playwright Docker 官方鏡像實(shí)戰(zhàn)指南拉取、運(yùn)行、seccomp 安全隔離與遠(yuǎn)程 Server 連接【免費(fèi)下載鏈接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/pl/playwrightPlaywright 官方提供了內(nèi)嵌瀏覽器與系統(tǒng)依賴的 Docker 鏡像讓你無需在每臺(tái)機(jī)器上手工安裝瀏覽器即可運(yùn)行端到端測(cè)試、爬蟲抓取或遠(yuǎn)程瀏覽器服務(wù)。本文基于倉庫內(nèi)的 Docker 官方文檔 展開結(jié)合 utils/docker/Dockerfile.noble、utils/docker/seccomp_profile.json 等構(gòu)建源碼完整覆蓋鏡像拉取、以 root 或非 root 用戶運(yùn)行、seccomp 沙箱配置、CI 集成、run-server遠(yuǎn)程連接與 noVNC 可視調(diào)試等場(chǎng)景并解釋鏡像內(nèi)部的目錄結(jié)構(gòu)與版本鎖定機(jī)制。官方鏡像的內(nèi)容與定位官方文檔 docs/src/docker.md 明確了鏡像的邊界鏡像已包含Playwright 瀏覽器二進(jìn)制Chromium、Firefox、WebKit以及瀏覽器運(yùn)行所需的系統(tǒng)依賴鏡像不包含Playwright 包本身npm/pip/nuget/Maven 依賴需要在容器內(nèi)自行安裝對(duì)應(yīng)語言的 Playwright 包。這一設(shè)計(jì)與 Dockerfile.noble 的構(gòu)建過程一致鏡像先把瀏覽器“烘焙”進(jìn)/ms-playwright目錄通過ENV PLAYWRIGHT_BROWSERS_PATH/ms-playwright而 Playwright 包本身留給你在使用時(shí)安裝。拉取鏡像鏡像發(fā)布在 Microsoft Artifact RegistryMCR。以下四個(gè)命令分別對(duì)應(yīng) JavaScript、Python、.NET、Java 語言棧docker pull mcr.microsoft.com/playwright:vVERSION-noble# Python docker pull mcr.microsoft.com/playwright/python:vVERSION-noble # .NET docker pull mcr.microsoft.com/playwright/dotnet:vVERSION-noble # Java docker pull mcr.microsoft.com/playwright/java:vVERSION-noble說明原始文檔中使用%%VERSION%%占位符文檔構(gòu)建時(shí)會(huì)替換為當(dāng)前發(fā)布版本號(hào)。當(dāng)前倉庫package.json中的版本為 1.64.0-next開發(fā)線實(shí)際使用時(shí)請(qǐng)以 MCR 上最新穩(wěn)定 tag 為準(zhǔn)文檔 noVNC 一節(jié)給出的具體示例即mcr.microsoft.com/playwright:v1.57.0。務(wù)必固定版本 tag。文檔特別警告如果鏡像中的 Playwright 版本與你項(xiàng)目/測(cè)試中的版本不一致Playwright 將無法定位到瀏覽器可執(zhí)行文件。固定版本可以消除這種漂移。鏡像標(biāo)簽體系當(dāng)前發(fā)布的 tag 規(guī)則見 docs/src/docker.md “Image tags” 一節(jié)Tag含義:vVERSION基于 Ubuntu 24.04 LTSNoble Numbat的發(fā)布鏡像:vVERSION-noble基于 Ubuntu 24.04 LTSNoble Numbat:vVERSION-jammy基于 Ubuntu 22.04 LTSJammy Jellyfish:vVERSION-resolute基于 Ubuntu 26.04 LTSResolute Raccoon從發(fā)布腳本 utils/docker/publish_docker.sh 的源碼結(jié)構(gòu)可以進(jìn)一步確認(rèn)兩點(diǎn)裸 tag不帶發(fā)行版后綴只打在stable頻道且僅附加在 noble 構(gòu)建上NOBLE_TAGS(${VERSION_TAG})只在 stable 分支執(zhí)行見 publish_docker.shcanary頻道的 tag 形如v版本-canary-UTC時(shí)間戳且每個(gè) tag 都會(huì)生成amd64/arm64兩種架構(gòu)鏡像再用docker manifest合成多架構(gòu) manifest見 publish_docker.sh 與 publish_docker.sh?；A(chǔ)鏡像與 Alpine 限制官方只基于 glibc 家族的 Ubuntu 發(fā)行版構(gòu)建Ubuntu 26.04 LTSresolute、Ubuntu 24.04 LTSnoble、Ubuntu 22.04 LTSjammy。Firefox 與 WebKit 的瀏覽器二進(jìn)制是為 glibc 編譯的因此Alpine Linux 等基于 musl 的發(fā)行版不受支持——如果你要自建鏡像請(qǐng)以 Ubuntu/Debian 系為基礎(chǔ)而不是 Alpine。鏡像內(nèi)部結(jié)構(gòu)源碼級(jí)解讀閱讀 utils/docker/Dockerfile.noble 可以看到官方鏡像的幾個(gè)關(guān)鍵設(shè)計(jì)預(yù)創(chuàng)建非 root 用戶pwuser構(gòu)建階段通過adduser pwuser創(chuàng)建Dockerfile.noble。這正是后文“抓取/爬蟲場(chǎng)景用--user pwuser運(yùn)行”能直接生效的原因。瀏覽器分圖層安裝以支持并行拉取Chromium、Firefox、WebKit 各自獨(dú)立RUN層安裝Dockerfile.noble。其中安裝 Chromium 會(huì)同時(shí)帶入chromium-headless-shell和ffmpeg后者用于視頻錄制。寫入鏡像名標(biāo)記構(gòu)建時(shí)執(zhí)行playwright-core mark-docker-image ${DOCKER_IMAGE_NAME_TEMPLATE}Dockerfile.noble。該隱藏 CLI 命令定義在 packages/playwright-core/src/cli/program.ts實(shí)現(xiàn)位于 packages/playwright-core/src/cli/installActions.ts——它把鏡像名模板寫入容器內(nèi)使 Playwright 在版本匹配時(shí)能直接定位/ms-playwright下已安裝的瀏覽器。這也從源碼層面解釋了為什么“鏡像版本必須與項(xiàng)目版本一致”是硬性要求。Node.js 預(yù)裝JS 鏡像內(nèi)置 Node.js 24Dockerfile.noble所以遠(yuǎn)程連接示例可以直接用npx -y playwright版本 run-server啟動(dòng)服務(wù)。運(yùn)行鏡像root 與 seccomp 兩種模式文檔給出一條重要安全提示該鏡像僅用于測(cè)試與開發(fā)目的不建議用它訪問不可信的網(wǎng)站。同時(shí)默認(rèn)以root用戶運(yùn)行瀏覽器會(huì)禁用 Chromium 沙箱沙箱在 root 下不可用。因此文檔按場(chǎng)景給出兩套運(yùn)行方式場(chǎng)景一可信網(wǎng)站的端到端測(cè)試root 模式如果你的代碼運(yùn)行在可信站點(diǎn)上例如自己的 E2E 測(cè)試用 root 運(yùn)行即可省去管理獨(dú)立用戶的麻煩docker run -it --rm --ipchost mcr.microsoft.com/playwright:vVERSION-noble /bin/bashPython / .NET / Java 鏡像同理只需替換鏡像名playwright/python、playwright/dotnet、playwright/java。場(chǎng)景二抓取與爬蟲非 root seccomp訪問不可信站點(diǎn)時(shí)文檔推薦用獨(dú)立用戶pwuser啟動(dòng)瀏覽器并疊加 seccomp profile以啟用 Chromium 沙箱docker run -it --rm --ipchost --user pwuser \ --security-opt seccompseccomp_profile.json \ mcr.microsoft.com/playwright:vVERSION-noble /bin/bash其中seccomp_profile.json就是倉庫中的 utils/docker/seccomp_profile.json。它本質(zhì)是 Docker 默認(rèn) seccomp profile 加上一條“允許創(chuàng)建用戶命名空間”的例外規(guī)則seccomp_profile.json{ comment: Allow create user namespaces, names: [ clone, setns, unshare ], action: SCMP_ACT_ALLOW, args: [], includes: {}, excludes: {} }Chromium 的用戶命名空間沙箱依賴clone/setns/unshare這些系統(tǒng)調(diào)用默認(rèn)的 Docker seccomp 策略會(huì)攔截它們所以必須用這份放寬了這三個(gè)調(diào)用的 profile。使用--security-opt seccompseccomp_profile.json時(shí)需把該文件掛載或映射到容器可訪問的路徑例如當(dāng)前目錄或~/.docker。推薦的 Docker 運(yùn)行配置文檔列出了三條運(yùn)行建議均針對(duì) Chromium 在容器內(nèi)的常見故障加--init標(biāo)志避免對(duì) PID1 進(jìn)程的特殊處理這是容器內(nèi)產(chǎn)生僵尸進(jìn)程的常見原因Chromium 場(chǎng)景加--ipchost不加的話 Chromium 可能因共享內(nèi)存不足而崩潰Docker 默認(rèn)的/dev/shm較小本地開發(fā)遇到 Chromium 啟動(dòng)的怪異錯(cuò)誤時(shí)嘗試docker run --cap-addSYS_ADMIN增加權(quán)限定位問題。CI 集成文檔將 CI 場(chǎng)景指向 docs/src/ci.md 中的 Continuous Integration 指南那里給出了各 CI 平臺(tái)GitHub Actions 等配合官方鏡像的完整示例配置。核心思路與本文一致在 CI runner 上直接docker run官方鏡像執(zhí)行測(cè)試省去“在 runner 上裝瀏覽器 裝依賴”的步驟。遠(yuǎn)程連接容器內(nèi)跑 Playwright Server宿主機(jī)跑測(cè)試這是 Docker 鏡像最有價(jià)值的進(jìn)階用法在容器內(nèi)啟動(dòng)Playwright Server測(cè)試留在宿主機(jī)或另一臺(tái)機(jī)器上運(yùn)行。適用于在不受支持的 Linux 發(fā)行版上跑測(cè)試或任何遠(yuǎn)程執(zhí)行場(chǎng)景。第一步在容器中啟動(dòng) Serverdocker run -p 3000:3000 --rm --init -it \ --workdir /home/pwuser --user pwuser \ mcr.microsoft.com/playwright:vVERSION-noble \ /bin/sh -c npx -y playwrightVERSION run-server --port 3000 --host 0.0.0.0注意命令中鏡像版本與playwrightVERSION的包版本要保持一致。第二步連接 ServerJavaScript 有兩種連接方式# 方式 1playwright/test 通過環(huán)境變量連接 PW_TEST_CONNECT_WS_ENDPOINTws://127.0.0.1:3000/ npx playwright test// 方式 2BrowserType.connect API適用于其他應(yīng)用 const browser await playwright[chromium].connect(ws://127.0.0.1:3000/);環(huán)境變量機(jī)制的源碼依據(jù)playwright/test的入口 packages/playwright/src/index.ts 中讀取process.env.PW_TEST_CONNECT_WS_ENDPOINT并將測(cè)試重定向到遠(yuǎn)程服務(wù)器。其余語言通過connect方法連接from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.connect(ws://127.0.0.1:3000/)using Microsoft.Playwright; using var playwright await Playwright.CreateAsync(); await using var browser await playwright.Chromium.ConnectAsync(ws://127.0.0.1:3000/);package org.example; import com.microsoft.playwright.*; public class App { public static void main(String[] args) { try (Playwright playwright Playwright.create()) { Browser browser playwright.chromium().connect(ws://127.0.0.1:3000/); } } }容器訪問宿主機(jī)本地服務(wù)器如果測(cè)試要訪問運(yùn)行在宿主機(jī)上的被測(cè)服務(wù)如本地起的 Web Server容器內(nèi)的localhost指向容器自身而非宿主機(jī)。解決方法是加--add-hosthostmachine:host-gatewaydocker run --add-hosthostmachine:host-gateway -p 3000:3000 --rm --init -it \ --workdir /home/pwuser --user pwuser \ mcr.microsoft.com/playwright:vVERSION-noble \ /bin/sh -c npx -y playwrightVERSION run-server --port 3000 --host 0.0.0.0之后測(cè)試代碼中把目標(biāo)地址從localhost改為hostmachine。文檔最后再次提醒遠(yuǎn)端執(zhí)行時(shí)測(cè)試端與容器內(nèi)的 Playwright 版本必須一致。用 noVNC 可視調(diào)試Docker / GitHub Codespaces官方鏡像內(nèi)置 noVNC 查看器可以讓你在容器里“看見”瀏覽器用于錄制測(cè)試、拾取選擇器和運(yùn)行 codegen。在.devcontainer/devcontainer.json中啟用desktop-litefeature 并指定 web 端口即可{ image: mcr.microsoft.com/playwright:v1.57.0, forwardPorts: [6080], features: { desktop-lite: { webPort: 6080 } } }配置后在瀏覽器新標(biāo)簽頁打開 6080 端口即可訪問 noVNC web viewer直接在容器內(nèi)完成測(cè)試錄制與選擇器拾取。其他實(shí)用技巧.NET 用戶使用其他版本 SDK鏡像內(nèi)預(yù)裝了某一版 .NET SDK如需其他版本可在容器內(nèi)用官方 dotnet-install 腳本安裝curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --install-dir /usr/share/dotnet --channel 9.0自建鏡像如果不想依賴官方鏡像只需在基礎(chǔ)鏡像里裝好“語言運(yùn)行時(shí) 瀏覽器 系統(tǒng)依賴”。文檔給出的最小 DockerfileJavaScriptNodeFROM node:20-bookworm RUN npx -y playwrightVERSION install --with-depsPythonFROM python:3.12-bookworm RUN pip install playwrightVERSION \ playwright install --with-depsinstall --with-deps會(huì)同時(shí)安裝瀏覽器與系統(tǒng)依賴。與官方鏡像不同自建鏡像的瀏覽器默認(rèn)裝在當(dāng)前用戶的~/.cache/ms-playwright而非/ms-playwright因此不需要mark-docker-image這類標(biāo)記機(jī)制。小結(jié)場(chǎng)景關(guān)鍵配置可信站點(diǎn) E2Edocker run -it --rm --ipchost ...root 即可抓取/爬蟲不可信站點(diǎn)--user pwuser --security-opt seccompseccomp_profile.json防止僵尸進(jìn)程 / Chromium 崩潰--init--ipchost必要時(shí)--cap-addSYS_ADMIN遠(yuǎn)程執(zhí)行容器內(nèi)run-server --port 3000外部connect(ws://127.0.0.1:3000/)或PW_TEST_CONNECT_WS_ENDPOINT容器訪問宿主服務(wù)--add-hosthostmachine:host-gateway代碼中改用hostmachine可視調(diào)試devcontainerdesktop-litefeature 轉(zhuǎn)發(fā) 6080 端口貫穿所有場(chǎng)景的三條紀(jì)律固定鏡像版本 tag、鏡像版本與項(xiàng)目版本一致、瀏覽器相關(guān)鏡像只基于 glibc 發(fā)行版。倉庫中 utils/docker/ 目錄下的 Dockerfile.noble、Dockerfile.jammy、Dockerfile.resolute、seccomp_profile.json 與 publish_docker.sh 是理解與驗(yàn)證上述機(jī)制的第一手材料?！久赓M(fèi)下載鏈接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/pl/playwright創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考