SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

VPS에서 헤드리스 브라우저 실행 시 오류 해결 방법

VPS 환경에서 Playwright 기반 Chromium을 구동할 때 발생하는 /dev/shm 부족, 샌드박스 설정, 폰트 누락 문제를 해결합니다. 에이전트 운영 시 필수적인 프로세스 관리와 리소스 제한 설정 가이드를 확인하여 안정적인 크롤링 환경을 구축하십시오.

운영 중인 환경

VPS에서 구동하는 헤드리스 브라우저는 창이 없는 Chromium이며, 사람이 아닌 코드가 이를 제어합니다. 서버 환경에서 이는 에이전트가 로컬 소켓을 통해 통신하는 장기 실행 프로세스 트리입니다. 설치는 명령어 한 줄로 완료되지만, 진짜 작업은 그 이후부터 시작됩니다. 브라우저가 시스템 자원을 점유하는 한도를 설정하고, 제어용 엔드포인트가 외부 인터넷에 노출되지 않도록 차단해야 합니다.

이 가이드는 도구 선택이 완료되어 운영 단계에 진입한 사용자를 가정합니다. 아직 크롤러나 추출기 도구를 비교 중이라면 자체 호스팅 가능한 Firecrawl 대안을 먼저 확인한 뒤 돌아오십시오. 아래의 모든 내용은 Playwright의 Chromium을 기준으로 합니다. Playwright는 자체 브라우저 빌드와 의존성 설치 도구를 포함하고 있어, 베어메탈 Ubuntu VPS와 컨테이너 내부에서 동일한 명령어가 작동합니다. 이 가이드의 명령어는 Playwright 1.62 버전을 기준으로 합니다.

의존성 추측 없이 Chromium 설치하기

npm i -D playwright@1.62.0
npx playwright install --with-deps chromium

--with-deps은 Chromium에 필요한 공유 라이브러리와 폰트를 위해 apt을 실행하며, 필요한 시점에 root 권한을 요청합니다. 브라우저 빌드 자체는 명령을 실행한 사용자의 ~/.cache/ms-playwright 디렉터리로 다운로드됩니다. 서버 환경에서는 서비스 사용자가 일반적으로 로그인한 사용자와 다르기 때문에 이 점이 중요합니다. 관리자 권한으로 sudo npx playwright install-deps chromium을 사용하여 시스템 패키지를 한 번 설치한 다음, 설치 명령과 서비스 유닛 모두에 PLAYWRIGHT_BROWSERS_PATH=/opt/pw-browsers를 설정하여 하나의 복사본을 공유하도록 하십시오. 브라우저를 찾을 수 없는 서비스는 실행 시 검색 경로를 명시한 메시지와 함께 실패합니다.

Playwright 버전을 고정하십시오. 각 릴리스는 특정 브라우저 빌드와 연결되어 있으므로, 버전을 고정하지 않은 npm update는 실행 중인 서비스의 브라우저를 예고 없이 변경할 수 있습니다. 2026년 11월 16일 기준으로 최신 릴리스는 1.65.1입니다. 버전을 변경하기 전에 릴리스 노트를 확인하십시오. ARM64 서버의 경우, 1.63 버전에서 브라우저 폴더 이름이 변경되었음을 유의하십시오. 이는 이후에 다룰 AppArmor 프로필 설정에 영향을 줍니다.

Chromium 빌드는 두 가지가 존재하며 서로 다른 프로그램입니다. 헤드리스 모드에서 Playwright는 기본적으로 headless shell을 사용하는데, 이는 헤드리스 모드로만 실행되는 더 작은 바이너리입니다. 일반적인 설치 시 전체 브라우저 옆에 이 셸이 다운로드되며, npx playwright install --with-deps --only-shell은 셸만 단독으로 설치합니다. 전체 브라우저는 chromium 채널을 통해 얻을 수 있으며, Playwright 브라우저 문서에서는 이를 "실제 Chrome 브라우저이며, 따라서 더 정확하고 신뢰할 수 있으며 더 많은 기능을 제공한다"고 설명합니다. 대량의 데이터를 가져올 때는 셸을 사용하십시오. 사이트가 다르게 동작하여 원인을 파악해야 할 때는 전체 브라우저를 사용하십시오.

