# 跨请求重用代理

> URL: https://foura.ai/zh/docs/how-to/reuse-a-proxy
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

了解如何在后续 request 中保持相同的 proxy 出口，使 JavaScript 渲染、API 调用和分页抓取均来自同一 IP。

## 为何复用 Proxy

首次请求目标时，FourA 会为你挑选一个可用的 proxy。Proxy 或 Auto response 中会包含所使用的 proxy ID。在后续 request 中传回该 ID 可以：

- 后续页面通过相同出口访问，保持 session cookie 和 rate limit 对目标的一致性。
- 限制国家范围的抓取可保留在允许列表中，无需重新筛选。
- 成本较低的 `POST /api/single/` endpoint 通过你已付费发现的 proxy 重放，仅按 Single 而非 Proxy 计费。

proxy ID 是不透明的 base36 字符串（类似于 `A1B2C3`），绝非原始 IP。

## ID 在 Response 中的位置

| Endpoint | 字段 | 出现时机 |
|----------|-------|-------------------|
| `POST /api/auto/` | `session.proxy` | 当 `returnSession` 为 `true`（默认值）时 |
| `POST /api/single/` | `proxy`（顶层） | 仅当 request 提供 `proxy` 字段时 |
| `POST /api/proxy/` | `proxy`（顶层） | 成功时始终存在 |
| `POST /api/browser/` | `proxy`（顶层） | 仅当 request 提供 `proxy` 字段时 |

若要获取全新出口而不固定出口，请从 Auto 或 Proxy 开始。二者都会探测可用出口并返回其 ID 供你使用。

## 模式 1：Auto 探测，Single 重放

适用于未知目标。Auto 遍历一次梯队，然后 Single 为每个后续页面复用该优胜 session。

```python
import requests

API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

# Step 1: discover a working exit with Auto.
r = requests.post(f"{API}/api/auto/", headers=H, json={
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
}).json()

session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")

# Step 2: paginate with Single, reusing the same exit, User-Agent and cookies.
for sku in ("43", "44", "45"):
    body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
    if proxy:
        body["proxy"] = proxy
    headers = []
    if user_agent:
        headers.append(["User-Agent", user_agent])
    if session.get("cookies"):
        headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
    if headers:
        body["headers"] = headers
    p = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, p["status"])
```

使用 `.get()` 读取 session。通过普通 proxy 请求获取的 session 包含 `proxy` 且没有 `userAgent`，部分响应则完全不携带 `session`。

Auto 调用的费用取决于其阶梯策略的实际消耗。随后的每次 Single 调用消耗 2 个积分（默认使用带 `unblocker` 的 Single）。

## 模式 2：Proxy 负责探测，Browser 通过同一出口渲染

当目标网站必须识别特定的出口国家，且最终内容需要 JavaScript 渲染时使用此模式。

```bash
# Step 1: pick a country-scoped exit with Proxy.
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "exitCountries": ["FR", "GB"],
    "request": {"method": "GET", "url": "https://example.com/pricing"}
  }'
# Response includes: "proxy": "A1B2C3", "exitCountry": "FR"

# Step 2: render the JS-heavy page through THAT exit.
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "proxy": "A1B2C3",
    "timeout_ms": 20000
  }'
```

请勿再次调用 `/api/proxy/` 来刷新选择。新的调用可能会选择不同的出口，从而失去固定的意义。如果固定的出口停止工作，请运行一次新的 `/api/proxy/` 调用来选择新出口，然后继续使用该出口。

## 模式 3：跳过已失效的出口

如果之前正常的出口开始返回拒绝响应或验证页面，请通知 FourA 在下一次选择时避开该出口。

```json
{
  "maxTries": 5,
  "ignoreProxies": ["A1B2C3"],
  "request": { "method": "GET", "url": "https://example.com/data" }
}
```

`ignoreProxies` 接收来自先前 response 的 proxy ID 列表。它适用于 `/api/proxy/` 和 `/api/auto/`。该列表在每次内部重试时均生效，因此带有 `ignoreProxies` 的单次调用绝不会选择已失效的出口。

