Come configurare un proxy: dal nome utente allo scraper

Una volta capito a cosa serve ogni parte del nome utente, configurare un proxy in qualsiasi strumento richiede pochi minuti. Questa pagina spiega la configurazione strumento per strumento, la soluzione degli errori e come proteggere il token.

1. Crea un account e salva il token di accesso

Nella pagina di registrazione ricevi un token di accesso. È la password per accedere e per collegarti al proxy. Il server non lo conserva, quindi salvalo in un file .txt.

2. Ricarica il saldo

Scegli un importo nell'area di ricarica della dashboard e invia la richiesta. Puoi ricaricare da $30, e l'importo va sul saldo quando il pagamento è confermato.

3. Crea il nome utente

Scrivi paese, città e sessione nel nome utente per fissare posizione e durata dell'IP. Se li scegli in crea i dati di connessione della dashboard, viene creato da solo.

Esempi di nome utente

Nuovo IP a ogni richiesta
user-country-us
Scelta della città
user-country-us-city-new_york
Tenere lo stesso IP
user-country-us-session-shop1
IP mobile
user-type-mobile-country-us

4. Prova la connessione

Invia una richiesta con curl e guarda IP e paese nella risposta.

Formato di connessione

HTTP

http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000

SOCKS5

socks5://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000

curl

curl -x http://gate.proxytoo.com:7000 -U "user-country-us:YOUR_TOKEN" https://ipinfo.io/json

5. Inseriscilo nei tuoi strumenti

Inserisci host, nome utente e token in Python, Node.js o nel tuo strumento di automazione del browser.

Esempi di codice

Python (requests)

import requests

proxy = "http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000"
res = requests.get("https://ipinfo.io/json",
                   proxies={"http": proxy, "https": proxy})
print(res.json())

Node.js (undici)

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

Puppeteer

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://gate.proxytoo.com:7000"],
});
const page = await browser.newPage();
await page.authenticate({ username: "user-country-us", password: "YOUR_TOKEN" });
await page.goto("https://ipinfo.io/json");

Se la connessione non va

  • 407 Proxy Authentication Required

    Nome utente o token non corrispondono. Controlla di averli incollati esattamente così, senza spazi in più.

  • Tempo di connessione scaduto

    Se hai scelto una città, riprova con il solo paese. Controlla anche se il firewall aziendale blocca la porta 7000.

  • Un sito continua a bloccare

    Distanzia di più le richieste e cambia IP a ogni richiesta. Per siti con blocchi forti, i proxy residenziali sono la scelta giusta.

Come si legge il nome utente di un proxy?

Il nome utente di un proxy è una breve stringa di impostazioni composta da parti unite da trattini. Inizia con user e prosegue con coppie di nome e valore che stabiliscono la posizione di uscita e per quanto tempo l'IP viene mantenuto. Una volta conosciute le parti, puoi scrivere qualsiasi stringa di connessione a mano senza aprire la dashboard.

Dopo country viene un codice paese di due lettere in minuscolo. user-country-us indica un IP statunitense e user-country-jp un IP giapponese. Dopo city viene il nome della città in minuscolo con gli spazi trasformati in trattini bassi, come in user-country-us-city-new_york.

Dopo session viene un nome di sessione scelto da te. Con user-country-jp-session-shop1, ogni richiesta che usa quel nome mantiene lo stesso IP per un massimo di 120 minuti. Aggiungi type-mobile, come in user-type-mobile-country-gb, per uscire da un IP mobile.

Nel campo della password va sempre il tuo token di accesso, che inizia con pt_. Per cambiare posizione o sessione modifica solo il nome utente e lascia il token com'è.

  • user indica l'inizio delle impostazioni.
  • country più un codice di due lettere sceglie il paese.
  • city più un nome con trattini bassi sceglie la città.
  • session più un nome mantiene lo stesso IP.
  • type-mobile sceglie un IP mobile.

Proxy HTTP o SOCKS5: quale usare?

I proxy HTTP sono la scelta predefinita più semplice per web scraping e lavoro nel browser, mentre i proxy SOCKS5 sono adatti al traffico non web o alle configurazioni in cui vuoi risolvere il DNS lato proxy. ProxyToo li accetta entrambi su un unico gateway, gate.proxytoo.com:7000. Mantieni lo stesso nome utente e token e cambia solo lo schema all'inizio dell'indirizzo.

I proxy HTTP sono nati per le richieste web, quindi quasi tutte le librerie e i browser li supportano subito. Funzionano anche i siti HTTPS, perché il proxy apre un tunnel cifrato per la connessione. Per strumenti web come requests, Scrapy, Puppeteer e Playwright, parti dal formato HTTP.

