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

MoliをVPSで自己ホストする方法とCDP接続

小規模なVPSでヘッドレスChromeが重い場合に、MoliをインストールしてloopbackでCDPを公開し、エージェントやPlaywrightから接続する方法を説明します。Chromeが必要なページの見分け方も紹介します。

小さな VPS に適したヘッドレスブラウザー

Moli は AI エージェント向けのヘッドレスブラウザーです。ヘッドレス Chrome を動かせない小規模な VPS にも、自分でホストできるほど軽量です。Chromium のラッパーではなく、Rust で記述されたブラウザーエンジンであり、自動化ライブラリがすでに使用しているプロトコルである Chrome DevTools Protocol (CDP) に応答します。1 つのバイナリをインストールして moli serve を実行し、Playwright または独自のエージェントコードを http://127.0.0.1:9222 に接続します。

インストールする前に、トレードオフを確認してください。プロジェクトは対応範囲を明確に示しています。GUI ブラウザー、GPU コンポジター、Chrome とのピクセル単位の互換性、高忠実度の Canvas、WebGL、メディア再生には対応していません。これらを必要とするページは失敗します。Playwright で実行する実際の Chrome がフォールバックとなります。最後のセクションでは、どのページで Chrome が必要かを判断する方法を説明します。

以下のすべてのコマンドは、プロジェクトの README と公開されている skill ファイルに基づいています。2026 年 11 月 16 日に、固定されたバージョンを使用して再確認しています。チャート内の数値はすべて、プロジェクトが自らのエンジンについて公開した値であり、このサイトで測定した値ではありません。各チャートのキャプションにも、その旨を記載しています。まだエンジンを選定中であれば、VPS 上のエージェント向けヘッドレスブラウザーに関する詳しい調査で、代替手段を確認できます。

ヘッドレス Chrome はなぜこれほど多くのメモリを使用するのか?

Chrome はマルチプロセスブラウザーです。サイト単位でドキュメントをグループ化し、デスクトップ Linux では完全な Site Isolation により、クロスサイト iframe を含む各サイトを専用の renderer プロセスで処理します。Chrome は同一サイトのページで renderer を共有できますが、複数のサイトにアクセスするセッションでは複数の renderer が動作します。各 renderer は独自の V8 ヒープとグラフィックスバッファーを保持します。この設計は、クラッシュしたページによってウィンドウ全体が停止しないようにするデスクトップ環境には適しています。一方、2 GB の VPS では、1 回のブラウジング処理だけで、実行中のアプリケーションそのものより多くのメモリを消費することがあります。

このプロジェクトでは、4 つのエンジンを使用して 192 件の一般公開 URL をクロールし、結果を公開しました。

グラフMixed public web crawl, 192 URLs, figures published by the Moli project
このグラフのデータ
[
  {
    "engine": "Moli",
    "useful_pages": 103,
    "median_rss_mib": 73
  },
  {
    "engine": "Chrome Headless",
    "useful_pages": 101,
    "median_rss_mib": 773
  },
  {
    "engine": "Lightpanda",
    "useful_pages": 85,
    "median_rss_mib": 40
  },
  {
    "engine": "Obscura",
    "useful_pages": 57,
    "median_rss_mib": 39
  }
]

Chrome Headless は 101 件の有用なページを返し、Moli は 103 件を返しました。このサンプルでは、両エンジンが Web のほぼ同じ割合を読み取ったことになります。差が出るのはメモリです。Chrome の RSS(resident set size、プロセスが実際に RAM 上で保持するメモリ)の中央値は 773 MiB で、Moli は 73 MiB でした。この傾向は、プロセスアーキテクチャから説明できるため、信頼できます。ただし、実際のページで同じ比率になるとは限りません。

問題になるのは中央値ではありません。ピーク値です。2 GB のマシンでメモリが不足すると、kernel がプロセスを 1 つ選んで kill し、その記録が dmesg -T または journalctl -k に残ります。

Out of memory: Killed process 4211 (chrome) total-vm:2318936kB, anon-rss:1418324kB, file-rss:0kB, shmem-rss:0kB, UID:1000 pgtables:3540kB oom_score_adj:0