## 固定 Session 的有效时长

只要底层 proxy 状态健康，出口本身就会保持存活，通常为数分钟到数小时不等。如果重放请求开始返回 challenge、拦截或非预期的重定向，则该出口可能已被轮换，或目标站点刷新了其 clearance 状态。

发生这种情况时有两种选择：

1. 针对同一 URL 发起全新的 `/api/auto/` 调用。Auto 会自动发现新的可用 session；请丢弃之前的 ID。
2. 如果希望继续手动固定，发起带有 `ignoreProxies: ["<burned-id>"]` 的全新 `/api/proxy/` 调用。

Auto response 中的 session cookie 也会根据目标站点自身的规则过期。某些站点会将 clearance 绑定数小时；其他站点则仅维持数分钟。应将 session 视为缓存，而非持久 token。

## 无法固定 ID 的情况

`proxy` 值可能返回三种 400 错误，它们代表不同的含义：

| 错误 | 发生原因 | 解决办法 |
|-------|---------------|------------|
| `Invalid proxy format` | 该值不是 FourA 签发的 ID。传入原始 proxy 地址会导致此错误。 | 逐字发送来自 response 的不透明字符串。 |
| `Proxy not found` | ID 已成功解码，但不再解析为活跃的出口。 | 从新的 Auto 或 Proxy 调用中获取全新的出口。 |
| `Managed exit: this proxy id cannot be pinned to a request` | 该 ID 属于高级出口，但您当前周期的套餐高级流量已用尽，或您的套餐不包含高级出口。 | 通过 `POST /api/proxy/` 运行调用并接受其选择的出口，或者增加高级流量配额后重新固定。 |

第三种错误可能由成功调用所返回的 ID 触发，因此即使操作完全正确也可能遇到。请按照处理过期 session 的方式应对：回退到全新的发现调用，而不是重试相同的 ID。

## 常见错误

- **跨账户复用 proxy ID。**切勿在账户之间共享 ID：一个账户可以固定的 ID 可能会被另一个账户拒绝，例如在没有高级流量的套餐中使用高级出口。
- **尝试解码 ID。**此 base36 字符串是不透明的。不要解析它，不要截断字符，也不要转换为小写。请原样传回。
- **通过受 rate limit 限制的出口进行固定。**如果目标网站按 IP 进行 rate limit，将大量 request 集中到一个出口会更快触发封禁。对于高并发工作负载，建议让 Auto 或 Proxy 轮换多个出口，仅在目标确实需要时才进行固定。
- **无意中固定了高级出口。**由高级出口提供服务的调用（Proxy 或 Auto 上的 `exitClass: "premium"`）所返回的 ID 会固定高级出口。来自高级 Auto 调用的 ID 会在 Single 或 Browser 上固定高级出口，但不一定是 Auto 当时使用的具体地址。每次通过它重放都会计入您的高级流量配额，并且 response 会携带 `X-FourA-Exit-Class: premium`。
- **在不支持地理定位的套餐上发送 `exitCountries`。**国家/地区作用域从 Startup 套餐起包含。在未包含该功能的套餐上，发送 `exitCountries` 的调用将被拒绝，并返回 `403` 和 `X-FourA-Limit: plan_limit_feature`。
- **在后续调用中忽略 `exitCountries`。**如果您固定了指定作用域的出口，随后再次调用 Proxy 时未携带 `exitCountries`，后续调用可能会通过其他国家/地区路由。请在每个需要的调用中保持该作用域。

## 相关内容

- [API Endpoints](https://foura.ai/docs/api/endpoints)：完整参数与 response 参考
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch)：Auto 如何构建供您重放的 session
- [受保护网站](https://foura.ai/docs/guides/protected-sites)：何时固定有效以及何时轮换更佳
- [常见问题](https://foura.ai/docs/troubleshooting/common-issues)：`no_eligible_proxy` 及其他 proxy 错误
- [Proxy Request 耗尽重试次数的原因](https://foura.ai/docs/troubleshooting/proxy-attempt-report)：在 Proxy 调用放弃时解读 `attemptReport`
