Firecrawl self-hosted từng chỉ có một nghĩa: clone repo, chạy Docker Compose, và duy trì một API, một dịch vụ Playwright, Redis, RabbitMQ cùng Postgres trên máy của bạn. Đến ngày 18 tháng 11 năm 2026, Firecrawl tung ra một lựa chọn thứ hai. Firecrawl Local là một binary Rust duy nhất có khả năng scrape, crawl và map các trang web thành markdown, đồng thời phản hồi cùng API v2 tại localhost:3002, không cần database, hàng đợi hay container.
Trả lời nhanh: chọn Firecrawl Local nếu bạn muốn scrape, crawl, map và batch scrape trên laptop hoặc trong bộ công cụ của agent mà không cần hạ tầng gì. Giữ lại stack Docker self-hosted nếu bạn cần job chạy bền, các định dạng json và summary, trích xuất LLM qua model của riêng bạn, hoặc một route search không bao giờ chạm đến Firecrawl Cloud.
Firecrawl self-hosted là gì, và Firecrawl Local là gì?
Firecrawl self-hosted là server Firecrawl đầy đủ từ apps/api, chạy trên hạ tầng của bạn với Docker Compose. Firecrawl Local là một bản build riêng, nhẹ hơn trong apps/local: một binary duy nhất fetch và làm sạch trang trên máy bạn bằng chính đoạn code làm sạch HTML đó, còn search, các trang bị chặn và Alexandria thì chuyển sang Firecrawl Cloud.
Cả hai đều nằm trong repository GitHub của Firecrawl, đều phục vụ API v2 trên cổng 3002, và đều mã nguồn mở theo AGPL-3.0. Firecrawl Local không thay thế server. README của Firecrawl Local nói rõ điều đó: hướng dẫn self-hosting “nằm trong apps/api và không bị Firecrawl Local thay đổi.”
Mới làm quen với Firecrawl? Hãy bắt đầu với hướng dẫn web scraping với Firecrawl của chúng tôi.
Firecrawl Local vs Firecrawl self-hosted trong nháy mắt
Đây là phiên bản tóm tắt, được tổng hợp từ hướng dẫn self-hosting, trang so sánh mã nguồn mở vs cloud và README của Local, tất cả đều đọc ngày 19 tháng 11 năm 2026.
| Firecrawl self-hosted | Firecrawl Local | |
|---|---|---|
| Bạn chạy gì | Stack Docker Compose: api, playwright-service, redis, rabbitmq, nuq-postgres | Một binary, firecrawl-local |
| Cài đặt | git clone, viết .env, docker compose up --build -d |
cargo install firecrawl-local |
| Điều kiện tiên quyết | Git, Docker Engine, Compose v2 | Rust và trình biên dịch C; Chrome và Node 22+ là tùy chọn |
| API | v2 trên cổng 3002 | v2 trên cổng 3002 (scrape, map, crawl, batch scrape, health) |
| Route search | Có sẵn trong stack mặc định | Chuyển tiếp sang Firecrawl Cloud |
Định dạng LLM (json, summary) |
Kết nối provider tương thích OpenAI hoặc Ollama | Bị bỏ qua kèm cảnh báo |
| Screenshot | Cần Fire-engine, không có trong stack mặc định | Hoạt động nếu đã cài Chrome |
actions của trình duyệt |
Cần Fire-engine | Bị bỏ qua |
| Lưu trữ job | Hàng đợi dựa trên Postgres | Trong bộ nhớ, hết hạn sau 1 giờ |
| Alexandria | Không có trong bảng tính năng self-host | Qua Firecrawl Cloud với tài khoản miễn phí |
| Thiết lập MCP | Trỏ MCP server về URL của bạn | firecrawl-local init ghi cấu hình |
| Giấy phép | AGPL-3.0 | AGPL-3.0 |
Local đánh đổi chiều sâu lấy sự nhẹ nhàng: nó giữ lại các route mà agent gọi nhiều nhất và bỏ đi những gì cần hàng đợi, model hoặc một cụm trình duyệt.
Điều gì đã thay đổi: từ năm dịch vụ về một binary
Con đường self-hosted ghim bản phát hành v2.11.162 trong hướng dẫn của nó. Bạn clone repo, viết một .env nhỏ với thông tin đăng nhập Postgres và USE_DB_AUTHENTICATION=false, rồi build và khởi động 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
Tệp compose đó khởi động một container api (container này cũng chạy các worker), một playwright-service để render, redis, rabbitmq và nuq-postgres cho hàng đợi job. Tệp compose giới hạn API ở 4 CPU và 8 GB bộ nhớ, Playwright service ở 2 CPU và 4 GB, và hướng dẫn lưu ý rằng những giới hạn này “không phải yêu cầu tối thiểu đã được kiểm chứng.”

