# How to quickly integrate and use Cliproxy traffic packages

#### Host and Port

**Host：** The IP or domain name of the connected Socks5 intermediate server.

**Port：** The Socks5 port that the intermediate server listens on.

**Function：**

* All clients connect to the same intermediate server.
* This server acts as a forwarding center for proxy requests.

**Special note**：Currently only us.cliproxy.io (United States) and sg.cliproxy.io (Singapore) are provided as intermediate servers. Please select an intermediate server that is closer to the region where the exit IP is located.

#### Account

**Format 1 (Sticky IP):**`username-region-region abbreviation-st-state name-sid-current session unique identifier-t-IP duration (`For example: test123456-region-US-st-Louisiana-sid-e6CXdJDm-t-15)

**Format 2 (Rotating IP)**:`username-region-region abbreviation-st-state name (`For example: test123456-region-US-st-Louisiana)

**Function:**

* The account part (`username`) is used to identify the user.
* The server parses the parameters of `username`, `region` and `st`, and selects the appropriate export according to the configuration.

**Special Note**:

* All parameters are separated by "-", of which **username** and **region** are **required** items, and other parameters can be empty. For example, format 1 can be **test123456-region-US-t-15** and format 2 can be **test123456-region-US**
* If the **current session identifier (sid)** changes, it will be considered a new request, and the intermediate server will automatically assign a **new IP**

#### Password

**Function:**Used for user authentication. Does not affect the selection of the egress IP, only for security verification.

#### Logical process

**Client connects to the Socks5 server**

* Use the specified host:port to connect.

**Server parses account information**

* Extracts `username` `region parameter` `session type` information
* Verifies whether `username` is valid.
* Finds whether the `egress IP` is available according to the `region parameter` (if not specified, the default policy is used for allocation).

**Password authentication**

* The server verifies whether `password` is correct.
* If the authentication fails, the connection is rejected.

**Egress IP selection**

* If the `egress IP geographic location` is explicitly specified in the account, the geographic location IP is used as the egress.
* If the `geolocation` is not specified, the egress IP is allocated according to the predefined policy (such as polling, load balancing, etc.).

**Connect to target server**

* The server initiates a connection to the target address based on the resolved exit IP and forwards traffic.

#### Typical Examples

| Cliproxy Account                                    | Connection exit IP location | 备注                                                                                                                                          |
| --------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| test123456-region-US-st-Louisiana-sid-e6CXdJDm-t-15 | Louisiana, USA              | When the sid changes, the egress IP will also change. If the sid does not change, the egress IP will automatically switch after 15 minutes. |
| test123456-region-SG-t-15                           | Singapore                   | null                                                                                                                                        |
| test123456-region-HK                                | Hongkong                    | Each request will connect to the target website with a new exit IP                                                                          |


---

# 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.cliproxy.com/faq/traffic-api.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.