사전 설치된 런타임으로 VPS에 Playwright 배포하기

지속적인 Linux 환경이 필요한 경우 VPS 인프라에 Playwright를 배포하여 엔드 투 엔드 테스트, 예약된 브라우저 검사, 스크린샷 및 승인된 브라우저 워크플로를 수행하십시오. VoyraCloud Playwright 애플리케이션 이미지는 Node.js, Playwright, Chromium 및 필요한 Linux 브라우저 종속성을 제공합니다. SSH를 통해 연결하고, 자신의 프로젝트를 추가한 후 브라우저 제어 서비스를 공개 인터넷에 노출하지 않고 헤드리스 Chromium을 실행합니다.

TL;DR

VoyraCloud Playwright 이미지는 SSH 우선 런타임이며, 호스팅된 브라우저 대시보드나 공개 원격 브라우저 API가 아닙니다.
Node.js, Playwright, Chromium 및 Linux 브라우저 종속성이 Ubuntu에 미리 설치되어 있으므로 제공된 예제에서 시작한 후 자신의 프로젝트를 추가할 수 있습니다.
이미지는 Playwright 전용 공개 포트를 열지 않습니다. 보고서와 추적은 사용자가 의도적으로 전송하거나 제공하지 않는 한 VPS에 남아 있습니다.
프로젝트의 Playwright 패키지를 제공된 브라우저 바이너리와 동일한 버전으로 유지하십시오. 버전 불일치는 Playwright가 Chromium을 찾거나 실행하는 것을 방해할 수 있습니다.
브라우저 작업을 비루트 사용자로 실행하고 Chromium 샌드박스를 사용할 수 있도록 하십시오. 서드파티 자격 증명을 소스 파일이나 보고서에 직접 저장하지 마십시오.
시작 리소스 게이트는 사용 가능한 제품 계획을 따릅니다: Cloud VPS에서 4 vCPU, 4 GB RAM 및 80 GB 스토리지 또는 Residential IP VPS에서 2 vCPU, 4 GB RAM 및 60 GB 스토리지, 하나의 검증된 Chromium 세션을 위한 2 GB 공유 메모리 환경이 제공됩니다. 이는 고정 동시성 약속이 아닙니다.
프로젝트 파일과 저장된 아티팩트는 일반 VPS 재부팅 간에 지속됩니다. 메모리 내 브라우저 세션, 임시 컨텍스트 및 저장되지 않은 상태는 지속되지 않습니다.

Playwright 애플리케이션 이미지에는 무엇이 포함되어 있나요?

Playwright 애플리케이션 이미지는 승인된 자동화 작업을 시작하는 데 필요한 브라우저 런타임을 포함하며, 프로젝트 코드와 운영 관행은 사용자의 통제 하에 유지됩니다. 반복적인 운영 체제 준비를 제거하지만 관리되는 자동화 서비스를 제공하지는 않습니다.

이미지에서 제공됨	사용자 관리 또는 포함되지 않음
Ubuntu Linux 런타임	귀하의 애플리케이션 및 테스트 코드
호환 가능한 Node.js 환경	프로젝트 특정 npm 종속성
고정된 안정적인 Playwright 릴리스	자동 Playwright 업그레이드
일치하는 Chromium 브라우저 바이너리	Firefox 또는 WebKit, 설치 및 검증하지 않는 한
필요한 Linux 브라우저 종속성	서드파티 계정, 쿠키, API 키 또는 대상 자격 증명
SSH를 통한 헤드리스 브라우저 실행	공개 브라우저 제어 엔드포인트 또는 웹 대시보드
시작 게이트에 대해 검증된 2 GB 공유 메모리 환경	보장된 병렬 브라우저 용량
지속적인 VPS 스토리지	자동 오프 서버 백업
제공된 예제 및 상태 점검	VoyraCloud에 의한 사용자 스크립트 개발 또는 디버깅

리소스 세부정보는 VPS가 생성될 때 제공된 Playwright 버전을 보여줍니다. 해당 값은 원래 이미지 상태를 설명하며, 나중에 자신의 프로젝트를 업데이트하더라도 자동으로 변경되지 않습니다. 종속성 잠금 파일과 운영 노트를 후속 사용자 관리 변경의 진실의 원천으로 유지하십시오.

