Firecrawl Self-Hosted ile Firecrawl Local Arasındaki Fark: Neler Değişti?

Self-hosted Firecrawl, Docker Compose altında beş hizmet çalıştırır. Firecrawl Local ise localhost:3002 üzerinde aynı v2 API'sini sunan tek bir Rust ikili dosyasıdır. İşte her birinin neleri kapsadığı, 37x iddiasının ne anlama geldiği ve hangisini seçmeniz gerektiği.

INEZA Felin-Michel

INEZA Felin-Michel

19 November 2026

Firecrawl Self-Hosted ile Firecrawl Local Arasındaki Fark: Neler Değişti?

Kurumsal İçin Apidog

Şirket İçi (On-Premises) Dağıtım

SSO ve RBAC

SOC 2 Uyumlu

Apidog Enterprise'ı Keşfedin

Firecrawl'ı kendi sunucunuzda barındırmak (self-hosted) eskiden tek bir anlama geliyordu: repoyu klonla, Docker Compose'u çalıştır ve makinende bir API, bir Playwright servisi, Redis, RabbitMQ ve Postgres'i ayakta tut. 18 Kasım 2026'da Firecrawl ikinci bir seçenek sundu. Firecrawl Local, siteleri markdown'a kazıyan, tarayan ve haritalayan tek bir Rust binary'sidir ve localhost:3002 üzerinde aynı v2 API'sine yanıt verir; veritabanı, kuyruk veya konteyner yoktur.

Kısa yanıt: Bir dizüstü bilgisayarda veya bir ajanın araç çantasında sıfır altyapıyla scrape, crawl, map ve toplu scrape yapmak istiyorsanız Firecrawl Local'i seçin. Kalıcı işler, json ve summary formatları, kendi modeliniz üzerinden LLM çıkarımı veya Firecrawl Cloud'a hiç dokunmayan bir arama rotasına ihtiyacınız varsa self-hosted Docker yığınını koruyun.

Firecrawl self-hosted nedir, Firecrawl Local nedir?

Self-hosted Firecrawl, apps/api içindeki tam Firecrawl sunucusudur ve Docker Compose ile kendi altyapınızda çalıştırılır. Firecrawl Local ise apps/local içinde ayrı, daha hafif bir yapıdır: aynı HTML temizleme kodunu kullanarak sayfaları makinenizde getirip temizleyen tek bir binary'dir ve arama, engellenen sayfalar ve Alexandria işlerini Firecrawl Cloud'a devreder.

Her ikisi de Firecrawl GitHub deposunda bulunur, ikisi de 3002 portunda v2 API'sine hizmet eder ve ikisi de AGPL-3.0 altında açık kaynaklıdır. Firecrawl Local, sunucunun yerini almaz. Firecrawl Local README bunu açıkça söylüyor: self-hosting kılavuzu " apps/api içinde yaşar ve Firecrawl Local'den etkilenmez."

Firecrawl'da yeni misiniz? Firecrawl web kazıma kılavuzumuzla başlayın.

Bir bakışta Firecrawl Local ile self-hosted Firecrawl

İşte kısa versiyon; 19 Kasım 2026'da okunan self-hosting kılavuzu, açık kaynak ile bulut karşılaştırma sayfası ve Local README'den derlendi.

Self-hosted Firecrawl Firecrawl Local
Çalıştırdığınız şey Docker Compose yığını: api, playwright-service, redis, rabbitmq, nuq-postgres Tek binary, firecrawl-local
Kurulum git clone, .env yaz, docker compose up --build -d cargo install firecrawl-local
Ön koşullar Git, Docker Engine, Compose v2 Rust ve bir C derleyicisi; Chrome ve Node 22+ isteğe bağlı
API 3002 portunda v2 3002 portunda v2 (scrape, map, crawl, toplu scrape, health)
Arama rotası Varsayılan yığında dahil Firecrawl Cloud'a iletilir
LLM formatları (json, summary) OpenAI uyumlu bir sağlayıcıya veya Ollama'ya bağlanın Uyarı ile atlanır
Ekran görüntüleri Fire-engine gerektirir, varsayılan yığında yok Chrome kuruluysa çalışır
Tarayıcı actions Fire-engine gerektirir Yoksayılır
İş depolama Postgres destekli kuyruk Bellekte, 1 saat sonra sona erer
Alexandria Self-host özellik tablosunda listelenmemiş Ücretsiz hesapla Firecrawl Cloud üzerinden
MCP kurulumu MCP sunucusunu URL'nize yönlendirin firecrawl-local init yapılandırmayı yazar
Lisans AGPL-3.0 AGPL-3.0

Local, derinlik yerine ağırlığı feda eder: ajanların en çok çağırdığı rotaları korur, kuyruk, model veya tarayıcı çiftliği gerektiren şeyleri bırakır.

Ne değişti: beş servisten tek binary'ye

