> ## Documentation Index
> Fetch the complete documentation index at: https://help.ip2up.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CURL請求

<Tip>平台的所有代理產品均需要在海外網路環境下使用，海外網路環境需要客戶自行配置。</Tip>

本文展示如何使用 `curl` 透過Ip2up靜態住宅代理IP發起請求，適用於終端或腳本中直接調用代理連線。
靜態住宅代理包含 **原生住宅 IP** 與 **ISP IP** 兩種線路類型，均支援帳號密碼子帳號認證，且出口 IP 在連線期間保持固定不變。

## HTTP 代理

```bash theme={null}
curl -x http://USERNAME:PASSWORD@PROXY_IP:PROXY_PORT https://ipinfo.io
```

## SOCKS5 代理

```bash theme={null}
curl --socks5 USERNAME:PASSWORD@PROXY_IP:PROXY_PORT https://ipinfo.io
```

## 關鍵參數說明

| 參數           | 說明                           |
| ------------ | ---------------------------- |
| `USERNAME`   | 代理連線認證的子帳號                   |
| `PASSWORD`   | 子帳號對應的連線密碼                   |
| `PROXY_IP`   | 靜態住宅代理出口 IP                  |
| `PROXY_PORT` | 代理端口                         |
| `-x`         | 指定 HTTP 代理模式                 |
| `--socks5`   | 指定 SOCKS5 代理模式               |
| `ipinfo.io`  | 僅用於驗證代理連通性和出口地域，可替換為任意目標 URL |