> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/cn/agent-browser/troubleshooting-guide.md).

# 故障排除指南

了解在使用 Oxylabs 代理浏览器时如何处理意外行为或较低成功率。

| 症状                      | 可能原因                | 解决方案                                                                  |
| ----------------------- | ------------------- | --------------------------------------------------------------------- |
| *会话检查（VNC）无法连接（浏览器已启动）* | 已达到 VNC 最大限制        | 减少 VNC 会话数量。                                                          |
| *TLS / 证书错误*            | Node.js 中的证书验证      | 设置 `NODE_TLS_REJECT_UNAUTHORIZED="0"` 在 require Playwright 之前（仅用于测试）。 |
| *配置文件已恢复，但 Cookie 为空*   | 会话之间出口 IP 发生变化      | 固定 `proxy_resi_ses_id` + `proxy_resi_ses_time` 每个会话都使用相同的值。           |
| *登录墙 / 成功率低*            | IP 信誉、地理位置错误，或引擎不匹配 | 设置 `p_cc`，请尝试不同的 `p_device`，或切换引擎和指纹。启用 `page_handler=true` 如果出现挑战。   |
| *目标已完全阻止*               | 受限目标类别              | 通过您的专属客户经理完成 KYC。                                                     |

{% hint style="info" %}
有关连接、会话和页面内错误代码，请参见 [响应代码](/products/cn/agent-browser/xiang-ying-dai-ma.md)。\
还遇到问题？请通过在线聊天或电子邮件联系 Oxylabs 支持（<support@oxylabs.io>).
{% endhint %}

如果您遇到意外行为或成功率较低，请考虑以下步骤：

{% hint style="info" %}
有关连接、会话和页面内错误代码，请参见响应代码。
{% endhint %}

### **了解我们的 CAPTCHA 处理流程**

熟悉我们的 [CAPTCHA 处理](/products/cn/agent-browser/captcha-handling.md) 方法及其用法。这可以帮助判断 CAPTCHA 挑战是否是问题来源。

### **使用国家参数**

在请求中指定国家参数可显著提高成功率。这可确保您的请求通过来自特定地理位置的 IP 路由，过滤掉来自随机或可能不太可靠位置的 IP。

您可以通过添加 `?p_cc` 参数到您的连接 URL 中。更多信息请参见 [地理位置定向](/products/cn/agent-browser/geolocation-and-proxy-selection.md).

### **使用设备类型参数**

尝试使用设备参数可提高成功率。您可以通过使用 `?p_device` 参数来自定义浏览器如何模拟不同设备类型。更多信息请参见 [设备类型](/products/cn/agent-browser/device-type.md) 部分。

#### **尝试不同的引擎和指纹组合**

反爬保护因目标而异。如果被阻止，请在 Windows 和 macOS 指纹之间切换，或在标准浏览器引擎和专有浏览器引擎之间切换。对于受保护的目标，请尝试 `p_src=oxybrowser` 配合 `p_fp_tag=oxyfp_mac_optimized`。更多信息请参见 [引擎与指纹](/products/cn/agent-browser/yin-qing-yu-zhi-wen.md).

{% hint style="info" %}
如果尝试这些步骤后问题仍然存在，请将问题详情和您已采取的步骤告知您的专属客户经理。
{% endhint %}

## 需要启用某项功能？ <a href="#need-a-feature-enabled" id="need-a-feature-enabled"></a>

某些 Agent Browser 功能默认受限。如需调整限制，请联系 Oxylabs 支持（[在线聊天](https://oxylabs.io/) 或 [电子邮件](mailto:support@oxylabs.io)）或您的专属客户经理：

* **更多持久化配置文件** – 将您的账户默认保存配置文件上限提高到 5 个以上。
* **更多持久化会话** – 将您的账户默认 5 个并发持久化会话上限提高。
* **受限目标** – 通过 KYC 流程解锁更多目标类别。
* **更高的速率限制** – 提高到超过 100 个并发会话 / 每秒 10 个。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/cn/agent-browser/troubleshooting-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.