컨테이너에서 헤드리스 브라우저가 충돌하는 이유

Docker는 각 컨테이너에 64 MB의 /dev/shm을 할당합니다. Docker 문서에는 "크기를 생략하면 시스템은 64m을 사용한다"라고 명시되어 있습니다. Chromium은 렌더링된 콘텐츠를 프로세스 간에 공유 메모리 영역을 통해 전달하므로, 무거운 페이지 하나가 이 영역을 가득 채울 수 있습니다. 그러면 렌더러가 종료되고 클라이언트는 로컬 노트북에서는 잘 작동하던 페이지에서 대상이 충돌했다는 오류를 보고합니다. 설정을 변경하기 전에 컨테이너 내부에서 크기를 먼저 확인하십시오.

df -h /dev/shm

두 가지 확실한 해결책이 있으며, 이들은 병행하는 것이 아니라 선택하는 대안입니다. --ipc=host는 컨테이너를 호스트 IPC 네임스페이스에 배치하여 호스트의 /dev/shm을 사용하게 하며, 이는 일반적으로 RAM의 절반 크기입니다. Playwright의 Docker 가이드는 이 설정을 권장하는데, 그렇지 않으면 "Chromium이 메모리 부족으로 충돌할 수 있기" 때문입니다. 이 방식의 대가는 컨테이너와 호스트 간의 IPC 격리가 해제된다는 점입니다. --shm-size=1g은 프라이빗 네임스페이스를 유지하면서 마운트 크기만 늘립니다.

docker run --rm -it --init --ipc=host --user pwuser mcr.microsoft.com/playwright:v1.62.0-noble /bin/bash

--disable-dev-shm-usage 플래그는 대부분의 검색 결과에서 찾을 수 있는 답변이지만, 이는 다른 동작을 수행합니다. 즉, 해당 파일들을 /dev/shm에서 임시 디렉터리로 이동시킵니다. 만약 /tmp가 디스크에 위치한다면, 충돌을 피하는 대신 렌더링 속도 저하와 디스크 쓰기 부하를 얻게 됩니다. 만약 /tmp가 tmpfs라면 데이터는 다시 RAM에 저장되며, 커널 문서가 기본적으로 물리 RAM의 절반으로 설정한 tmpfs 크기 제한까지만 사용할 수 있고, tmpfs 페이지는 스왑으로 밀려날 수 있습니다. 이것이 브라우저가 소형 VPS의 자원을 고갈시키는 한 가지 방법입니다. Playwright 1.62는 기본적으로 --disable-dev-shm-usage을 전달합니다. 직접 크기를 지정한 /dev/shm을 사용하려면 실행 옵션에서 ignoreDefaultArgs: ['--disable-dev-shm-usage']을 사용하여 해당 인수를 제거하십시오.

--no-sandbox 옵션의 실제 비용

Chromium은 Linux 사용자 네임스페이스를 기반으로 구축된 샌드박스 내에서 모든 렌더러를 격리합니다. 이 샌드박스는 악의적인 페이지와 서버 사이의 경계 역할을 합니다. Playwright는 기본적으로 Chromium 샌드박싱을 비활성화하므로, 실행 옵션에 chromiumSandbox: true를 추가하여 활성화해야 합니다. 샌드박스를 활성화했으나 시작할 수 없는 경우 Chromium은 실행을 거부하며, 로그에 다음과 같은 줄이 남습니다.

Failed to move to new namespace: PID namespaces supported, Network namespace supported, but failed: errno = Operation not permitted

일반적인 해결책은 --no-sandbox을 사용하는 것입니다. Chromium 공식 보안 페이지에서는 이 방식의 대가를 명확히 경고합니다. "보안을 크게 저하시키고 Chromium이 제대로 작동하지 않을 수 있으므로 권장하지 않습니다." 링크를 따라가는 에이전트는 정의상 개방된 웹을 탐색하는 것이며, 바로 그 지점에서 보안 저하의 위험이 시험대에 오릅니다. 근본적인 원인을 찾으십시오.

