Selenoid — лёгкий Selenium hub на Go, который поднимает браузеры в Docker-контейнерах. В этом форке добавлен native Playwright: клиент подключается по WebSocket, hub стартует Playwright-образ и проксирует соединение.
Тест (Selenium) ──► /wd/hub ──► qaguru/webdriver-chrome (Chrome)
Тест (Playwright) ──► /playwright/... ──► qaguru/playwright-* (browser-image)
Экосистема
flowchart TB
cm["cm<br/>установка на сервер"]
hub["selenoid hub"]
ui["selenoid-ui"]
bi["browser-image<br/>browser containers"]
wd["qaguru/webdriver-chrome<br/>Selenium Chrome"]
cm -->|"бинарники + browsers.json"| hub
ui <--> hub
hub --> bi
hub --> wd
Опционально: -access-key=… → обязательный query ?accessKey=. Несколько ключей задаются через запятую (на демо: user1:1234,qa_engineer:aAb_-4gs53FD). Local без flag — без ключа.
Совместим с DOCKER_API_VERSION=1.55 (moby client MaxAPIVersion)
Docker API
1.55
Версия API, с которой hub ходит к daemon (DOCKER_API_VERSION)
Docker SDK
moby
github.com/moby/moby/client + github.com/moby/moby/api (не github.com/docker/docker)
Проверка:
./scripts/check-toolchain.sh
docker version | grep -E 'Version:|API'
# Engine: 29.x, API version: 1.55
go version # go1.27.x
Hub и cm фиксируют DOCKER_API_VERSION=1.55 (скрипт ./scripts/start-selenoid.sh, образ, CI). На Linux/CI: Engine 29.x (./scripts/check-toolchain.sh). Hub без env пина может снизить API через negotiation (main.go).
Сборка без локального Go использует образ golang:1.27 (см. ./scripts/build-selenoid.sh).
Сборка и запуск
./scripts/build-selenoid.sh
docker pull qaguru/webdriver-chrome:149 qaguru/webdriver-chrome:149-min qaguru/video-recorder:latest
docker pull qaguru/playwright-chromium:1.61.1 # или сборка в browser-image
./scripts/start-selenoid.sh
Chrome WebDriver sessions can container-reuse a pre-started slot when -warm-pool-url / -pool-url / SELENOID_WARM_POOL_URL points at selenoid-pooland the slot exposes a loopback webdriverUrl (127.0.0.1). Otherwise the hub starts a cold Docker container. Playwright / video / VNC / HAR stay cold. Hot is session-reuse (existing UUID / WS, bypasses hub) — not this path. Not an Allure attachment.
Playwright-образы: порт 3000, protocol: "playwright", shmSize: 2GB. Версия npm-клиента @playwright/test должна совпадать с playwrightVersion в конфиге.
Подготовка образов
# WebDriver Chrome (qaguru) — default 149.0; 148.* optional regression
docker pull qaguru/webdriver-chrome:149 qaguru/webdriver-chrome:149-min
# Playwright — pull или сборка в browser-image
docker pull qaguru/playwright-chromium:1.61.1
# ./playwright/scripts/build.sh all 1.61.1 (в репозитории browser-image)
# Видеозапись сессий
docker pull qaguru/video-recorder:latest
Записи с enableVideo=true сохраняются в каталог video/ (или http://127.0.0.1:4444/video/).
Сессии с enableHAR=true (WebDriver Chrome/Edge, при -har-output-dir) — hub пишет сетевой архив через CDP в каталог har/, скачивается рядом с video/logs: GET http://127.0.0.1:4444/har/<session-id>.har (list ?json, DELETE — как у video). Это hub-артефакт для ручных сессий; в автотестах — один writer на сессию (client CDP→Allure или Playwright recordHar), не дублировать. Подробнее — docs/har.adoc.
Selenoid is a powerful implementation of Selenium Hub using Docker or standalone web driver binaries to start and launch browsers. Documentation has moved to: https://aerokube.com/selenoid/latest.