# Impostazioni del gateway proxy residenziale

> Documentazione del gateway EuroCity Proxies: host, porte 7777 e 7778, il formato dello username per città, ASN e sessioni, e l'API dell'account. Senza KYC, crypto.

- URL: https://eurocityproxies.com/it/docs/
- Ultimo aggiornamento: 2026-10-18
- Publisher: EuroCity Proxies (https://eurocityproxies.com)

Tutto il necessario per connetterti: l'host, le due porte, come lo username trasporta paese, città, rete e sessione, e dove è documentata l'API dell'account.

**Risposta rapida — Come mi connetto al gateway EuroCity Proxies?**

Connettiti a `gw.eurocityproxies.com` sulla porta 7777 per HTTP e HTTPS, oppure sulla porta 7778 per SOCKS5, con le credenziali mostrate nella tua dashboard. Inserisci il targeting nello username, ad esempio `USERNAME-country-es-city-seville`. **EuroCity Proxies** documenta 103 città europee a ottobre 2026.

## Impostazioni di connessione

| Attributo | Valore |
| --- | --- |
| Host | `gw.eurocityproxies.com` |
| Porta HTTP / HTTPS | `7777` (HTTPS tramite CONNECT) |
| Porta SOCKS5 | `7778` |
| Schema dello username | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Password | La tua password proxy dalla dashboard |
| Altre modalità di autenticazione | Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con credenziali proprie e limite di traffico. Chiavi API revocabili in qualsiasi momento |
| Rotazione | Ogni nuova connessione riceve un IP dal pool, di solito diverso; per ottenere un nuovo IP a ogni richiesta, invia una richiesta per connessione (disattiva il keep-alive) |
| Sessioni sticky | fino a 30 minuti (l'IP può cambiare prima) |
| Bloccato | Siti bancari, governativi e dei portali di pagamento, oltre alle porte SMTP (invio email) 25, 465 e 587 |

## Come si costruisce lo username?

Parti dallo username mostrato nella tua dashboard, poi aggiungi i parametri in questo ordine. Solo il paese è obbligatorio.

1. `-country-{cc}`: codice ISO a due lettere in minuscolo (`de`, `fr`, `pl`).
2. `-city-{city}`: nome della città in inglese, minuscolo, senza accenti, `_` per gli spazi (`the_hague`).
3. `-asn-{asn}`: numero di una rete (`3320`).
4. `-session-{id}`: la tua etichetta, solo lettere e cifre.
5. `-ttl-{minutes}`: durata della sessione, fino a 30.

La [panoramica del targeting](https://eurocityproxies.com/it/targeting/) spiega ogni parte, e ogni [pagina città](https://eurocityproxies.com/it/cities/) riporta il suo valore esatto.

Dettagli sui parametri: [geo-targeting proxy in Europa](https://eurocityproxies.com/it/targeting/), [targeting per città](https://eurocityproxies.com/it/targeting/city/) e il [glossario](https://eurocityproxies.com/it/glossary/). Lo stato del servizio è sulla [pagina di stato](https://eurocityproxies.com/it/status/); inizia dalle [guide](https://eurocityproxies.com/it/guides/) se è la tua prima connessione.

*Tre connessioni comuni*

```bash
# Rotating IP in Seville, HTTP port
curl -x http://USERNAME-country-es-city-seville:PASSWORD@gw.eurocityproxies.com:7777 https://api.ipify.org

# Sticky IP in Vienna for 10 minutes
curl -x http://USERNAME-country-at-city-vienna-session-v1-ttl-10:PASSWORD@gw.eurocityproxies.com:7777 https://ipinfo.io/json

# SOCKS5 in Warsaw; socks5h lets the proxy resolve the hostname
curl -x socks5h://USERNAME-country-pl-city-warsaw:PASSWORD@gw.eurocityproxies.com:7778 https://ipinfo.io/json
```

## Cosa significano gli errori più comuni?

- **407 Proxy Authentication Required:** lo username o la password sono errati, oppure un parametro è scritto male. Controlla il valore della città sulla sua pagina.
- **Connessione rifiutata o timeout su una richiesta di città:** potrebbe non esserci nessun IP online corrispondente. La disponibilità per città varia; il checkout mostra cosa è online. Nessun numero di IP è pubblicato. Riprova più tardi o amplia al paese.
- **403 dal sito di destinazione:** il sito ha rifiutato la richiesta. Un IP residenziale non rende lecito un accesso negato; controlla i termini del sito.
- **Destinazione bloccata:** i siti bancari, governativi e dei portali di pagamento, e le porte SMTP, vengono rifiutati dal gateway per design.

## Dov'è l'API dell'account?

La [documentazione API](https://eurocityproxies.com/docs/api/) copre il tuo account, le ricariche, gli ordini, l'utilizzo dei proxy residenziali e le chiavi API, con esempi in curl, Python e Node.js. I valori delle città per ogni paese provengono da `GET /v1/catalog/countries/{CC}/cities` (codice in maiuscolo nel percorso).

Le chiavi API possono essere revocate in qualsiasi momento dalla dashboard. Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con credenziali proprie e limite di traffico. Chiavi API revocabili in qualsiasi momento.

## Documentazione: FAQ

### Quale porta devo usare in un browser?

La porta 7777. Chrome e Firefox non inviano una password a un proxy SOCKS5, quindi usa la porta HTTP con username e password.

### Posso usare una allowlist di IP invece di una password?

Sì. Username e password su ogni piano, oppure una allowlist IP (fino a 10 IP). Sub-utenti con credenziali proprie e limite di traffico. Chiavi API revocabili in qualsiasi momento.

### Perché mantengo lo stesso IP senza un ID di sessione?

Il tuo client probabilmente mantiene la connessione aperta. Ogni nuova connessione riceve un IP dal pool, di solito diverso; per ottenere un nuovo IP a ogni richiesta, invia una richiesta per connessione (disattiva il keep-alive).

### Come viene misurato il traffico?

L'utilizzo conta tutti i dati inviati e ricevuti tramite il proxy (upload e download, header inclusi). 1 GB = 1.000.000.000 byte. I tentativi di connessione che falliscono prima di raggiungere la destinazione non vengono contati. Le interruzioni e gli incidenti sono elencati sulla [pagina di stato](https://eurocityproxies.com/it/status/).

---

EuroCity Proxies: EuroCity Proxies è un provider di proxy residenziali con targeting a livello città in tutta Europa, pagabili in cripto senza caricare documenti d'identità: IP su banda larga domestica fatturati per GB, con una pagina di dati locali per ciascuna delle 103 città in 35 paesi.
