Firecrawl المستضاف ذاتيًا مقابل Firecrawl المحلي: ما الذي تغيّر؟

تشغّل نسخة Firecrawl المستضافة ذاتيًا خمس خدمات ضمن Docker Compose. أما Firecrawl Local فهي ملف Rust تنفيذي واحد يقدّم واجهة v2 API نفسها على localhost:3002. إليك ما يغطيه كل منهما، وما يعنيه ادعاء الـ37×، وأي الخيارين تختار.

INEZA Felin-Michel

INEZA Felin-Michel

19 نوفمبر 2026

Firecrawl المستضاف ذاتيًا مقابل Firecrawl المحلي: ما الذي تغيّر؟

Apidog للمؤسسات

النشر على الخوادم المحلية

SSO و RBAC

متوافق مع SOC 2

استكشف Apidog للمؤسسات

كان 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 المستضاف ذاتيًا خدمة api مع العمّال، وplaywright-service، وredis، وrabbitmq، وnuq-postgres تحت docker compose up، بينما Firecrawl Local هو ملف Rust ثنائي واحد مع Chrome اختياري وتسليم منقّط إلى Firecrawl Cloud للبحث والصفحات المحجوبة وAlexandria؛ وكلاهما يعرض واجهة v2 API على localhost:3002

يُقلّص 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 هذه المسارات على جهازك:

كل مسار /v2 آخر، مثل /v2/search، يُمرَّر إلى Firecrawl Cloud ما لم يقل FIRECRAWL_CLOUD خلاف ذلك. مسارات v0 وv1 لا تُخدم إطلاقًا.

Firecrawl المستضاف ذاتيًا يغطّي الكشط والزحف ورسم الخرائط والبحث الأساسي في حزمته الافتراضية، وفقًا لصفحة المفتوح المصدر مقابل السحابة. يحتاج الاستخراج المدعوم بـ LLM إلى مزوّد توصله. أما Agent وBrowser وInteract ولوحة المعلومات فغير مضمّنة.

عقبتان عمليتان:

  1. فحوصات الصحة تختلف. يتحقق دليل الاستضافة الذاتية من الجاهزية عند /v0/health/readiness. لا يخدم Firecrawl Local الإصدار v0، لذا استخدم GET /health بدلًا من ذلك. حدّث أدوات المراقبة وفحوصات compose الصحية.
  2. البحث يتغيّر مكان تشغيله. على حزمة 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 بإعدادات افتراضية أكثر إحكامًا لجهاز واحد:

المقايضة هي التسليم إلى السحابة. مع الإعداد الافتراضي FIRECRAWL_CLOUD=auto، يذهب البحث والصفحات التي تحجب جهازك وAlexandria إلى Firecrawl Cloud. وتحمل تلك النتائج "source": "firecrawl-cloud". اضبط FIRECRAWL_CLOUD=search للسماح بالبحث فقط، أو off لعدم إرسال أي شيء.

Alexandria، كتالوج Firecrawl لمزوّدي البيانات، يحتاج حسابًا مجانيًا وfirecrawl-local login. يغطّي شرحنا لـ Firecrawl Alexandria ما يعيده.

أيهما يجب أن تختار؟

اختر Firecrawl Local إذا:

أبقِ على Firecrawl المستضاف ذاتيًا إذا:

ستشغّل فرق كثيرة كلَيهما: 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.
اختبار التكافؤ: يشغّل وكيل برمجة نفس حالة اختبار Apidog على حزمة الاستضافة الذاتية على المنفذ 3002 وFirecrawl Local على المنفذ 3012، ثم يقارن التقريرين على الحالة والنجاح وmarkdown

يقرأ الوكيل مخطط الحمولة، ويتحقق منه، ويشغّل نفس الحالة مرتين:

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 الوكيل من الوصول إلى شبكتك الخاصة.

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات