指南

如何设置 LatamProxies 代理（2026）

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

最后更新: 2026年10月5日 · 作者 LatamProxies · 3 分钟阅读

快速回答

如何设置 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；未使用余额保留在您的账户中

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

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

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

代理用户名如何构建？

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

仅USERNAME：来自任意支持国家的轮换IP。
USERNAME-country-mx：来自墨西哥的轮换IP。
USERNAME-country-ar-city-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 网关，巴西

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

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

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

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，圣保罗粘性会话

# 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，阿根廷

// 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，智利

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

// 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) — 巴西

# 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

// 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 价格监控，或检查多个地点的搜索结果。
粘性（-session-ID-ttl-30）：适合浏览器自动化、依赖 cookie 的分页、自己店铺的结账流程测试和广告验证任务。

对于 4G/5G 专用端口，轮换方式不同：通过 API 链接更换 IP。详见移动代理轮换指南。

常见错误是什么意思？

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

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

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

设置问题

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

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

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

在用户名中添加 -country- 和两位小写 ISO 代码：巴西为 br，墨西哥为 mx，阿根廷为 ar，哥伦比亚为 co，智利为 cl，秘鲁为 pe。完整的 38 国家列表见国家页面。

如何保持相同 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 使用。使用本指南中示例的主机、端口和用户名格式。如果工具无法发送代理凭证，请联系 [email protected]。

测试设置费用是多少？

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

获取您的凭证

用 USDT、BTC 或其他币种购买套餐，充值到账后即可开始发送请求。

从 US$0.50/GB 获取住宅代理住宅代理