エージェントはその行を認識できません。エージェントからは、通常 page.goto: Page crashed のような Playwright エラー、または閉じた target として、応答を停止したブラウザーが見えるだけです。そのエラーにはメモリに関する情報が含まれません。そのため、小容量のマシンでエージェントがランダムに失敗するときは、最初に OOM(out of memory)killer を確認します。ピーク値を基準にサイジングする手順は、エージェント用 VPS の RAM と CPU を選定する場合と同じです。

1つのバージョンに固定して Moli バイナリをインストールする

このプロジェクトは、GitHub releases で shell installer とビルド済みの tarball を公開しています。2026年11月16日時点での最新リリースは、2026年11月15日に公開された 1.1.25 です。ただし、以下のコマンドは 1.1.18 に固定されています。このプロジェクトが後述する Lexbench のスコアを測定したバージョンは 0.1.1 で、その他の数値の基になったバージョンは README に記載されていません。これらの数値は、インストールするビルドの性能を保証するものではなく、エンジンのおおまかな傾向を示すものとして扱ってください。

バージョンを固定します。常に latest を解決する installer を使うと、次回の再ビルドでエージェントが別のブラウザエンジンに移行します。ブラウザの動作が変わる可能性があるため、再ビルド時に発見するのではなく、予定した変更として扱うべきです。

shell installer は手早く導入する方法ですが、実行する前に内容を読む価値があります。

curl --proto '=https' --tlsv1.2 -fsSL \
  -o /tmp/moli-installer.sh \
  https://github.com/lexmount/moli/releases/download/v1.1.18/moli-installer.sh
less /tmp/moli-installer.sh
sh /tmp/moli-installer.sh

実行する前にスクリプトを読んでください。短いスクリプトです。uname -m からアーカイブを選び、単一のバイナリを ~/.local/bin に展開します。x86_64 では moli-x86_64-unknown-linux-gnu.tar.gz を使用し、Arm サーバーでは aarch64 アーカイブを使用するため、Arm と x86 の両方の VPS プランに対応しています。別の場所にインストールする場合は MOLI_INSTALL_DIR を設定します。バージョンについて何を解決するかにも注意してください。スクリプトを取得した tag ではなく、最新のリリースを解決します。最初に試すだけなら問題ありませんが、再現可能な再ビルドには適していません。

そのため、永続的に使用する場合は、installer と同じ処理を手動で行い、正確なアーカイブを自分で指定してください。これにより、system service からアクセスできる場所にバイナリを配置できます。また、ダウンロードしたスクリプトを shell にパイプする必要もありません。

cd /tmp
curl --proto '=https' --tlsv1.2 -fsSLO \
  https://github.com/lexmount/moli/releases/download/v1.1.18/moli-x86_64-unknown-linux-gnu.tar.gz
mkdir -p moli-pkg
tar -xzf moli-x86_64-unknown-linux-gnu.tar.gz -C moli-pkg --strip-components=1
sudo install -m 0755 moli-pkg/moli /usr/local/bin/moli
moli --version

moli --version 固定したバージョンを表示すれば、確認は完了です。installer の直後に moli: command not found を実行しても表示されない場合は、インストール先ディレクトリが PATH に含まれていません。その場合、installer が追加すべきディレクトリを示す行を出力します。

moli fetch による 1 回限りの抽出

エージェントにブラウザーで実行させる処理の多くは、「この URL を読み込み、内容を教えてください」というものです。この場合、サーバーは必要ありません。moli fetch はエンジンを起動し、1 ページを読み込み、1 つの成果物を標準出力に書き込んで終了します。そのため、呼び出しの間にメモリを保持しません。

moli fetch --dump markdown --wait-until networkidle https://example.com
moli fetch --dump semantic_tree_text --wait-selector "main" https://example.com
moli fetch --dump json --wait-until networkidle https://example.com > page.json

