> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 代理

> 了解代理类型、位置，以及 Firecrawl 如何为你的请求选择代理。

Firecrawl 提供多种代理类型，帮助你抓取复杂程度各异的网站。可通过 `proxy` 参数指定代理类型。

> 默认情况下，Firecrawl 会将所有请求经由代理转发，以提升可靠性与可访问性，即使你未指定代理类型或位置也同样生效。

<div id="location-based-proxy-selection">
  ## 基于位置的代理选择
</div>

Firecrawl 会根据你指定或自动检测到的位置，自动选择最合适的代理，从而优化抓取性能和可靠性。但目前并非所有地区都受支持。当前可用的地区如下：

| 国家代码 | 国家名称     | 基础代理支持 | 增强代理支持 |
| ---- | -------- | ------ | ------ |
| AE   | 阿拉伯联合酋长国 | 是      | 否      |
| AU   | 澳大利亚     | 是      | 否      |
| BR   | 巴西       | 是      | 否      |
| CA   | 加拿大      | 是      | 否      |
| CN   | 中国       | 是      | 否      |
| DE   | 德国       | 是      | 否      |
| DK   | 丹麦       | 是      | 否      |
| EE   | 爱沙尼亚     | 是      | 否      |
| EG   | 埃及       | 是      | 否      |
| ES   | 西班牙      | 是      | 否      |
| FR   | 法国       | 是      | 否      |
| GB   | 英国       | 是      | 否      |
| GR   | 希腊       | 是      | 否      |
| IL   | 以色列      | 是      | 否      |
| IN   | 印度       | 是      | 否      |
| IT   | 意大利      | 是      | 否      |
| JP   | 日本       | 是      | 否      |
| NL   | 荷兰       | 是      | 是      |
| PT   | 葡萄牙      | 是      | 否      |
| QA   | 卡塔尔      | 是      | 否      |
| TR   | 土耳其      | 是      | 否      |
| US   | 美国       | 是      | 是      |

<Warning>受支持的代理位置列表会随着时间变化。</Warning>

如果你需要上述列表以外地区的代理，请[联系我们](mailto:help@firecrawl.com)并告知你的需求。

如果你未指定代理或位置，Firecrawl 将自动使用美国代理。

<div id="how-to-specify-proxy-location">
  ## 如何指定代理位置
</div>

你可以在请求中通过设置 `location.country` 参数来指定代理位置。例如，要使用德国代理，将 `location.country` 设置为 `DE`。

更多详情请参阅 [`location.country` 的 API 参考](https://docs.firecrawl.dev/api-reference/endpoint/scrape#body-location)。

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流上限：
    # api_key="fc-YOUR-API-KEY",
  )

  doc = firecrawl.scrape('https://example.com',
      formats=['markdown'],
      location={
          'country': 'US',
          'languages': ['en']
      }
  )

  print(doc)
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({
    // 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流额度：
    // apiKey: "fc-YOUR-API-KEY",
  });

  const doc = await firecrawl.scrape('https://example.com', {
    formats: ['markdown'],
    location: { country: 'US', languages: ['en'] },
  });

  console.log(doc.metadata);
  ```

  ```bash cURL theme={null}
  # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 可获得更高限流：
  curl -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com",
      "formats": ["markdown"],
      "location": { "country": "US", "languages": ["en"] }
    }'
  ```
</CodeGroup>

<Info>如果你请求的国家没有可用代理，Firecrawl 会使用距离最近的可用区域 (EU 或 US) ，并将浏览器位置设置为你请求的国家。</Info>

<Warning>除非你确定有此需要，否则我们强烈建议不要指定 `location`。</Warning>

<div id="proxy-types">
  ## 代理类型
</div>

Firecrawl 支持三种类型的代理：

* **basic**：用于抓取大多数网站的代理。速度快，通常能正常工作。
* **enhanced**：用于抓取复杂网站并同时保持隐私的增强型代理。速度较慢，但在某些网站上更可靠。[进一步了解 Enhanced 模式 →](/zh/features/enhanced-mode)
* **auto**：如果 basic 代理抓取失败，Firecrawl 会自动使用 enhanced 代理重试抓取。如果使用 enhanced 重试成功，该次抓取将收取 5 点额度；如果第一次使用 basic 抓取就成功，则只会收取正常费用。

***

> **注意：** 关于使用 enhanced 代理的详细信息，包括额度成本和重试策略，请参阅[Enhanced 模式文档](/zh/features/enhanced-mode)。

> 你是需要 Firecrawl API 密钥的 AI 代理吗？请参阅 [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) 了解自动化接入说明。