SOCKS5 inoltra la connessione stessa, quindi può trasportare molti tipi di traffico oltre al web. In Python, se l'indirizzo inizia con socks5h il proxy risolve i nomi host nel paese di uscita, e la tua posizione resta coerente. I browser basati su Chromium supportano poco SOCKS5 con nome utente, quindi HTTP è la scelta più fluida per l'automazione del browser.

  • HTTP per web scraping e automazione del browser
  • SOCKS5 per programmi che inviano traffico non web
  • Un indirizzo socks5h per risolvere il DNS nel paese del proxy
  • Lo stesso nome utente e token per entrambi

Come aggiungere un proxy a un browser o a un browser antidetect?

In un browser normale apri un'estensione proxy e inserisci quattro valori in campi separati: host, porta, nome utente e token. Scegli il formato host:port:user:pass in Crea dati di connessione nella dashboard e i quattro valori arrivano su una sola riga, pronti da copiare campo per campo. Se al primo caricamento compare una richiesta di autenticazione, inserisci lì nome utente e token.

Un browser antidetect dà a ogni profilo un ambiente browser separato, quindi la regola di base è un nome utente per profilo. Nel campo proxy del profilo scegli HTTP o SOCKS5, poi aggiungi una parte session al nome utente con un nome di sessione diverso per ogni profilo. Ogni profilo riceve così il proprio IP, che resta lo stesso all'interno di quel profilo.

Allinea lingua, fuso orario e posizione del profilo al paese scelto, così le pagine appaiono come le vede un visitatore locale. Per un profilo che gestisce a lungo un solo account, i proxy ISP o i proxy datacenter dedicati mantengono lo stesso IP per tutta la durata. Ordinali in Acquista prodotti nella dashboard scegliendo quantità e durata.

  • Un nome di sessione per profilo
  • Lingua e fuso orario allineati al paese dell'IP
  • Proxy ISP per i profili di lunga durata
  • Nome utente e token nella richiesta di autenticazione

Come usare un proxy con Python requests e Scrapy?

In Python costruisci il proxy come una riga del tipo http://username:token@gate.proxytoo.com:7000 e passala all'impostazione proxy della libreria. Con requests il passaggio chiave è inserire lo stesso indirizzo sia nella voce http sia nella voce https. Compilando entrambe, anche le richieste HTTPS passano dal proxy.

Imposta il proxy una sola volta su un oggetto Session di requests e ogni richiesta di quella sessione lo userà. Usa un nome utente con il solo paese quando vuoi un nuovo IP a ogni richiesta, e un nome utente con una parte session per i flussi che proseguono, come un login. Per SOCKS5 installa l'estensione SOCKS di requests e cambia l'inizio dell'indirizzo in socks5h.

In Scrapy inserisci lo stesso tipo di indirizzo nel valore meta proxy di ogni richiesta, e il middleware proxy integrato trasforma nome utente e token nell'intestazione di autenticazione. Per applicare un'unica impostazione a tutte le richieste, scrivi un piccolo downloader middleware che compila il valore proxy. Per dividere il traffico in sessioni, fai assegnare a quel middleware un nome di sessione diverso a ogni gruppo di richieste.

Regola concorrenza e ritmo con impostazioni come CONCURRENT_REQUESTS e DOWNLOAD_DELAY. Parti basso, verifica che le risposte siano stabili, poi alzale gradualmente per bilanciare velocità e successo. I proxy residenziali si pagano in base al traffico, quindi escludere immagini e font fa durare di più il saldo.

Come configurare un proxy in Node.js, Puppeteer e Playwright?

In Node.js l'approccio abituale è creare un proxy agent e passarlo alla libreria di richieste. Per HTTP usa un pacchetto come https-proxy-agent o il ProxyAgent di undici, per SOCKS5 usa socks-proxy-agent, passando un indirizzo che contiene nome utente e token. Crea l'agent una volta e riutilizzalo tra le richieste, così le connessioni vengono riutilizzate e restano veloci.

Con Puppeteer passa solo l'indirizzo del gateway nell'argomento di avvio --proxy-server, poi invia nome utente e token separatamente con page.authenticate dopo aver aperto una pagina. Separarli così è la configurazione più affidabile in Chrome. Per cambiare paese o sessione, la via più semplice è avviare un altro browser con il nuovo nome utente.

Con Playwright imposta server, username e password nell'opzione proxy di avvio e l'autenticazione avviene in un solo passaggio. Nel campo password va il tuo token di accesso. Puoi anche avviare un browser e dare a ogni contesto il proprio proxy, quindi abbinando un nome di sessione a ogni contesto un singolo script gestisce più IP in parallelo.

L'automazione del browser scarica immagini, video e font a ogni pagina, e questo produce molto traffico. Bloccare le risorse superflue con l'intercettazione delle richieste riduce il costo dei proxy residenziali e mobili, che si pagano a GB. Aggiungere un nome di sessione mantiene stabile l'IP durante il caricamento, così le pagine si visualizzano correttamente.

Proxy a rotazione o sessioni sticky: cosa è meglio per lo scraping?