最初のコマンドは、# Example Domain で始まるページを Markdown として出力します。Markdown はマークアップを削除してテキストを保持するため、モデルに渡すデータとして最も軽量です。semantic_tree_text はロールと構造を保持します。リンクが本文と同じくらい重要な、ナビゲーション中心のページに適しています。--dump json は HTTP ステータスとリクエストのトレースを含めます。取得結果が空で原因を確認したい場合に使用します。

待機方法によって、コンテンツを取得できるか、空のページしか取得できないかが決まります。--wait-until networkidle はネットワーク通信が停止すると返ります。--wait-until domstable は DOM の変更が止まると返ります。バックグラウンドでポーリングを続け、ネットワーク通信が停止しないページではこちらが適しています。--wait-selector は指定した 1 つのセレクターを待機します。取得対象のページについて情報を持つ唯一の方法なので、対象が分かっている場合に最も信頼できます。

スクリーンショットと PDF には実際のレイアウトが必要です。レイアウトはデフォルトで無効になっています。

moli fetch --layout --dump screenshot https://example.com > page.png
moli fetch --layout --dump screenshot_full https://example.com > full-page.png
moli fetch --layout --dump pdf https://example.com > page.pdf

README では、デフォルトのレイアウトポリシーを LayoutPolicy::Mock としています。ジオメトリは仮想的に処理され、何も描画されません。ブラウザーでは、レイアウトと描画が処理負荷の高い部分だからです。このデフォルト設定により、前述のメモリ使用量になります。また、空の PNG が返る場合、多くはページの破損ではなく、--layout フラグが不足しています。

エージェントが選択したのではなく、エージェントが見つけた URL を取得する場合は、--block-private-networks を追加します。ページ上で読み取ったリンクをたどるエージェントは、クラウドインスタンスの認証情報を取得する http://169.254.169.254/ や、Web に公開する想定のない localhost 上のデータベースポートへ誘導される可能性があります。このフラグは、直接接続するリクエストでプライベートアドレスをブロックします。--block-cidrs を追加すると、特定のブロック範囲も指定できます。プロキシが解決した対象は、プロキシ側でフィルタリングする必要があります。ジョブが 1 ページの読み取りではなくクロールの場合、そのパイプラインの構成は セルフホスト型 Firecrawl の代替手段で説明しています。その前段階である URL の発見方法については、SearXNG を利用するエージェント向け検索スキルで説明しています。

CDP 経由でエージェントを Moli に接続する

多くの手順でページを移動してクリックするエージェントでは、代わりにサーバーを実行します。

moli serve --host 127.0.0.1 --port 9222

127.0.0.1 とポート 9222 がデフォルトなので、引数なしの moli serve でも loopback のみにバインドされます。ただし、永続的な設定では必ず両方を明示してください。次に service file を読む人がデフォルト値を覚えておく必要がなくなります。

クライアントを接続する前に、サーバーを確認します。

curl -s http://127.0.0.1:9222/json/version

正常なサーバーは webSocketDebuggerUrl フィールドを含む JSON オブジェクトを返します。この URL に CDP クライアントを接続します。curl: (7) Failed to connect to 127.0.0.1 port 9222: Connection refused は何も待ち受けていないことを示します。その場合は、サーバーを起動した端末を確認するか、サービスとして実行している場合は journalctl -u moli -n 50 を確認します。/json/list ではオープンなターゲットを一覧表示し、/json/protocol ではこの build が実装するドメインを一覧表示します。これにより、依存する CDP メソッドが利用できるか確認できます。

Playwright は独自にブラウザーを起動せず、その endpoint に接続します。

import { chromium } from "playwright";

const browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
const context = browser.contexts()[0];
const page = context.pages()[0] ?? await context.newPage();

await page.goto("https://example.com");
console.log(await page.locator("body").innerText());

await browser.close();

重要なのは connectOverCDP であり、chromium.launch() ではありません。ここでは子プロセスとして Chromium を起動しないため、executablePath や --no-sandbox などの一般的なコンテナ用フラグには作用対象がありません。同じ理由で、proxy、cookie、user-agent の設定は Moli サーバーの独自フラグとして指定します。Chrome protocol 全体ではなく、選択された CDP 機能だけが利用できると考えてください。明示的な unsupported-method エラーは、コードのバグではなくエンジンの対応範囲を示します。

