Lightpanda متصفح headless بلغة Zig: وكلاء الذكاء الاصطناعي والذاكرة والمراقبة

Lightpanda متصفح headless بلغة Zig متوافق مع CDP وMCP: التثبيت، وأرقام المشروع، ومقاييس Prometheus، والحدود التي يجب معرفتها قبل أي تجربة.
Lightpanda navigateur headless en Zig : agents IA, mémoire et supervision

Lightpanda متصفح headless: يقدّم مستودع lightpanda-io/browser نفسه على أنه متصفح بلا واجهة «مبني من الصفر لوكلاء الذكاء الاصطناعي والأتمتة». ليس نسخة (fork) من Chromium ولا رقعة فوق WebKit، بل محرك مكتوب بلغة Zig يضمّ V8 لتنفيذ JavaScript وhtml5ever لتحليل HTML وlibcurl للشبكة، ويتخلى عمدًا عن أي محرك عرض (rendering) رسومي. تعرض صفحة المستودع نحو 38 200 نجمة و1900 فرع في 30 أكتوبر 2026، بترخيص AGPL-3.0.

بالنسبة لمهندس موثوقية المواقع (SRE)، الفائدة ملموسة: الوكلاء الذين «يتصفحون» يتكاثرون، وكل نسخة من Chrome headless تكلّف مئات الميغابايتات. يعد Lightpanda بتشغيل سكربتات Puppeteer أو Playwright نفسها، عبر بروتوكول CDP، بجزء يسير من هذه الذاكرة. ما قيمة هذا الوعد، وكيف نراقب أسطولًا من المتصفحات التي يقودها وكلاء؟

توضيح للأمانة: لم تشغّل span.observer أداة Lightpanda. الأوامر مأخوذة من README ومن وثائق lightpanda.io؛ وأرقام الأداء هي التي نشرها المشروع، ونقدّمها على هذا الأساس؛ وأسماء المقاييس مقروءة من الشيفرة المصدرية للمستودع.

Lightpanda متصفح headless: ماذا يقول المستودع

  • الترخيص واللغة: AGPL-3.0، تم التحقق منه في ملف LICENSE في 30 أكتوبر 2026. يتطلب المشروع Zig 0.17.0 (في README وفي الحقل minimum_zig_version من ملف build.zig.zon) وسلسلة أدوات Rust لترجمة html5ever.
  • الإصدارات: تسرد صفحة الإصدارات 1.0.0 في 2 أكتوبر 2026، و1.0.1 في 15 أكتوبر، و1.0.2 في 23 أكتوبر 2026 («Latest»). ويحمل الفرع الرئيسي 1.1.0-dev. تُنشر ملفات ثنائية «nightly» لنظامي Linux وmacOS (x86_64 وaarch64)؛ ويجعلها README طريقة التثبيت الافتراضية.
  • النضج: لم يعد README يتحدث عن «beta» منذ الإصدار 1.0. غير أن صفحة المعمارية تصف تغطية واجهات Web APIs بأنها «جزئية لكنها متنامية»، وينشر المشروع يوميًا نتائجه في اختبارات Web Platform Tests على perf.lightpanda.io/wpt. ويضيف كل إصدار واجهات جديدة (Web Crypto وتحليل XML في 1.0.2): النطاق ما زال يتحرك.
  • الواجهات: خادم CDP (lightpanda serve) لأدوات Puppeteer وPlaywright وchromedp؛ وWebDriver BiDi عبر --protocol webdriver؛ وخادم MCP أصلي (lightpanda mcp)؛ ووضع agent يقوده نموذج لغوي كبير (LLM) داخل العملية نفسها؛ وأمر fetch يفرّغ صفحة بصيغة HTML أو Markdown أو JSON-LD.

جولة في المعمارية

تلخّص الوثائق النموذج في تسلسل هرمي: App واحد لكل عملية (الشبكة، مجمّع ساحات الذاكرة (arenas)، منصة V8، القياس عن بُعد)، وكائنات Browser يغلّف كل منها عزلة (isolate) من V8، وSession واحدة لكل متصفح (ملفات تعريف الارتباط، Web Storage)، ثم Page وFrame التي تحمل DOM وواجهات Web APIs.

مخطط من وثائق Lightpanda: سطح التحكم (serve وfetch وagent وmcp وHTTP API) يقود App واحدًا لكل عملية، ينشئ كائنات Browser (عزلة V8 لكل منها)، تحتوي Session ثم Page ثم Frame (DOM وWeb APIs)
Source : lightpanda.io

قراران يفسّران البصمة المنخفضة للذاكرة. غياب محرك العرض: لا تُرسم الصفحة أبدًا، وتُقدَّر مواضع العناصر تقريبيًا من DOM، ويعيد Page.captureScreenshot صورة بديلة. والساحات: تستعير الصفحة ساحة عند التحميل وتعيدها عند الإغلاق، ما يجعل تفكيكها شبه مجاني.

من جهة الأرقام، ينشر المشروع اختبار أداء (benchmark) للزحف: 933 صفحة من موقع تجريبي، وبرنامج Go يقوده chromedp، وChrome 143 في المقابل. ويستخلص README منه «ذاكرة أقل 16 مرة وسرعة أعلى 9 مرات». ويعطي المستند التفصيلي في مستودع lightpanda-io/demo القيم: عند 25 وحدة متوازية، 4.81 ثانية وذروة 123 ميغابايت لـ Lightpanda مقابل 46.70 ثانية و2.0 غيغابايت لـ Chrome.

منحنى منشور في مستودع lightpanda-io/demo: الذاكرة بالميغابايت على مدار الزحف على 933 صفحة، 25 تبويبة Chrome ترتفع حتى 2000 ميغابايت، و25 عملية Lightpanda تبقى دون 130 ميغابايت
Source : github.com

ثلاثة تحفظات واردة في المستند نفسه: كان Chrome يعمل بتبويبات داخل عملية واحدة بينما كان Lightpanda يعمل في عمليات منفصلة؛ وتُقاس الذاكرة بمقياس PSS عبر smem كل 100 مللي ثانية؛ ويذكر README مثيلًا من نوع m5.large بينما يتحدث المستند التفصيلي عن m5.xlarge. هذه قياسات المشروع، قابلة لإعادة الإنتاج بسكربتاته، وليست قياسًا مستقلًا.

التثبيت خطوة بخطوة

الخطوة 1 — الحصول على ملف ثنائي

# Linux x86_64
curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux && \
chmod a+x ./lightpanda
./lightpanda version

# macOS Apple Silicon
brew install lightpanda-io/browser/lightpanda

# Docker (serveur CDP sur 9222)
docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:latest

فخّان ينبّه إليهما README: الملفات الثنائية لنظام Linux مرتبطة بمكتبة glibc وتفشل على Alpine، ولا يوجد ملف ثنائي أصلي لنظام Windows؛ يُثبَّت داخل WSL2 الذي يمرّر localhost:9222 إلى المضيف.

الخطوة 2 — تشغيل خادم CDP

./lightpanda serve --obey-robots --log-format pretty --log-level info --host 127.0.0.1 --port 9222

من جهة Puppeteer، استبدل تشغيل Chrome بـ puppeteer.connect({ browserWSEndpoint: "ws://127.0.0.1:9222" }). وبحسب مرجع الأمر، يقبل serve افتراضيًا 16 اتصال CDP متزامنًا (--cdp-max-connections) ويعرض نقطة نهاية /metrics بصيغة Prometheus، يمكن تعطيلها عبر --disable-metrics.

الخطوة 3 — ربط وكيل عبر MCP

يتحدث خادم MCP بروتوكول JSON-RPC 2.0 عبر stdio افتراضيًا. ومع --port يخدم عدة وكلاء عبر HTTP: يتلقى كل اتصال جلسة تصفح خاصة به (صفحة، ملفات تعريف ارتباط، ذاكرة) معرَّفة بالترويسة Mcp-Session-Id. ويسرد المرجع 32 أداة، منها goto وmarkdown وextract وclick وfill وconsoleLogs وsession_new.