root 권한으로 실행 중인지, 사용자 네임스페이스가 차단되었는지 확인해야 합니다. root로 실행할 때는 Chromium 샌드박스를 사용할 수 없으므로, Playwright 이미지에는 pwuser이라는 일반 사용자 계정이 포함되어 있습니다. Docker 환경에서 Playwright는 샌드박스 브라우징을 위해 clone, setns, unshare를 허용하는 seccomp 프로필을 사용할 것을 권장합니다. Ubuntu 24.04 이상에서는 AppArmor가 비특권 사용자 네임스페이스를 제한하며, 기본 프로필에 포함되지 않은 경로의 Chromium 바이너리는 실행이 거부됩니다. ~/.cache/ms-playwright 아래에 다운로드된 Playwright는 정확히 이러한 경로에 해당합니다. 다음 두 가지를 확인하십시오.

id -u
sysctl kernel.apparmor_restrict_unprivileged_userns
sudo dmesg | grep -i userns_create

sysctl의 1 값과 apparmor="DENIED" operation="userns_create"이 포함된 커널 로그 라인은 두 번째 원인을 확인해 줍니다. 해당 바이너리 하나만 /etc/apparmor.d/pw-chromium에서 허용하십시오. 이렇게 하면 시스템의 다른 부분에 대한 제한은 그대로 유지됩니다.

abi <abi/4.0>,
include <tunables/global>