Self-hosted yol, kılavuzunda v2.11.162 sürümünü sabitler. Repoyu klonlarsınız, Postgres kimlik bilgilerini ve USE_DB_AUTHENTICATION=false değerini içeren küçük bir .env yazarsınız, ardından yığını derleyip başlatırsınız:

git clone https://github.com/firecrawl/firecrawl.git
cd firecrawl
git checkout v2.11.162
docker compose up --build -d
docker compose ps --all

Bu compose dosyası bir api konteyneri (worker'ları da çalıştırır), rendering için bir playwright-service, iş kuyruğu için redis, rabbitmq ve nuq-postgres başlatır. Compose dosyası API'yi 4 CPU ve 8 GB bellekle, Playwright servisini de 2 CPU ve 4 GB ile sınırlar ve kılavuz bu sınırların "doğrulanmış minimum gereksinimler olmadığını" belirtir.

Yan yana mimari: self-hosted Firecrawl, docker compose up altında api ve worker'ları, playwright-service, redis, rabbitmq ve nuq-postgres'i çalıştırırken Firecrawl Local, isteğe bağlı Chrome ve arama, engellenen sayfalar ile Alexandria için Firecrawl Cloud'a noktalı devir içeren tek bir Rust binary'sidir; her ikisi de v2 API'sini localhost:3002 üzerinde sunar

Firecrawl Local bunu tek bir komuta indirger:

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 yok ve konteyner yok. JavaScript sayfaları zaten sahip olduğunuz Chrome veya Chromium'da render edilir; bir tarayıcı olmadan statik sayfalar yine çalışır ve geri kalanı bir uyarı döndürür.

search, find-tools, data ve login komutları Firecrawl Cloud'a ulaşır. firecrawl-local login, Firecrawl CLI kurulum kılavuzumuzdaki barındırılan CLI'nin kimlik bilgilerini yeniden kullanır.

Endpoint kapsamı: her biri ne sunuyor

Geçişlerin kırıldığı yer tam olarak burasıdır, bu yüzden bir SDK'nın temel URL'sini değiştirmeden önce bunu kontrol edin.

Firecrawl Local, makinenizde şu rotaları sunar:

Diğer tüm /v2 rotaları, örneğin /v2/search, FIRECRAWL_CLOUD aksini belirtmediği sürece Firecrawl Cloud'a iletilir. v0 ve v1 rotaları hiç sunulmaz.

Self-hosted Firecrawl, açık kaynak ile bulut sayfasına göre varsayılan yığınında temel scrape, crawl, map ve search'ü kapsar. LLM destekli çıkarım, bağladığınız bir sağlayıcı gerektirir. Agent, Browser, Interact ve dashboard dahil değildir.

İki pratik tuzak:

  1. Health kontrolleri farklıdır. Self-hosting kılavuzu hazır olma durumunu /v0/health/readiness adresinde kontrol eder. Firecrawl Local v0 sunmadığı için bunun yerine GET /health kullanın. Monitörlerinizi ve compose healthcheck'lerinizi güncelleyin.
  2. Arama nerede çalıştığını değiştirir. Docker yığınında arama altyapınızda kalır. Local'de ise Firecrawl Cloud'a gider ve anahtarsız arama hız sınırlamasına tabidir. Makineden hiçbir şeyin çıkmaması gerekiyorsa FIRECRAWL_CLOUD=off ayarlayın; o zaman arama çalışmayı durdurur.

Hız ve bellek: iddiaları dikkatle okuyun

Firecrawl'ın X'teki lansman gönderisi, Firecrawl Local'in "(self-hosted'e kıyasla) 37 kat daha hızlı Rust tabanlı bir scrape primitifi" olduğunu ve "230 kat daha az bellek (boşta 11 MB)" kullandığını söylüyor. Gönderi ilk gününde yaklaşık 324 bin görüntüleme ve 3,2 bin beğeni aldı.

Bu rakamları Firecrawl'ın iddiaları olarak değerlendirin. README hiçbir kıyaslama yöntemi, sayfa seti veya donanım yayınlamıyor, bu yüzden "37 kat"ın neyi ölçtüğünü size söyleyemeyiz. Mimarînin desteklediği şey yöndür: boştaki tek bir süreç, yalnızca API ve Playwright servisleri arasında 12 GB'a kadar izin veren compose limitleriyle beş konteynerden çok daha hafif oturmalıdır.

Seçiminizi hız belirliyorsa, kendi URL'lerinizde ölçün. Aynı scrape'i her iki sunucuda çalıştırın, süreleri karşılaştırın ve markdown'ın eşleştiğini kontrol edin. Aşağıdaki Apidog CLI bölümü bunu tekrarlanabilir bir test haline getirmenin bir yolunu gösteriyor.

Güvenlik, buluta devir ve veri akışı

Self-hosting size tam kontrol ve tam sorumluluk verir. Kılavuzun hızlı başlangıcı kimlik doğrulamayı devre dışı bırakır ve bunun "bir üretim mimarisi olmadığı" konusunda uyarır; dolayısıyla dayanıklı birimler, kimlik doğrulama, TLS ve izleme eklemek size kalır.