빠른 시작: VPS에 Playwright 배포하는 방법

가장 빠른 경로는 Playwright 이미지로 VPS를 생성하고, SSH를 통해 연결하고, 제공된 런타임을 확인한 후 단일 작업자로 하나의 Chromium 테스트를 실행하는 것입니다. 프로비저닝 후 열어야 할 브라우저 대시보드는 없습니다.

VoyraCloud Playwright 페이지를 열고 구매 흐름을 계속합니다.
적격한 Cloud VPS 또는 Residential IP VPS 계획을 선택한 다음 해당 제품에서 현재 제공되는 지역을 선택합니다.
이미지 섹션에서 Playwright가 선택되었는지 확인하고 리소스를 생성한 후 프로비저닝이 완료될 때까지 기다립니다.
리소스 세부정보를 열고 표시된 SSH 연결 정보를 사용합니다.
로그인 후 제공된 Node.js 및 Playwright 버전을 확인합니다:

node --version
npx playwright --version

종속성을 변경하기 전에 이미지와 함께 제공된 예제를 실행합니다. 예제는 Chromium을 시작하고, 테스트 페이지를 열고, 주장을 만들고, 스크린샷을 작성해야 합니다.
제공된 상태 점검이 성공한 후에만 자신의 프로젝트를 생성하거나 전송합니다.
하나의 Chromium 작업자로 시작하고 메모리 및 디스크 사용량을 검사한 후 실제 프로젝트를 측정한 후에만 작업 부하를 증가시킵니다.

이미지는 Playwright 전용 액세스 URL를 필요로 하지 않습니다. SSH가 관리 경로이며 기본적으로 영구 원격 제어 포트가 활성화되어 있지 않습니다.

VPS에서 Playwright 프로젝트를 어떻게 생성하나요?

정상적인 Node.js 프로젝트를 생성하고 Playwright 종속성을 제공된 런타임에서 표시된 정확한 버전으로 고정하십시오. Playwright 패키지와 브라우저 바이너리는 함께 이동하므로 관련이 없는 최신 패키지를 설치하면 건강한 이미지를 손상시킬 수 있습니다.

비루트 사용자 소유의 디렉토리에서 시작하십시오:

mkdir -p ~/playwright-project
cd ~/playwright-project
npm init -y

제공된 버전을 다시 확인하십시오:

npx playwright --version

프로젝트에 동일한 정확한 버전을 설치합니다. <same-version>을 이전 명령에서 출력된 숫자로 교체하십시오:

npm install --save-dev @playwright/test@<same-version>

homepage.spec.js를 생성합니다:

const { test, expect } = require('@playwright/test');

test('예제 페이지에 접근 가능', async ({ page }) => {
  await page.goto('https://example.com/', {
    waitUntil: 'domcontentloaded',
  });

  await expect(page).toHaveTitle(/예제 도메인/);
  await page.screenshot({
    path: 'artifacts/example-homepage.png',
    fullPage: true,
  });
});

playwright.config.js에 작은 구성을 생성합니다:

const { defineConfig, devices } = require('@playwright/test');

module.exports = defineConfig({
  testDir: '.',
  outputDir: 'test-results',
  workers: 1,
  reporter: [['list'], ['html', { open: 'never' }]],
  use: {
    trace: 'retain-on-failure',
    screenshot: 'only-on-failure',
    ...devices['Desktop Chrome'],
  },
  projects: [
    {
      name: 'chromium',
      use: { browserName: 'chromium' },
    },
  ],
});

스크린샷 디렉토리를 생성하고 테스트를 실행합니다:

mkdir -p artifacts
npx playwright test homepage.spec.js --project=chromium --workers=1

이 예제는 의도적으로 하나의 Chromium 작업자와 중립적인 공개 예제 페이지를 사용합니다. URL은 귀하가 소유하고 운영하거나 테스트할 수 있는 웹사이트로만 교체하십시오. 이미지는 서드파티 서비스를 자동화할 수 있는 권한을 부여하지 않습니다.

헤드리스 VPS에서 보고서와 추적은 어떻게 작동하나요?

Playwright 보고서와 추적은 귀하의 프로젝트에 의해 생성된 파일이므로 VPS에 저장하고 영구 공개 서비스를 열지 않고도 검토할 수 있습니다. 이는 테스트가 서버 환경에서만 실패할 때 특히 유용합니다.

