# 如何设置 LatamProxies 代理（2026）

> 在 cURL、Python、Node.js、Playwright 和 Puppeteer 中设置 LatamProxies 拉丁美洲代理：端口 7777，SOCKS5，国家定向。无需 KYC，支持加密货币支付。

- URL: https://latamproxies.com/zh/guides/proxy-setup/
- 最后更新: 2026-10-05
- Publisher: LatamProxies (https://latamproxies.com)

提供 cURL、Python、Node.js、Playwright 和 Puppeteer 的复制粘贴示例，支持拉丁美洲的国家、城市和粘性会话定向。

**快速回答 — 如何设置 LatamProxies 代理？**

要设置 **LatamProxies** 代理，请将您的工具指向端口为 `7777`（HTTP/HTTPS）或 `7778`（SOCKS5）的 `gw.latamproxies.com`。将定向信息放入用户名，例如 `USERNAME-country-br-city-sao_paulo`，并使用您的代理密码。住宅代理流量起始于 US$0.50/GB。无需 KYC——无身份证、无自拍、无文件。支持加密货币支付。

## 连接详情

| 属性 | 值 |
| --- | --- |
| 网关主机 | `gw.latamproxies.com` |
| HTTP / HTTPS 端口 | `7777` |
| SOCKS5 端口 | `7778` |
| 用户名格式 | `USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}` |
| 国家代码 | ISO 3166-1，小写：`br`，`mx`，`ar`，`co`，`cl`，`pe` |
| 城市 | 小写，空格用`_`替代：`sao_paulo`，`mexico_city`，`buenos_aires` |
| 轮换 | 每次请求更换新 IP，或粘性会话最长 30 分钟 |
| 价格 | 住宅代理来自US$0.50/GB · 无需 KYC · 仅加密货币支付 |
| 充值 | 加密货币最低充值 US$25；未使用余额保留在您的账户中 |

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

五个步骤，总共几分钟，付款确认后即可开始。

1. **购买套餐** — 在价格页面选择套餐并用USDT、BTC、USDC、ETH、LTC或SOL支付。US$2.63的1 GB套餐足以测试。小套餐最低充值为US$25；余额不会过期且不可退款。
2. **复制您的凭证** — 打开仪表盘，复制您的代理用户名和密码。它们不是您的账户号码。
3. **构建用户名** — 在用户名中添加定位参数：巴西用-country-br，城市用-city-sao_paulo，粘性IP用-session-abc123-ttl-30。
4. **用cURL测试** — 通过网关运行一次cURL请求，检查IP和国家是否符合要求。
5. **将其接入您的工具** — 参考下面的Python、Node.js、Playwright或Puppeteer示例。

## 代理用户名如何构建？

所有定位信息都放在用户名中，因此每个国家无需不同的主机或端口。完整格式为`USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}`。`USERNAME`之后的部分均为可选。

- 仅`USERNAME`：来自任意支持国家的轮换IP。
- `USERNAME-country-mx`：来自[墨西哥](https://latamproxies.com/zh/residential-proxies/mexico/)的轮换IP。
- `USERNAME-country-ar-city-buenos_aires`：来自[布宜诺斯艾利斯](https://latamproxies.com/zh/residential-proxies/argentina/buenos-aires/)的轮换IP。
- `USERNAME-country-br-session-abc123-ttl-30`：同一巴西IP，最长30分钟。

国家代码为小写两字母ISO代码。城市名小写，空格用`_`替代，无重音符号：`sao_paulo`，而非`São Paulo`。不要添加其他参数：网关不读取用户名中的ASN、邮编或运营商参数。

### 用户名参数

| 参数 | 示例 | 作用 |
| --- | --- | --- |
| `country` | `-country-co` | 该国家的出口IP（此处为哥伦比亚） |
| `city` | `-city-mexico_city` | 该城市的出口 IP；与 `country` 一起使用 |
| `session` | `-session-job42` | 只要 id 不变，IP 保持不变 |
| `ttl` | `-ttl-30` | 会话时长（分钟），最长 30 分钟 |

## 如何用 cURL 测试代理？

cURL 是最快验证您的凭证和目标设置的方法。下面的请求通过 HTTP 网关，打印出口 IP。将 `USERNAME` 和 `PASSWORD` 替换为您的控制面板中的值。

*cURL — HTTP 网关，巴西*

```bash
curl -x http://gw.latamproxies.com:7777 \
  -U "USERNAME-country-br:PASSWORD" \
  https://api.ipify.org?format=json
```

*cURL — SOCKS5，墨西哥城，粘性 30 分钟*

```bash
curl --socks5-hostname gw.latamproxies.com:7778 \
  -U "USERNAME-country-mx-city-mexico_city-session-abc123-ttl-30:PASSWORD" \
  https://api.ipify.org?format=json
```

## 如何用 Python requests 使用代理？

使用 `requests`，为 `http` 和 `https` 设置相同的代理 URL。HTTPS 目标通过 HTTP 网关的 CONNECT 隧道，因此代理 URL 协议保持为 `http://`。对于 SOCKS5，安装 `requests[socks]` 并使用 `socks5h://`，确保 DNS 在目标国家通过代理解析。

*Python requests — 哥伦比亚轮换 IP*

```python
import requests

USER = "USERNAME-country-co"
PASS = "PASSWORD"
proxy = f"http://{USER}:{PASS}@gw.latamproxies.com:7777"

proxies = {"http": proxy, "https": proxy}
r = requests.get("https://api.ipify.org?format=json", proxies=proxies, timeout=30)
print(r.json())
```

*Python requests — SOCKS5，圣保罗粘性会话*

```python
# pip install "requests[socks]"
import requests

USER = "USERNAME-country-br-city-sao_paulo-session-job42-ttl-30"
PASS = "PASSWORD"
proxy = f"socks5h://{USER}:{PASS}@gw.latamproxies.com:7778"

with requests.Session() as s:
    s.proxies = {"http": proxy, "https": proxy}
    for _ in range(3):
        print(s.get("https://api.ipify.org?format=json", timeout=30).json())  # same IP 3 times
```

## 如何用 Node.js 使用代理？

在 Node.js 18 及以上版本，内置的 `fetch` 不读取代理设置，需使用 `undici` 的 `ProxyAgent` 并作为 `dispatcher` 传入。使用 `axios` 时，使用 `https-proxy-agent` 并设置 `proxy: false`，防止 axios 自行处理代理逻辑。

*Node.js — undici ProxyAgent，阿根廷*

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

const user = 'USERNAME-country-ar';
const pass = 'PASSWORD';
const dispatcher = new ProxyAgent({
  uri: 'http://gw.latamproxies.com:7777',
  token: 'Basic ' + Buffer.from(`${user}:${pass}`).toString('base64'),
});

const res = await fetch('https://api.ipify.org?format=json', { dispatcher });
console.log(await res.json());
```

*Node.js — axios 搭配 https-proxy-agent，智利*

```javascript
// npm install axios https-proxy-agent
import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const user = encodeURIComponent('USERNAME-country-cl');
const pass = encodeURIComponent('PASSWORD');
const agent = new HttpsProxyAgent(`http://${user}:${pass}@gw.latamproxies.com:7777`);

const { data } = await axios.get('https://api.ipify.org?format=json', {
  httpsAgent: agent,
  proxy: false,
  timeout: 30000,
});
console.log(data);
```

## 如何用 Playwright 使用代理？

Playwright 启动时接受代理服务器、用户名和密码。浏览器工作时使用粘性会话：页面加载多个资源，单个 IP 保持会话一致。更改会话 id 可为下一个浏览器上下文获取新 IP。

*Playwright (Node.js) — 利马粘性 IP*

```javascript
// npm install playwright
import { chromium } from 'playwright';

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.latamproxies.com:7777',
    username: 'USERNAME-country-pe-city-lima-session-pw1-ttl-30',
    password: 'PASSWORD',
  },
});
const page = await browser.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body'));
await browser.close();
```

*Playwright (Python) — 巴西*

```python
# pip install playwright && playwright install chromium
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.latamproxies.com:7777",
        "username": "USERNAME-country-br-session-pw2-ttl-30",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org?format=json")
    print(page.text_content("body"))
    browser.close()