lightpanda mcp --port 9223
curl -s http://127.0.0.1:9223/mcp -H 'Content-Type: application/json' -d '{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "markdown", "arguments": { "url": "https://example.com" } }
}'
إعداد mcpServers من README الخاص بـ Lightpanda مع الأمر lightpanda والوسيط mcp، ثم مقتطف من أسطر HELP في الملف src/Metrics.zig: serve_active_connections وserve_commands وjs_heap_limits وjs_errors وarena_memory_bytes وjs_heap_physical_bytes وhttp_requests وhttp_error وhttp_duration_ms وrobots_access وadblock_verdicts

مراقبة أسطول من متصفحات headless

المقاييس. يحدّد الملف src/Metrics.zig في المستودع ما تعرضه /metrics: build_info{version}، وعدّادات باللاحقة _total (serve_commands_total{driver} وhttp_requests_total{mode} وhttp_error_total{reason} وjs_errors_total{kind} وjs_heap_limits_total للصفحات التي أُنهيت عند بلوغ حد كومة V8)، ومقاييس لحظية (gauges) (serve_active_connections{driver} وarena_memory_bytes وjs_heap_physical_bytes مجموعًا على كل العزلات الحية)، ومدرّجات تكرارية (histograms) (http_duration_ms وjs_heap_size_bytes). ولأمر fetch المنفرد، تتيح الشيفرة الراية --metrics التي تكتب هذه السلاسل في الخرج. تحقق من الأسماء في إصدارك قبل كتابة أي تنبيه: هذا الملف يتغير مع المشروع.

السجلات. تضبط الخيارات المشتركة المستوى (--log-level، وwarn افتراضيًا) والصيغة (--log-format logfmt أو pretty)؛ ويضمّن --log-filter نطاقات (scopes) أو يستبعدها. ومنذ 1.0.2 تخرج أخطاء JavaScript في الصفحة تحت النطاق page_error بمستوى WARN. ويوصي دليل MCP بالإبقاء على warn في الإنتاج؛ وكل شيء يذهب إلى stderr.

التتبعات. لا يصدر Lightpanda تتبعات OpenTelemetry: لا يوثّق المشروع أي تصدير OTLP. لذلك يبقى تتبع الجلسة من جهة الوكيل: زوّد العميل بالأدوات اللازمة (سكربت Puppeteer أو مضيف MCP) لفتح span لكل أداة مستدعاة وإرفاق عنوان URL المزار وحالة HTTP به؛ وقد فصّلنا هذا النهج في مقال Chrome DevTools MCP ووكلاء البرمجة. ومن جهة التطبيق المستهدف، تُرصد استدعاءات XHR وfetch الصادرة من متصفح headless كأي طلب آخر: انظر مراقبة طلبات XHR.

وماذا عن Dynatrace؟

لا يوثّق المشروع أي تكامل مع Dynatrace؛ ولا ندّعي أكثر مما تتيحه نقطة نهاية Prometheus. في Kubernetes، تصف وثائق Dynatrace SaaS جمع مصدّرات Prometheus بواسطة وحدة Kubernetes في ActiveGate عبر التعليقات التوضيحية metrics.dynatrace.com/scrape، وتوصي للنشرات الجديدة بـ Collector من OpenTelemetry (مستقبِل prometheus وتصدير OTLP). وهذا المسار الثاني يصلح أيضًا لـ Dynatrace Managed حيث يصل OTLP عبر Environment ActiveGate. وعندها يكون js_heap_physical_bytes وserve_active_connections مرشحين طبيعيين لتنبيه تشبّع لكل عقدة.

الحدود والنقاط المفتوحة

  • لا عرض: لقطة الشاشة الحقيقية، واكتشاف العناصر المخفية بصريًا، والاختبارات البصرية خارج النطاق. وتشير صفحة اختبارات الأداء في المشروع نفسها إلى أن الخرج النصي قد يفتقر إلى محتوى كانت صفحة معروضة ستُظهره.
  • تغطية Web APIs «جزئية لكنها متنامية»: الموقع الذي يعتمد على واجهة غائبة سيفشل بصمت. راقب js_errors_total وscript_errors_total.
  • الوتيرة: ثلاثة إصدارات في ثلاثة أسابيع في أكتوبر 2026، لكل منها قسم «Behavior changes» (إزالة setImmediate في 1.0.1). ثبّت إصدارًا بدلًا من nightly.
  • AGPL-3.0 والقياس عن بُعد: عرض المتصفح كخدمة شبكية يفعّل التزامات رخصة AGPL؛ ويشير README إلى أن Lightpanda يرسل افتراضيًا بيانات استخدام، تُوقَف عبر LIGHTPANDA_DISABLE_TELEMETRY=true.