예제 구성은 다음을 기록합니다:

list 리포터의 터미널 결과.
playwright-report/ 아래의 HTML 보고서.
test-results/ 아래의 테스트 첨부 파일 및 실패 출력.
trace가 retain-on-failure로 설정되어 있기 때문에 실패한 테스트에 대한 추적.
구성된 아티팩트 위치 아래의 스크린샷.

HTML 보고서를 안전하게 보려면 루프백 인터페이스에서 임시 서버를 시작하십시오:

npx playwright show-report --host 127.0.0.1 --port 9323

자신의 컴퓨터에서 리소스 세부정보의 연결 값을 사용하여 SSH 터널을 생성하십시오:

ssh -L 9323:127.0.0.1:9323 <ssh-user>@<server-ip>

그런 다음 로컬 컴퓨터에서 http://127.0.0.1:9323를 열어보십시오. 작업이 끝나면 보고서 프로세스를 중지하십시오. 보고서 뷰어를 0.0.0.0에 바인딩하거나 인터넷에 직접 노출하지 마십시오. 보고서에는 페이지 텍스트, URL, 스크린샷, 헤더, 오류 메시지 및 기타 민감한 테스트 증거가 포함될 수 있습니다.

저장된 추적을 보려면 Playwright의 추적 뷰어를 사용하십시오:

npx playwright show-trace test-results/<trace-file>.zip

뷰어가 로컬 HTTP 프로세스를 시작하면 동일한 루프백 및 SSH 터널 모델을 사용하십시오. 신뢰할 수 있는 워크스테이션으로 추적을 전송하고 공식 도구로 검사할 수도 있습니다. 추적 아카이브는 DOM 스냅샷, 네트워크 정보 및 스크린샷을 포함할 수 있으므로 잠재적으로 민감한 것으로 취급하십시오.

왜 Playwright와 Chromium 버전이 일치해야 하나요?

Playwright는 자체 릴리스를 위해 빌드된 브라우저 바이너리를 기대하므로 패키지와 제공된 Chromium 수정 버전은 일치해야 합니다. 공식 Playwright 문서는 정확한 버전을 고정할 것을 권장하며, 불일치하는 환경은 브라우저 실행 파일을 찾지 못할 수 있다고 경고합니다.

변경 사항	안전한 접근법	피해야 할 위험
새 프로젝트에 Playwright 추가	제공된 정확한 버전 설치	관련 없는 최신 버전 설치
Playwright 패키지 업데이트	동일한 유지 관리 창에서 브라우저 바이너리 업데이트	npm 종속성만 업데이트
Node.js 변경	대상 Playwright 릴리스가 이를 지원하는지 확인	테스트 없이 Node.js 업그레이드
Firefox 또는 WebKit 추가	일치하는 브라우저 및 종속성을 설치하고 검증	모든 브라우저가 미리 설치되어 있다고 가정
잠금 파일 재구성	해결된 Playwright 버전 검토	광범위한 semver 범위를 방치
롤백	패키지 잠금, 브라우저 바이너리 및 프로젝트를 함께 복원	하나의 레이어만 롤백

업데이트하기 전에 작동 중인 버전을 기록하십시오:

node --version
npx playwright --version
npm ls @playwright/test

그런 다음 프로젝트와 잠금 파일을 백업하십시오. 공식 Playwright 업데이트 절차를 따르십시오. 이 절차는 패키지와 브라우저 종속성을 모두 업데이트합니다. 변경 후 제공된 상태 점검 패턴과 자신의 스모크 테스트를 실행하십시오. VoyraCloud는 기존 Playwright 환경을 자동으로 업그레이드하거나 사용자 관리 조합에 대한 호환성을 보장하지 않습니다.

Playwright는 어떻게 안전하게 실행해야 하나요?

Playwright는 Chromium 샌드박스를 사용할 수 있는 전용 비루트 사용자로 실행해야 하며, 최소한의 자격 증명과 불필요한 공개 리스너가 없어야 합니다. 브라우저는 열리는 페이지에서 복잡한 콘텐츠를 처리하므로, 작업 부하가 요구하는 것보다 더 많은 호스트 권한을 받아서는 안 됩니다.

다음 운영 규칙을 사용하십시오:

