SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

VPSでヘッドレスブラウザを安定稼働させる設定ガイド

VPS上でChromiumを動かす際に発生する/dev/shm不足やサンドボックスエラー、フォント欠損などのトラブルを回避する方法を解説します。Playwrightのバージョン固定や共有ライブラリの適切な設定を行い、AIエージェントの実行環境を安定させるための具体的な手順をまとめました。

実行するもの

VPS 上のヘッドレスブラウザは、ウィンドウを表示せず、人間ではなくコードから操作する Chromium です。サーバー上では、エージェントがローカルソケット経由で通信する、長時間稼働するプロセスツリーとして動作します。インストールは 1 つのコマンドで完了します。重要なのは、その後の運用です。ブラウザがマシンから使用できるリソースを制限し、制御エンドポイントをパブリックインターネットから隔離します。

このガイドでは、使用するツールはすでに決まっており、これから運用を始めるものとします。クローラーと抽出ツールをまだ比較している場合は、まず セルフホスト型 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 が必要になると root 権限を要求します。ブラウザー本体のビルドは、コマンドを実行したユーザーの ~/.cache/ms-playwright にダウンロードされます。これはサーバー上では重要です。通常、サービスユーザーはログインに使用するユーザーとは異なるためです。管理者として sudo npx playwright install-deps chromium でシステムパッケージを一度インストールし、インストールコマンドとサービス unit の両方で PLAYWRIGHT_BROWSERS_PATH=/opt/pw-browsers を設定して、1 つのコピーを共有します。サービスからブラウザーが見えない場合、検索したパスを示すメッセージとともに起動に失敗します。

Playwright のバージョンを固定します。各リリースは 1 つのブラウザービルドに対応しているため、バージョンを固定しない npm update では、実行中のサービスでブラウザーが置き換わる可能性があります。2026 年 11 月 16 日時点の最新リリースは 1.65.1 です。固定するバージョンを変更する前に、リリースノートを確認してください。ARM64 サーバーでは、1.63 でブラウザーフォルダーの名前が変更された点に注意してください。後述する AppArmor プロファイルに影響します。

Chromium のビルドは 2 種類あり、同じプログラムではありません。ヘッドレスモードでは、Playwright はデフォルトで headless shell を使用します。これはヘッドレス実行だけに対応した、より小さいバイナリです。通常のインストールでは完全なブラウザーとともにダウンロードされ、npx playwright install --with-deps --only-shell では shell だけがインストールされます。完全なブラウザーは chromium チャネルで取得できます。Playwright のブラウザードキュメントでは、これを「本物の Chrome ブラウザーであり、より忠実で信頼性が高く、より多くの機能を提供する」と説明しています。大量取得には shell を使用します。サイトの挙動が異なり、その理由を調べる必要がある場合は、完全なブラウザーを使用します。

コンテナ内でヘッドレスブラウザがクラッシュする理由

Docker は各コンテナに 64 MB の /dev/shm を割り当てます。Docker のドキュメントには、「サイズを完全に省略すると、システムは 64m を使用する」と明記されています。Chromium はプロセス間でレンダリング済みコンテンツをこの共有メモリ領域経由で受け渡すため、負荷の高いページ 1 つで領域が満杯になることがあります。すると renderer が終了し、ノートパソコンでは正常に動作するページでも、クライアントには crashed target と報告されます。変更を加える前に、コンテナ内からサイズを確認してください。

df -h /dev/shm