Per uno scraping in cui ogni pagina viene letta da sola usa un nuovo IP a ogni richiesta, mentre per i flussi che proseguono, come un login o un carrello, usa una sessione. Senza la parte session l'IP cambia a ogni richiesta, con la parte session l'IP resta lo stesso sotto quel nome. Un solo token gestisce entrambi, quindi puoi scegliere per ogni fase del lavoro.

La modalità a rotazione è adatta ai lavori in cui le pagine non hanno legami tra loro, come risultati di ricerca, elenchi di prodotti e tabelle di prezzi. Le richieste si distribuiscono in modo uniforme su molti IP, quindi per il sito sembrano normale traffico di tanti visitatori. Anche nelle grandi scansioni di un solo sito, distanziare le richieste mantiene tutto stabile.

Con le sessioni, il trucco è un nome di sessione separato per ogni unità di lavoro. Se controlli cinque account di negozi, chiamali da shop1 a shop5 così ognuno mantiene il proprio IP. Dividere il lavoro in flussi brevi che terminano entro la durata della sessione mantiene un solo IP per l'intero flusso.

Se ti serve lo stesso IP per un mese intero, i proxy ISP o i proxy datacenter dedicati sono la scelta migliore, mentre per grandi volumi a basso prezzo unitario sono ottime opzioni i proxy datacenter condivisi o i proxy IPv6. Per lavori con molto traffico in cui i paesi misti vanno bene, i proxy residenziali illimitati a $37.58 al giorno rendono i costi facili da pianificare.

  • Nuovo IP a ogni richiesta per pagine indipendenti
  • Un nome di sessione fisso per login e checkout
  • Un nome di sessione diverso per ogni unità di lavoro
  • ISP o datacenter dedicato per lo stesso IP tutto il mese

Come verificare l'IP del proxy e risolvere gli errori di connessione?

Il controllo più rapido è inviare tramite il proxy una richiesta a una pagina che mostra il tuo IP, poi verificare che IP e paese corrispondano al paese nel nome utente. Scegli il formato curl in Crea dati di connessione nella dashboard e ottieni un comando di verifica pronto da incollare nel terminale. Se hai impostato una sessione, invia lo stesso comando due o tre volte per verificare che l'IP resti invariato.

Una risposta 407 significa che il proxy non ha accettato le credenziali, e di solito dipende da un solo carattere nel nome utente o nel token. Verifica che il token inizi con pt_, che copiandolo non siano finiti spazi o a capo e che il nome utente inizi con user. Se nell'indirizzo su una riga finiscono caratteri speciali, codificarli in URL risolve il problema.

Risposte come 403 o 429 arrivano dal sito, quindi la connessione al proxy ha funzionato e il sito sta controllando velocità o schemi delle richieste. Distanzia le richieste, invia intestazioni simili a quelle di un browser e passa da una sessione a un nuovo IP per richiesta.

I timeout dipendono spesso da una rete aziendale o scolastica che blocca la porta del gateway, da un target di città troppo ristretto o da un timeout breve nel codice. Prova lo stesso comando da un'altra rete, togli la parte city e indica solo il paese, e dai alla richiesta un timeout più lungo. Controlla anche di avere saldo disponibile e, per i prodotti a IP, che l'ordine risulti In uso in I miei ordini.

  • 407: controlla nome utente e token
  • 403 o 429: rallenta e ruota gli IP
  • Timeout: controlla rete, città e timeout
  • Esegui lo stesso comando più volte per testare una sessione

Come proteggere il token di accesso del proxy?

Il token di accesso è sia il tuo ID account sia la password dei proxy, quindi chiunque lo possieda può usare i proxy con il tuo saldo. Il server conserva solo un hash del token, quindi il file del token salvato alla registrazione è l'unico originale. Tienine copie in due posti e aggiungilo a un gestore di password, così resta al sicuro e facile da trovare.

Non inserire il token nel codice e caricalo da una variabile d'ambiente o da un file di configurazione separato. Aggiungi quel file a .gitignore per tenerlo fuori dal repository e, su un server condiviso, restringi i permessi del file così che solo tu possa leggerlo. In questo modo puoi condividere il codice mentre il token resta sulla tua macchina.

Fai attenzione anche a log e screenshot. Stampare l'indirizzo proxy completo in caso di errore scrive il token direttamente nel log, quindi maschera la parte del token ogni volta che registri un indirizzo. Quando pubblichi una domanda o uno screenshot, mostra solo il nome utente e rimuovi prima il token.

  • File del token conservato in due posti
  • Token caricato da una variabile d'ambiente
  • File di configurazione fuori dal repository
  • Token mascherato in log e screenshot

Un uso responsabile

  • Raccogli informazioni pubbliche e non entrare negli account altrui senza permesso.
  • Distanzia le richieste per non sovraccaricare i siti che visiti.
  • Non si possono usare per spam, accessi non autorizzati o frodi.

Prendi un token e collegati con IP del paese che ti serve

Per registrarti basta un token. Ricarica da $30 e usa ogni tipo di proxy con un unico saldo.

Prendi il token e inizia