小型 VPS 如何自托管 Moli 无头浏览器
在小型 VPS 上安装 Moli,将 CDP 绑定到回环地址并连接 AI 代理。了解它为何比无头 Chrome 更省内存,以及不支持高保真 Canvas 和媒体播放的页面。
适合小型 VPS 的无头浏览器
Moli 是供 AI agent 使用的无头浏览器,体积足够小,可以自行部署在无法容纳无头 Chrome 的 VPS 上。它是使用 Rust 编写的浏览器引擎,不是 Chromium 的封装层,并且支持 Chrome DevTools Protocol(CDP),也就是您的自动化库已经使用的协议。您只需安装一个二进制文件,运行 moli serve,然后让 Playwright 或您自己的 agent 代码连接到 http://127.0.0.1:9222。
安装前请先了解取舍。该项目明确说明了自身的适用范围:不提供 GUI 浏览器、不使用 GPU 合成器、不保证与 Chrome 逐像素一致,也不支持高保真的 Canvas/WebGL/媒体播放。依赖这些功能的页面会失败。在 Playwright 中使用真实 Chrome 仍然是备用方案,最后一节将说明如何判断哪些页面需要它。
下面的每条命令都来自该项目的 README 和已发布的 skill 文件,并已于 16 November 2026 根据固定版本再次核对。图表中的每个数字都是项目发布的、关于其自身引擎的数据,不是本网站测量所得;每个图表标题都会对此作出说明。如果您仍在选择浏览器引擎,请参阅更全面的 面向 agent 的 VPS 无头浏览器 调研,了解其他方案。
为什么 Headless Chrome 会占用大量内存?
Chrome 是一个多进程浏览器。它按站点对文档进行分组,在桌面版 Linux 上,完整的站点隔离(Site Isolation)会将每个站点(包括跨站 iframe)保留在各自的渲染进程中。Chrome 允许同站页面共享一个渲染器,但如果一个会话涉及多个站点,仍会运行多个渲染进程,且每个渲染器都有自己的 V8 堆内存和图形缓冲区。这种设计适用于桌面环境,因为单个页面崩溃不应导致整个窗口关闭。但在 2 GB 的 VPS 上,这意味着单次浏览操作消耗的内存可能超过你实际运行的应用程序。
该项目使用四种引擎爬取了 192 个混合公共 URL 并发布了结果。
此图表背后的数据
[
{
"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 个,因此在该样本中,两个引擎读取的网页比例大致相同。内存占用是两者产生差异的地方:Chrome 的中位数 RSS(常驻内存集,即进程实际持有的 RAM)为 773 MiB,而 Moli 为 73 MiB。这一趋势是可信的,因为它源于各自的进程架构。对于你的页面,不应假定两者的确切比例相同。
中位数并不是最棘手的指标,峰值才是。当 2 GB 的服务器内存耗尽时,内核会挑选一个进程并将其杀死,记录会出现在 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你的代理程序永远看不到那一行日志。它只会看到浏览器停止响应,通常表现为 Playwright 错误,例如 page.goto: Page crashed 或目标已关闭。错误信息中未提及内存,这就是为什么当代理程序在小型服务器上随机失败时,首先要检查 OOM(内存溢出)杀手的原因。针对峰值进行容量规划,与 为代理 VPS 选择 RAM 和 CPU 是同样的任务。
安装 Moli 二进制文件,并固定到一个版本
该项目会在 GitHub releases 上提供 Shell 安装脚本和预构建 tarball。截至 16 November 2026,最新版本是 1.1.25,于 15 November 2026 发布;下面的命令仍固定使用 1.1.18。该项目在 0.1.1 上测得本指南后文引用的 Lexbench 分数,但 README 没有说明其他数据对应的版本。请将这些数据视为引擎的大致性能特征,而不要视为对所安装构建版本的保证。
固定版本。始终解析到 latest 的安装程序会在下次重新构建时将您的代理切换到另一个浏览器引擎,而浏览器行为变化应当提前安排,而不是等到发生后才发现。
Shell 安装脚本是最快的入门方式,但应先阅读,再运行。
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 可将其安装到其他位置。注意它解析的版本:这是最新版本,而不是您获取脚本时使用的标签。初步查看时这样没有问题,但对于需要可重复执行的重新构建则不合适。
因此,对于任何永久部署,请手动执行安装程序的操作,并自行指定准确的归档文件。这样还可以将二进制文件放到系统服务能够访问的位置,并避免将下载的脚本通过管道传给 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 --versionmoli --version 输出您固定的版本,这就是完整的检查。安装程序之后立即执行 moli: command not found,表示安装目录不在您的 PATH 中;安装程序会输出一行信息,指出需要添加的目录。
使用 moli fetch 一次性提取
代理交给浏览器的许多任务都是“加载这个 URL,然后告诉我其中写了什么”。这类任务完全不需要服务器。moli fetch 启动引擎,加载一个页面,将一个结果写入标准输出后退出,因此多次调用之间不会占用内存。
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第一个命令以 Markdown 格式输出页面,并以 # Example Domain 开头。Markdown 会去除标记并保留文本,因此最适合交给模型。semantic_tree_text 会保留角色和结构。对于链接与正文同样重要、包含大量导航内容的页面,应使用此格式。--dump json 会包含 HTTP 状态和请求跟踪信息。抓取结果为空且需要查明原因时,应使用它。
等待策略决定返回的是内容还是空壳。--wait-until networkidle 会在网络连接变为空闲后返回。--wait-until domstable 会在 DOM 停止变化后返回。对于在后台轮询、因此始终无法进入空闲状态的页面,这是更好的选择。--wait-selector 会等待指定的选择器。它是唯一了解所抓取页面内容的策略。如果知道目标元素,应优先使用它,因为可靠性最高。
截图和 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.pdfREADME 将默认布局策略标为 LayoutPolicy::Mock:系统会模拟几何信息但不执行绘制,因为布局和绘制是浏览器中开销较大的部分。上面的内存数据之所以如此,原因就在于此。也就是说,PNG 为空通常是因为缺少 --layout 标志,而不是页面损坏。
对于代理发现而不是手动选择的 URL,应添加 --block-private-networks。代理跟随页面中读取到的链接时,可能会被引导去请求 http://169.254.169.254/ 中的云实例凭据,或请求 localhost 上原本不应暴露到 Web 的数据库端口。此标志会阻止直接连接请求访问私有地址,--block-cidrs 则会添加指定的阻止地址范围;通过代理解析出的目标必须由代理进行过滤。需要执行爬取而不是读取单个页面时,请参阅自托管 Firecrawl 替代方案;而在此之前,关于如何发现 URL,请参阅基于 SearXNG 的代理搜索技能。
通过 CDP 为 agent 连接 Moli
对于需要执行多步导航和点击的 agent,应改为运行服务器。
moli serve --host 127.0.0.1 --port 9222127.0.0.1 和端口 9222 是默认值,因此直接使用 moli serve 时也只会绑定到 loopback。对于任何持久化配置,仍应明确写出这两个参数。这样下一个查看服务文件的人不必记住默认值。
在将客户端连接到服务器前,先检查服务器:
curl -s http://127.0.0.1:9222/json/version正常运行的服务器会返回一个包含 webSocketDebuggerUrl 字段的 JSON 对象。CDP 客户端会连接到该字段中的 URL。curl: (7) Failed to connect to 127.0.0.1 port 9222: Connection refused 表示没有进程正在监听,因此应查看启动服务器的终端;如果服务器已作为服务运行,则使用 journalctl -u moli -n 50。/json/list 列出已打开的目标,/json/protocol 列出此构建实现的域。通过这两个命令,可以确认所依赖的 CDP 方法是否存在。
Playwright 会连接到该端点,而不是自行启动浏览器:
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)都没有可作用的进程。代理、Cookie 和 user-agent 设置也应作为 Moli 服务器自身的参数传入,原因相同。应将其视为部分 CDP 支持,而不是完整的 Chrome 协议:明确返回的“不支持方法”错误表示引擎的边界,不是代码错误。
两个服务器参数决定 agent 可以执行的操作。--layout 会启用真实几何信息,这是坐标点击和截图所需的功能。--resource 会获取可选的图像、字体和媒体。它会在每次加载页面时消耗带宽和内存,因此除非页面证明确实需要这些资源,否则应保持关闭。--profile-dir 会在多次运行之间保留 Cookie 和存储数据;不启用它时,每次运行都是一次性的。
此图表背后的数据
[
{
"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
}
]在项目的示例 agent 工作负载中,Moli 建立 CDP 连接耗时 34.85 ms,而 Chromium 耗时 169.37 ms;峰值 PSS(比例集大小,即在共享页面的进程之间拆分计算共享页面内存后的内存占用)为 102.46 MiB,而 Chromium 为 348.82 MiB。结构上的差异体现在最后一列:Moli 使用 1 个进程,而 Chromium 使用 11 个进程。一个进程意味着 systemd 只需监督一个对象,一个 cgroup 只需设置一项上限,因此下一节可以保持简短。
在 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。
创建服务用户,然后创建单元文件:
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.targetsudo systemctl daemon-reload
sudo systemctl enable --now moli.service
systemctl status moli.service
curl -s http://127.0.0.1:9222/json/versionsystemctl status 应显示 active (running),而 curl 应返回发现 JSON。ProtectSystem=strict 会使文件系统只读,但 API 文件系统和配置的例外项除外;StateDirectory=moli 会创建 /var/lib/moli,将其所有者设为服务用户,并保持可写。使用 PrivateTmp=yes 后,单元的私有 /tmp 和 /var/tmp 也可写。如果单元启动后因 journalctl -u moli 中的权限错误退出,几乎总是因为它尝试写入 ProtectSystem 刚刚设为只读的路径,因此应将该路径移到状态目录下。
MemoryMax=768M 会限制单元的内存使用量。该单元拥有独立的 cgroup;当使用量达到限制时,内核会尝试回收内存。如果无法降低使用量,OOM killer 会在该 cgroup 内运行,不会终止其外部的进程。日志中会记录一次终止操作:
moli.service: A process of this unit has been killed by the OOM killer.将该行视为容量设定信号。可能是页面占用的内存超过预期,也可能是限制过低。应根据自有页面的测量结果设置该数值,下一节将介绍测量方法。记账功能会测量使用量;MemoryMax 和 CPUQuota 等独立控制项会限制其他服务,使用 systemd 限制内存和 CPU 会通过其余控制项实现。
自行测量峰值内存
已发布的数据来自其他人的硬件和页面。峰值内存决定服务器能否正常运行,而峰值完全取决于实际加载的内容。请先测量,再确定资源规格。
对于一次性抓取,请使用 time 二进制文件。它报告的信息远多于同名的 shell 内置命令:
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)。将其除以 1024,换算为 MiB。请让它抓取代理实际访问的 10 个页面,而不是抓取 example.com,并保留最差结果而非平均值,因为 OOM killer 会根据峰值采取行动。
对于服务,请读取内核已经为其 cgroup 维护的计数器:
cat /sys/fs/cgroup/system.slice/moli.service/memory.peak
systemd-cgtop -mmemory.peak 是字节数,也是自创建 cgroup 以来的高水位值;只有重新创建 cgroup 后,服务重启才会重置该值。MemoryMax 必须高于这个数值,并为尚未访问过的最重页面预留额外空间。systemd-cgtop -m 显示每个单元的实时使用量,这是查看当前服务器上哪个服务最耗资源的最快方法。
Moli 在哪里会失败?什么时候仍然需要 Chrome?
该项目还针对 1,308 个可比的浏览器自动化任务运行基准测试,并发布多个引擎的得分。
此图表背后的数据
[
{
"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 个失败,约占五分之一。如果您的代理只访问一组固定且由您控制的页面,这个比例说明不了多少,因为这些页面要么能正常工作,要么不能,您可以在今天下午确认。该报告描述的是观测结果,而不是能力上限,因此这些失败不能证明某些功能不受支持,也不能代表开放网络上的失败率。
项目声明的范围指出,以下工作负载应使用 Chrome 进行检查。
- 需要高保真 Canvas 渲染的应用;Moli 已实现 Canvas 绘图操作,因此仅使用 Canvas 不能证明需要 Chrome
- 任何需要高保真 WebGL 或 GPU 合成的内容,因为没有 GPU 合成器
- 要求较高的媒体播放任务
- 针对 Chrome 验证像素级精确截图的视觉测试,因为与 Chrome 保持一致并不是项目目标
项目引用的另一个数据是:一次完整运行通过了 1.612 million 个 Web 平台测试。这个数据说明的是标准覆盖范围,不是对代理将访问的网站作出的保证。某个页面可能只使用获得良好支持的标准,但仍会在机器人检查环节失败,而任何引擎得分都无法涵盖这种情况。
因此,应在设计中保留回退方案。先将每个 URL 都发送给 Moli。当页面返回空内容,或某个选择器始终未出现时,再让 Playwright 驱动真正的 Chrome 重试该 URL;可以在更大的机器上运行,也可以安排在能够承担 773 MiB 进程的时段运行。大多数代理的大部分时间都在处理普通页面,因此由小型引擎承担主要请求量,由高成本引擎处理少数疑难页面。
FAQ
Moli 能替代代理使用的无头 Chrome 吗?
如果只是读取页面、提取文本和执行普通点击,通常可以。在项目自己的 1,308 项任务基准测试中,Moli 完成了 81.88 percent,而 Chrome 为 99.85 percent;Moli 0.1.1 仍有 237 项任务失败。这些结果不能证明每次失败都需要 Moli 不支持的功能。高保真 Canvas/WebGL/媒体播放不在项目声明的范围内,但单独使用 Canvas 并不会使应用不兼容。将未通过检查的 URL 转交给真正的 Chrome,不要因此让所有流量都切回 Chrome。
Moli 在 VPS 上需要多少 RAM?
项目报告称,在一次包含 192 个 URL 的爬取中,RSS 中位数为 73 MiB;在一次示例代理运行中,PSS 峰值为 102.46 MiB,而无头 Chrome 的中位数为 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 接口从另一台机器访问该端点。如果必须绑定到其他地址,请将其绑定到私有接口,并使用防火墙控制访问。
为什么我的截图为空,或者点击没有落在任何内容上?
布局默认处于禁用状态。README 将默认策略命名为 LayoutPolicy::Mock,因此元素几何信息不是真实的,任何依赖页面元素框的位置都无法正常工作。使用 moli serve --layout 启动服务器,或将 --layout 添加到 moli fetch,这样截图和坐标相关路径就会开始正常工作。缺少图片由另一个标志控制:--resource。
我应该安装哪个版本的 Moli?
固定一个版本,并记录下来。截至 16 November 2026,最新版本为 1.1.25;本指南中的命令仍固定使用 1.1.18。项目的 Lexbench 分数是在 0.1.1 上测得的,因此与他人比较结果前,应先比较版本。下载该标签的 moli-x86_64-unknown-linux-gnu.tar.gz,然后自行安装二进制文件,不要依赖 shell 安装程序;该安装程序会解析最新版本,而不是你从中获取的那个标签。最后使用 moli --version 确认。