الممارسات الجيدة

  • اضبط LIGHTPANDA_DISABLE_TELEMETRY=true في الصورة أو في ملف البيان (manifest)، لا في سكربت يُشغَّل يدويًا.
  • قيّد كل نسخة: --v8-max-heap-mb و--watchdog-ms (30 000 مللي ثانية افتراضيًا) و--http-timeout (15 000 مللي ثانية افتراضيًا) و--cdp-max-connections؛ ثم نبّه على js_heap_limits_total الذي يعدّ الصفحات التي أنهاها هذا الحد.
  • فعّل --block-private-networks عندما يزور الوكيل عناوين URL يختارها بنفسه: المتصفح الذي يطيع نموذجًا لغويًا هو سطح هجوم من نوع SSRF. وهذا يكمّل عزل الـ pod الموصوف في agent-sandbox، بيئة Kubernetes المعزولة لوكلاء الذكاء الاصطناعي، وضوابط وكلاء الذكاء الاصطناعي في الإنتاج.
  • أبقِ على --obey-robots وعلى --user-agent-suffix يعرّف بخدمتك؛ علمًا أن --user-agent يرفض أي قيمة تحتوي على «Mozilla».
  • جلسة MCP واحدة لكل وكيل (Mcp-Session-Id مختلف)؛ ومشاركة صفحة بين وكلاء يجب أن تبقى خيارًا صريحًا.

الأسئلة الشائعة

هل تعمل سكربتات Puppeteer أو Playwright الخاصة بي دون تعديل؟

يعد README بذلك لجزء CDP: نستبدل تشغيل Chrome باتصال إلى ws://127.0.0.1:9222. أما كل ما ينتظر عرضًا رسوميًا فلن يعطي النتيجة نفسها، وقد تكسر واجهة Web API غائبة موقعًا بعينه.

ما المقاييس التي يجب مراقبتها أولًا؟

بحسب src/Metrics.zig: serve_active_connections وjs_heap_physical_bytes للتشبّع، وjs_heap_limits_total وjs_errors_total للصفحات الفاشلة، وhttp_error_total{reason} وhttp_duration_ms للشبكة الصادرة.

هل ينتج Lightpanda تتبعات OpenTelemetry؟

لا، لا شيء من هذا القبيل موثّق. تُبنى تتبعات الجلسة في العميل الذي يقود المتصفح، بـ span لكل أداة أو لكل تنقّل؛ وتكمّل مقاييس Prometheus هذه الرؤية من جهة الموارد.

الخلاصة

يعالج Lightpanda تكلفة حقيقية: ذاكرة Chrome headless مضروبة في عدد الوكلاء. الرهان التقني متماسك، والأرقام المنشورة موثّقة وقابلة لإعادة الإنتاج، ونقطة النهاية /metrics تُظهر أن المشروع يفكّر في التشغيل. والمقابل حقيقي بالقدر نفسه: واجهات Web APIs غير مكتملة، وإصدارات متكررة، ورخصة AGPL، وقياس عن بُعد مفعّل افتراضيًا. مرشح جيد لتجربة مقيسة، لا لاستبدال أعمى. المصادر: مستودع lightpanda-io/browser ومرجع الأمر serve واختبارات الأداء في مستودع demo.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. Dynatrace علامة تجارية لشركة Dynatrace LLC. العلامات المذكورة تعود إلى مالكيها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Requête XHR : comprendre, écrire et superviser XMLHttpRequest

طلب XHR: فهم XMLHttpRequest وكتابته ومراقبته

Next Post
Shannon pentester IA : tester ses applications web par exploitation réelle

Shannon اختبار الاختراق بالذكاء الاصطناعي: اختبار تطبيقات الويب بالاستغلال الفعلي

Related Posts