비루트 계정에서 프로젝트 명령을 실행하십시오. sudo npx playwright test를 사용하지 마십시오.
루트 실행이 샌드박스를 비활성화하는 대신 Chromium 샌드박싱을 활성화 상태로 유지하십시오.
비밀을 제한된 환경 파일이나 비밀 관리자에 저장하고, 테스트 소스, 스크린샷, 보고서 또는 셸 기록에는 저장하지 마십시오.
대상 도메인을 귀하가 소유하거나 테스트할 수 있는 시스템으로 제한하십시오.
CAPTCHA, 접근 제어 문제, 계정 경고, 결제 게이트 또는 반복된 인증 실패에서 중지하십시오.
강력한 인증 및 현재 운영 체제 보안 업데이트로 SSH 액세스를 보호하십시오.
HTML 보고서, 추적 뷰어, 디버깅 엔드포인트 또는 사용자 정의 브라우저 서버를 공개 인터넷에 노출하지 마십시오.
생성된 아티팩트를 공유하기 전에 검토하십시오. 페이지 콘텐츠와 테스트 데이터가 스크린샷 및 추적에 나타날 수 있습니다.

공식 Playwright Docker 가이드는 동일한 권한 구분을 제공합니다: 신뢰할 수 있는 엔드 투 엔드 테스트 코드에 대해 루트가 허용될 수 있지만, 브라우저 콘텐츠가 완전히 신뢰되지 않을 때는 별도의 사용자 및 샌드박스 제어를 권장합니다. VoyraCloud 이미지는 SSH 우선 네이티브 런타임을 사용합니다. 나중에 프로젝트를 컨테이너에 배치하는 경우 해당 컨테이너의 사용자, 샌드박스, 초기화 프로세스 및 공유 메모리를 직접 구성해야 합니다.

2 GB 공유 메모리 요구 사항은 무엇을 의미하나요?

2 GB 공유 메모리 요구 사항은 Chromium에 검증된 시작 작업 부하를 위한 공간을 제공하지만, 특정한 병렬 페이지나 브라우저 수를 보장하지는 않습니다. Chromium은 렌더러 프로세스에 공유 메모리를 사용하며, 공간이 부족하면 무작위 테스트 실패처럼 보이는 충돌을 일으킬 수 있습니다.

사용 가능한 공유 메모리 파일 시스템을 확인하십시오:

df -h /dev/shm

VoyraCloud 이미지 수락 게이트는 2 GB 공유 메모리 환경에서 시작 구성에 대해 하나의 헤드리스 Chromium 세션을 검증합니다. 실제 수요는 페이지 복잡성, 비디오 및 추적 캡처, 브라우저 컨텍스트, 확장, 다운로드, 테스트 데이터 및 동시에 작업하는 작업자의 수에 따라 달라집니다.

나중에 자신의 Docker 배포를 생성하는 경우, 호스트 설정이 새 컨테이너가 동일한 허용량을 받도록 자동으로 보장하지 않습니다. Playwright에 대한 공식 Chromium 가이드를 기반으로 컨테이너를 구성한 후 독립적으로 테스트하십시오.

Playwright에는 얼마나 많은 VPS 용량이 필요합니까?

Playwright 용량은 브라우저 수, 페이지 복잡성, 아티팩트 및 동시성에 따라 달라지므로 최소 용량은 좁은 작업 부하에 대한 검증된 진입 게이트에 불과합니다. 초기 구매 게이트는 Cloud VPS에서 4 vCPU, 4 GB RAM 및 80 GB 스토리지 또는 Residential IP VPS에서 2 vCPU, 4 GB RAM 및 60 GB 스토리지로, 해당 계획이 지역 수락 테스트를 통과한 후 제공됩니다.

작업 부하	용량 안내
하나의 예약된 Chromium 스모크 테스트	진입 게이트에 적합한 시작 사례
작은 직렬 엔드 투 엔드 스위트	하나의 작업자로 시작하고 측정
스크린샷이 많은 테스트	디스크 성장 및 메모리 사용량 관찰
비디오 및 추적 보존	추가 스토리지 및 정리 계획
여러 병렬 작업자	작업 부하 특정 테스트 및 더 많은 리소스 필요
여러 브라우저 또는 큰 페이지	작업 부하 특정 테스트 필요
장기 실행 자동화 서비스	감독, 로깅, 모니터링 및 측정된 용량 추가

