Firecrawl Self-Hosted vs Firecrawl Local: Có gì thay đổi?

Firecrawl tự host chạy năm dịch vụ bằng Docker Compose. Firecrawl Local là một binary Rust duy nhất cung cấp cùng API v2 tại localhost:3002. Dưới đây là phạm vi của từng lựa chọn, ý nghĩa của tuyên bố 37x và nên chọn cái nào.

INEZA Felin-Michel

INEZA Felin-Michel

19 tháng 11 2026

Firecrawl Self-Hosted vs Firecrawl Local: Có gì thay đổi?

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

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

Kiến trúc song song: Firecrawl self-hosted chạy api cùng các worker, playwright-service, redis, rabbitmq và nuq-postgres dưới lệnh docker compose up, trong khi Firecrawl Local là một binary Rust duy nhất với Chrome tùy chọn và một đường nét đứt bàn giao cho Firecrawl Cloud xử lý search, các trang bị chặn và Alexandria; cả hai đều phơi bày API v2 tại localhost:3002

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:

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

  1. 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ùng GET /health thay thế. Hãy cập nhật monitor và healthcheck của compose.
  2. 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=off nế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:

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:

Giữ Firecrawl self-hosted nếu:

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.
Bài test tương đương: một coding agent chạy cùng một test case Apidog trên stack self-hosted ở cổng 3002 và Firecrawl Local ở cổng 3012, rồi so sánh hai báo cáo về status, success và markdown

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.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API