```

## 如何用 Puppeteer 使用代理？

Chrome 不接受位于 `--proxy-server` 内的凭据，因此 Puppeteer 通过启动参数传递服务器，并通过 `page.authenticate()` 传递用户名和密码。

*Puppeteer — 墨西哥城的粘性 IP*

```javascript
// npm install puppeteer
import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://gw.latamproxies.com:7777'],
});
const page = await browser.newPage();
await page.authenticate({
  username: 'USERNAME-country-mx-city-mexico_city-session-pp1-ttl-30',
  password: 'PASSWORD',
});
await page.goto('https://api.ipify.org?format=json');
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();
```

## 我应该使用轮换还是粘性会话？

独立请求使用轮换 IP，多步骤流程使用粘性会话。每次请求更换新 IP，或粘性会话最长 30 分钟。

- **轮换**（无 `session`）：适合抓取大量产品页面，例如 [Mercado Libre 价格监控](https://latamproxies.com/zh/use-cases/mercado-libre-price-monitoring/)，或检查多个地点的搜索结果。
- **粘性**（`-session-ID-ttl-30`）：适合浏览器自动化、依赖 cookie 的分页、自己店铺的结账流程测试和 [广告验证](https://latamproxies.com/zh/use-cases/ad-verification/) 任务。

对于 4G/5G 专用端口，轮换方式不同：通过 API 链接更换 IP。详见 [移动代理轮换指南](https://latamproxies.com/zh/guides/mobile-proxy-rotation/)。

## 常见错误是什么意思？

大多数问题来自用户名字符串或目标网站：

- **407 代理认证要求**：用户名或密码错误。检查空格，并对密码中的特殊字符进行 URL 编码。
- **连接被拒绝或连接超时**：检查主机和端口。HTTP 使用 `7777`，SOCKS5 使用 `7778`。
- **国家错误**：检查国家代码（`br`，不是 `bra`）和城市拼写（`sao_paulo`）。
- **目标返回 403 或 CAPTCHA**：放慢速度，更频繁轮换，或使用带真实浏览器的粘性会话。
- **网关拒绝目标**：银行、政府门户、支付门户和 SMTP 被我们的[可接受使用政策](https://latamproxies.com/zh/acceptable-use-policy/)阻止。

如果问题持续，请发送邮件至 support@latamproxies.com，附上您的用户名字符串（不含密码）、目标和错误信息。

## 设置问题

### LatamProxies 代理使用什么主机和端口？

所有住宅代理流量均通过 `gw.latamproxies.com`。HTTP 和 HTTPS 目标使用端口 `7777`，SOCKS5 使用端口 `7778`。所有国家使用相同主机和端口；目标国家通过用户名设置，例如 `USERNAME-country-cl`。

### 如何定位特定的拉美国家？

在用户名中添加 `-country-` 和两位小写 ISO 代码：巴西为 `br`，墨西哥为 `mx`，阿根廷为 `ar`，哥伦比亚为 `co`，智利为 `cl`，秘鲁为 `pe`。完整的 38 国家列表见[国家页面](https://latamproxies.com/zh/residential-proxies/countries/)。

### 如何保持相同 IP？

在用户名中添加 `-session-` 和任意 ID，以及 `-ttl-` 和分钟数，例如 `USERNAME-country-br-session-abc123-ttl-30`。只要重复使用该 ID，IP 就保持不变，适用于 最长 30 分钟。使用新 ID 可获得新 IP。

### 我应该使用 HTTP 还是 SOCKS5？

大多数工具使用 HTTP 端口 `7777`：浏览器、爬虫和 HTTP 库都原生支持，HTTPS 目标通过隧道安全传输。当工具只支持 SOCKS，或者你想让 DNS 在代理端解析时，使用 SOCKS5 端口 `7778`，配合 `socks5h://`。

