> For the complete documentation index, see [llms.txt](https://jollyproxy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jollyproxy.gitbook.io/docs/zh-hans/zhu-zhai-dai-li/can-shu-shuo-ming.md).

# 参数说明

{% hint style="danger" icon="exclamation" %}
**使用须知**：JollyProxy 全系代理产品均需在海外网络环境下运行，请确保您已自行配置好相应的海外网络环境。
{% endhint %}

本文展示如何使用 `curl` 通过 JollyProxy 住宅代理发起请求，适用于终端或脚本中直接调用代理连接。

**参数格式**

```yaml
<账户名>-<代理类型>-<定位信息>[-sid-<会话ID>]
```

**参数说明**

<table data-header-hidden data-search="false"><thead><tr><th width="156.2000732421875"></th><th width="124"></th><th width="128.4000244140625"></th><th></th></tr></thead><tbody><tr><td>名称</td><td>类型</td><td>是否必备</td><td>备注</td></tr><tr><td><code>account</code></td><td>string</td><td>是</td><td>账户名</td></tr><tr><td><code>proxyAdress</code></td><td>string</td><td>是</td><td>代理地址</td></tr><tr><td><code>country</code></td><td>string</td><td>否</td><td>国家</td></tr><tr><td><code>state</code></td><td>string</td><td>否</td><td>省份</td></tr><tr><td><code>city</code></td><td>string</td><td>否</td><td>城市</td></tr><tr><td><code>session</code></td><td>string</td><td>否</td><td>会话ID，最长支持 11 位字符</td></tr><tr><td><code>sessTime</code></td><td>int64</td><td>否</td><td>预设 5 分钟，可选 1-180 分钟</td></tr><tr><td><code>sessFallBack</code></td><td>int64</td><td>否</td><td>下线时，是否补充节点</td></tr></tbody></table>

**定位格式**

<table data-header-hidden><thead><tr><th width="133"></th><th width="230.39990234375"></th><th width="129"></th><th></th></tr></thead><tbody><tr><td>级别</td><td>格式</td><td>代理类型写法</td><td>示例</td></tr><tr><td>无定位</td><td><code>any</code></td><td><code>res</code></td><td><code>account-res-any</code></td></tr><tr><td>国家</td><td><code>&#x3C;country></code></td><td><code>res</code></td><td><code>account-res-us</code></td></tr><tr><td>国家+州</td><td><code>&#x3C;country>_&#x3C;state></code></td><td><code>res_sc</code></td><td><code>account-res_sc-us_california</code></td></tr><tr><td>国家+州+城市</td><td><code>&#x3C;country>_&#x3C;state>_&#x3C;city></code></td><td><code>res_sc</code></td><td><code>account-res_sc-us_california_losangeles</code></td></tr></tbody></table>

> **说明：**
>
> * **当定位信息包含州或城市时，代理类型必须添加 `sc` 后缀（如 `res_sc`）**
> * **所有地区名称需使用小写字母，且不含空格，例如：`us`、`california`、`losangeles`、`newsouthwales`**

**请求示例**

以下示例中，请将 `account`、`password`、`[ip]`、`[port]` 替换为您实际获取的代理信息。

**1. 随机节点（无定位）**

```shell
# 不固定节点（每次请求自动更换 IP）
curl -x http://account-res-any:password@[ip]:[port] http://httpbin.org/ip

# 固定节点（通过 sid 保持同一 IP）
curl -x http://account-res-any-sid-295592634:password@[ip]:[port] http://httpbin.org/ip
```

**2. 指定国家**

```shell
# 不固定节点
curl -x http://account-res-us:password@[ip]:[port] http://httpbin.org/ip

# 固定节点
curl -x http://account-res-us-sid-295592634:password@[ip]:[port] http://httpbin.org/ip
```

**3. 指定国家-地区（需使用 socks5 协议及 res\_sc 类型）**

```shell
# 不固定节点
curl -x socks5://account-res_sc-us_california:password@[ip]:[port] http://httpbin.org/ip

# 固定节点
curl -x socks5://account-res_sc-us_california-sid-295592634:password@[ip]:[port] http://httpbin.org/ip
```

**4. 指定国家-地区-城市（需使用 res\_sc 类型）**

```shell
# 不固定节点
curl -x http://account-res_sc-us_california_losangeles:password@[ip]:[port] http://httpbin.org/ip

# 固定节点
curl -x http://account-res_sc-us_california_losangeles-sid-295592634:password@[ip]:[port] http://httpbin.org/ip
```


---

# 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://jollyproxy.gitbook.io/docs/zh-hans/zhu-zhai-dai-li/can-shu-shuo-ming.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.