Playwright Test는 파일을 병렬로 실행할 수 있지만, 기본 작업자 수는 용량 약속이 아닙니다. --workers=1로 시작하고 CPU, 메모리, 공유 메모리, 테스트 기간 및 디스크 사용량을 관찰한 후 점진적으로 증가시키십시오. 병렬 프로젝트, 비디오 또는 대규모 추적 보존을 활성화하기 전에 더 큰 계획이 필요할 수 있습니다.

재부팅 후 무엇이 지속되나요?

지속적인 VPS 스토리지에 작성된 파일은 정상 재부팅 후에도 남아 있지만, 메모리 내에서 실행 중인 브라우저 상태는 남아 있지 않습니다. 서버를 재시작하기 전에 중요한 모든 아티팩트 또는 상태 파일을 저장하십시오.

지속적인 파일에는 다음이 포함될 수 있습니다:

귀하의 Node.js 프로젝트 및 잠금 파일.
Playwright 구성 및 테스트 소스.
스크린샷, 비디오, HTML 보고서 및 추적 아카이브.
의도적으로 저장된 저장 상태 파일.
귀하의 로그 및 프로세스 구성.

재부팅이 다음을 보존할 것이라고 기대하지 마십시오:

실행 중인 Chromium 프로세스.
열린 페이지 또는 메모리 내 브라우저 컨텍스트.
저장되지 않은 쿠키, 로컬 스토리지 또는 JavaScript 상태.
프로젝트가 삭제하거나 지속적인 경로 외부에 작성하는 임시 파일.
프로세스 감독 및 재시작 처리가 없는 상태에서 실행 중인 작업.

지속성은 백업이 아닙니다. 보고서, 프로젝트 또는 상태 파일이 비즈니스에 중요하다면 적절한 암호화 및 보존과 함께 오프 서버 목적지로 복사하십시오. 인증 상태를 백업하는 것은 필요하고 보호되며 명확한 회전 정책의 적용을 받지 않는 한 피하십시오.

Playwright에 대한 Cloud VPS 또는 Residential IP VPS?

Cloud VPS는 일반 Playwright 개발, QA 및 승인된 자동화를 위한 주요 선택이며, Residential IP VPS는 안정적인 주거 네트워크 출처가 합법적인 테스트 요구 사항의 일부일 때만 관련이 있습니다.

Cloud VPS는 다음과 같은 경우에 사용하십시오:

귀하가 소유한 애플리케이션에 대한 엔드 투 엔드 테스트.
예약된 생산 스모크 검사.
내부 브라우저 워크플로.
스크린샷 생성 및 회귀 테스트.
데이터 센터 네트워크 신원이 허용되는 자동화.

Residential IP VPS는 권한이 있는 지역 QA 또는 모니터링에 관련이 있을 수 있으며, 동일한 안정적인 주거 네트워크 신원이 실행 간에 유지되어야 합니다. 이는 자동화 방지 제어를 우회하거나 CAPTCHA를 해결하거나 계정을 보호하거나 모든 대상을 도달할 수 있는 약속이 아닙니다. 네트워크 관련 실패에 대한 더 깊은 논의는 Playwright가 VPS에서 차단되는 이유를 읽어보십시오.

사전 제작 체크리스트

Playwright VPS는 런타임, 보안, 리소스 동작, 아티팩트 및 복구 경로가 귀하의 프로젝트로 테스트된 후에만 정기적으로 사용할 준비가 됩니다.

node --version 및 npx playwright --version을 확인하십시오.
환경을 수정하지 않고 제공된 Chromium 상태 점검을 실행하십시오.
프로젝트 잠금 파일에서 동일한 Playwright 버전을 고정하십시오.
비루트 사용자로 실행하고 Chromium이 샌드박스와 함께 시작되는지 확인하십시오.
하나의 Chromium 작업자로 시작하고 2 GB 공유 메모리 환경을 확인하십시오.
스크린샷, HTML 보고서 및 실패 추적을 저장하십시오.
루프백 리스너와 SSH 터널을 통해 보고서를 보십시오.
VPS를 재시작하고 스모크 테스트를 다시 실행하십시오.
필요한 프로젝트 파일과 아티팩트가 지속되었는지 확인하십시오.
비즈니스에 중요한 코드와 데이터에 대한 오프 서버 백업을 구성하십시오.
자격 증명을 보호하고 공유하기 전에 보고서에서 비밀을 제거하십시오.
허용된 대상, 비율 제한 및 중지 조건을 문서화하십시오.