実際の対処方法は 2 つあります。これらは併用するものではなく、どちらか一方を選びます。--ipc=host はコンテナをホストの IPC namespace に配置し、通常は RAM の半分であるホストの /dev/shm を使用させます。Playwright の Docker ガイド はこの方法を推奨しています。これを使わないと「Chromium はメモリ不足になり、クラッシュする」ためです。ただし、コンテナとホスト間の IPC 分離が失われます。--shm-size=1g はプライベートな namespace を維持したまま、mount のサイズだけを大きくします。

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 に戻り、tmpfs のサイズ制限だけが上限になります。kernel のドキュメント によると、この上限はデフォルトで物理 RAM の半分です。また、tmpfs のページは swap に追い出されることがあります。これが、ブラウザによって小容量 VPS のメモリが消費される原因の 1 つです。Playwright 1.62 はデフォルトで --disable-dev-shm-usage を渡します。サイズを設定した /dev/shm を使用するには、起動オプションで ignoreDefaultArgs: ['--disable-dev-shm-usage'] によりその引数を削除してください。

実際に発生する --no-sandbox の代償

Chromium は、Linux の user namespace を基盤とする sandbox 内で各 renderer を分離します。この sandbox が、悪意のあるページとサーバーの境界になります。Playwright はデフォルトで Chromium の sandbox を無効にするため、起動オプションで chromiumSandbox: true を指定して有効にします。有効な sandbox を起動できない場合、Chromium は実行を拒否し、ログには次のような行が記録されます。

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

通常の対処は --no-sandbox です。Chromium 自身のセキュリティページには、その代償が明記されています。「セキュリティが大幅に低下し、Chromium が正常に動作しなくなる可能性があるため、これは推奨しません」。リンクをたどる agent は、定義上、オープンな Web を閲覧します。まさに、その低下したセキュリティが試される環境です。本当の原因を特定してください。

確認すべき原因は、root での実行と user namespace のブロックです。root で実行すると Chromium の sandbox は利用できません。そのため Playwright のイメージには pwuser という一般ユーザーが用意されています。Docker では、sandbox を有効にしたブラウジングのため、clone、setns、unshare を許可する seccomp プロファイルも Playwright が推奨しています。Ubuntu 24.04 以降では、AppArmor が非特権 user namespace を制限します。付属のプロファイルが対象としていないパスにある 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" を含む kernel の行が確認できれば、2 つ目の原因に該当します。/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 は完全な browser を chrome-linux64/chrome に、shell を 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 で共有インストールした場合に対応します。パスには browser の revision も含まれるため、Playwright をアップグレードするたびに変わります。上記の glob なら、この変更後も機能します。特定のパスだけを対象にしたプロファイルは、対象が一致しなくなってもエラーになりません。そのため、関係ないように見える更新の後に browser が再び起動に失敗します。

スクリーンショットが空白、または四角形だらけになる理由

空白のスクリーンショットや空の四角形だらけのスクリーンショットは、通常、レンダリングの不具合ではなくフォントの問題です。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 が見つけたフォントにフォールバックします。推測せず、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 の context のロケールとタイムゾーンは、デフォルトでシステム設定になります。そのため、LANG が未設定、またはタイムゾーンが UTC だと決めつけず、イメージの設定を確認します。マシン単位ではなくブラウザー context 単位で設定すると、1 つのブラウザーで異なる地域向けのタスクを処理できます。

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

ブラウザプロセスのリークがサーバーをスワップさせる理由

「ゾンビ」という名称は、性質の異なる2つの問題に対して使われます。真のゾンビプロセスとは、終了したものの親プロセスが 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

このカウント値は、タスクの合間にアイドル時の値へ戻る必要があります。1日を通して数値が増加し続ける場合、修正すべきは起動フラグではなくコードです。finally ブロック内でコンテキストを閉じ、SIGTERM でブラウザを終了させ、1ヶ月間起動し続けるのではなく一定のタスク数ごとにブラウザを再利用してください。systemd環境下では、停止や再起動によってユニットのcgroup内の全プロセスが終了されるため、sudo systemctl restart browser.service は信頼できるリセット手段となります。ターミナルマルチプレクサ内で手動起動されたブラウザにはそのような保証はなく、セッション終了後も孤立したプロセスが生き残ります。

1 つのブラウザーコンテキストに必要な RAM はどのくらいか

