# Come configurare proxy residenziali LatamProxies (2026)

> Configura LatamProxies proxy residenziali latinoamericani in cURL, Python, Node.js, Playwright e Puppeteer: porta 7777, SOCKS5, targeting per paese. Senza KYC, crypto.

- URL: https://latamproxies.com/it/guides/proxy-setup/
- Ultimo aggiornamento: 2026-10-05
- Publisher: LatamProxies (https://latamproxies.com)

Esempi da copiare e incollare per cURL, Python, Node.js, Playwright e Puppeteer, con targeting per paese, città e sessione sticky per l'America Latina.

**Risposta rapida — Come posso configurare proxy residenziali LatamProxies?**

Per configurare **proxy residenziali LatamProxies**, punta il tuo strumento a `gw.latamproxies.com` sulla porta `7777` (HTTP/HTTPS) o `7778` (SOCKS5). Inserisci il tuo targeting nel nome utente, per esempio `USERNAME-country-br-city-sao_paulo`, e usa la tua password proxy. Il traffico residenziale parte da 0,50 USD/GB. Senza KYC — nessun documento, nessun selfie, nessuna verifica d'identità. Paga in criptovalute.

## Dettagli di connessione

| Attributo | Valore |
| --- | --- |
| Host gateway | `gw.latamproxies.com` |
| Porta HTTP / HTTPS | `7777` |
| Porta SOCKS5 | `7778` |
| Formato nome utente | `USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}` |
| Codice paese | ISO 3166-1, minuscolo: `br`, `mx`, `ar`, `co`, `cl`, `pe` |
| Città | Minuscolo, spazi come `_`: `sao_paulo`, `mexico_city`, `buenos_aires` |
| Rotazione | Nuovo IP a ogni richiesta, oppure sessioni sticky fino a 30 minuti |
| Prezzo | Proxy residenziali da 0,50 USD/GB · senza KYC · solo crypto |
| Ricarica | Minimo 25 USD in criptovalute; il saldo non utilizzato resta sul tuo account. |

## Come passo dal pagamento alla prima richiesta?

Cinque passaggi, pochi minuti in totale una volta confermato il pagamento.

1. **Acquista un piano** — Scegli un piano sulla pagina prezzi e paga in USDT, BTC, USDC, ETH, LTC o SOL. Il piano 1 GB a 2,63 USD è sufficiente per testare. Il piano piccolo si paga con una ricarica minima di 25 USD; il resto rimane sul tuo saldo (non scade mai, non rimborsabile).
2. **Copia le tue credenziali** — Apri il pannello di controllo e copia username e password del proxy. Non sono il numero del tuo account.
3. **Costruisci lo username** — Aggiungi il targeting allo username: -country-br per Brasile, -city-sao_paulo per una città, -session-abc123-ttl-30 per un IP sticky.
4. **Testa con cURL** — Esegui una richiesta cURL tramite il gateway e verifica che IP e paese corrispondano a quanto richiesto.
5. **Inseriscilo nel tuo strumento** — Usa gli esempi qui sotto per Python, Node.js, Playwright o Puppeteer.

## Come si costruisce lo username del proxy?

Tutto il targeting va nello username, così non serve un host o porta diversi per ogni paese. Il formato completo è `USERNAME-country-{cc}-city-{city}-session-{id}-ttl-{minutes}`. Ogni parte dopo `USERNAME` è opzionale.

- `USERNAME` da solo: un IP rotante da qualsiasi paese supportato.
- `USERNAME-country-mx`: un IP rotante in [Messico](https://latamproxies.com/it/residential-proxies/mexico/).
- `USERNAME-country-ar-city-buenos_aires`: un IP rotante a [Buenos Aires](https://latamproxies.com/it/residential-proxies/argentina/buenos-aires/).
- `USERNAME-country-br-session-abc123-ttl-30`: lo stesso IP brasiliano per fino a 30 minuti.

I codici paese sono codici ISO a due lettere in minuscolo. I nomi delle città sono minuscoli con `_` al posto degli spazi e senza accenti: `sao_paulo`, non `São Paulo`. Non aggiungere altri parametri: il gateway non legge ASN, CAP o parametri carrier nello username.

### Parametri dello username

| Parametro | Esempio | Cosa fa |
| --- | --- | --- |
| `country` | `-country-co` | IP di uscita in quel paese (qui Colombia) |
| `city` | `-city-mexico_city` | IP di uscita in quella città; usalo insieme a `country` |
| `session` | `-session-job42` | Mantiene la stessa IP finché l'id rimane invariato |
| `ttl` | `-ttl-30` | Durata della sessione in minuti, fino a 30 minuti |

## Come posso testare il proxy con cURL?

cURL è il modo più veloce per verificare che le tue credenziali e il targeting funzionino. La richiesta qui sotto passa attraverso il gateway HTTP e stampa l'IP di uscita. Sostituisci `USERNAME` e `PASSWORD` con i valori dal tuo cruscotto.

*cURL — gateway HTTP, Brasile*

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

*cURL — SOCKS5, Città del Messico, sessione sticky 30 minuti*

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

## Come uso il proxy con Python requests?

Con `requests`, imposta la stessa URL del proxy sia per `http` che per `https`. Gli obiettivi HTTPS sono tunnelati tramite il gateway HTTP con CONNECT, quindi lo schema URL del proxy rimane `http://`. Per SOCKS5, installa `requests[socks]` e usa `socks5h://` così il DNS viene risolto tramite il proxy, nel paese target.

*Python requests — IP rotante in Colombia*

```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, sessione sticky a São Paulo*

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

## Come uso il proxy con Node.js?

In Node.js 18 o versioni successive, il `fetch` integrato non legge le impostazioni del proxy, quindi usa il `ProxyAgent` di `undici` e passalo come `dispatcher`. Con `axios`, usa `https-proxy-agent` e imposta `proxy: false` così axios non applica la sua logica proxy.

*Node.js — undici ProxyAgent, Argentina*

```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 con https-proxy-agent, Cile*

```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);
```

## Come uso il proxy con Playwright?

Playwright accetta il server proxy, nome utente e password al lancio. Usa una sessione sticky per il lavoro con il browser: una pagina carica molte risorse, e un IP per pagina mantiene la sessione coerente. Cambia l'id della sessione per ottenere un nuovo IP per il prossimo contesto del browser.

*Playwright (Node.js) — IP sticky a Lima*

```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) — Brasile*

```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()
```

## Come uso il proxy con Puppeteer?

Chrome non accetta le credenziali all'interno di `--proxy-server`, quindi Puppeteer passa il server come argomento di avvio e il nome utente e la password con `page.authenticate()`.

*Puppeteer — proxy residenziali con IP sticky a Città del Messico*

```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();
```

## Devo usare sessioni rotanti o sticky?

Usa proxy residenziali con IP rotanti per richieste indipendenti e sessioni sticky per flussi multi-step. Nuovo IP a ogni richiesta, oppure sessioni sticky fino a 30 minuti.

- **Rotanti** (senza `session`): ideali per scansionare molte pagine prodotto, come il monitoraggio prezzi di [Mercado Libre](https://latamproxies.com/it/use-cases/mercado-libre-price-monitoring/), o per controllare risultati di ricerca da molte località.
- **Sticky** (`-session-ID-ttl-30`): perfetti per automazione browser, paginazione che dipende dai cookie, test di checkout sul tuo store e percorsi di [verifica annunci](https://latamproxies.com/it/use-cases/ad-verification/).

Per le porte dedicate 4G/5G, la rotazione funziona diversamente: cambi l'IP tramite un link API. Vedi la [guida alla rotazione dei proxy mobili](https://latamproxies.com/it/guides/mobile-proxy-rotation/).

## Cosa significano gli errori comuni?

La maggior parte dei problemi deriva dalla stringa del nome utente o dal sito target:

- **407 Proxy Authentication Required**: nome utente o password errati. Controlla spazi e codifica URL i caratteri speciali nella password.
- **Connessione rifiutata o timeout alla connessione**: verifica host e porta. HTTP usa `7777`, SOCKS5 usa `7778`.
- **Paese sbagliato**: controlla il codice paese (`br`, non `bra`) e l'ortografia della città (`sao_paulo`).
- **403 o CAPTCHA dal target**: rallenta, ruota più spesso o usa una sessione sticky con un browser reale.
- **Target rifiutato dal gateway**: banche, portali governativi, portali di pagamento e SMTP sono bloccati dalla nostra [Politica di Uso Accettabile](https://latamproxies.com/it/acceptable-use-policy/).

Se il problema persiste, scrivi a support@latamproxies.com con la tua stringa nome utente (senza password), il target e l'errore.

## Domande di configurazione

### Quale host e porta usano i proxy LatamProxies?

Tutto il traffico residenziale passa attraverso `gw.latamproxies.com`. Usa la porta `7777` per target HTTP e HTTPS, e la porta `7778` per SOCKS5. Lo stesso host e porte funzionano per ogni paese; il targeting si imposta nel nome utente, per esempio `USERNAME-country-cl`.

### Come posso targettizzare un paese specifico dell'America Latina?

Aggiungi `-country-` e il codice ISO a due lettere in minuscolo al tuo nome utente: `br` per Brasile, `mx` per Messico, `ar` per Argentina, `co` per Colombia, `cl` per Cile, `pe` per Perù. La lista completa dei paesi 38 è sulla [pagina dei paesi](https://latamproxies.com/it/residential-proxies/countries/).

### Come faccio a mantenere lo stesso IP?

Aggiungi `-session-` con un qualsiasi ID e `-ttl-` con un numero di minuti, per esempio `USERNAME-country-br-session-abc123-ttl-30`. L'IP resta lo stesso finché riutilizzi quell'ID, fino a 30 minuti. Usa un nuovo ID per ottenere un nuovo IP.

### Devo usare HTTP o SOCKS5?

Usa HTTP sulla porta `7777` per la maggior parte degli strumenti: browser, scraper e librerie HTTP lo gestiscono nativamente, e i target HTTPS sono tunnelizzati in modo sicuro. Usa SOCKS5 sulla porta `7778` quando uno strumento supporta solo SOCKS, o quando vuoi risolvere DNS lato proxy con `socks5h://`.

### Il mio nome utente proxy è lo stesso del numero account?

No. Il numero account serve per accedere al dashboard. Il nome utente e la password proxy sono mostrati nel dashboard e si usano solo per il gateway. Non condividere mai il numero account e non inserirlo mai negli script.

### Posso usare i proxy con Scrapy, Selenium o altri strumenti?

Sì. Qualsiasi strumento che supporta proxy HTTP o SOCKS5 con autenticazione username e password funziona con LatamProxies. Usa lo stesso host, porta e formato nome utente mostrati in questa guida. Se uno strumento non può inviare credenziali proxy, contatta support@latamproxies.com.

### Quanto costa testare la configurazione?

Il piano residenziale più piccolo costa 1 GB per 2,63 USD, sufficiente per migliaia di richieste di test su pagine leggere. I piani più grandi costano meno per GB, fino a 0,50 USD/GB. Senza KYC — niente ID, selfie o documenti. Paga in crypto. Vedi la [pagina prezzi](https://latamproxies.com/it/pricing/). Il piano piccolo si paga con un ricarica minima di 25 USD; il resto resta sul tuo saldo (mai scade, non rimborsabile).

**Ottieni le tue credenziali** Acquista un piano con USDT, BTC o un'altra coin e inizia a inviare richieste appena il tuo saldo è accreditato. [Ottieni proxy residenziali — da 0,50 USD/GB](https://latamproxies.com/it/pricing/) · [Proxy residenziali](https://latamproxies.com/it/residential-proxies/)

---

LatamProxies: LatamProxies è un provider senza KYC di proxy residenziali e mobili 4G/5G per l'America Latina e i Caraibi — Brasile, Messico, Argentina, Colombia, Cile, Perù e altri — pagamento solo in criptovalute (USDT, BTC, USDC, ETH, LTC, SOL). Il traffico residenziale parte da 0,50 USD/GB.