Firecrawl Local thu gọn tất cả thành một lệnh:
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
Không có .env và không có container. Các trang JavaScript được render trong Chrome hoặc Chromium bạn đã có sẵn; nếu không có, các trang tĩnh vẫn hoạt động còn phần còn lại trả về cảnh báo.
Các lệnh search, find-tools, data và login sẽ gọi đến Firecrawl Cloud. firecrawl-local login tái sử dụng thông tin đăng nhập của CLI bản hosted từ hướng dẫn cài đặt Firecrawl CLI của chúng tôi.
Phạm vi endpoint: mỗi bên phục vụ gì
Đây là chỗ các cuộc migration hay vỡ, nên hãy kiểm tra trước khi đổi base URL của SDK.
Firecrawl Local phục vụ các route sau trên máy bạn:
POST /v2/scrapescrape một URLPOST /v2/mapliệt kê URL của một trang webPOST /v2/crawl, cùngGETvàDELETE /v2/crawl/{id}POST /v2/batch/scrape, cùngGETvàDELETE /v2/batch/scrape/{id}GET /health
Mọi route /v2 khác, chẳng hạn /v2/search, đều được chuyển tiếp sang Firecrawl Cloud trừ khi FIRECRAWL_CLOUD nói khác. Các route v0 và v1 hoàn toàn không được phục vụ.
Firecrawl self-hosted bao phủ các thao tác scrape, crawl, map và search cốt lõi trong stack mặc định, theo trang so sánh mã nguồn mở vs cloud. Trích xuất có hỗ trợ LLM cần một provider mà bạn kết nối. Agent, Browser, Interact và dashboard không được bao gồm.
Hai cái bẫy thực tế:
- Kiểm tra health khác nhau. Hướng dẫn self-hosting kiểm tra readiness tại
/v0/health/readiness. Firecrawl Local không phục vụ v0, nên hãy dùngGET /healththay thế. Hãy cập nhật monitor và healthcheck của compose. - Search đổi chỗ chạy. Trên stack Docker, search ở lại trên hạ tầng của bạn. Trên Local, nó đi đến Firecrawl Cloud, và search không cần key sẽ bị giới hạn tốc độ. Đặt
FIRECRAWL_CLOUD=offnếu không có gì được phép rời khỏi máy; khi đó search sẽ ngừng hoạt động.
Tốc độ và bộ nhớ: đọc kỹ các tuyên bố
bài đăng ra mắt trên X của Firecrawl nói rằng Firecrawl Local là một “primitive scrape viết bằng Rust nhanh gấp 37 lần (so với self-hosted)” và dùng “bộ nhớ ít hơn 230 lần (11 MB khi rảnh).” Bài đăng đạt khoảng 324K lượt xem và 3,2K lượt thích trong ngày đầu tiên.
Hãy coi những con số đó là tuyên bố của Firecrawl. README không công bố phương pháp benchmark, không có tập trang và không có cấu hình phần cứng, nên chúng tôi không thể nói cho bạn biết “37x” đã đo cái gì. Điều mà kiến trúc thực sự ủng hộ là hướng đi: một tiến trình rảnh rỗi đáng lẽ phải nhẹ hơn nhiều so với năm container mà giới hạn compose của chúng cho phép lên đến 12 GB chỉ riêng cho dịch vụ API và Playwright.
Nếu tốc độ quyết định lựa chọn của bạn, hãy đo trên chính URL của bạn. Chạy cùng một thao tác scrape trên cả hai server, so sánh thời gian, và kiểm tra markdown có khớp nhau không. Phần về Apidog CLI dưới đây trình bày một cách để biến việc đó thành bài test có thể lặp lại.
Bảo mật, bàn giao cho cloud và luồng dữ liệu
Self-hosting cho bạn toàn quyền kiểm soát và toàn bộ trách nhiệm. Quickstart trong hướng dẫn tắt xác thực và cảnh báo nó “không phải là kiến trúc production,” nên volume bền vững, auth, TLS và monitoring là việc của bạn phải thêm vào.
Firecrawl Local có các mặc định chặt chẽ hơn cho một máy đơn:
servegắn vào127.0.0.1và từ chối địa chỉ localhost và private trừ khi bạn truyền--allow-private.- Địa chỉ link-local và metadata cloud bị chặn trong mọi chế độ, kể cả sau khi redirect.
scrape,crawlvàmcpchấp nhận--public-only, mà README khuyến nghị khi agent duyệt các trang bạn không tin tưởng.- Crawl tôn trọng
robots.txt.
Cái giá phải trả là việc bàn giao cho cloud. Với mặc định FIRECRAWL_CLOUD=auto, search, các trang chặn máy của bạn, và Alexandria sẽ đi đến Firecrawl Cloud. Những kết quả đó mang "source": "firecrawl-cloud". Đặt FIRECRAWL_CLOUD=search để chỉ cho phép search, hoặc off để không gửi gì đi.
Alexandria, danh mục các nhà cung cấp dữ liệu của Firecrawl, cần tài khoản miễn phí và firecrawl-local login. Bài giải thích về Firecrawl Alexandria của chúng tôi đề cập nó trả về những gì.
Bạn nên chọn cái nào?
Chọn Firecrawl Local nếu:
- Bạn muốn một AI agent scrape và crawl trên laptop.
firecrawl-local initthêm MCP server vào Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI và Codex, sao lưu từng cấu hình trước. - Bạn chạy các job ngắn kết thúc trong vòng một giờ.
- Bạn chỉ cần markdown, HTML, raw HTML và link.
- Bạn không muốn tự lo Postgres, Redis và RabbitMQ.
Giữ Firecrawl self-hosted nếu:
- Các job crawl phải sống sót qua lần khởi động lại hoặc chạy lâu hơn một giờ.
- Bạn cần đầu ra
jsonhoặcsummaryqua model của riêng bạn. - Search phải ở lại trên hạ tầng của bạn.
- Nhiều dịch vụ hoặc người dùng chia sẻ một backend scraping phía sau auth của bạn.
Nhiều nhóm sẽ chạy cả hai: Local trên laptop và trong agent, stack Docker hoặc Firecrawl Cloud trong production. Với các thiết lập agent chỉ cần search, bài tổng hợp của chúng tôi về web search mã nguồn mở cho Claude liệt kê các lựa chọn khác, và hướng dẫn Firecrawl MCP và llms.txt đề cập MCP server bản hosted.
Chuyển code SDK từ self-hosted sang Local
Code SDK của bạn không đổi, chỉ có URL thay đổi: đặt API URL của SDK Python hoặc Node thành http://localhost:3002, không cần API key cho các route local. Trước khi chuyển, hãy xác nhận code của bạn không gọi v0 hay v1, không bao giờ yêu cầu json, summary hay actions, và không bao giờ poll một crawl ID cũ hơn một giờ hoặc qua một lần khởi động lại serve.
Để coding agent của bạn chạy bài test tương đương với Apidog CLI
Đổi backend là một câu hỏi về hợp đồng: liệu /v2/scrape trên Local có trả về đúng hình dạng mà code của bạn đã parse? Đừng diff các response bằng tay. Chạy cả hai server song song (Docker trên 3002, firecrawl-local serve --port 3012) và để coding agent của bạn kiểm tra cả hai bằng Apidog CLI.
Thiết lập một lần:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Sau đó đưa cho agent một prompt:
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.