エージェントが実行できる処理は、2 つのサーバーフラグで決まります。--layout は実際の geometry を有効にします。座標によるクリックとスクリーンショットにはこの機能が必要です。--resource はオプションの画像、フォント、メディアを取得します。ページを読み込むたびに帯域幅とメモリを消費するため、必要であることが確認できるまで無効にしてください。--profile-dir は実行間で cookie と storage を保持します。これを指定しない場合、各実行の状態は破棄されます。

グラフOne agent episode, Moli against Chromium, figures published by the Moli project
このグラフのデータ
[
  {
    "engine": "Moli",
    "cdp_ready_ms": 34.85,
    "peak_pss_mib": 102.46,
    "processes": 1
  },
  {
    "engine": "Chromium",
    "cdp_ready_ms": 169.37,
    "peak_pss_mib": 348.82,
    "processes": 11
  }
]

プロジェクトのサンプルエージェント workload では、Moli は Chromium の 169.37 ms に対し、34.85 ms で CDP 接続を受け付けました。ピーク PSS(proportional set size。共有ページを共有するプロセス間で分割して数えるメモリ使用量)は、Chromium の 348.82 MiB に対し、102.46 MiB でした。構造上の違いは最後の列です。プロセス数は 11 に対し、1 です。1 プロセスであれば、systemd が監視する対象も、上限を設定する cgroup も 1 つで済みます。そのため、次のセクションは短くなります。

loopback で moli serve を systemd サービスとして実行する

エージェントが待機中のブラウザを必要とする場合は、サーバーをサービスとして実行します。不要な場合は、URL ごとに moli fetch を引き続き使用してください。アイドル状態のサーバーでもメモリを保持するためです。

ポート 9222 をパブリックインターフェースで公開しないでください。CDP には認証手順が一切ありません。そのポートに到達できるユーザーは、ブラウザを操作できるだけでなく、ブラウザから到達可能なあらゆる情報を読み取れます。これには、プロファイルディレクトリ内の Cookie も含まれます。127.0.0.1 に限定してください。別のマシンからアクセスする場合は、SSH トンネル(ssh -L 9222:127.0.0.1:9222 user@your-vps)またはプライベート VPN インターフェースを使用します。エージェントは、そのトンネルの自身側にある http://127.0.0.1:9222 へ接続させます。

サービスユーザーを作成し、続いて unit ファイルを作成します。

sudo useradd --system --home-dir /var/lib/moli --shell /usr/sbin/nologin moli

/etc/systemd/system/moli.service を記述します。

[Unit]
Description=Moli headless browser CDP server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=moli
Group=moli
ExecStart=/usr/local/bin/moli serve --host 127.0.0.1 --port 9222 --profile-dir /var/lib/moli/profile --block-private-networks
Restart=on-failure
RestartSec=2
StateDirectory=moli
MemoryAccounting=yes
MemoryMax=768M
NoNewPrivileges=yes
PrivateTmp=yes
ProtectHome=yes
ProtectSystem=strict

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now moli.service
systemctl status moli.service
curl -s http://127.0.0.1:9222/json/version

systemctl status には active (running) が表示され、curl は discovery JSON を返します。ProtectSystem=strict により、API ファイルシステムと設定した例外を除いてファイルシステムが読み取り専用になります。StateDirectory=moli は /var/lib/moli を作成し、サービスユーザーを所有者にして、書き込み可能な状態を維持します。PrivateTmp=yes を指定すると、unit 専用の /tmp と /var/tmp も書き込み可能になります。起動後すぐに停止し、journalctl -u moli に権限エラーが記録される unit は、ほぼ必ず ProtectSystem によって読み取り専用にされた場所へ書き込もうとしています。そのパスを state ディレクトリ配下へ移してください。

MemoryMax=768M は unit のメモリ使用量を制限します。unit には専用の cgroup が割り当てられ、使用量が上限に達すると、カーネルはメモリの回収を試みます。使用量を減らせない場合は、その cgroup 内で OOM killer が実行され、外部のプロセスは終了させません。journal には次のような kill の記録が残ります。