profile pw-chromium /{home/*/.cache/ms-playwright,opt/pw-browsers}/*/chrome-*/{chrome,headless_shell,chrome-headless-shell} flags=(unconfined) {
  userns,
}

sudo apparmor_parser -r /etc/apparmor.d/pw-chromium를 사용하여 설정을 로드하십시오. x86-64 환경에서 Playwright는 전체 브라우저를 chrome-linux64/chrome에, 셸을 chrome-headless-shell-linux64/chrome-headless-shell에 배치합니다. ARM64 환경의 Playwright 1.62 버전은 이를 chromium-<revision>/chrome-linux/chrome와 chromium_headless_shell-<revision>/chrome-linux/headless_shell이라는 별도의 디렉터리에 설치했습니다. 1.63 버전부터 ARM64는 chrome-linux-arm64/chrome와 chrome-headless-shell-linux-arm64/chrome-headless-shell를 사용하여 x86-64 패턴을 따릅니다. chrome-* 글로브(glob) 패턴은 이러한 모든 레이아웃을 포괄하며, /opt/pw-browsers 브랜치는 PLAYWRIGHT_BROWSERS_PATH로 생성된 공유 설치 환경을 다룹니다. 해당 경로에는 브라우저 리비전 정보가 포함되어 있어 Playwright를 업그레이드할 때마다 경로가 변경됩니다. 위의 글로브 패턴은 이러한 변경에도 유효합니다. 특정 경로를 직접 지정하여 작성한 프로필은 업데이트 후 아무런 경고 없이 매칭이 중단되며, 관련 없어 보이는 업데이트 이후 브라우저 실행이 다시 실패하게 됩니다.

스크린샷이 빈 화면이나 사각형으로만 나오는 이유

스크린샷이 비어 있거나 빈 사각형으로 가득 차 있다면, 이는 렌더링 버그보다는 폰트 문제일 가능성이 큽니다. install-deps는 기본적으로 작동하는 폰트인 fonts-liberation, fonts-freefont-ttf, fonts-noto-color-emoji, fonts-unifont, 일본어용 fonts-ipafont-gothic, 중국어용 fonts-wqy-zenhei, 태국어용 fonts-tlwg-loma-otf을 불러옵니다. 이 세트에는 Noto CJK가 포함되어 있지 않으므로, 한국어를 비롯한 여러 언어는 fontconfig가 찾을 수 있는 폰트로 대체(fallback)됩니다. 추측하지 말고 fontconfig에 직접 확인하십시오.

fc-match "sans-serif:lang=ko"
fc-match "sans-serif:lang=ar"
fc-list | wc -l

사용 중인 언어가 unifont로 확인되거나 실제 글리프가 없는 폰트로 대체된다면, fonts-noto-core 및 fonts-noto-cjk를 설치한 뒤 다시 확인하십시오. Fontconfig는 결과를 캐시하므로 폰트 설치 후 브라우저를 재시작해야 합니다. 폰트가 전혀 없는 최소화된 이미지의 경우 시작 시 Fontconfig error: Cannot load default config file 로그가 기록되며 모든 페이지가 비어 있는 상태로 렌더링됩니다.

로캘과 시간대는 폰트와 별개이며, 단순히 모양뿐만 아니라 페이지에 표시되는 내용 자체를 변경합니다. Playwright의 컨텍스트 로캘과 시간대는 기본적으로 시스템 설정을 따르므로, LANG이 설정되지 않았거나 시간대가 UTC라고 가정하지 말고 이미지의 설정을 확인하십시오. 한 브라우저가 여러 지역의 작업을 처리할 수 있도록, 머신 단위가 아닌 브라우저 컨텍스트 단위로 설정하십시오.

const context = await browser.newContext({
  locale: 'en-GB',
  timezoneId: 'Europe/Paris',
});

브라우저 프로세스 누수로 인해 시스템이 스왑을 사용하는 이유

"좀비"라는 이름은 서로 다른 두 가지 문제를 지칭합니다. 진정한 의미의 좀비 프로세스는 부모 프로세스가 wait()를 호출하지 않아 종료된 프로세스를 말합니다. 이는 PID 항목만 점유할 뿐 메모리를 소비하지 않습니다. 컨테이너에서 브라우저를 PID 1로 실행할 때 이러한 현상이 발생하는데, PID 1은 기본적으로 리퍼(reaper) 역할을 수행하지 않기 때문입니다. Docker의 --init 플래그는 "신호를 전달하고 프로세스를 수거하는" 작은 init 프로세스를 실행하여 이 문제를 정확히 해결합니다. Compose에서는 동일한 기능을 init: true로 설정할 수 있습니다.

실제로 시스템이 스왑을 사용하게 만드는 누수는 성격이 다릅니다. 이는 종료되지 않고 살아 있는 Chromium 프로세스들입니다. 이 문제는 작업이 newContext()와 close() 사이에서 예외를 발생시키거나, 제어 스크립트가 강제 종료되면서 브라우저 트리만 고아 프로세스로 남을 때 발생합니다. 가장 심각한 경우는 요청마다 새로운 브라우저를 실행하는 코드입니다. 다음 명령어로 개수를 확인하십시오.

pgrep -c -f 'headless_shell|chrome'
ps -eo pid,ppid,rss,etime,comm --sort=-rss | head -20

작업이 끝나면 프로세스 개수는 유휴 상태의 값으로 돌아와야 합니다. 만약 하루 동안 개수가 계속 증가한다면, 실행 플래그가 아닌 코드에서 해결책을 찾아야 합니다. finally 블록 내에서 컨텍스트를 닫고, SIGTERM 시점에 브라우저를 종료하며, 한 달 내내 실행하는 대신 일정 작업 횟수마다 브라우저를 재시작하십시오. systemd 환경에서는 서비스 중지나 재시작 시 해당 유닛의 cgroup에 속한 모든 프로세스가 종료되므로, sudo systemctl restart browser.service를 사용하면 확실하게 초기화할 수 있습니다. 터미널 멀티플렉서 내부에서 수동으로 실행한 브라우저는 이러한 보장이 없으므로, 세션이 종료되어도 고아 프로세스가 계속 살아남게 됩니다.

하나의 브라우저 컨텍스트에는 얼마만큼의 RAM이 필요한가

"하나의 브라우저"는 하나의 프로세스가 아니므로 질문을 정확하게 해야 합니다. Chromium은 브라우저 프로세스, GPU 프로세스, 유틸리티 프로세스, 그리고 사이트당 하나의 렌더러 프로세스를 실행하며, 사이트 격리(site isolation) 기능은 사이트 간 iframe에도 별도의 렌더러를 할당합니다. BrowserContext는 동일한 트리 내부의 별도 쿠키 저장소이자 스토리지 영역이므로, 두 번째 컨텍스트를 생성하는 비용은 저렴합니다. 반면 두 번째 페이지는 렌더러 프로세스를 새로 시작하므로 비용이 적지 않으며, 광고가 많은 페이지는 여러 개의 프로세스를 추가로 실행합니다.

따라서 측정해야 할 수치는 사용자의 워크로드 환경에서 전체 트리가 사용하는 최대 메모리(peak memory)입니다. 에이전트가 여는 페이지에 따라 결과가 달라지므로, 타인의 블로그에 적힌 수치는 의미가 없습니다. 실제 사용할 장비에서 방문할 사이트를 대상으로 직접 측정하십시오.

sudo systemd-run --unit=browser-probe -p MemoryMax=2G -p MemorySwapMax=0 -p WorkingDirectory=/srv/agent /usr/bin/node worker.js
systemctl status browser-probe

Ubuntu 24.04 환경에서 해당 출력의 Memory: 라인은 해당 유닛의 현재 사용량과 최대 사용량을 모두 보고합니다. 워커를 한 번에 한 페이지씩 실행하여 최대치를 기록한 다음, 두 페이지를 열어 두 번째 페이지가 실제로 소모하는 비용을 확인하십시오. 동시성 계산은 산술적으로 접근합니다. 전체 RAM에서 서버 운영에 필요한 용량을 빼고, 수백 MB의 여유 공간을 확보한 뒤, 측정된 워커당 최대 메모리 사용량으로 나눕니다. 하부 장비의 사양을 결정하려면 에이전트 VPS에 필요한 RAM과 CPU 용량을 참조하십시오.

해당 수치는 두 곳에서 강제해야 합니다. 코드 내에서는 고정된 워커 풀이나 세마포어를 사용하여, 에이전트 요청이 급증할 때 브라우저를 무분별하게 실행하지 않고 대기열에 쌓이도록 합니다. 운영체제 수준에서는 cgroup 제한을 사용하여, 대기열의 버그가 시스템 전체를 마비시키지 않도록 방지하십시오.

[Service]
MemoryMax=2G
MemorySwapMax=0
TasksMax=512
Restart=always

MemorySwapMax=0는 보이는 것보다 훨씬 중요합니다. 이 설정이 없으면 cgroup은 제한치에 도달할 때 페이지를 스왑으로 밀어낼 수 있습니다. 이 경우 서버는 멈추지 않지만 모든 요청이 느려지는데, 이는 깔끔한 실패보다 진단하기가 더 어렵습니다. 스왑은 단지 종료를 지연시킬 뿐입니다. systemd 문서에 따르면 사용량이 "제한치 내에서 제어될 수 없는 경우, 유닛 내부에서 OOM(Out-Of-Memory) 킬러가 호출됩니다". 스왑을 0으로 제한하면 유닛은 스왑을 사용할 수 없으며, MemoryMax에 도달하면 메모리 회수가 불가능할 경우 OOM 킬러가 작동하기 전에 회수(reclaim)가 트리거됩니다. Restart=always은 메인 프로세스가 종료될 때 서비스를 재시작하지만, 렌더러만 OOM 킬러에 의해 종료되는 경우에는 재시작이 보장되지 않습니다. Compose에서 동일한 제어 항목은 mem_limit, shm_size, init이며, 자세한 내용은 Docker Compose에서 메모리 제한 설정하기에서 다룹니다.

브라우저 엔드포인트를 공용 인터넷에서 격리하기

Playwright는 브라우저를 서버로 실행하여 에이전트에 WebSocket URL을 제공할 수 있습니다.

const { chromium } = require('playwright');
const server = await chromium.launchServer({ port: 3000 });
console.log(server.wsEndpoint());

해당 엔드포인트에는 로그인 절차가 없습니다. Playwright API 문서에는 다음과 같이 명시되어 있습니다. "wsPath을 알고 있는 모든 프로세스나 웹 페이지(Playwright에서 실행 중인 페이지 포함)는 OS 사용자의 제어권을 탈취할 수 있습니다." 기본 호스트는 localhost이며 "루프백 인터페이스에서만 연결을 허용"합니다. 또한 문서는 0.0.0.0와 같이 명시적인 주소를 전달하면 "수신 대기 중인 포트에 도달할 수 있는 모든 대상에게 브라우저 RPC를 노출한다"고 경고합니다. Chrome 자체의 --remote-debugging-port은 상황이 더 나쁩니다. DevTools 프로토콜은 어떠한 인증도 제공하지 않으며 전적으로 루프백 바인딩에 의존합니다.

실제로 무엇이 공개되어 있는지 확인하십시오. VPS 내부뿐만 아니라 외부의 다른 기기에서도 확인해야 합니다.

ss -ltnp

0.0.0.0에 바인딩된 브라우저 포트에서 응답이 온다면 이는 보안 취약점입니다. 대부분의 클라우드 제공업체는 제어판에서 별도의 네트워크 방화벽을 운영하며, 사용자의 ufw 규칙은 이를 인지하지 못한다는 점을 기억하십시오. 대신 SSH 터널이나 사설 VPN을 통해 다른 기기에서 엔드포인트에 접근하십시오.

ssh -N -L 3000:127.0.0.1:3000 you@your-vps

여기서 발생하는 위험은 단순히 브라우저 사용 시간을 도용당하는 수준을 넘어섭니다. 제어 가능한 브라우저는 네트워크 내부에서 작동하는 요청 위조 도구와 같습니다. 해당 소켓에 접근할 수 있는 공격자는 http://127.0.0.1:8080, 데이터베이스 관리 페이지 또는 169.254.169.254의 클라우드 메타데이터 주소를 가져오게 한 뒤, 페이지 응답을 읽어낼 수 있습니다. 방화벽은 이 요청을 VPS 자체에서 발생하는 것으로 간주하여 허용합니다. 제어 엔드포인트를 해당 서버의 셸 접근 권한과 동일하게 취급하십시오.

MCP 서버도 동일한 구조를 가집니다. npx @playwright/mcp@latest --headless --port 8931는 localhost에서 HTTP로 서비스를 제공하며, --host 0.0.0.0은 로컬 도구를 공용 도구로 전환하는 플래그입니다. 프로젝트 README에는 Playwright MCP가 "보안 경계가 아님"이 명시되어 있습니다. 포트를 루프백에 유지하고 에이전트가 동일한 터널을 통해 접근하도록 하십시오.

에이전트가 읽는 페이지는 신뢰할 수 없는 입력입니다

공개 웹을 탐색하는 에이전트는 낯선 사람이 작성한 텍스트를 사용자의 지침이 포함된 모델에 전달합니다. 웹 페이지에는 모델을 대상으로 하는 텍스트가 포함될 수 있으며, 이는 모델에게 작업을 중단하거나, 도구를 호출하거나, 특정 URL로 데이터를 전송하도록 지시할 수 있습니다. 모델은 두 내용을 모두 텍스트로 수신하므로, 페이지의 내용과 사용자의 지침을 확실하게 구분할 방법이 없습니다. 적대적인 페이지가 악용할 수 있는 여지를 최소화하도록 설계를 구성하십시오.

  • 브라우저는 별도의 OS 사용자 계정으로 실행하고, 해당 환경에는 SSH 키나 클라우드 자격 증명을 포함하지 마십시오.
  • 작업마다 새로운 컨텍스트를 사용하고, --isolated와 함께 Playwright MCP를 사용하십시오. 작업이 끝나면 MCP 브라우저를 종료하여 해당 세션의 저장소를 폐기하십시오.
  • 작업 허용 범위 내에서 오리진 허용 목록(allowlist)을 유지하십시오. Playwright MCP는 --allowed-origins 및 --blocked-origins를 세미콜론으로 구분된 목록으로 받습니다. 이러한 필터는 리다이렉트에는 영향을 미치지 않으며 보안 경계로 간주해서는 안 됩니다.
  • 메일 발송이나 결제와 같이 상태를 변경하는 모든 작업 전에는 반드시 사람의 확인 단계를 거치도록 하십시오.

더 나은 방법은 브라우저 전체를 폐기하고 재구축할 수 있는 머신에서 실행하는 것입니다. 이는 일회용 VM에서 코딩 에이전트 실행하기와 같은 논리입니다. 에이전트의 실제 작업이 자유로운 브라우징이 아닌 검색이라면, 전체 브라우저보다는 더 제한적인 도구가 안전합니다. 직접 구축한 SearXNG 기반의 검색 기능을 사용하면 적대적인 페이지를 직접 로드하지 않고도 결과를 얻을 수 있습니다.

FAQ

Chromium이 호스트에서는 잘 작동하는데 Docker 컨테이너 안에서는 왜 충돌하나요?

컨테이너는 기본적으로 64 MB의 /dev/shm을 할당받지만, 호스트는 훨씬 더 큰 공간을 사용하기 때문입니다. Chromium은 렌더링된 콘텐츠를 이 공유 메모리 영역을 통해 전달하므로, 무거운 페이지를 로드하면 메모리가 가득 차서 렌더러 프로세스가 종료됩니다. 컨테이너 내부에서 df -h /dev/shm를 실행하여 이를 확인하십시오. 이후 호스트의 공유 메모리를 사용하는 --ipc=host 옵션을 추가하거나, 컨테이너 자체의 공유 메모리 크기를 늘리는 --shm-size=1g 옵션을 사용하여 실행하십시오. --disable-dev-shm-usage은 문제를 /tmp로 옮길 뿐입니다. Playwright 1.62 버전부터는 해당 플래그가 기본적으로 전달되므로, ignoreDefaultArgs: ['--disable-dev-shm-usage']를 사용하여 Chromium이 설정한 공유 메모리를 사용하도록 하십시오.

VPS에서 다른 작업을 하지 않는다면 --no-sandbox는 안전한가요?

아니요, 안전하지 않습니다. 샌드박스는 악의적인 페이지가 시스템의 나머지 부분에 접근하지 못하도록 차단하는 역할을 합니다. Chromium 보안 페이지에서는 이 플래그에 대해 다음과 같이 경고합니다: "보안 수준이 크게 낮아지고 Chromium이 제대로 작동하지 않을 수 있으므로 권장하지 않습니다." 링크를 따라가는 에이전트는 공개된 웹을 탐색하는 것과 같습니다. 대신 근본적인 원인을 해결하십시오. 브라우저를 root 권한으로 실행하지 말고, Ubuntu 24.04 환경이라면 브라우저 바이너리 경로에 userns,을 포함하는 AppArmor 프로필을 추가하여 해당 프로그램에 대해서만 권한 없는 사용자 네임스페이스를 허용하십시오. chromiumSandbox: true을 사용하여 샌드박싱을 명시적으로 활성화하고, Docker 환경에서는 Playwright가 권장하는 seccomp 프로필도 함께 사용하십시오.

작은 VPS에서 브라우저를 몇 개나 실행할 수 있나요?

숫자를 맹신하지 말고 직접 측정하십시오. Chromium은 사이트마다 하나의 렌더러 프로세스를 시작하므로, 열어두는 페이지에 따라 결과가 달라집니다. MemoryMax을 설정한 상태에서 systemd-run로 워커 하나를 실행하고, systemctl status의 Memory: 라인에서 최대 메모리 사용량을 확인하십시오. 그 후 가용 RAM을 해당 최댓값으로 나누고 여유 공간을 확보하십시오. 코드 내에 큐를 구현하고 유닛 파일에 MemoryMax을 설정하여, 요청이 몰릴 때 스왑이 발생하지 않고 대기하도록 결과를 두 번 적용하십시오.

에이전트가 다른 머신에서 브라우저로 연결할 수 있나요?

가능하지만, 포트를 0.0.0.0에 바인딩해서는 안 됩니다. Playwright 서버 엔드포인트와 Chrome DevTools 포트는 비밀번호 없이 접근 가능한 모든 클라이언트의 연결을 허용합니다. 리스너를 127.0.0.1에 유지하고 SSH 터널이나 사설 VPN을 통해 연결하십시오. 서버에서 ss -ltnp로 확인하고 외부에서 포트 상태를 점검하십시오. 또한 클라우드 제공업체의 별도 네트워크 방화벽 설정도 확인해야 합니다.

페이지는 정상적으로 로드되었는데 왜 스크린샷이 빈 화면으로 나오나요?

폰트가 누락되었기 때문입니다. 페이지의 스크립트를 지원하는 폰트가 없으면 텍스트가 빈 상자로 표시되거나 아예 나타나지 않아, 이미지가 적은 페이지는 빈 화면처럼 보입니다. 스크랩하려는 각 언어에 대해 fc-match "sans-serif:lang=ko"을 실행하고, 일반적인 대체 폰트가 필요한 경우 fonts-noto-core과 fonts-noto-cjk를 설치한 뒤 브라우저를 재시작하여 fontconfig 캐시를 갱신하십시오. 폰트가 전혀 없는 컨테이너는 시작 시 Fontconfig error: Cannot load default config file을 로그에 남깁니다.

이 글이 도움이 되었나요?