Agent đọc schema payload, xác thực nó và chạy cùng một case hai lần:
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 gửi request từ máy của bạn, nên cả hai cổng localhost đều truy cập được. Đổi -r cli,json thành -r junit và cùng bài kiểm tra đó sẽ chạy trong CI mỗi lần Firecrawl nâng cấp; hướng dẫn Apidog CLI cho CI/CD của chúng tôi trình bày cách thiết lập, còn Apidog CLI trong Claude Code đề cập phía agent. Gói Free của Apidog hỗ trợ đội tối đa 4 người dùng.
FAQ
Firecrawl Local có thay thế Firecrawl self-hosted không? Không. Nó là một bản build riêng trong apps/local. Server đầy đủ trong apps/api và hướng dẫn self-hosting của nó không thay đổi, và bạn vẫn cần nó cho các job bền vững và các định dạng LLM.
Firecrawl Local có thật sự nhanh gấp 37 lần Firecrawl self-hosted không? Đó là tuyên bố của Firecrawl từ bài đăng ra mắt, cùng với bộ nhớ ít hơn 230 lần và 11 MB khi rảnh. README không công bố phương pháp benchmark, nên hãy tự kiểm tra trên URL của bạn.
Firecrawl Local có hoạt động mà không cần cloud không? Có. Đặt FIRECRAWL_CLOUD=off và scrape, crawl, map sẽ ở lại trên máy bạn. Search, fallback cho trang bị chặn và Alexandria sẽ ngừng hoạt động.
Firecrawl self-hosted có miễn phí không? Code miễn phí theo AGPL-3.0, cho cả server và Local. Bạn trả tiền cho máy móc và thời gian để tự chạy Postgres, Redis và RabbitMQ.
AI agent nên dùng cái nào? Firecrawl Local, trong hầu hết trường hợp. firecrawl-local init đăng ký nó như một MCP server trong sáu công cụ agent, và --public-only ngăn agent chạm đến mạng riêng của bạn.
