آموزش نصب و میزبانی Moli به عنوان مرورگر سبک برای ایجنتها
مرورگر Moli جایگزین سبک برای Chrome در VPSهای کوچک است. با اجرای دستور moli serve و اتصال Playwright به پورت 9222، مصرف منابع را کاهش دهید و محدودیتهای آن را بشناسید.
یک مرورگر بدون رابط کاربری (headless) مناسب برای VPSهای کوچک
Moli یک مرورگر headless برای ایجنتهای هوش مصنوعی است و به اندازهای سبک است که میتوان آن را روی VPSهایی که فضای کافی برای اجرای headless Chrome ندارند، میزبانی کرد. این یک موتور مرورگر است که با زبان Rust نوشته شده و یک wrapper برای Chromium نیست؛ همچنین از پروتکل Chrome DevTools Protocol (CDP) پشتیبانی میکند، همان پروتکلی که کتابخانه اتوماسیون شما هماکنون از آن استفاده میکند. شما تنها یک فایل باینری را نصب میکنید، moli serve را اجرا میکنید و سپس Playwright یا کد ایجنت خود را به http://127.0.0.1:9222 متصل میکنید.
پیش از نصب، حتماً محدودیتها را مطالعه کنید. این پروژه دامنه کاری خود را بهصراحت بیان کرده است: بدون رابط کاربری گرافیکی (GUI)، بدون GPU compositor، بدون برابری پیکسلبهپیکسل با Chrome و بدون پشتیبانی از Canvas/WebGL/media با کیفیت بالا. صفحاتی که به این قابلیتها نیاز دارند، با خطا مواجه خواهند شد. استفاده از Chrome واقعی در Playwright همچنان گزینه جایگزین (fallback) باقی میماند و بخش آخر به شما نشان میدهد که چگونه تشخیص دهید کدام صفحات به آن نیاز دارند.
تمام دستورات زیر از فایل README پروژه و فایلهای آموزشی منتشرشده آن استخراج شده و در تاریخ 16 November 2026 بر اساس نسخه پینشده، بازبینی شدهاند. تمام اعداد موجود در جداول، ارقامی هستند که خود پروژه درباره موتور خود منتشر کرده است و نه اندازهگیریهای این سایت؛ توضیحات هر جدول نیز به این موضوع اشاره دارد. اگر هنوز در حال انتخاب موتور مناسب هستید، بررسی جامعتر مرورگرهای headless برای ایجنتها روی VPS گزینههای جایگزین را پوشش میدهد.
چرا Chrome بدون رابط کاربری (headless) حافظه زیادی مصرف میکند؟
Chrome یک مرورگر چند-پردازشی است. این مرورگر اسناد را بر اساس سایت گروهبندی میکند و در نسخه دسکتاپ لینوکس، قابلیت Site Isolation کامل باعث میشود هر سایت، شامل iframeهای بینسایتی، در پردازشهای رندرکننده (renderer) اختصاصی خود اجرا شوند. Chrome میتواند به صفحات همسایت اجازه دهد از یک رندرکننده مشترک استفاده کنند، اما نشستی که چندین سایت را باز میکند همچنان چندین پردازش اجرا میکند و هر رندرکننده، V8 heap و بافرهای گرافیکی مخصوص به خود را دارد. این طراحی برای دسکتاپ مناسب است، جایی که کرش کردن یک صفحه نباید کل پنجره را از کار بیندازد. در یک VPS با 2 گیگابایت رم، این یعنی یک مرحله مرور ساده میتواند حافظه بیشتری نسبت به برنامهای که واقعاً در حال اجرای آن هستید، اشغال کند.
این پروژه 192 آدرس عمومی متنوع را با چهار موتور مختلف خزش (crawl) کرد و نتایج را منتشر نمود.
دادههای پشت این نمودار
[
{
"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
}
]نسخه Headless مرورگر Chrome تعداد 101 صفحه مفید و Moli تعداد 103 صفحه مفید را بازگرداند؛ بنابراین در این نمونه، هر دو موتور سهم تقریباً یکسانی از وب را خواندند. تفاوت اصلی در مصرف حافظه است: میانه RSS (اندازه مجموعه مقیم، یعنی حافظهای که یک پردازش واقعاً در RAM نگه میدارد) برای Chrome برابر با 773 مگابایت و برای Moli برابر با 73 مگابایت است. این روند منطقی است زیرا مستقیماً از معماری پردازشی آنها ناشی میشود. نباید فرض کنید که نسبت دقیق در صفحات شما نیز همینگونه خواهد بود.
عددی که به شما آسیب میزند میانه نیست، بلکه اوج مصرف (Peak) است. وقتی یک سرور 2 گیگابایتی با کمبود حافظه مواجه میشود، هسته سیستمعامل یک پردازش را انتخاب و آن را متوقف (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عامل (agent) شما هرگز آن خط را نمیبیند. آنچه میبیند مرورگری است که پاسخدهی را متوقف کرده، که معمولاً به صورت خطای Playwright مانند page.goto: Page crashed یا یک هدف (target) بسته شده ظاهر میشود. هیچچیز در آن خطا به حافظه اشاره نمیکند، به همین دلیل است که وقتی یک عامل بهطور تصادفی روی یک سرور کوچک شکست میخورد، OOM (خروج از حافظه) killer اولین چیزی است که باید بررسی کنید. تعیین ابعاد برای اوج مصرف، همان تمرینی است که در انتخاب RAM و CPU برای VPS عامل توضیح داده شده است.
نصب باینری Moli با نسخه ثابت
این پروژه یک نصبکننده shell و فایلهای tarball از پیش ساختهشده را در GitHub releases منتشر میکند. تا تاریخ 16 نوامبر 2026، جدیدترین نسخه 1.1.25 است که در 15 نوامبر 2026 منتشر شده است؛ دستورات زیر همچنان روی نسخه 1.1.18 ثابت (pin) شدهاند. این پروژه امتیاز Lexbench خود را که در ادامه این راهنما ذکر شده، روی نسخه 0.1.1 اندازهگیری کرده است و فایل README نسخهای که سایر ارقام بر اساس آن محاسبه شدهاند را مشخص نمیکند. تمام این ارقام را به عنوان شمای کلی موتور در نظر بگیرید، نه تعهدی درباره نسخهای که نصب میکنید.
نسخه را ثابت کنید. نصبکنندهای که همیشه latest را فراخوانی میکند، در بازسازی بعدی، عامل (agent) شما را به یک موتور مرورگر متفاوت منتقل میکند و تغییر در رفتار مرورگر، تغییری است که باید برای آن برنامهریزی کنید، نه اینکه بهطور تصادفی با آن مواجه شوید.
نصبکننده 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 استفاده میکند، بنابراین هر دو طرح VPS مبتنی بر Arm و x86 پوشش داده میشوند. برای نصب در مسیری دیگر، MOLI_INSTALL_DIR را تنظیم کنید. توجه کنید که اسکریپت برای نسخه چه چیزی را فراخوانی میکند: جدیدترین نسخه منتشر شده، نه تگی که اسکریپت را از آن دریافت کردهاید. این برای بررسی اولیه مناسب است اما برای بازسازیهایی که میخواهید تکرارپذیر باشند، اشتباه است.
بنابراین برای هر مورد دائمی، کاری که نصبکننده انجام میدهد را بهصورت دستی انجام دهید و آرشیو دقیق را خودتان نامگذاری کنید. این همچنین روشی است که با آن باینری را در جایی قرار میدهید که سرویس سیستم به آن دسترسی داشته باشد و از pipe کردن اسکریپت دانلود شده به 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
بسیاری از وظایفی که یک agent به مرورگر محول میکند، از نوع «این URL را بارگذاری کن و بگو چه محتوایی دارد» هستند. این کار اصلاً نیازی به سرور ندارد. moli fetch موتور را اجرا میکند، یک صفحه را بارگذاری میکند، یک artifact را در خروجی استاندارد مینویسد و خارج میشود؛ بنابراین هیچ چیزی بین فراخوانیها در حافظه باقی نمیماند.
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 ارزانترین فرمتی است که میتوان به یک مدل داد، زیرا markupها را حذف کرده و فقط متن را نگه میدارد. semantic_tree_text نقشها و ساختار را حفظ میکند که برای صفحات متکی بر ناوبری، جایی که لینکها به اندازه متن اهمیت دارند، مناسب است. --dump json وضعیت HTTP و ردپای درخواست را به همراه دارد؛ بنابراین زمانی که یک fetch خالی برمیگردد و نیاز دارید دلیل آن را بدانید، از آن استفاده کنید.
استراتژی انتظار تعیین میکند که محتوا دریافت میکنید یا یک پوسته خالی. --wait-until networkidle به محض آرام شدن شبکه برمیگردد. --wait-until domstable زمانی برمیگردد که DOM دیگر تغییر نکند؛ این گزینه برای صفحاتی که در پسزمینه polling انجام میدهند و هرگز واقعاً آرام نمیشوند، انتخاب بهتری است. --wait-selector منتظر یک selector خاص میماند که شما تعیین میکنید. این تنها استراتژی است که درباره صفحهای که در حال دریافت آن هستید اطلاعات دارد و به همین دلیل، هرگاه هدف را میشناسید، مطمئنترین گزینه است.
اسکرینشات و PDF به layout واقعی نیاز دارند و layout بهصورت پیشفرض غیرفعال است:
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 سیاست پیشفرض layout را LayoutPolicy::Mock نامگذاری میکند: هندسه صفحه شبیهسازی میشود و چیزی ترسیم (paint) نمیشود، زیرا layout و paint بخش پرهزینه کار مرورگر هستند. آن پیشفرض دلیل ارقام حافظه ذکر شده در بالا است. همچنین به این معنی است که یک PNG خالی معمولاً به دلیل نبود پرچم --layout است، نه خرابی صفحه.
برای URLهایی که agent شما پیدا کرده است (نه URLهایی که خودتان انتخاب کردهاید)، از --block-private-networks استفاده کنید. agentای که لینکهای خواندهشده در یک صفحه را دنبال میکند، ممکن است به سمت دریافت http://169.254.169.254/ برای اعتبارسنجیهای ابری یا پورت دیتابیس روی localhost هدایت شود که هرگز قرار نبوده در معرض وب باشد. این پرچم آدرسهای خصوصی را برای درخواستهای مستقیم مسدود میکند و --block-cidrs محدودههای مسدودشده خاصی را اضافه میکند؛ اهدافی که توسط پروکسی حل میشوند باید توسط خود پروکسی فیلتر شوند. زمانی که وظیفه به جای خواندن یک صفحه، خزیدن (crawling) در سایت است، شکل آن خط لوله در جایگزینهای self-hosted برای Firecrawl بررسی شده است و مرحله پیش از آن، یعنی یافتن URLها، در مهارت جستجوی مبتنی بر SearXNG برای agentها پوشش داده شده است.
اتصال یک عامل (Agent) به Moli از طریق CDP
برای عاملی که در مراحل مختلف پیمایش کرده و کلیک میکند، بهجای آن از سرور استفاده کنید.
moli serve --host 127.0.0.1 --port 9222مقدار 127.0.0.1 و پورت 9222 مقادیر پیشفرض هستند، بنابراین یک moli serve ساده بهطور پیشفرض فقط به loopback متصل میشود. با این حال، در هر پیکربندی دائمی، هر دو را بهطور کامل بنویسید؛ چرا که نفر بعدی که فایل سرویس شما را میخواند، نباید مجبور باشد مقادیر پیشفرض را به خاطر بسپارد.
پیش از اتصال کلاینت، سرور را بررسی کنید:
curl -s http://127.0.0.1:9222/json/versionیک سرور سالم با یک شیء JSON پاسخ میدهد که حاوی فیلد webSocketDebuggerUrl است؛ این همان URL است که کلاینت CDP به آن متصل میشود. خطای curl: (7) Failed to connect to 127.0.0.1 port 9222: Connection refused به این معناست که هیچ سرویسی در حال گوش دادن نیست؛ بنابراین ترمینالی که آن را در آن اجرا کردهاید بررسی کنید، یا اگر به صورت سرویس است، از journalctl -u moli -n 50 استفاده کنید. دستور /json/list اهداف (targets) باز را فهرست میکند و /json/protocol دامنههایی را که این بیلد پیادهسازی کرده است نشان میدهد؛ این روشی است که متوجه شوید آیا متد 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 تأثیری ندارند. به همین دلیل، تنظیمات پروکسی، کوکی و user-agent باید به عنوان فلگهای خودِ سرور Moli اعمال شوند. انتظار پوشش کامل پروتکل Chrome را نداشته باشید و تنها بخشی از CDP را در نظر بگیرید: خطای صریح unsupported-method نشاندهنده محدودیت موتور است، نه باگ در کد شما.
دو فلگ سرور تعیین میکنند که عامل چه کارهایی میتواند انجام دهد. --layout هندسه واقعی را فعال میکند که برای کلیک بر اساس مختصات و اسکرینشاتها ضروری است. --resource تصاویر، فونتها و رسانههای اختیاری را دریافت میکند؛ این کار باعث مصرف پهنای باند و حافظه در هر بار بارگذاری صفحه میشود، بنابراین تا زمانی که صفحه واقعاً به آنها نیاز نداشته باشد، آن را غیرفعال نگه دارید. --profile-dir کوکیها و حافظه را بین اجراها حفظ میکند و بدون آن، هر اجرا کاملاً مستقل و موقتی خواهد بود.
دادههای پشت این نمودار
[
{
"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
}
]در نمونه بار کاری عامل پروژه، Moli اتصال CDP را پس از 34.85 میلیثانیه پذیرفت، در حالی که این زمان برای Chromium برابر با 169.37 میلیثانیه بود. حداکثر PSS (اندازه تناسبی مجموعه، حافظهای که با تقسیم صفحات مشترک بین پردازشهای استفادهکننده محاسبه میشود) برابر با 102.46 MiB در مقابل 348.82 MiB بود. تفاوت ساختاری در ستون آخر نهفته است: 1 پردازش در مقابل 11 پردازش. یک پردازش، یک موجودیت واحد برای نظارت توسط systemd و یک cgroup برای محدودسازی است؛ همین موضوع باعث میشود بخش بعدی کوتاه باشد.
اجرای moli serve به عنوان یک سرویس systemd روی loopback
هنگامی که یک عامل (agent) به مرورگری نیاز دارد که در انتظار آن باشد، سرور را به عنوان یک سرویس اجرا کنید. در غیر این صورت، همچنان از moli fetch به ازای هر URL استفاده کنید، زیرا سرورِ بیکار همچنان حافظه را اشغال میکند.
پورت 9222 را روی رابط عمومی (public interface) قرار ندهید. پروتکل CDP هیچگونه مرحله احراز هویتی ندارد. هر کسی که به آن پورت دسترسی داشته باشد، میتواند مرورگر را کنترل کرده و هر چیزی که مرورگر به آن دسترسی دارد، از جمله کوکیهای موجود در دایرکتوری پروفایل شما را بخواند. آن را روی 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.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 مربوط به discovery را بازگرداند. ProtectSystem=strict سیستم فایل را به جز فایلسیستمهای API و موارد استثنای پیکربندیشده، فقطخواندنی (read-only) میکند؛ StateDirectory=moli مسیر /var/lib/moli را ایجاد میکند که متعلق به کاربر سرویس است و آن را قابلنوشتن نگه میدارد. با PrivateTmp=yes، مسیرهای /tmp و /var/tmp خصوصیِ unit نیز قابلنوشتن هستند. unitای که شروع میشود و سپس با خطای مجوز در journalctl -u moli متوقف میشود، تقریباً همیشه در حال تلاش برای نوشتن در جایی است که ProtectSystem آن را فقطخواندنی کرده است؛ بنابراین آن مسیر را به زیر دایرکتوری state منتقل کنید.
MemoryMax=768M میزان استفاده از حافظه unit را محدود میکند. unit دارای cgroup اختصاصی خود میشود و هنگامی که میزان استفاده به حد مجاز برسد، هسته (kernel) تلاش میکند حافظه را بازیابی کند. اگر میزان استفاده کاهش نیابد، OOM killer در داخل همان cgroup فراخوانی میشود و فرآیندهای خارج از آن را نمیکشد. ژورنال این توقف را ثبت میکند:
moli.service: A process of this unit has been killed by the OOM killer.این خط را به عنوان یک سیگنال برای تعیین اندازه (sizing) بخوانید. یا صفحات (pages) سنگینتر از آن چیزی هستند که برنامهریزی کرده بودید، یا حد مجاز بسیار پایین است. عدد را بر اساس اندازهگیری صفحات خود تنظیم کنید، که موضوع بخش بعدی است. Accounting میزان استفاده را اندازهگیری میکند؛ کنترلهای جداگانهای مانند MemoryMax و CPUQuota محدودیتهایی را بر سایر سرویسها اعمال میکنند و محدود کردن حافظه و CPU با systemd سایر موارد را پوشش میدهد.
اندازهگیری اوج مصرف حافظه توسط خودتان
ارقام منتشرشده از سختافزار و صفحات وب دیگران بهدست آمدهاند. اوج مصرف حافظه تعیین میکند که آیا سرور شما دوام میآورد یا خیر، و این مقدار کاملاً به آنچه بارگذاری میکنید بستگی دارد. پیش از تعیین ابعاد سرور، اندازهگیری کنید.
برای دریافتهای تکمرحلهای (one-shot)، از باینری time استفاده کنید که گزارش بسیار دقیقتری نسبت به دستور داخلی (builtin) شل با همان نام ارائه میدهد:
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 صفحهای که عامل (agent) شما واقعاً بازدید میکند اجرا کنید، نه روی example.com؛ و بهجای میانگین، بدترین نتیجه را در نظر بگیرید، زیرا OOM killer به اوجهای مصرف واکنش نشان میدهد.
برای سرویس، شمارندهای را بخوانید که هسته (kernel) از قبل برای cgroup آن نگه میدارد:
cat /sys/fs/cgroup/system.slice/moli.service/memory.peak
systemd-cgtop -mmemory.peak یک شمارش بایت است و نشاندهنده بالاترین حد ثبتشده (high-water mark) از زمان ایجاد 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 در 237 مورد از 1,308 وظیفهٔ انتخابشده شکست خورد، یعنی تقریباً از هر پنج مورد، یک مورد. اگر عامل (agent) شما از مجموعه صفحات ثابتی بازدید میکند که تحت کنترل شما هستند، این نسبت اطلاعات کمی به شما میدهد؛ زیرا صفحات شما یا کار میکنند یا نمیکنند و میتوانید همین امروز بعدازظهر این موضوع را بررسی کنید. این گزارش مشاهدات را توصیف میکند، نه سقف تواناییها را؛ بنابراین آن شکستها به معنای عدم پشتیبانی از ویژگیها یا نرخ شکست در وب عمومی نیستند.
دامنهٔ کاری مشخصشده توسط پروژه، بارهایی (workloads) را تعیین میکند که باید با Chrome بررسی شوند:
- برنامههایی که به رندرینگ Canvas با دقت بالا نیاز دارند؛ Moli عملیات ترسیم Canvas را پیادهسازی میکند، بنابراین Canvas به تنهایی دلیلی برای نیاز به Chrome نیست.
- هر چیزی که به WebGL با دقت بالا یا GPU compositing نیاز دارد، زیرا هیچ GPU compositorای وجود ندارد.
- پخش رسانههای سنگین.
- تستهای بصری که اسکرینشاتهای دقیق پیکسلی را در برابر Chrome تأیید میکنند، زیرا برابری با Chrome هدف پروژه نیست.
رقم دیگری که پروژه ذکر میکند، یعنی عبور از 1.612 میلیون تست پلتفرم وب در یک اجرای کامل، بیانیهای دربارهٔ پوشش استانداردها است. این یک تضمین برای سایتهایی که عامل شما از آنها بازدید میکند، نیست. یک صفحه میتواند فقط از استانداردهای کاملاً پشتیبانیشده استفاده کند و همچنان در بررسیهای ضد ربات شکست بخورد، و هیچ امتیاز موتوری این مورد را پوشش نمیدهد.
بنابراین، قابلیت بازگشت به حالت قبل (fallback) را در طراحی خود حفظ کنید. ابتدا هر URL را به Moli بفرستید. زمانی که صفحه خالی بازگشت یا یک selector هرگز ظاهر نشد، آن URL خاص را دوباره با Playwright و هدایت Chrome واقعی، روی یک ماشین بزرگتر یا در زمانبندیای که یک پردازش 773 MiB در آن مقرونبهصرفه است، امتحان کنید. اکثر عاملها بیشترین زمان خود را در صفحات معمولی صرف میکنند، بنابراین موتور کوچک حجم اصلی کار را بر عهده میگیرد و موتور گرانقیمت موارد خاص و دشوار را مدیریت میکند.
FAQ
آیا Moli میتواند جایگزین headless Chrome برای ایجنت من باشد؟
برای خواندن صفحات، استخراج متن و کلیکهای معمولی، معمولاً بله. در بنچمارک اختصاصی این پروژه با 1308 تسک، این ابزار به نرخ موفقیت 81.88 درصد در برابر 99.85 درصد برای Chrome دست یافته است که منجر به 237 تسک ناموفق در نسخه 0.1.1 Moli شده است؛ این مشاهدات به این معنا نیست که هر شکست لزوماً به دلیل عدم پشتیبانی از یک قابلیت خاص است. پخش با کیفیت بالای Canvas/WebGL/media خارج از محدودهٔ تعریفشدهٔ پروژه است، اما صرف استفاده از Canvas باعث ناسازگاری یک برنامه نمیشود. URLهایی که در بررسیهای شما شکست میخورند را به جای بازگرداندن کل سیستم به Chrome واقعی، به همان Chrome هدایت کنید.
Moli روی یک VPS به چه مقدار RAM نیاز دارد؟
این پروژه میانگین RSS برابر با 73 MiB را در یک crawl با 192 URL و حداکثر PSS برابر با 102.46 MiB را در یک نمونه اپیزود ایجنت گزارش میدهد، در حالی که این مقدار برای headless Chrome برابر با 773 MiB است. اینها اعداد گزارششده در مستندات خودشان هستند. مقادیر مصرفی خود را با استفاده از /usr/bin/time -v در اطراف یک فراخوانی moli fetch برای استفاده one-shot اندازه بگیرید، یا برای سرویس، /sys/fs/cgroup/system.slice/moli.service/memory.peak را بخوانید، سپس MemoryMax را بالاتر از بدترین عددی که مشاهده کردید تنظیم کنید.
آیا باز گذاشتن پورت 9222 روی اینترنت امن است؟
خیر. پروتکل CDP فاقد احراز هویت است، بنابراین هر کسی که به این پورت دسترسی داشته باشد میتواند مرورگر شما را کنترل کرده و هر چیزی که مرورگر به آن دسترسی دارد را بخواند. پورت را روی --host 127.0.0.1 نگه دارید و از طریق یک SSH tunnel یا یک رابط VPN خصوصی از دستگاه دیگری به endpoint متصل شوید. اگر مجبور به bind کردن روی آدرس دیگری هستید، آن را روی یک رابط خصوصی قرار دهید و دسترسی را با فایروال کنترل کنید.
چرا اسکرینشات من خالی است یا کلیکهایم به هدف نمیخورند؟
Layout بهصورت پیشفرض غیرفعال است. فایل README سیاست پیشفرض را LayoutPolicy::Mock نامگذاری کرده است، بنابراین هندسه عناصر واقعی نیست و هر چیزی که به موقعیت یک کادر در صفحه وابسته باشد، دادهای برای پردازش ندارد. سرور را با moli serve --layout شروع کنید یا --layout را به moli fetch اضافه کنید تا اسکرینشات و مسیرهای مختصات شروع به کار کنند. تصاویر گمشده مربوط به یک فلگ متفاوت هستند: --resource.
کدام نسخه از Moli را باید نصب کنم؟
یک نسخه را انتخاب و آن را ثبت کنید. تا تاریخ 16 نوامبر 2026، جدیدترین نسخه منتشر شده 1.1.25 است؛ دستورات این راهنما روی نسخه 1.1.18 ثابت شدهاند. امتیاز Lexbench پروژه روی نسخه 0.1.1 اندازهگیری شده است، بنابراین پیش از مقایسه نتایج با دیگران، نسخهها را با هم تطبیق دهید. فایل moli-x86_64-unknown-linux-gnu.tar.gz مربوط به آن تگ را دانلود کنید و به جای تکیه بر shell installer، باینری را شخصاً نصب کنید؛ چرا که shell installer به جای تگی که دریافت کردهاید، جدیدترین نسخه را نصب میکند. سپس با moli --version نصب را تأیید کنید.