Firecrawl Local, tek bir makine için daha sıkı varsayılanlarla gelir:

Ödünleşim buluta devirdir. Varsayılan FIRECRAWL_CLOUD=auto ile arama, makinenizi engelleyen sayfalar ve Alexandria Firecrawl Cloud'a gider. Bu sonuçlar "source": "firecrawl-cloud" taşır. Yalnızca aramaya izin vermek için FIRECRAWL_CLOUD=search, hiçbir şey göndermemek için off ayarlayın.

Firecrawl'ın veri sağlayıcıları kataloğu olan Alexandria, ücretsiz bir hesap ve firecrawl-local login gerektirir. Firecrawl Alexandria açıklamamız ne döndürdüğünü ele alıyor.

Hangisini seçmelisiniz?

Firecrawl Local'i seçin, eğer:

Self-hosted Firecrawl'ı koruyun, eğer:

Birçok ekip ikisini birden çalıştıracak: Local dizüstü bilgisayarlarda ve ajanlarda, Docker yığını veya Firecrawl Cloud ise üretimde. Yalnızca aramaya ihtiyaç duyan ajan kurulumları için Claude için açık kaynak web arama derlememiz diğer seçenekleri listeliyor ve Firecrawl MCP ve llms.txt kılavuzu barındırılan MCP sunucusunu ele alıyor.

SDK kodunu self-hosted'den Local'e taşıma

SDK kodunuz değişmez, yalnızca URL değişir: Python veya Node SDK'nın API URL'sini http://localhost:3002 olarak ayarlayın; yerel rotalar için API anahtarı yoktur. Değiştirmeden önce kodunuzun v0 veya v1 çağrısı yapmadığını, hiçbir zaman json, summary veya actions istemediğini ve bir saatten eski veya bir serve yeniden başlatması boyunca bir crawl kimliğini yoklamadığını doğrulayın.

Kodlama ajanınızın Apidog CLI ile bir parite testi çalıştırmasına izin verin

Arka uçları değiştirmek bir sözleşme sorunudur: Local'deki /v2/scrape, kodunuzun halihazırda ayrıştırdığı aynı şekli mi döndürüyor? Yanıtları elle karşılaştırmayın. Her iki sunucuyu yan yana çalıştırın (Docker 3002'de, firecrawl-local serve --port 3012) ve kodlama ajanınızın ikisini de Apidog CLI ile test etmesine izin verin.

Bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Ardından ajanınıza tek bir komut verin:

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.
Parite testi: bir kodlama ajanı aynı Apidog test vakasını 3002 portundaki self-hosted yığınına ve 3012 portundaki Firecrawl Local'e karşı çalıştırır, ardından iki raporu durum, başarı ve markdown üzerinden farklandırır

Ajan yük şemasını okur, doğrular ve aynı vakayı iki kez çalıştırır:

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 istekleri makinenizden gönderdiği için her iki localhost portuna da erişilebilir. -r cli,json yerine -r junit koyun ve aynı kontrol, her Firecrawl yükseltmesinde CI'da çalışsın; Apidog CLI CI/CD kılavuzumuz kurulumu gösteriyor ve Claude Code'da Apidog CLI ajan tarafını ele alıyor. Apidog'un Free planı 4 kullanıcıya kadar ekipleri kapsar.

SSS

Firecrawl Local, self-hosted Firecrawl'ın yerini alır mı? Hayır. apps/local içinde ayrı bir yapıdır. apps/api içindeki tam sunucu ve self-hosting kılavuzu değişmemiştir ve kalıcı işler ile LLM formatları için hâlâ ona ihtiyacınız vardır.

Firecrawl Local gerçekten self-hosted Firecrawl'dan 37 kat daha hızlı mı? Bu, Firecrawl'ın lansman gönderisindeki iddiasıdır; buna 230 kat daha az bellek ve boşta 11 MB da eşlik ediyor. README hiçbir kıyaslama yöntemi yayınlamıyor, bu yüzden kendi URL'lerinizde test edin.

Firecrawl Local bulut olmadan çalışır mı? Evet. FIRECRAWL_CLOUD=off ayarlayın, scraping, crawling ve mapping makinenizde kalır. Arama, engellenen sayfa yedeği ve Alexandria çalışmayı durdurur.

Self-hosted Firecrawl ücretsiz mi? Kod, hem sunucu hem de Local için AGPL-3.0 altında ücretsizdir. Makinelerin ve Postgres, Redis, RabbitMQ'yu kendiniz çalıştırmanın bedelini siz ödersiniz.

Bir AI ajanı hangisini kullanmalı? Çoğu durumda Firecrawl Local'i. firecrawl-local init onu altı ajan aracında bir MCP sunucusu olarak kaydeder ve --public-only, bir ajanın özel ağınıza erişmesini engeller.

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin