> 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/documentation/cn/kai-shi-shi-yong/quick-start-web-unblocker.md).

# 快速开始：网页解锁器

通过简单的分步指南，几分钟内即可开始使用 Oxylabs 网页解锁器。

{% hint style="success" %}
已经熟悉基础内容？查看 [网页解锁器文档](/products/cn/web-unblocker.md).
{% endhint %}

Oxylabs [网页解锁器](https://oxylabs.io/products/web-unblocker) 是一种由 AI 驱动的代理解决方案，旨在处理最复杂的机器人流量管理系统（例如 Akamai、Cloudflare 或 DataDome）。它会自动管理代理轮换、浏览器指纹识别和 CAPTCHA 处理，让您专注于数据。

{% stepper %}
{% step %}

### 设置与凭据

1. **创建账户：** 在以下位置注册： [Oxylabs 仪表板](https://dashboard.oxylabs.io/).
2. **创建 API 用户：** 导航到 网页解锁器 → Users 并创建用户名和密码（这些是用于授权访问网页解锁器的凭据，且不同于您的仪表盘登录凭据）
   {% endstep %}

{% step %}

### 你的首次请求

网页解锁器作为代理集成。使用端点 `unblock.oxylabs.io:60000` 并通过自定义请求头传递指令。

```bash
curl -k -x unblock.oxylabs.io:60000 -U 'USERNAME:PASSWORD' \
'https://sandbox.oxylabs.io/products' \
-H 'x-oxylabs-geo-location: United States' \
-H 'x-oxylabs-render: html'
```

{% hint style="info" %}
替换 `USERNAME` 和 `PASSWORD` 为您的用户凭据
{% endhint %}
{% endstep %}
{% endstepper %}

### 关键请求头

与标准代理不同，网页解锁器使用请求头来控制其 AI 驱动的功能：

| 请求头                       | 值                 | 描述                     |
| ------------------------- | ----------------- | ---------------------- |
| `x-oxylabs-geo-location`  | `美国`, `德国`等       | 将出口节点设置为特定国家。          |
| `x-oxylabs-render`        | `html` 或 `png`    | 启用 JavaScript 渲染或返回截图。 |
| `x-oxylabs-session-id`    | `AnyRandomString` | 使多次请求保持相同 IP（粘性会话）。    |
| `x-oxylabs-force-headers` | `1`               | 强制工具向目标发送您自己的自定义请求头。   |

### 常见响应代码

| 代码    | 状态     | 描述                    |
| ----- | ------ | --------------------- |
| `200` | `成功`   | 请求成功。您将收到完整渲染后的 HTML。 |
| `401` | `未授权`  | API 用户凭据无效或缺少身份验证。    |
| `429` | `请求过多` | 您已达到账户的速率限制。          |
| `550` | `故障`   | 系统在多次重试后仍无法访问该站点。     |

你可以找到 [完整的响应代码列表](/products/cn/web-unblocker/response-codes.md) 在网页解锁器产品部分中。

### 下一步

* **高级浏览器控制：** 需要点击按钮或滚动？请查看 [自定义浏览器指令](/products/cn/web-unblocker/custom-browser-instructions.md) 在产品部分中。
* **地理定向：** 如需本地化数据，请参阅 [地理位置](/products/cn/web-unblocker/making-requests/geo-location.md) 页面，以针对特定国家、城市或坐标。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/documentation/cn/kai-shi-shi-yong/quick-start-web-unblocker.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