質問は正確に定義してください。「1 つのブラウザー」は 1 プロセスではありません。Chromium は、ブラウザープロセス、GPU プロセス、ユーティリティプロセス、サイトごとに 1 つのレンダラープロセスを起動します。サイト分離により、クロスサイト iframe も独自のレンダラープロセスを持ちます。BrowserContext は同じプロセスツリー内にある独立した Cookie とストレージの領域なので、2 つ目のコンテキストによる増加は小さくなります。一方、2 つ目のページではレンダラープロセスが起動するため、必要なメモリは増えます。広告の多いページでは、複数のプロセスが起動します。

測定すべき数値は、自分のワークロードでプロセスツリー全体が使用するピークメモリです。他人のブログにある数値は、この用途では参考になりません。エージェントが開くページによって必要なメモリが決まるためです。実際に使用するマシンで、実際にアクセスするサイトを対象に測定してください。

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: 行に、unit の現在の使用量とピーク使用量が表示されます。まずページを 1 つずつ開くように worker を実行し、ピーク値を記録します。次に 2 ページを開いた状態で繰り返し、2 つ目のページが実際に消費するメモリを確認します。並行実行数は算術で求められます。総 RAM から、マシンの他の処理に必要な容量を引き、数百 MB の余裕を残してから、worker 1 つあたりの測定ピーク値で割ります。基盤となるマシンのサイジングについては、エージェント用 VPS に必要な RAM と CPU を参照してください。

この数値は 2 か所で適用します。コードでは、固定 worker pool または semaphore を使用します。これにより、エージェントのリクエストが集中しても、ブラウザーを起動せずキューに入れられます。OS では cgroup の制限を使用します。キューのバグが発生しても、マシン全体を停止させないためです。

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