### 我的代理用户名和账户号码一样吗？

不一样。账户号码用于登录仪表盘。代理用户名和密码显示在仪表盘中，仅用于网关。切勿分享账户号码，也不要将其写入脚本。

### 我可以用 Scrapy、Selenium 或其他工具使用代理吗？

可以。任何支持带用户名密码认证的 HTTP 或 SOCKS5 代理的工具都可以配合 LatamProxies 使用。使用本指南中示例的主机、端口和用户名格式。如果工具无法发送代理凭证，请联系 support@latamproxies.com。

### 测试设置费用是多少？

最小的住宅代理套餐是 1 GB，包含 US$2.63，足够进行数千次轻量页面的测试请求。更大套餐的每 GB 价格更低，最低可达 US$0.50/GB。无需 KYC —— 无需身份证、自拍或文件。支持加密货币支付。详见[价格页面](https://latamproxies.com/zh/pricing/)。小套餐最低充值 US$25 起，余额永不过期且不可退款。

**获取您的凭证** 用 USDT、BTC 或其他币种购买套餐，充值到账后即可开始发送请求。 [从 US$0.50/GB 获取住宅代理](https://latamproxies.com/zh/pricing/) · [住宅代理](https://latamproxies.com/zh/residential-proxies/)

---

LatamProxies: LatamProxies 是一家面向拉丁美洲和加勒比地区的无需 KYC 住宅和 4G/5G 移动代理提供商——覆盖巴西、墨西哥、阿根廷、哥伦比亚、智利、秘鲁等——仅支持加密货币支付（USDT、BTC、USDC、ETH、LTC、SOL）。住宅流量起价 US$0.50/GB。