# StatesideIP 美国代理入门（2026）

> 6 步设置美国住宅代理：加密货币支付，复制凭证，用户名添加州、市、邮编或 ASN 定向，使用 curl 测试。无需 KYC；价格从 US$0.52/GB 起。

- URL: https://statesideip.com/zh/guides/getting-started/
- 最后更新: 2026-10-05
- Publisher: StatesideIP (https://statesideip.com)

从支付到首次定向请求：凭证、用户名语法、HTTP 和 SOCKS5 的 curl 测试、粘性会话及常见错误修复。

**快速解答 — 如何设置美国住宅代理？**

要设置 **StatesideIP** 美国住宅代理，请从 US$0.52/GB 购买套餐并复制凭证。在用户名中添加如 `-country-us-state-ny` 的定向信息。然后连接到 `gw.statesideip.com`，端口为 7777（HTTP）或 7778（SOCKS5）。无需 KYC — 无需身份证、自拍或文件。支持加密货币支付。一行 curl 测试即可确认出口 IP。

## 所需内容

| 属性 | 值 |
| --- | --- |
| 套餐 | 任意住宅代理套餐；1 GB 费用为 US$1.50（2026 年 10 月） |
| 网关主机 | `gw.statesideip.com` |
| HTTP/HTTPS 端口 | 7777 |
| SOCKS5 端口 | 7778 |
| 用户名格式 | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| 粘性会话 | 1 到 120 分钟，通过 ttl 参数按会话设置 |
| 测试端点 | `https://api.ipify.org?format=json`（显示您的出口 IP） |
| 工具 | curl、Python、Node.js 或任何支持 HTTP 或 SOCKS5 代理的工具 |
| KYC | 无需 KYC — 无需身份证、无需自拍、无需文件。使用加密货币支付。 |

## 如何从付款到首次请求？

六个步骤让您从空账户到拥有可用的美国 IP。

1. **购买套餐** — 在定价页面]选择一个住宅代理套餐。1 GB套餐，价格为US$1.50，足够进行首次测试。每个套餐（包括最小套餐）都需从US$25的最低充值额支付；余额剩余部分永久有效，不可退款。
2. **加密货币支付** — 选择 BTC、USDT、USDC、ETH、LTC 或 SOL，然后支付发票。详情见加密货币支付]。
3. **打开仪表盘** — 从已确认的加密货币余额购买套餐后，凭证会立即显示在您的仪表板中。复制您的用户名和密码。
4. **构建用户名** — 从您的用户名开始，添加定位段，如-country-us-state-tx。
5. **运行测试** — 向https://api.ipify.org?format=json发送一次 curl 请求，检查打印的 IP。
6. **将您的工具指向网关** — 在您的爬虫、浏览器或脚本中使用gw.statesideip.com，端口为7777或7778。

## 我可以使用哪些用户名段？

StatesideIP用户名中的每个段设置一个选项。仅添加所需的段，格式顺序为：`USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}`。

| 段 | 设置 | 示例 |
| --- | --- | --- |
| `country-{cc}` | 国家，两字母代码 | `country-us`，`country-ca`，`country-pr` |
| `state-{state}` | 美国州或加拿大省份代码 | `state-fl`, `state-on`, `state-bc` |
| `city-{city}` | 城市名，小写，空格用下划线替代 | `city-miami`, `city-san_antonio` |
| `zip-{zip}` | 美国五位数邮政编码 | `zip-77006`（蒙特罗斯，休斯顿） |
| `asn-{asn}` | ISP 网络编号，不带“AS” | `asn-22773`（考克斯） |
| `session-{id}` | 自定义的粘性会话 ID | `session-run7` |
| `ttl-{minutes}` | 粘性会话时长（分钟） | `ttl-45` |

## 如何用 curl 测试代理？

先运行 HTTP 测试，再运行 SOCKS5 测试；两者都会显示请求发出的 IP。每个测试运行两次：没有 `session` 段时，IP 应该会变化。使用 `--socks5-hostname` 以确保 DNS 查询也通过代理。

*HTTP 和 SOCKS5 下的 curl 测试*

```bash
# HTTP/HTTPS gateway: rotating US IP
curl -x http://gw.statesideip.com:7777 \
  -U "USERNAME-country-us:PASSWORD" \
  "https://api.ipify.org?format=json"

# SOCKS5 gateway: rotating IP in Florida
curl --socks5-hostname gw.statesideip.com:7778 \
  -U "USERNAME-country-us-state-fl:PASSWORD" \
  "https://api.ipify.org?format=json"
```

*Python（requests 库）*

```python
# pip install requests
import requests

proxy = "http://USERNAME-country-us-state-ca:PASSWORD@gw.statesideip.com:7777"
r = requests.get("https://api.ipify.org?format=json",
                 proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json())
```

*Node.js（undici 库）*

```javascript
// npm install undici
import { fetch, ProxyAgent } from "undici";

const agent = new ProxyAgent({
  uri: "http://gw.statesideip.com:7777",
  token: "Basic " + Buffer.from("USERNAME-country-us-state-ny:PASSWORD").toString("base64"),
});
const res = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await res.json());
```

