> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/dai-li-can-shu-shuo-ming.md). # 代理参数说明 在 IPWO 中，代理参数主要通过**用户名（Username）传递**，用于控制 IP 的地区、会话、时长等行为。 👉 这是 IPWO 动态住宅代理的核心机制 *** ### 🚀 参数格式 用户名结构示例： ``` username_custom_zone_US_sid_12345_time_10 ``` 👉 基本格式： ``` username + 参数拼接（用 _ 连接） ``` *** ### 📌 常用参数说明 #### 🌍 国家（zone） 指定代理 IP 所在国家 ``` custom_zone_US ``` 常见示例： * US → 美国 * JP → 日本 * GB → 英国 👉 用于实现地区定向访问 ([Zkjds](https://www.zkjds.com/post/2579.html?utm_source=chatgpt.com)) *** #### 🔄 会话（sid） 控制是否使用粘性 IP（固定 IP） ``` sid_12345 ``` 说明： * 相同 sid → 使用同一个 IP * 不同 sid → 分配不同 IP 👉 适用于登录、账号等需要稳定 IP 的场景 *** #### ⏱ IP 时长（time） 控制 IP 保持时间（分钟） ``` time_10 ``` 说明： * 单位：分钟 * 到期后自动更换 IP 👉 常用于动态轮换代理 ([Zkjds](https://www.zkjds.com/post/2579.html?utm_source=chatgpt.com)) *** #### 🏙 城市（可选） 指定更精细的地理位置 ``` city_Tokyo ``` 👉 可与国家参数组合使用 *** #### 🧭 省份 / 州（可选） ``` st_California ``` 👉 适用于更精准定位（部分地区支持） *** ### ⚡ 完整示例 ```bash curl -x "us.ipwo.net:7878" \ -U "username_custom_zone_US_st_California_city_LosAngeles_sid_12345_time_10:password" \ https://ipinfo.io ``` *** ### 🔍 参数组合规则 * 参数通过 `_` 连接 * 顺序不限（建议保持规范顺序） * 可按需组合多个参数 示例： ``` username_custom_zone_JP_sid_8888_time_5 ``` *** ### 💡 使用建议 * 新手建议先只使用 `zone` * 需要稳定 IP 时再添加 `sid` * 避免一次添加过多参数，方便排错 * 参数越多，控制越精细 *** ### ❗ 常见问题 #### 参数不生效？ * 检查拼写是否正确 * 确认参数格式是否符合规则 *** #### IP 不切换？ * 检查是否设置了固定 sid *** #### IP 不在指定地区？ * 检查 zone / city 是否正确 *** ### 👉 下一步 * 查看「[快速验证](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/kuai-su-yan-zheng.md)」→ 测试参数是否生效 * 查看「[接入方式](broken://pages/FytZ1eL5v0h0ZG7guXuy)」→ 集成到代码 * 查看「[API 提取](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi/api-dong-tai-huo-qu-jin-dong-tai-dai-li.md)」→ 自动获取代理 *** ### 总结 IPWO 参数的核心特点： * 参数写在用户名中 * 通过拼接控制代理行为 * 支持地区、会话、时长等多维控制 👉 理解这一点，就掌握了 IPWO 的核心用法 *** --- # 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://docs.ipwo.net/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/dai-li-can-shu-shuo-ming.md?ask=&goal= ``` `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.