MemorySwapMax=0 は見た目以上に重要です。これを設定しない場合、cgroup は上限に近づくとページを swap に移動できます。そのため、マシンは稼働し続けても、すべてのリクエストが遅くなることがあります。これは、明確な失敗として検出できる場合より診断が困難です。swap は停止を遅らせるだけです。systemd のドキュメントには、「使用量を上限内に収められない場合、unit 内で out-of-memory killer が呼び出される」と記載されています。swap を 0 に制限すると、unit は swap を使用できません。MemoryMax に到達すると、使用量を抑えられない場合に OOM kill が発生する前に reclaim が実行されます。Restart=always は、メインプロセスが終了したときにサービスを再起動します。ただし、レンダラーだけが OOM kill されても、サービスが再起動するとは限りません。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を知っているプロセスやWebページ(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は「セキュリティ境界ではない」と明記されています。ポートはループバックに留め、エージェントには同じトンネル経由でアクセスさせてください。

エージェントが読み取るページは信頼できない入力です

オープンな Web を閲覧するエージェントでは、見知らぬ第三者が書いたテキストが、あなたの指示を保持するモデルに入力されます。ページには、そのモデルにタスクを中止する、ツールを呼び出す、URL にデータを投稿するよう指示するテキストを含められます。モデルは両方をテキストとして受け取るため、ページの記述とあなたの指示を確実に区別できません。悪意のあるページが利用できる情報や権限を少なくする構成にしてください。

  • ブラウザーは専用の OS ユーザーで実行し、その環境に SSH キーやクラウド認証情報を配置しないでください。
  • タスクごとに新しいコンテキストを使用し、Playwright MCP では --isolated を使用してください。タスクの間に MCP ブラウザーを閉じて、そのセッションのストレージを破棄します。
  • ジョブで許可されている場合は、オリジンの許可リストを設定してください。Playwright MCP は --allowed-origins と --blocked-origins をセミコロン区切りのリストとして受け取ります。これらのフィルターはリダイレクトには適用されず、セキュリティ境界にもなりません。
  • メールの送信や支払いなど、状態を変更する操作の前に、人間による確認を必須にしてください。

さらに安全にするには、ブラウザー全体を、破棄して再構築できるマシン上で実行します。これは、使い捨て VM でコーディングエージェントを実行する場合と同じ考え方です。エージェントの実際の目的が検索であり、自由な Web 閲覧ではない場合は、完全なブラウザーよりも限定的なツールの方が安全です。独自の SearXNG をバックエンドにした検索スキルなら、悪意のあるページを読み込まずに検索結果を返します。

FAQ

Chromium は Docker 内ではクラッシュするのに、同じ VPS 上で直接実行すると正常なのはなぜですか?

コンテナではデフォルトで 64 MB の /dev/shm が割り当てられますが、ホストではそれよりはるかに大きい容量が確保されているためです。Chromium はレンダリングしたコンテンツをこの共有メモリ領域に渡すため、負荷の高いページを開くと領域が満杯になり、renderer が終了します。コンテナ内で df -h /dev/shm を実行して確認し、ホストの共有メモリを使う --ipc=host、またはコンテナ独自の共有メモリを拡張する --shm-size=1g のいずれかを指定して起動します。--disable-dev-shm-usage は問題を /tmp に移すだけです。Playwright 1.62 はデフォルトでそのフラグを渡すため、Chromium に設定した共有メモリを使わせるには ignoreDefaultArgs: ['--disable-dev-shm-usage'] を使用します。

VPS で他の処理を何も実行していない場合、--no-sandbox は安全ですか?

いいえ。sandbox は、悪意のあるページがマシンの他の部分へ到達するのを防ぎます。Chromium のセキュリティページでも、このフラグについて「セキュリティが大幅に低下し、Chromium が正常に動作しなくなる可能性があるため、推奨しません」と説明されています。リンクをたどる agent は、公開 Web を閲覧しています。原因を解消してください。ブラウザーを root として実行せず、Ubuntu 24.04 では、ブラウザーのバイナリパスに対して userns, を付与した AppArmor プロファイルを追加し、権限のない user namespace をそのプログラムに限って許可します。chromiumSandbox: true で sandboxing を明示的に有効にします。Docker では、Playwright が推奨する seccomp プロファイルも使用してください。

小規模な VPS で、ブラウザーを何個実行できますか?

数値をそのまま流用せず、実測してください。Chromium はサイトごとに 1 つの renderer process を起動するため、開くページによって結果が異なります。MemoryMax を設定した状態で systemd-run の下で 1 つの worker を実行し、systemctl status の Memory: 行からピーク値を読み取ります。その後、空き RAM をそのピーク値で割り、余裕を残します。結果は、コード内のキューと unit file の MemoryMax の 2 箇所で制限してください。これにより、リクエストが集中してもマシンが swap する代わりに待機します。

agent は別のマシンからブラウザーに接続できますか?

はい。ただし、ポートを 0.0.0.0 に bind してはいけません。Playwright server endpoint と Chrome DevTools port は、パスワードなしで到達可能な任意の client からの接続を受け付けます。listener は 127.0.0.1 に限定し、SSH tunnel またはプライベート VPN 経由で接続します。サーバー上で ss -ltnp を実行し、外部から port check を行って確認します。プロバイダーの独立した network firewall も確認してください。

ページが明らかに読み込まれているのに、スクリーンショットが真っ白なのはなぜですか?

フォントが不足しているためです。ページの script に対応するフォントがないと、テキストは空のボックスとして描画されるか、まったく描画されません。そのため、画像の少ないページでも真っ白に見える画像が返されます。取得対象の各言語について fc-match "sans-serif:lang=ko" を実行し、結果が汎用フォールバックの場合は fonts-noto-core と fonts-noto-cjk をインストールします。その後、fontconfig がキャッシュを再読み込みするよう、ブラウザーを再起動します。フォントがまったくないコンテナでは、起動時に Fontconfig error: Cannot load default config file がログに出力されます。

この記事は役に立ちましたか?