Firecrawl

Firecrawl 是開源網頁爬取 API。本模板依官方 自架指南（v2.11.162）部署：PostgreSQL 佇列、關閉資料庫認證、不啟用 FoundationDB。

包含服務：

• ui — firecrawl-ui 控制台（scrape / crawl / extract / map / search）
• api — harness.js --start-docker（同一容器內跑 API、worker、extract-worker 與 NUQ 佇列 worker）
• playwright — 處理 JS 渲染頁的 Chromium 微服務
• redis — 快取與限流（無密碼，與上游 Compose 一致）
• rabbitmq — NUQ 任務佇列
• postgres — nuq-postgres（Postgres 17 + pg_cron + NUQ schema）。資料庫名稱必須是 postgres，因為 pg_cron 寫死了該庫名。

資源建議

上游 Compose 建議 API 至少 4 vCPU / 8 GB RAM，Playwright 至少 2 vCPU / 4 GB RAM。請使用 Pro 方案或獨立伺服器。

設定

需要填寫 API 網域和 UI 網域。認證預設關閉（USE_DB_AUTHENTICATION=false），請求不需要 API key。不要把這套未鑑權基線直接暴露到不可信網路。

可選 LLM 能力：部署時填寫 OPENAI_API_KEY，以及可選的 OPENAI_BASE_URL。任意 OpenAI 相容供應商均可（OpenAI、OpenRouter、xAI、Ollama、Zeabur AI Hub）。兩者都留空則略過 LLM。部署後仍可在 api 的 env 改 MODEL_NAME。

BULL_AUTH_KEY 會自動產生，可在 api 服務 env 查看。

快速測試

curl --fail-with-body --max-time 75 \
  -X POST https://<your-domain>/v2/scrape \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"],"timeout":60000}'

成功回應形如 {"success":true,"data":{"markdown":"...","metadata":{"statusCode":200}}}。

自架能力範圍

需求	本模板
scrape / crawl / map / search	已包含（Fetch + Playwright）
LLM extract / summary	依上面設定 OpenAI 相容 key
Fire-engine 反爬、截圖、page actions	不包含，需要 Fire-engine / Cloud
Agent、Browser、interact、product/audio/video	使用 Firecrawl Cloud 或額外外部服務

控制台

部署完成後打開 UI 網域。UI 服務的 Nginx 會把 /v2、/v1、/v0 反向代理到 API，控制台走同源請求，不依賴 CORS。若 API URL 為空，打開設定（齒輪）貼上 UI 網域（或 API 網域）。設定存在瀏覽器 localStorage。

維運佇列面板：

https://<api-domain>/admin/<BULL_AUTH_KEY>/queues

版本

上游 GHCR 只有 :latest。本模板以 digest 鎖定 Firecrawl 映像（拉取日期 2026-09-02）。

參考

• 自架文件: https://docs.firecrawl.dev/contributing/self-host
• GitHub: https://github.com/firecrawl/firecrawl
• 開源 vs Cloud: https://docs.firecrawl.dev/contributing/open-source-or-cloud
• 控制台 UI: https://github.com/obeone/firecrawl-ui
• License: AGPL-3.0（Firecrawl）；MIT（firecrawl-ui）