كان Firecrawl المستضاف ذاتيًا يعني شيئًا واحدًا: استنسخ المستودع، وشغّل Docker Compose، وأبقِ على API وخدمة Playwright وRedis وRabbitMQ وPostgres حيّة على جهازك. في 18 نوفمبر 2026، أطلقت Firecrawl خيارًا ثانيًا. Firecrawl Local هو ملف Rust ثنائي واحد يقوم بكشط المواقع والزحف إليها ورسم خرائطها وتحويلها إلى markdown، ويستجيب لنفس واجهة v2 API على localhost:3002، دون قاعدة بيانات أو طابور أو حاوية.
الإجابة السريعة: اختر Firecrawl Local إذا أردت الكشط والزحف ورسم الخرائط والكشط بالدُفعات على حاسوب محمول أو ضمن أدوات وكيل ذكي، دون أي بنية تحتية. أبقِ على حزمة Docker المستضافة ذاتيًا إذا كنت بحاجة إلى مهام دائمة، أو صيغتي json وsummary، أو استخراج LLM عبر نموذجك الخاص، أو مسار بحث لا يلامس Firecrawl Cloud أبدًا.
ما هو Firecrawl المستضاف ذاتيًا، وما هو Firecrawl Local؟
Firecrawl المستضاف ذاتيًا هو خادم Firecrawl الكامل من apps/api، يُشغَّل على بنيتك التحتية الخاصة باستخدام Docker Compose. أما Firecrawl Local فهو بناء منفصل وأخف في apps/local: ملف ثنائي واحد يجلب الصفحات وينظّفها على جهازك باستخدام نفس كود تنظيف HTML، ويحيل البحث والصفحات المحجوبة وAlexandria إلى Firecrawl Cloud.
كلاهما موجود في مستودع Firecrawl على GitHub، وكلاهما يقدّم واجهة v2 API على المنفذ 3002، وكلاهما مفتوح المصدر بترخيص AGPL-3.0. لا يحلّ Firecrawl Local محل الخادم. فـ README الخاص بـ Firecrawl Local يقول ذلك صراحةً: دليل الاستضافة الذاتية "موجود في apps/api ولم يتغيّر بفضل Firecrawl Local".
جديد على Firecrawl؟ ابدأ بـ دليلنا لكشط الويب باستخدام Firecrawl.
Firecrawl Local مقابل Firecrawl المستضاف ذاتيًا في لمحة
هذه هي النسخة المختصرة، مستندة إلى دليل الاستضافة الذاتية، وصفحة المفتوح المصدر مقابل السحابة، وREADME الخاص بـ Local، وكلها قُرئت في 19 نوفمبر 2026.
| Firecrawl المستضاف ذاتيًا | Firecrawl Local | |
|---|---|---|
| ما الذي تشغّله | حزمة Docker Compose: api، playwright-service، redis، rabbitmq، nuq-postgres | ملف ثنائي واحد، firecrawl-local |
| التثبيت | git clone، وكتابة .env، وdocker compose up --build -d |
cargo install firecrawl-local |
| المتطلبات الأساسية | Git وDocker Engine وCompose v2 | Rust ومترجم C؛ وChrome وNode 22+ اختياريان |
| API | v2 على المنفذ 3002 | v2 على المنفذ 3002 (scrape، map، crawl، batch scrape، health) |
| مسار البحث | مضمّن في الحزمة الافتراضية | يُعاد توجيهه إلى Firecrawl Cloud |
صيغ LLM (json، summary) |
وصّل مزوّدًا متوافقًا مع OpenAI أو Ollama | تُتخطّى مع تحذير |
| لقطات الشاشة | تحتاج Fire-engine، غير موجود في الحزمة الافتراضية | تعمل إذا كان Chrome مثبّتًا |
actions المتصفح |
تحتاج Fire-engine | تُتجاهل |
| تخزين المهام | طابور مدعوم بـ Postgres | في الذاكرة، تنتهي صلاحيتها بعد ساعة |
| Alexandria | غير مدرجة في جدول ميزات الاستضافة الذاتية | عبر Firecrawl Cloud بحساب مجاني |
| إعداد MCP | وجّه خادم MCP إلى عنوان URL الخاص بك | firecrawl-local init يكتب الإعداد |
| الترخيص | AGPL-3.0 | AGPL-3.0 |
يُقايض Local العمق بالخفة: فهو يحتفظ بالمسارات التي يستدعيها الوكلاء الأكثر، ويستغني عمّا يحتاج طابورًا أو نموذجًا أو مزرعة متصفحات.
ما الذي تغيّر: من خمس خدمات إلى ملف ثنائي واحد
يثبّت مسار الاستضافة الذاتية الإصدار v2.11.162 في دليله. تستنسخ المستودع، وتكتب ملف .env صغيرًا يحتوي بيانات اعتماد Postgres وUSE_DB_AUTHENTICATION=false، ثم تبني الحزمة وتشغّلها:
git clone https://github.com/firecrawl/firecrawl.git
cd firecrawl
git checkout v2.11.162
docker compose up --build -d
docker compose ps --all
يشغّل ملف compose هذا حاوية api (وهي تشغّل العمّال أيضًا)، وخدمة playwright-service للعرض، وredis، وrabbitmq، وnuq-postgres لطابور المهام. يحدّد ملف compose سقف الـ API عند 4 وحدات معالجة و8 جيجابايت من الذاكرة، وخدمة Playwright عند وحدتي معالجة و4 جيجابايت، ويشير الدليل إلى أن تلك الحدود "ليست متطلبات دنيا مُتحقَّقًا منها".

