Firecrawl self-hosted dulu hanya berarti satu hal: clone repo, jalankan Docker Compose, lalu jaga agar API, layanan Playwright, Redis, RabbitMQ, dan Postgres tetap hidup di mesin Anda. Pada 18 November 2026, Firecrawl merilis opsi kedua. Firecrawl Local adalah satu binary Rust yang melakukan scrape, crawl, dan map situs ke markdown serta melayani API v2 yang sama di localhost:3002, tanpa database, queue, atau container.
Jawaban singkat: pilih Firecrawl Local jika Anda ingin scrape, crawl, map, dan batch scrape di laptop atau di toolbelt agen tanpa infrastruktur apa pun. Pertahankan stack Docker self-hosted jika Anda membutuhkan job persisten, format json dan summary, ekstraksi LLM melalui model Anda sendiri, atau route search yang tidak pernah menyentuh Firecrawl Cloud.
Apa itu Firecrawl self-hosted, dan apa itu Firecrawl Local?
Firecrawl self-hosted adalah server Firecrawl lengkap dari apps/api, yang dijalankan di infrastruktur Anda sendiri dengan Docker Compose. Firecrawl Local adalah build terpisah yang lebih ringan di apps/local: satu binary yang mengambil dan membersihkan halaman di mesin Anda menggunakan kode pembersihan HTML yang sama, lalu menyerahkan search, halaman terblokir, dan Alexandria ke Firecrawl Cloud.
Keduanya berada di repositori GitHub Firecrawl, keduanya melayani API v2 di port 3002, dan keduanya open source di bawah AGPL-3.0. Firecrawl Local tidak menggantikan server. README Firecrawl Local menyatakannya secara langsung: panduan self-hosting "berada di apps/api dan tidak berubah oleh Firecrawl Local."
Baru mengenal Firecrawl? Mulailah dengan panduan web scraping Firecrawl kami.
Firecrawl Local vs Firecrawl self-hosted secara singkat
Berikut versi ringkasnya, disusun dari panduan self-hosting, halaman open source vs cloud, dan README Local, semuanya dibaca pada 19 November 2026.
| Fitur | Firecrawl self-hosted | Firecrawl Local |
|---|---|---|
| Yang Anda jalankan | Stack Docker Compose: api, playwright-service, redis, rabbitmq, nuq-postgres | Satu binary, firecrawl-local |
| Instalasi | git clone, tulis .env, docker compose up --build -d | cargo install firecrawl-local |
| Prasyarat | Git, Docker Engine, Compose v2 | Rust dan compiler C; Chrome dan Node 22+ opsional |
| API | v2 di port 3002 | v2 di port 3002 (scrape, map, crawl, batch scrape, health) |
| Route search | Termasuk dalam stack default | Diteruskan ke Firecrawl Cloud |
Format LLM (json, summary) | Hubungkan penyedia yang kompatibel dengan OpenAI atau Ollama | Dilewati dengan peringatan |
| Screenshot | Memerlukan Fire-engine, tidak ada di stack default | Berfungsi jika Chrome terpasang |
actions browser | Memerlukan Fire-engine | Diabaikan |
| Penyimpanan job | Queue berbasis Postgres | Di memori, kedaluwarsa setelah 1 jam |
| Alexandria | Tidak tercantum dalam tabel fitur self-host | Melalui Firecrawl Cloud dengan akun gratis |
| Setup MCP | Arahkan server MCP ke URL Anda | firecrawl-local init menulis konfigurasinya |
| Lisensi | AGPL-3.0 | AGPL-3.0 |
Local menukar kedalaman dengan keringanan: ia mempertahankan route yang paling sering dipanggil agen dan membuang hal-hal yang membutuhkan queue, model, atau kumpulan browser.
Apa yang berubah: dari lima layanan menjadi satu binary
Jalur self-hosted menetapkan rilis v2.11.162 dalam panduannya. Anda clone repo, tulis .env kecil dengan kredensial Postgres dan USE_DB_AUTHENTICATION=false, lalu build dan jalankan stack:
git clone https://github.com/firecrawl/firecrawl.git cd firecrawl git checkout v2.11.162 docker compose up --build -d docker compose ps --all File compose tersebut menjalankan container api (yang juga menjalankan worker), playwright-service untuk rendering, redis, rabbitmq, dan nuq-postgres untuk queue job. File compose membatasi API pada 4 CPU dan 8 GB memori serta layanan Playwright pada 2 CPU dan 4 GB, dan panduan mencatat bahwa batasan tersebut "bukan persyaratan minimum yang terverifikasi."
Firecrawl Local menciutkan semua itu menjadi satu perintah:
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 Tidak ada .env dan tidak ada container. Halaman JavaScript dirender di Chrome atau Chromium yang sudah Anda miliki; tanpa itu, halaman statis tetap berfungsi dan sisanya mengembalikan peringatan.
Perintah search, find-tools, data, dan login menjangkau Firecrawl Cloud. firecrawl-local login menggunakan kembali kredensial CLI hosted dari panduan instalasi Firecrawl CLI kami.
Cakupan endpoint: apa yang dilayani masing-masing
Di sinilah migrasi sering rusak, jadi periksa ini sebelum Anda mengalihkan base URL SDK.
Firecrawl Local melayani route berikut di mesin Anda:
-
POST /v2/scrapemelakukan scrape satu URL -
POST /v2/mapmendaftar URL sebuah situs -
POST /v2/crawl, plusGETdanDELETE /v2/crawl/{id} -
POST /v2/batch/scrape, plusGETdanDELETE /v2/batch/scrape/{id} GET /health
Setiap route /v2 lainnya, seperti /v2/search, diteruskan ke Firecrawl Cloud kecuali FIRECRAWL_CLOUD menentukan sebaliknya. Route v0 dan v1 tidak dilayani sama sekali.
Firecrawl self-hosted mencakup scrape, crawl, map, dan search inti dalam stack default, menurut halaman open source vs cloud. Ekstraksi berbasis LLM membutuhkan penyedia yang Anda hubungkan. Agent, Browser, Interact, dan dashboard tidak disertakan.
Dua jebakan praktis:
- Pemeriksaan health berbeda. Panduan self-hosting memeriksa kesiapan di
/v0/health/readiness. Firecrawl Local tidak melayani v0, jadi gunakanGET /healthsebagai gantinya. Perbarui monitor dan healthcheck compose Anda. - Search berubah di mana ia berjalan. Pada stack Docker, search tetap di infrastruktur Anda. Pada Local, ia pergi ke Firecrawl Cloud, dan search tanpa kunci dibatasi rate-nya. Setel
FIRECRAWL_CLOUD=offjika tidak boleh ada apa pun yang keluar dari mesin; search kemudian berhenti berfungsi.
Kecepatan dan memori: baca klaimnya dengan cermat
Postingan peluncuran Firecrawl di X menyebut Firecrawl Local adalah "primitive scrape berbasis Rust yang 37x lebih cepat (dibanding self-hosted)" dan menggunakan "memori 230x lebih sedikit (11 MB saat idle)." Postingan tersebut menarik sekitar 324K tayangan dan 3,2K like pada hari pertamanya.
Anggap angka-angka itu sebagai klaim Firecrawl. README tidak menerbitkan metode benchmark, kumpulan halaman, maupun perangkat keras, jadi kami tidak bisa memberi tahu Anda apa yang diukur oleh "37x". Yang didukung arsitektur adalah arahnya: satu proses idle seharusnya jauh lebih ringan daripada lima container yang batas compose-nya saja mengizinkan hingga 12 GB antara layanan API dan Playwright.
Jika kecepatan menentukan pilihan Anda, ukurlah pada URL Anda sendiri. Jalankan scrape yang sama terhadap kedua server, bandingkan waktu, dan periksa apakah markdown-nya cocok. Bagian tentang Apidog CLI di bawah menunjukkan satu cara untuk menjadikannya uji yang dapat diulang.
Keamanan, serah-terima ke cloud, dan alur data
Self-hosting memberi Anda kendali penuh dan tanggung jawab penuh. Quickstart dalam panduan menonaktifkan autentikasi dan memperingatkan bahwa itu "bukan arsitektur produksi," jadi volume persisten, auth, TLS, dan monitoring menjadi tanggung jawab Anda.
Firecrawl Local hadir dengan default yang lebih ketat untuk satu mesin:
-
servemengikat ke127.0.0.1dan menolak localhost serta alamat privat kecuali Anda meneruskan--allow-private. - Alamat link-local dan metadata cloud diblokir di setiap mode, termasuk setelah redirect.
-
scrape,crawl, danmcpmenerima--public-only, yang direkomendasikan README ketika agen menjelajahi situs yang tidak Anda percayai. - Crawl menghormati
robots.txt.
Tukar-tambahnya adalah serah-terima ke cloud. Dengan FIRECRAWL_CLOUD=auto default, search, halaman yang memblokir mesin Anda, dan Alexandria pergi ke Firecrawl Cloud. Hasil tersebut membawa "source": "firecrawl-cloud". Setel FIRECRAWL_CLOUD=search untuk hanya mengizinkan search, atau off untuk tidak mengirim apa pun.
Alexandria, katalog penyedia data Firecrawl, membutuhkan akun gratis dan firecrawl-local login. Penjelasan Firecrawl Alexandria kami membahas apa yang dikembalikannya.
Mana yang harus Anda pilih?
Pilih Firecrawl Local jika:
- Anda ingin agen AI melakukan scrape dan crawl di laptop Anda.
firecrawl-local initmenambahkan server MCP ke Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, dan Codex, dengan mencadangkan setiap konfigurasi terlebih dahulu. - Anda menjalankan job singkat yang selesai dalam satu jam.
- Anda hanya membutuhkan markdown, HTML, HTML mentah, dan tautan.
- Anda tidak ingin mengelola Postgres, Redis, dan RabbitMQ sendiri.
Pertahankan Firecrawl self-hosted jika:
- Job crawl harus bertahan setelah restart atau berjalan lebih dari satu jam.
- Anda membutuhkan output
jsonatausummarymelalui model Anda sendiri. - Search harus tetap di infrastruktur Anda.
- Beberapa layanan atau pengguna berbagi satu backend scraping di balik auth Anda.
Banyak tim akan menjalankan keduanya: Local di laptop dan di agen, stack Docker atau Firecrawl Cloud di produksi. Untuk setup agen yang hanya membutuhkan search, rangkuman kami tentang web search open source untuk Claude mencantumkan opsi lain, dan panduan Firecrawl MCP dan llms.txt membahas server MCP hosted.
Memigrasikan kode SDK dari self-hosted ke Local
Kode SDK Anda tidak berubah, hanya URL-nya: setel API URL SDK Python atau Node ke http://localhost:3002, tanpa API key untuk route lokal. Sebelum mengalihkannya, pastikan kode Anda tidak memanggil v0 atau v1, tidak pernah meminta json, summary, atau actions, dan tidak pernah melakukan polling ID crawl yang lebih tua dari satu jam atau melintasi restart serve.
Biarkan coding agent Anda menjalankan uji paritas dengan Apidog CLI
Mengganti backend adalah pertanyaan kontrak: apakah /v2/scrape di Local mengembalikan bentuk yang sama dengan yang sudah di-parse kode Anda? Jangan diff respons secara manual. Jalankan kedua server berdampingan (Docker di 3002, firecrawl-local serve --port 3012) dan biarkan coding agent Anda menguji keduanya dengan Apidog CLI.
Siapkan sekali:
npm install -g apidog-cli@latest apidog auth login --with-token <YOUR_TOKEN> apidog skill install Lalu beri agen Anda satu prompt:
Self-hosted Firecrawl berjalan di http://localhost:3002 dan Firecrawl Local di http://localhost:3012. Di project Apidog <id>, buat dua environment, "self-hosted" dan "local". Tambahkan test case untuk POST /v2/scrape pada https://example.com (assert 200, success: true, data.markdown tidak kosong) dan POST /v2/map (assert 200 dan array links tidak kosong). Jalankan test case tersebut terhadap kedua environment dan beri tahu saya setiap assertion yang berbeda. Agen membaca skema payload, memvalidasinya, dan menjalankan test case yang sama dua kali:
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 mengirim permintaan dari mesin Anda, sehingga kedua port localhost dapat dijangkau. Ganti -r cli,json dengan -r junit dan pemeriksaan yang sama berjalan di CI pada setiap upgrade Firecrawl; panduan Apidog CLI CI/CD kami menunjukkan setup-nya, dan Apidog CLI di Claude Code membahas sisi agen. Paket Free Apidog mencakup tim hingga 4 pengguna.
FAQ
Apakah Firecrawl Local menggantikan Firecrawl self-hosted? Tidak. Ini adalah build terpisah di apps/local. Server lengkap di apps/api dan panduan self-hosting-nya tidak berubah, dan Anda tetap membutuhkannya untuk job persisten dan format LLM.
Apakah Firecrawl Local benar-benar 37x lebih cepat daripada Firecrawl self-hosted? Itu klaim Firecrawl dari postingan peluncurannya, bersama dengan memori 230x lebih sedikit dan 11 MB saat idle. README tidak menerbitkan metode benchmark, jadi ujilah pada URL Anda sendiri.
Apakah Firecrawl Local berfungsi tanpa cloud? Ya. Setel FIRECRAWL_CLOUD=off dan scrape, crawl, serta map tetap di mesin Anda. Search, fallback halaman terblokir, dan Alexandria berhenti berfungsi.
Apakah Firecrawl self-hosted gratis? Kodenya gratis di bawah AGPL-3.0, baik untuk server maupun Local. Anda membayar mesin dan waktu untuk menjalankan Postgres, Redis, dan RabbitMQ sendiri.
Mana yang harus digunakan agen AI? Firecrawl Local, dalam banyak kasus. firecrawl-local init mendaftarkannya sebagai server MCP di enam tool agen, dan --public-only mencegah agen menjangkau jaringan privat Anda.


![Quadruped Robot Software — Ch.10: Quadruped AI and Physical AI [KR]](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ffiibwtdu8wij6gnnuoyc.png)

