# cURL 请求参数

下面是参数列表，后面是请求类型的示例：

| 参数       | 描述                                                                                                                                                                               |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| username | 代理用户名                                                                                                                                                                            |
| res      | 表示动态住宅代理请求                                                                                                                                                                       |
| res\_sc  | 表示使用州/城市配置的前缀                                                                                                                                                                    |
| country  | 国家/地区代码采用两个字母格式，不区分大小写。 例如，nl表示位于荷兰的IP； za 代表南非； it为意大利                                                                                                                          |
| city     | 城市名称，应与国家/地区代码组合，例如 nl\_amsterdam                                                                                                                                                |
| state    | <p>美国州，应与城市名称相结合，例如<br>us\_alabama\_birmingham</p>                                                                                                                               |
| SID      | 会话 ID ，可为下次请求保留相同的 IP。否则，系统将默认为每个新请求分配一个新的 IP。相同的 IP 地址可保留直到最终用户设备断开连接。 请注意，res 请求的会话 ID 时间最多可以维持半小时。 SID 支持 1 到 99999999 之间的任意随机字符串。最低的 SID 可以是 sid-1，最高的 SID 可以是 sid-99999999。 |
| NNID     | <p>与标准会话 ID (SSID) 功能相比，长会话 ID 功能允许您在更长的时间范围（会话）内保留相同的 IP。<br>请注意，RES 请求的长会话 ID 时间最多可以维持 1 小时。</p>                                                                               |
| ASN      | 添加 ASN 编号，可以请求特定网络或提供商路由互联网流量                                                                                                                                                    |
| PASSWORD | 代理密码                                                                                                                                                                             |
| site URL | 用户的目标网址                                                                                                                                                                          |

仅输入了用户名和密码的基本请求会配置一个随机的动态IP地址：

·curl-x 用户名-res-any:<PASSWORD@gw.netnut.net>:5959 "example.site.com"

请求特定国家/州/城市代理，如下例所示：

·curl-x 用户名-res-nl:密码@gw\.netnut.net:5959 "example.site.com"

·curl-x 用户名-res\_sc-nl\_amsterdam:密码@gw\.netnut.net:5959 "example.site.com"

·curl-x 用户名-res\_sc-us\_alabama\_birmingham:密码@gw\.netnut.net:5959“example.site.com”

​

添加SID（会话ID）参数可以在下次查询时使用相同的IP。 请注意，SID 前面必须带有国家/地区，如下例所示：

curl-x 用户名-res-any-sid-45456:密码@gw\.netnut.net:5959" "example.site.com"

&#x20;

在请求中输入 ASN 编号，可以从特定运营商或网络中选择代理：

curl-x 用户名-res-ASN-sid-45456:密码@gw\.netnut.net:5959" "example.site.com"

注意：您可以在每个请求中使用国家/地区或 ASN 参数。

您可以点[这里](https://asnlookup.com/)搜索 ASN 编号。

\
与标准会话 ID (SSID) 功能相比，长会话 ID 功能允许您在更长的时间范围（会话）内保留相同的 IP。

请注意，RES 请求的长会话 ID 时间最多可以维持 1 小时。

为了使用长会话 ID 功能，必须发送以下初始请求 –

curl -x 用户名-resfix-<国家/地区>-nnid-0:密码@gw\.netnut.net:5959 "example.site.com"

初始请求的响应将包含唯一令牌 X-NN-LLS，例如 -

< HTTP/1.1 200 OK

< Cache-Control: private

< Content-Type: text/html; charset=utf-8

< Server: Microsoft-IIS/10.0

< X-AspNet-Version: 4.0.30319

< X-Powered-By: ASP.NET

< Date: Wed, 31 Jan 2024 11:11:07 GMT

< Content-Length: 12

< Connection: keep-alive

< X-NN-LLS: c3e2154118da4f6f49d

如果您希望在随后的请求中使用相同 IP 地址（使用相同的 IP 地址直到最终用户设备断开连接），请将 nnid-0 替换为 nnid-"unique token"

例如，使用上述响应，后续请求将为 -curl -x 用户名-resfix-\<country>-nnid- c3e2154118da4f6f49d:密码@gw\.netnut.net:5959 "example.site.com"

重要提示：您收到的唯一令牌与发送的初始请求相关。

例如，如果在初始请求中选择的国家/地区是英国，则唯一令牌将导致所有后续请求使用英国 IP 地址。

<br>


---

# Agent Instructions: 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:

```
GET https://help.netnut.io/netnut-documentation/netnut-documentation-chn/netnut-dai-li/dong-tai-zhu-zhai-dai-li/curl-qing-qiu-can-shu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
