DEV Community

Cover image for Firecrawl Self-Hosted ile Firecrawl Local Arasındaki Fark: Neler Değişti?
Tobias Hoffmann
Tobias Hoffmann

Posted on Originally published at apidog.com

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

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.

Apidog'u bugün deneyin

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

.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:

  • POST /v2/scrape tek bir URL'yi kazır
  • POST /v2/map bir sitenin URL'lerini listeler
  • POST /v2/crawl ve ayrıca GET ile DELETE /v2/crawl/{id}
  • POST /v2/batch/scrape ve ayrıca GET ile DELETE /v2/batch/scrape/{id}
  • GET /health

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:

  • serve, 127.0.0.1 adresine bağlanır ve --allow-private vermediğiniz sürece localhost ile özel adresleri reddeder.
  • Link-local ve bulut meta veri adresleri her modda, yönlendirmelerden sonra bile engellenir.
  • scrape, crawl ve mcp, README'nin güvenmediğiniz sitelerde bir ajanın gezinmesi durumunda önerdiği --public-only seçeneğini kabul eder.
  • Crawl'lar robots.txt'ye uyar.

Ö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:

  • Bir AI ajanının dizüstü bilgisayarınızda scrape ve crawl yapmasını istiyorsanız. firecrawl-local init, MCP sunucusunu Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI ve Codex'e ekler ve her yapılandırmayı önce yedekler.
  • Bir saat içinde biten kısa işler çalıştırıyorsanız.
  • Yalnızca markdown, HTML, raw HTML ve bağlantılara ihtiyacınız varsa.
  • Postgres, Redis ve RabbitMQ'nun sahibi olmak istemiyorsanız.

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

  • Crawl işleri bir yeniden başlatmadan sağ çıkmalı veya bir saatten uzun sürmeliyse.
  • Kendi modeliniz üzerinden json veya summary çıktısına ihtiyacınız varsa.
  • Arama altyapınızda kalmalıysa.
  • Birden fazla servis veya kullanıcı, kimlik doğrulamanızın arkasında tek bir scraping arka ucunu paylaşıyorsa.

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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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.

Top comments (0)