moli.service: A process of this unit has been killed by the OOM killer.

この行を、必要な容量を判断するための指標として読み取ります。ページが想定より重いか、上限が低すぎます。値は、実際のページを測定して設定してください。測定方法については次のセクションで説明します。Accounting は使用量を測定します。別のサービスに対する上限は、MemoryMax や CPUQuota などの個別の制御で設定します。systemd でメモリと CPU に上限を設定するでは、これらの制御を組み合わせて使用します。

自分でピークメモリを測定する

公開されている数値は、別のハードウェアと別のページを使った測定結果です。サーバーが稼働し続けられるかどうかはピークメモリ使用量で決まり、その値は読み込む内容に完全に依存します。リソースを決める前に測定してください。

1 回だけ取得する場合は、同名の shell 組み込みコマンドより多くの情報を出力する time binary を使用します。

sudo apt update && sudo apt install -y time
/usr/bin/time -v moli fetch --dump markdown --wait-until networkidle https://example.com > /dev/null

出力の末尾にはリソース統計のブロックがあり、Maximum resident set size (kbytes) が含まれています。MiB に変換するには 1024 で割ります。example.com ではなく、実際に agent がアクセスする 10 個のページに対して実行し、平均ではなく最大の結果を採用してください。OOM killer はピーク値に反応するためです。

サービスの場合は、kernel がその cgroup 用に保持しているカウンターを読み取ります。

cat /sys/fs/cgroup/system.slice/moli.service/memory.peak
systemd-cgtop -m

memory.peak はバイト数であり、cgroup の作成後に記録された最大値です。サービスを再起動しても、cgroup が再作成されない限りリセットされません。この値を MemoryMax が上回る必要があります。さらに、まだアクセスしていない最も負荷の高いページに備えて余裕を確保してください。systemd-cgtop -m は unit ごとの現在の使用量を示します。現在サーバー上で最もリソースを消費しているサービスを確認する最短の方法です。

Moli ではどこで失敗し、どのような場合に Chrome が必要になりますか?

このプロジェクトでは、比較可能なブラウザー自動化タスク 1,308 件のベンチマークも実施し、複数のエンジンのスコアを公開しています。

グラフLexbench headless browser suite, 1,308 tasks, figures published by the Moli project
このグラフのデータ
[
  {
    "engine": "Chrome",
    "success_rate_pct": 99.85
  },
  {
    "engine": "Moli 0.1.1",
    "success_rate_pct": 81.88
  },
  {
    "engine": "Kitesurf",
    "success_rate_pct": 62.08
  },
  {
    "engine": "Lightpanda",
    "success_rate_pct": 53.29
  },
  {
    "engine": "Obscura",
    "success_rate_pct": 44.88
  }
]

これら 5 個のエンジンでは、Moli 0.1.1 がタスクの 81.88 パーセントを完了し、参照エンジンである Chrome は 99.85 パーセントを完了しました。これはプロジェクトが独自のテストスイートで自ら採点した結果です。そのため、独立した検証結果ではなく、プロジェクト側の主張として読む必要があります。

実務上の解釈は簡単です。Moli 0.1.1 は、選ばれた 1,308 件のタスクのうち 237 件に失敗しました。およそ 5 件に 1 件です。ただし、エージェントがアクセスするページを固定し、すべて自分で管理している場合、この比率から分かることはほとんどありません。対象ページが動作するかどうかは実際に確認できるためです。レポートが示しているのは観測結果であり、対応可能な機能の上限ではありません。したがって、これらの失敗から未対応機能やオープン Web における失敗率を判断することはできません。

プロジェクトが示す対象範囲では、次のワークロードで Chrome を確認する必要があります。

  • 高忠実度の Canvas レンダリングを必要とするアプリケーション。ただし、Moli は Canvas の描画操作を実装しているため、Canvas を使うことだけでは Chrome が必要だとは判断できません
  • 高忠実度の WebGL または GPU コンポジットを必要とするもの。GPU コンポジターが存在しないためです
  • 高い性能を要求するメディア再生
  • Chrome に対するピクセル単位で完全に一致するスクリーンショットを検証するビジュアルテスト。Chrome との互換性を完全に一致させることは目標ではないためです

