> ## 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 |