if ($http_authorization != "Bearer <KEY>") { return 401; }

# 放在 http 块（/etc/nginx/nginx.conf 或单独 conf.d 文件）
map $http_authorization $fc_user {
    default                      "";
    "Bearer <KEY>"     "leo";
    "Bearer <KEY>"   "friend1";
}

# 按用户分别限速，朋友那份给紧一点
limit_req_zone $fc_user zone=fc_limit:10m rate=30r/m;

location / {
    if ($fc_user = "") { return 401; }
    limit_req zone=fc_limit burst=10 nodelay;

    # 日志里记清楚是谁调的，方便回溯
    access_log /var/log/nginx/firecrawl-access.log;

    proxy_pass http://127.0.0.1:3002;
    # ...其余 proxy_set_header 保持不变
}

python3 -c "import secrets; print('fc-friend-' + secrets.token_hex(20))"

接口地址：https://firecrawl.saveme505.help
认证：请求头带 Authorization: Bearer <你的 token>
接口格式跟官方 Firecrawl 完全一致，文档看 https://docs.firecrawl.dev

curl 示例：
curl -X POST https://firecrawl.saveme505.help/v1/scrape \
  -H "Authorization: Bearer <你的 token>" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"]}'

如果你也用 Claude Code，MCP 这么配：
{
  "command": "npx",
  "args": ["-y", "firecrawl-mcp"],
  "env": {
    "FIRECRAWL_API_URL": "https://firecrawl.saveme505.help",
    "FIRECRAWL_API_KEY": "<你的 token>"
  }
}

能用的接口：/v1/scrape、/v1/map、/v1/crawl、/v1/search、/v1/parse
用不了的：agent、monitor、research、interact（这些是 Firecrawl 云端专属功能，自建版没有）
注意：没有反爬引擎，Cloudflare 之类强风控的站点大概率抓不动，这个改不了。

git clone --depth 1 https://github.com/firecrawl/firecrawl.git <HOME>/firecrawl
cd <HOME>/firecrawl

x-common-service: &common-service
  # image: ghcr.io/firecrawl/firecrawl
  build: apps/api

x-common-service: &common-service
  image: ghcr.io/firecrawl/firecrawl:latest

PORT=3002
HOST=0.0.0.0
USE_DB_AUTHENTICATION=false

BULL_AUTH_KEY=<随机字符串>

POSTGRES_USER=firecrawl
POSTGRES_PASSWORD=<随机密码>
# 库名必须是 postgres！镜像把 pg_cron 的 cron.database_name 硬编码成 postgres，
# 改成别的名字会让初始化脚本中断，队列表一张都建不出来
POSTGRES_DB=postgres

# 不配这个 /v1/search 就是废的
SEARXNG_ENDPOINT=http://searxng:8080

# 默认 60 秒不够，api 容器要拉起 10 个子进程，会超时自杀形成重启循环
HARNESS_STARTUP_TIMEOUT_MS=300000

NUM_WORKERS_PER_QUEUE=8
CRAWL_CONCURRENT_REQUESTS=10
MAX_CONCURRENT_JOBS=5
BROWSER_POOL_SIZE=5
LOGGING_LEVEL=info

services:
  searxng:
    image: searxng/searxng:latest
    environment:
      SEARXNG_BASE_URL: http://searxng:8080/
      SEARXNG_SECRET: '<随机 64 位十六进制>'
    volumes:
      - ./searxng:/etc/searxng:rw
    networks:
      - backend
    restart: unless-stopped

  api:
    ports: !override
      - '127.0.0.1:3002:3002'
    restart: unless-stopped
  redis:
    restart: unless-stopped
  rabbitmq:
    restart: unless-stopped
    cpus: 4.0          # 圈住 Erlang 忙等，别让它吃满整机
  nuq-postgres:
    restart: unless-stopped
  playwright-service:
    restart: unless-stopped

use_default_settings: true
server:
  secret_key: '<跟上面同一个>'
  limiter: false
  image_proxy: false
  method: 'GET'          # firecrawl 走 GET，默认是 POST
search:
  safe_search: 0
  formats:
    - html
    - json               # 必须显式放开 json，默认只有 html
general:
  debug: false

docker compose up -d api playwright-service redis rabbitmq nuq-postgres searxng

# 抓取
curl -X POST http://127.0.0.1:3002/v1/scrape \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"]}'

# 搜索（返回空数组也是 HTTP 200，要看 data 里有没有东西）
curl -X POST http://127.0.0.1:3002/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"test","limit":3}'

location /admin/ { return 404; }   # 队列管理台必须屏蔽
location / {
    if ($http_authorization != "Bearer <他的 token>") { return 401; }
    proxy_pass http://127.0.0.1:3002;
    proxy_read_timeout 300s;       # 爬取耗时长，默认 60s 不够
    # ...
}