# 快代理（Kuaidaili）

> 快代理提供代理 IP 服务，覆盖隧道代理 Pro、隧道代理、私密代理、独享代理、海外动态代理和海外静态代理。这里精选官方产品、开发与 API 文档，帮助开发者和 AI Agent 选择产品、接入代理并排查问题。

请先根据所用产品阅读对应开发手册；不同产品的提取方式、连接参数和限制不能混用。具体规格、价格与可用能力以当前产品文档和订单信息为准。

三类认证用途不同：Agent Gateway 使用 Agent 凭证调用账户与业务接口；订单 OpenAPI 按接口文档使用订单密钥等方式认证；连接代理服务器时使用对应产品支持的 IP 白名单或用户名密码鉴权。不要将 Agent 凭证用作代理连接密码，也不要将 API 请求认证与代理连接鉴权混淆。

## 产品选择

- [隧道代理 Pro](https://www.kuaidaili.com/doc/product/tps_pro/): 了解隧道代理 Pro 的功能、适用场景与产品说明。
- [隧道代理](https://www.kuaidaili.com/doc/product/tps/): 了解通过隧道入口使用代理的方式与功能。
- [私密代理](https://www.kuaidaili.com/doc/product/dps/): 了解私密代理 IP 的提取和使用场景。
- [独享代理](https://www.kuaidaili.com/doc/product/kps/): 了解独享代理的产品类型与使用方式。
- [海外动态代理](https://www.kuaidaili.com/doc/product/fps/): 了解海外动态代理的隧道与提取模式。
- [海外静态代理](https://www.kuaidaili.com/doc/product/sfps/): 了解海外静态代理的产品说明。

## 快速接入与开发手册

- [开发者快速入门](https://www.kuaidaili.com/doc/dev/quickstart/): 从获取代理、测试连接到编写程序的入门步骤。
- [隧道代理 Pro 开发手册](https://www.kuaidaili.com/doc/dev/tps_pro/): 连接验证、地区与换 IP 周期设置、资源调度及错误处理。
- [隧道代理开发手册](https://www.kuaidaili.com/doc/dev/tps/): 连接验证、锁定 IP、多通道及相关接口。
- [私密代理开发手册](https://www.kuaidaili.com/doc/dev/dps/): 提取与连接代理、带宽和频率限制及开发建议。
- [独享代理开发手册](https://www.kuaidaili.com/doc/dev/kps/): 提取与连接独享代理、相关接口及错误处理。
- [海外动态代理开发手册](https://www.kuaidaili.com/doc/dev/fps/): 隧道和提取模式、地区与换 IP 周期设置。
- [海外静态代理开发手册](https://www.kuaidaili.com/doc/dev/sfps/): 海外静态代理的提取、连接与错误处理。

## 订单 OpenAPI

- [API 接口概览](https://www.kuaidaili.com/doc/api/): 查找账户、订单、代理提取、白名单等接口；调用域名以对应接口和订单信息为准。
- [API 授权与验证](https://www.kuaidaili.com/doc/api/auth/): API 请求的认证方式与签名规则。
- [API 返回格式](https://www.kuaidaili.com/doc/api/return/): 解释接口响应格式与返回字段。
- [获取私密代理 IP](https://www.kuaidaili.com/doc/api/getdps/): 私密代理提取接口的参数、格式与调用说明。
- [设置 IP 白名单](https://www.kuaidaili.com/doc/api/setipwhitelist/): 设置订单的代理访问白名单；注意该接口与添加单个白名单 IP 的区别。
- [获取代理鉴权信息](https://www.kuaidaili.com/doc/api/getproxyauthorization/): 获取代理连接所需的鉴权信息，按对应产品的规则使用。

## SDK 与代码示例

- [官方 SDK](https://www.kuaidaili.com/doc/dev/sdk/): 查找官方 SDK 与各语言接入资源。
- [SDK 使用示例](https://www.kuaidaili.com/doc/dev/sdk_api_proxy/): 使用 SDK 调用 API 和接入代理的示例。

## CLI 与 AI Agent

- [CLI 安装指南](https://www.kuaidaili.com/kdl-agent/docs/install.md): Markdown 安装说明，包含环境要求和官方安装入口。
- [CLI 使用指南](https://www.kuaidaili.com/kdl-agent/docs/cli-guide.md): Markdown 命令说明，涵盖账户、订单、报价、代理接入和授权边界。
- [Agent Gateway API 指南](https://www.kuaidaili.com/kdl-agent/docs/api-guide.md): 使用 Agent 凭证调用 Gateway；与订单 OpenAPI 分开使用。
- [官方 kdl-agent Skill](https://www.kuaidaili.com/.well-known/skills/kdl-agent/SKILL.md): 面向 AI Agent 的 CLI 使用说明与任务操作约定。

## 故障排查

- [测试代理可用性](https://www.kuaidaili.com/doc/dev/proxy/): 在本地或服务器上验证代理连接与鉴权。
- [API 公共错误码](https://www.kuaidaili.com/doc/api/errcode/): 排查 API 调用失败；代理连接错误另查对应产品开发手册。
- [开发常见问题](https://www.kuaidaili.com/doc/dev/faq/): 代理接入与开发过程中的常见问题。