FAQ

Playwright 이미지에 웹 대시보드가 포함되어 있나요?

아니요, Playwright 이미지에는 웹 대시보드나 공개 브라우저 제어 엔드포인트가 포함되어 있지 않습니다. SSH를 통해 연결하고 자신의 Node.js 또는 Playwright Test 프로젝트를 실행합니다. 임시 보고서 뷰어는 127.0.0.1에 바인딩되어야 하며 SSH 터널을 통해 접근해야 합니다.

어떤 브라우저가 포함되어 있나요?

이미지에는 제공된 안정적인 Playwright 릴리스에 맞는 Chromium이 포함되어 있습니다. Firefox 및 WebKit은 명시된 기본 제공의 일부가 아닙니다. 추가 일치하는 브라우저를 직접 설치할 수 있지만, 해당 종속성과 리소스 사용을 검증해야 합니다.

npm으로 Playwright를 업데이트할 수 있나요?

예, 하지만 Playwright 패키지와 브라우저 바이너리를 함께 업데이트한 후 환경을 다시 테스트하십시오. 먼저 작동 중인 버전과 잠금 파일을 저장하십시오. 기존 VoyraCloud 리소스는 생성 후 자동으로 업그레이드되지 않습니다.

이 VPS는 몇 개의 Playwright 작업자를 실행할 수 있나요?

고정된 작업자 수나 동시성 보장은 없습니다. 시작 게이트는 Cloud VPS에서 4 vCPU, 4 GB RAM 및 80 GB 스토리지 또는 Residential IP VPS에서 2 vCPU, 4 GB RAM 및 60 GB 스토리지로 2 GB 공유 메모리에서 하나의 Chromium 세션을 검증합니다. 병렬 용량은 페이지, 아티팩트, 코드 및 런타임 동작에 따라 달라집니다.

재부팅 후 보고서와 추적이 사용 가능한가요?

저장된 보고서 및 추적 파일은 VPS 스토리지에 작성되면 지속되지만, 활성 세션 및 저장되지 않은 상태는 지속되지 않습니다. 지속성은 또한 오프 서버 백업을 대체하지 않습니다.

Playwright를 루트로 실행해야 하나요?

아니요, 일반 브라우저 작업에 비루트 사용자를 사용하고 Chromium 샌드박싱을 활성화 상태로 유지하십시오. 루트 실행은 브라우저 또는 테스트 코드의 손상 영향을 증가시키고 일반 구성에서 Chromium 샌드박스를 비활성화할 수 있습니다.

이미지에 프록시, 쿠키 또는 웹사이트 계정이 포함되어 있나요?

아니요, 이미지에는 프록시 서비스, 쿠키, API 키, 웹사이트 계정 또는 서드파티 자격 증명이 포함되어 있지 않습니다. 비밀, 권한, 대상 정책 및 적용 법률에 대한 책임은 귀하에게 있습니다.

Playwright가 CAPTCHA 또는 자동화 방지 제어를 우회할 수 있나요?

그러한 기능이나 결과는 포함되어 있지 않으며 약속되지도 않습니다. CAPTCHA, 접근 제한 또는 반복된 인증 실패는 검토를 위해 워크플로를 중지해야 합니다. 가능한 경우 공식 API 또는 서면 승인을 사용하십시오.

결론

VPS에 Playwright를 신뢰성 있게 배포하려면 미리 설치된 런타임으로 시작하고, 프로젝트를 제공된 Playwright 버전에 고정하며, 하나의 샌드박스화된 Chromium 작업자를 실행하고, 의도적으로 저장한 파일만 보존하십시오. VoyraCloud 이미지는 환경 설정을 단축하면서 SSH 액세스, 프로젝트 코드, 자격 증명, 업데이트, 용량 계획 및 백업을 귀하의 통제 하에 유지합니다.

VoyraCloud Playwright 애플리케이션 이미지를 사용하여 기본적으로 Playwright 전용 공개 포트가 활성화되지 않은 SSH 우선 브라우저 자동화 런타임을 이용하십시오.