> 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-hant/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-hant/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.