プロジェクトが引用するもう 1 つの数値、1 回の完全な実行で 1.612 million 件の Web プラットフォームテストに合格したという結果は、標準への対応範囲を示すものです。エージェントがアクセスするサイトで動作することを保証するものではありません。十分に対応された標準機能だけを使うページでも、ボットチェックで失敗することがあります。どのエンジンのスコアにも、その点は含まれません。

そのため、設計にはフォールバックを残してください。すべての URL をまず Moli に送ります。ページが空の状態で返る場合や、セレクターが表示されない場合は、その URL だけを Playwright で実際の Chrome を操作して再試行します。より大きなマシンを使うか、773 MiB のプロセスを許容できるスケジュールで実行してください。ほとんどのエージェントは通常のページに大半の時間を費やすため、小さなエンジンが処理量を担い、高価なエンジンが例外的なケースを担います。

FAQ

Moli はエージェント用の headless Chrome の代わりになりますか?

ページの読み取り、テキストの抽出、通常のクリックであれば、通常は代替できます。プロジェクト独自の 1,308 タスクのベンチマークでは、Chrome の 99.85 パーセントに対して 81.88 パーセントを完了し、Moli 0.1.1 では 237 タスクが失敗しました。ただし、この結果から、すべての失敗に未対応の機能が必要だとは判断できません。高い再現性が必要な Canvas、WebGL、メディア再生は、プロジェクトが明示する対象範囲外です。ただし、Canvas を使用しているだけでアプリケーションに互換性がなくなるわけではありません。確認に失敗した URL だけを実際の Chrome に転送し、すべてを元に戻すことは避けてください。

VPS 上で Moli が必要とする RAM はどの程度ですか?

プロジェクトの報告では、192 URL のクロールにおける RSS の中央値は 73 MiB、サンプルのエージェント実行における PSS のピークは 102.46 MiB です。headless Chrome の RSS の中央値は 773 MiB でした。これらはプロジェクトのページに記載された値です。単発利用では、/usr/bin/time -v で moli fetch の呼び出しを囲んで実際の値を測定してください。サービスでは /sys/fs/cgroup/system.slice/moli.service/memory.peak を確認し、観測した最大値を超えるように MemoryMax を設定します。

ポート 9222 をインターネットに公開しても安全ですか?

いいえ。CDP には認証がないため、そのポートに到達できるユーザーは誰でもブラウザーを操作し、ブラウザーから到達できるあらゆる情報を読み取れます。--host 127.0.0.1 を維持し、別のマシンから SSH トンネルまたはプライベート VPN インターフェース経由でエンドポイントに接続してください。別のアドレスに bind する必要がある場合は、プライベートインターフェースに割り当て、ファイアウォールでアクセスを制御します。

スクリーンショットが空になる、またはクリックしても何もない場所に移動するのはなぜですか?

レイアウトはデフォルトで無効です。README ではデフォルトポリシーとして LayoutPolicy::Mock が指定されているため、要素のジオメトリが実際のものにならず、ページ上のボックスに依存する処理が機能しません。moli serve --layout でサーバーを起動するか、moli fetch に --layout を追加してください。これでスクリーンショットと座標による操作が機能します。画像が表示されない場合は別のフラグが原因で、--resource を確認します。

どのバージョンの Moli をインストールすべきですか?

1 つのバージョンに固定し、使用したバージョンを記録してください。2026 年 11 月 16 日時点の最新リリースは 1.1.25 ですが、このガイドのコマンドは 1.1.18 に固定されています。プロジェクトの Lexbench スコアは 0.1.1 で測定されています。そのため、他のユーザーと結果を比較する前にバージョンを確認してください。対象タグの moli-x86_64-unknown-linux-gnu.tar.gz をダウンロードし、取得したタグではなく最新リリースを解決する shell installer に頼らず、自分でバイナリをインストールしてください。その後、moli --version で確認します。

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