> For the complete documentation index, see [llms.txt](https://docs.ipdunar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipdunar.com/zh/kuai-su-ru-men/introduction.md).

# 产品简介

ipdunar 是面向工程师的代理平台。我们运维 IP 基础设施、轮换逻辑与地理定位——你只需要发起 HTTP 请求。

## 文档结构

* [**产品**](https://docs.ipdunar.com/zh/chan-pin/overview.md) — 住宅、移动、ISP 三款代理的参考文档
* [**集成指南**](https://docs.ipdunar.com/zh/ji-cheng-zhi-nan/integrations.md) — Selenium、Puppeteer、Scrapy、反检测浏览器、n8n、LangChain 等即插即用教程
* [**API 参考**](https://docs.ipdunar.com/zh/api-can-kao/api-reference.md) — 管理订单、子账号、流量、报表的 REST 接口
* [**故障排查**](https://docs.ipdunar.com/zh/gu-zhang-pai-cha/troubleshooting.md) — 错误码与恢复手册

## 约定

代码示例中的占位符如下，请替换为控制台中的实际值。

| 占位符                | 含义                                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| `USERNAME`         | 子账号名（例如 `s1a2b3c4d5e`）。完整的代理用户名需要套入 [ipdunar 用户名语法](https://docs.ipdunar.com/zh/kuai-su-ru-men/username-format.md)。 |
| `PASSWORD`         | 子账号密码                                                                                                               |
| `gate.ipdunar.com` | 代理网关主机名                                                                                                             |
| `7777`             | 默认的 HTTP/SOCKS5 端口                                                                                                  |
| `API_KEY`          | 在 **控制台 → API** 中签发的 REST API 密钥                                                                                    |

每个代理用户名都遵循同一种结构：

```
ipdunar_{username}-type-{type}-region-{region}[-state-{state}][-city-{city}][-asn-{asn}][-session-{session_id}-sesstime-{ttl}]
```

如果示例显示 `ipdunar_s1a2b3c4d5e-type-res-region-us`，你需要替换的就是其中的 `s1a2b3c4d5e` 部分。

所有示例默认在类 Unix shell 下运行，Windows 用户请相应调整引号。

## 版本管理

REST API 通过 URL 进行版本管理（`/v1/...`）。破坏性变更会以新的主版本发布，并提供 6 个月废弃过渡期。详见[更新日志](https://docs.ipdunar.com/zh/zi-yuan/changelog.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 by asking a question.

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

```
GET https://docs.ipdunar.com/zh/kuai-su-ru-men/introduction.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.