يُقلّص Firecrawl Local ذلك إلى أمر واحد:
cargo install firecrawl-local
firecrawl-local scrape https://example.com --markdown
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages
firecrawl-local map https://firecrawl.dev
firecrawl-local serve
لا يوجد .env ولا حاويات. تُعرَض صفحات JavaScript في Chrome أو Chromium الموجود لديك بالفعل؛ وبدونه، لا تزال الصفحات الثابتة تعمل، والباقي يُعيد تحذيرًا.
تصل أوامر search وfind-tools وdata وlogin إلى Firecrawl Cloud. ويعيد firecrawl-local login استخدام بيانات اعتماد CLI المستضاف من دليل تثبيت Firecrawl CLI.
تغطية نقاط النهاية: ما الذي يخدمه كلٌّ منهما
هنا تنكسر عمليات الترحيل، لذا تحقّق من ذلك قبل تغيير عنوان URL الأساسي لأي SDK.
يخدم Firecrawl Local هذه المسارات على جهازك:
POST /v2/scrapeيكشط عنوان URL واحدًاPOST /v2/mapيُدرج عناوين URL الخاصة بالموقعPOST /v2/crawl، بالإضافة إلىGETوDELETE /v2/crawl/{id}POST /v2/batch/scrape، بالإضافة إلىGETوDELETE /v2/batch/scrape/{id}GET /health
كل مسار /v2 آخر، مثل /v2/search، يُمرَّر إلى Firecrawl Cloud ما لم يقل FIRECRAWL_CLOUD خلاف ذلك. مسارات v0 وv1 لا تُخدم إطلاقًا.
Firecrawl المستضاف ذاتيًا يغطّي الكشط والزحف ورسم الخرائط والبحث الأساسي في حزمته الافتراضية، وفقًا لصفحة المفتوح المصدر مقابل السحابة. يحتاج الاستخراج المدعوم بـ LLM إلى مزوّد توصله. أما Agent وBrowser وInteract ولوحة المعلومات فغير مضمّنة.
عقبتان عمليتان:
- فحوصات الصحة تختلف. يتحقق دليل الاستضافة الذاتية من الجاهزية عند
/v0/health/readiness. لا يخدم Firecrawl Local الإصدار v0، لذا استخدمGET /healthبدلًا من ذلك. حدّث أدوات المراقبة وفحوصات compose الصحية. - البحث يتغيّر مكان تشغيله. على حزمة Docker، يبقى البحث على بنيتك التحتية. أما على Local، فيذهب إلى Firecrawl Cloud، والبحث بدون مفتاح محدود المعدل. اضبط
FIRECRAWL_CLOUD=offإذا لم يكن مسموحًا بمغادرة أي شيء للجهاز؛ عندها يتوقف البحث عن العمل.
السرعة والذاكرة: اقرأ الادعاءات بعناية
تقول منشورات الإطلاق على X إن Firecrawl Local هو "أساس كشط بـ Rust أسرع 37 مرة (مقارنةً بالاستضافة الذاتية)" ويستهلك "ذاكرة أقل بـ 230 مرة (11 ميجابايت في وضع الخمول)". حصد المنشور حوالي 324 ألف مشاهدة و3.2 ألف إعجاب في يومه الأول.
تعامل مع تلك الأرقام باعتبارها ادعاءات Firecrawl. فالـ README لا ينشر منهجية قياس أداء ولا مجموعة صفحات ولا عتادًا، لذا لا يمكننا إخبارك بما قاسه "الـ 37 مرة". ما تدعمه الهندسة هو الاتجاه: من المفترض أن يكون عملية خاملة واحدة أخف بكثير من خمس حاويات تسمح حدود compose الخاصة بها بما يصل إلى 12 جيجابايت بين خدمتي API وPlaywright وحدهما.
إذا كانت السرعة تحسم اختيارك، فقِسها على عناوين URL الخاصة بك. شغّل نفس الكشط على كلا الخادمين، وقارن التوقيتات، وتحقّق من تطابق markdown. يعرض القسم الخاص بـ Apidog CLI أدناه طريقة لجعل ذلك اختبارًا قابلًا للتكرار.
الأمان وتسليم السحابة وتدفق البيانات
تمنحك الاستضافة الذاتية تحكمًا كاملًا ومسؤولية كاملة. يعطّل البدء السريع في الدليل المصادقة ويحذر من أنه "ليس بنية إنتاجية"، لذا فإن الأحجام الدائمة والمصادقة وTLS والمراقبة متروكة لك لتضيفها.
يأتي Firecrawl Local بإعدادات افتراضية أكثر إحكامًا لجهاز واحد:
serveيرتبط بـ127.0.0.1ويرفض localhost والعناوين الخاصة ما لم تمرّر--allow-private.- عناوين link-local وعناوين بيانات السحابة الوصفية محظورة في كل الأوضاع، بما في ذلك بعد إعادة التوجيه.
scrapeوcrawlوmcpتقبل--public-only، وهو ما يوصي به README عندما يتصفح وكيل مواقع لا تثق بها.- تحترم عمليات الزحف
robots.txt.
المقايضة هي التسليم إلى السحابة. مع الإعداد الافتراضي FIRECRAWL_CLOUD=auto، يذهب البحث والصفحات التي تحجب جهازك وAlexandria إلى Firecrawl Cloud. وتحمل تلك النتائج "source": "firecrawl-cloud". اضبط FIRECRAWL_CLOUD=search للسماح بالبحث فقط، أو off لعدم إرسال أي شيء.
Alexandria، كتالوج Firecrawl لمزوّدي البيانات، يحتاج حسابًا مجانيًا وfirecrawl-local login. يغطّي شرحنا لـ Firecrawl Alexandria ما يعيده.
أيهما يجب أن تختار؟
اختر Firecrawl Local إذا:
- كنت تريد أن يقوم وكيل ذكاء اصطناعي بالكشط والزحف على حاسوبك المحمول. يضيف
firecrawl-local initخادم MCP إلى Claude Code وClaude Desktop وCursor وWindsurf وGemini CLI وCodex، مع عمل نسخة احتياطية من كل إعداد أولًا. - كنت تشغّل مهامًا قصيرة تنتهي خلال ساعة.
- كنت تحتاج فقط إلى markdown وHTML وraw HTML والروابط.
- كنت لا تريد تحمّل إدارة Postgres وRedis وRabbitMQ.
أبقِ على Firecrawl المستضاف ذاتيًا إذا:
- كانت مهام الزحف يجب أن تصمد أمام إعادة التشغيل أو تعمل لأكثر من ساعة.
- كنت تحتاج إلى مخرجات
jsonأوsummaryعبر نموذجك الخاص. - كان البحث يجب أن يبقى على بنيتك التحتية.
- كانت عدة خدمات أو مستخدمين يتشاركون واجهة كشط خلفية واحدة وراء مصادقتك.
ستشغّل فرق كثيرة كلَيهما: Local على الحواسيب المحمولة وفي الوكلاء، وحزمة Docker أو Firecrawl Cloud في الإنتاج. لإعدادات الوكلاء التي تحتاج البحث فقط، تُدرج مجموعتنا لـ البحث المفتوح المصدر على الويب لـ Claude خيارات أخرى، ويغطي دليل Firecrawl MCP وllms.txt خادم MCP المستضاف.
ترحيل كود SDK من الاستضافة الذاتية إلى Local
لا يتغيّر كود SDK الخاص بك، بل يتغيّر عنوان URL فقط: اضبط عنوان API الخاص بـ Python أو Node SDK على http://localhost:3002، دون مفتاح API للمسارات المحلية. قبل أن تُشغّله، تأكّد من أن كودك لا يجري أي استدعاءات v0 أو v1، ولا يطلب json أو summary أو actions أبدًا، ولا يستقصي معرّف زحف أقدم من ساعة أو عبر إعادة تشغيل serve.
دع وكيل البرمجة لديك يجري اختبار تكافؤ بـ Apidog CLI
تبديل الواجهات الخلفية مسألة عقد: هل يعيد /v2/scrape على Local نفس الشكل الذي يحلّله كودك بالفعل؟ لا تُقارن الاستجابات يدويًا. شغّل كلا الخادمين جنبًا إلى جنب (Docker على 3002، وfirecrawl-local serve --port 3012) ودع وكيل البرمجة لديك يختبر كلَيهما بـ Apidog CLI.
اضبطه مرة واحدة:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
ثم أعطِ وكيلك مطالبة واحدة:
Self-hosted Firecrawl runs on http://localhost:3002 and Firecrawl Local on
http://localhost:3012. In Apidog project <id>, create two environments,
"self-hosted" and "local". Add test cases for POST /v2/scrape on
https://example.com (assert 200, success: true, non-empty data.markdown) and
POST /v2/map (assert 200 and a non-empty links array). Run the cases against
both environments and tell me every assertion that differs.

يقرأ الوكيل مخطط الحمولة، ويتحقق منه، ويشغّل نفس الحالة مرتين:
firecrawl-local serve --port 3012 &
apidog environment create self-hosted --project <id> --base-url http://localhost:3002
apidog environment create local --project <id> --base-url http://localhost:3012
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file scrape-case.json
apidog test-case create --project <id> --file scrape-case.json
apidog run --test-case <caseId> --project <id> -e <selfHostedEnvId> -r cli,json --out-file self-hosted
apidog run --test-case <caseId> --project <id> -e <localEnvId> -r cli,json --out-file local
يرسل Apidog CLI الطلبات من جهازك، لذا فإن كلا منفذي localhost قابلان للوصول. استبدل -r cli,json بـ -r junit ليُشغَّل نفس الفحص في CI مع كل ترقية لـ Firecrawl؛ يعرض دليل Apidog CLI لـ CI/CD الإعداد، ويغطي Apidog CLI في Claude Code الجانب الخاص بالوكيل. تغطي خطة Apidog المجانية الفرق التي تصل إلى 4 مستخدمين.
الأسئلة الشائعة
هل يحلّ Firecrawl Local محل Firecrawl المستضاف ذاتيًا؟ لا. إنه بناء منفصل في apps/local. الخادم الكامل في apps/api ودليل الاستضافة الذاتية الخاص به لم يتغيّرا، ولا تزال بحاجة إليه للمهام الدائمة وصيغ LLM.
هل Firecrawl Local فعلاً أسرع 37 مرة من Firecrawl المستضاف ذاتيًا؟ هذا ادعاء Firecrawl من منشور الإطلاق، إلى جانب ذاكرة أقل بـ 230 مرة و11 ميجابايت في وضع الخمول. لا ينشر README منهجية قياس أداء، لذا اختبره على عناوين URL الخاصة بك.
هل يعمل Firecrawl Local بدون السحابة؟ نعم. اضبط FIRECRAWL_CLOUD=off ويبقى الكشط والزحف ورسم الخرائط على جهازك. يتوقف البحث وبديل الصفحات المحجوبة وAlexandria عن العمل.
هل Firecrawl المستضاف ذاتيًا مجاني؟ الكود مجاني بموجب AGPL-3.0، لكل من الخادم وLocal. تدفع مقابل الأجهزة والوقت لتشغيل Postgres وRedis وRabbitMQ بنفسك.
أيهما يجب أن يستخدمه وكيل الذكاء الاصطناعي؟ Firecrawl Local، في معظم الحالات. يسجّله firecrawl-local init كخادم MCP في ست أدوات للوكلاء، ويمنع --public-only الوكيل من الوصول إلى شبكتك الخاصة.