从测试切换到真实目标时，请遵守 robots.txt 和各站点条款。[Python 指南](https://statesideip.com/zh/guides/python-us-proxies/) 提供了更多 Python 示例。

## 旋转代理还是粘性会话：我应该选择哪种会话类型？

使用旋转会话处理多个独立请求，使用粘性会话处理必须保持同一 IP 的流程。没有 `session` 段时，每个请求都会获得一个新 IP。使用 `session-{id}` 和 `ttl-{minutes}` 时，IP 会保持您设置的时间：1 到 120 分钟，通过 ttl 参数按会话设置。

- `USERNAME-country-us-state-ga-city-atlanta-session-cart01-ttl-20` 会保持一个亚特兰大 IP 20 分钟。
- 更改会话 ID 可获得不同的粘性 IP。
- 住宅代理的 IP 可能在会话结束前离线，因此请添加重试机制。

## 如何定位州、省、市、邮编、ASN 或加拿大省份？

更改 `country-` 之后的段，网关、端口和密码保持不变。

- **州**：`USERNAME-country-us-state-oh` — 俄亥俄州。
- **市**：`USERNAME-country-us-state-co-city-denver` — 丹佛。
- **邮政编码**：`USERNAME-country-us-zip-98101` — 西雅图市中心。
- **ASN**：`USERNAME-country-us-asn-5650` — Frontier 网络。
- **加拿大省份**：`USERNAME-country-ca-state-on` — 安大略。加拿大使用 `state` 段表示省份。
- **加拿大城市**：`USERNAME-country-ca-state-bc-city-vancouver` — 温哥华。

更多示例：[邮编定位](https://statesideip.com/zh/targeting/zip-code/)]、[ASN 定位](https://statesideip.com/zh/targeting/asn/)] 和 [美国城市中心](https://statesideip.com/zh/residential-proxies/united-states/cities/)]。

## 407 代理身份验证要求错误是什么意思？

407 错误表示网关未接受您的用户名或密码。请检查段中是否有拼写错误，或用户名和密码之间是否缺少冒号。在代理 URL 中，密码中的特殊字符可能需要进行 URL 编码。请从仪表盘重新复制密码。如果凭据正确，请检查余额并联系支持。

## 为什么请求会超时？

超时通常是因为过滤条件过于严格、住宅代理背后的连接速度慢，或目标服务器响应慢。将邮编或 ASN 过滤范围扩大到城市或州。设置客户端超时为 30 秒或更长，并使用新 IP 重试。粘性 IP 也可能因住宅设备离线而断开。

## 为什么 IP 显示错误的位置？

地理位置数据库存在差异，因此正确的 IP 在某些查询工具中可能显示错误。首先确认国家、省份和城市段是否匹配。城市名称需要使用下划线，如 `city-san_antonio`。然后比较两到三个查询服务，并测试目标网站。

## 入门：常见问题

### 开始前我需要准备什么？

您需要一个 StatesideIP 住宅代理计划以及仪表盘中的用户名和密码。您还需要支持 HTTP 或 SOCKS5 代理的工具；curl 足以进行首次测试。1 GB 计划位于 US$1.50，涵盖多个地点的测试。所有计划（包括最小套餐）均需从 US$25 起充值，余额可保留（永不过期，不可退款）。购买无需提供身份证或任何文件。

### 我应该使用哪个端口：7777 还是 7778？

HTTP 和 HTTPS 客户端（如浏览器、Python requests 以及大多数爬虫）请使用端口 7777。当工具需要 socket 级代理时，请使用 SOCKS5 的端口 7778。两个端口使用相同的用户名和定向分段，切换时无需更改登录信息。

### 定向分段需要额外收费吗？

截至2026年10月，每个StatesideIP住宅代理计划均包含州、城市、邮编和ASN段。计划价格从US$1.50起，适用于1 GB到US$0.52/GB的大批量使用，且仅按流量计费。每个计划，包括最小套餐，均需从US$25的最低充值开始支付；余额将保留在您的账户中（永不过期，不可退款）。住宅流量不过期，因此测试余额可供后续使用。

### 我可以用相同的凭证管理多个项目吗？

可以，但子用户功能可以将项目区分开。10 GB的套餐包含每个项目的子用户，100 GB套餐还增加了每个子用户的使用统计。这样每个项目都有独立登录和独立流量统计，更方便成本管理。

### 我如何设置加拿大 IP？

将国家段更改为 `ca`，并使用 `state` 段作为省份。例如，`USERNAME-country-ca-state-qc-city-montreal` 提供蒙特利尔 IP。StatesideIP 涵盖带省份、城市和 ASN 定向的 加拿大全部 10 个省。邮编定向仅适用于五位数的美国邮政编码。

### 如果什么都不管用，我该怎么办？

按照本指南运行 curl 测试，只添加 `-country-us`，以排除定向错误。如果仍然失败，请复制准确的错误信息和时间，并发送邮件给 support@statesideip.com。电子邮件回复时间为12小时内，全年7天服务。切勿在邮件中发送密码。

**准备好获取你的第一个美国 IP 吗？** 来自 US$0.52/GB 的住宅代理，支持州、省、市、邮编和 ASN 定向。无需 KYC — 无需身份证、自拍或文件。支持加密货币支付。 [获取美国住宅代理——来自 US$0.52/GB](https://statesideip.com/zh/pricing/) · [Python 指南](https://statesideip.com/zh/guides/python-us-proxies/)

---

StatesideIP: StatesideIP 是一家美国和加拿大代理提供商：住宅 IP 支持州、城市、邮政编码和 ASN 定位，以及专用 T-Mobile、AT&T 和 Verizon 4G/5G 移动端口。无需 KYC——无需身份证、自拍或文件。加密货币支付。