# Come configurare proxy residenziali in Giappone e Asia orientale

> Configura proxy residenziali in Giappone, Corea, Taiwan o Hong Kong con curl, Python, Node.js, Playwright, Puppeteer e browser: formato username e gestione sessioni.

- URL: https://japanproxies.com/it/guides/setup/
- Ultimo aggiornamento: 2026-10-14
- Publisher: JapanProxies (https://japanproxies.com)

Inserisci tutto nell’username del proxy: codice paese e, se vuoi un IP stabile per un po', un ID sessione e un tempo di durata. Esempi copiabili per gli strumenti più usati.

**Risposta rapida — Come mi connetto a un proxy residenziale giapponese?**

Imposta il tuo strumento su `gw.japanproxies.com` alla porta 7777 per HTTP e HTTPS, o alla porta 7778 per SOCKS5, con la tua password **JapanProxies** e l’username `USERNAME-country-jp`. Usa `kr`, `tw` o `hk` per Sud Corea, Taiwan o Hong Kong. Aggiungi `-session-ID-ttl-30` per mantenere un IP per 30 minuti. I piani partono da 2,62 USD per 1 GB, pagati in crypto senza KYC.

## Dettagli di connessione

| Attributo | Valore |
| --- | --- |
| Host | `gw.japanproxies.com` |
| Porta HTTP / HTTPS | 7777 |
| Porta SOCKS5 | 7778 |
| Formato username | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Codici paese | `jp` Giappone · `kr` Corea del Sud · `tw` Taiwan · `hk` Hong Kong |
| ID sessione | Lettere e numeri a scelta; stesso ID mantiene lo stesso IP finché la sessione rimane attiva |
| Durata sessione (ttl) | Il tempo che imposti (ttl, in minuti), fino a 30 minuti; l'IP può cambiare prima, per esempio se il dispositivo residenziale va offline |
| Password | Dal tuo dashboard |

## Cosa inserire nell’username?

*USERNAME è il nome base mostrato nella tua dashboard. Le segmentazioni per città non sono ancora supportate in Asia Orientale.*

| Username | Cosa ottieni |
| --- | --- |
| `USERNAME-country-jp` | Un IP residenziale giapponese; ogni connessione nuova solitamente ottiene un IP diverso |
| `USERNAME-country-jp-city-osaka` | Un IP residenziale a Osaka se disponibile (disponibilità città variabile) |
| `USERNAME-country-kr-asn-4766` | Un IP coreano sulla rete KT (ASN 4766), senza costi aggiuntivi |
| `USERNAME-country-kr-session-a1-ttl-30` | Un IP coreano per massimo 30 minuti, riutilizzando la sessione `a1` |
| `USERNAME-country-tw-session-b7-ttl-30` | Un IP taiwanese per un massimo di 30 minuti; può cambiare prima se il dispositivo va offline |
| `USERNAME-country-hk-session-c2-ttl-10` | Un IP di Hong Kong per un massimo di 10 minuti |

## Come testo la connessione con curl?

Esegui prima questi comandi. I primi due mostrano l'IP di uscita e il suo paese (HTTP, poi SOCKS5); il terzo dimostra che una sessione sticky mantiene lo stesso IP. Se entrambi mostrano il paese corretto, qualsiasi strumento funzionerà.

*curl: test HTTP e SOCKS5*

```bash
# HTTP proxy (also carries HTTPS through CONNECT)
curl -x http://USERNAME-country-jp:PASSWORD@gw.japanproxies.com:7777 https://ipinfo.io/json

# SOCKS5, with the hostname resolved at the exit
curl --socks5-hostname gw.japanproxies.com:7778 -U USERNAME-country-kr:PASSWORD https://ipinfo.io/json

# Sticky session: run twice, the IP stays the same
curl -x http://USERNAME-country-tw-session-test1-ttl-30:PASSWORD@gw.japanproxies.com:7777 https://ipinfo.io/ip
```

## Come uso il proxy in Python?

Con `requests`, passa lo stesso URL del proxy per `http` e `https`: il gateway gestisce HTTPS tramite CONNECT. Se la tua password contiene caratteri come `@` o `:`, codificala in URL. Per SOCKS5, installa `requests[socks]` e usa `socks5h://` così il DNS è risolto all'uscita.

*Python (requests): rotazione e sticky*

```python
from urllib.parse import quote

import requests

GATEWAY = "gw.japanproxies.com:7777"
PASSWORD = quote("PASSWORD", safe="")  # encode special characters


def proxies(user):
    url = f"http://{quote(user, safe='')}:{PASSWORD}@{GATEWAY}"
    return {"http": url, "https": url}


# Rotating: each new connection (one per request here) usually gets a new Japanese IP
for _ in range(3):
    print(requests.get("https://ipinfo.io/ip", proxies=proxies("USERNAME-country-jp"), timeout=30).text)

# Sticky: the same Korean IP for up to 30 minutes
sticky = proxies("USERNAME-country-kr-session-kr42-ttl-30")
for _ in range(3):
    print(requests.get("https://ipinfo.io/ip", proxies=sticky, timeout=30).text)
```

*Python (requests) su SOCKS5 — pip install "requests[socks]"*

```python
import requests

proxy = "socks5h://USERNAME-country-hk:PASSWORD@gw.japanproxies.com:7778"
r = requests.get("https://ipinfo.io/json", proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json()["country"])  # HK
```

## Come uso il proxy in Node.js?

Il pacchetto `undici`, che alimenta il modulo integrato `fetch` di Node, ha un `ProxyAgent` per proxy HTTP. Installalo con `npm install undici` e passa l'agente come `dispatcher`.

*Node.js (undici): fetch tramite IP taiwanese*

```javascript
import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent(
  "http://USERNAME-country-tw-session-tw7-ttl-30:PASSWORD@gw.japanproxies.com:7777"
);

const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
const info = await res.json();
console.log(info.ip, info.country); // TW
```

## Come uso il proxy in Playwright o Puppeteer?

I browser accettano server e credenziali separatamente. In Playwright, passali tramite l'opzione `proxy` di `launch()`; imposta `locale` e `timezoneId` del contesto per corrispondere al paese quando testi la localizzazione. In Puppeteer, passa `--proxy-server` all'avvio e richiama `page.authenticate()` prima della prima richiesta.

*Playwright (Python): un contesto browser giapponese*

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.japanproxies.com:7777",
        "username": "USERNAME-country-jp-session-pw1-ttl-30",
        "password": "PASSWORD",
    })
    context = browser.new_context(locale="ja-JP", timezone_id="Asia/Tokyo")
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.inner_text("body"))
    browser.close()
```

*Puppeteer (Node.js): una pagina coreana*

```javascript
import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://gw.japanproxies.com:7777"],
});
const page = await browser.newPage();
await page.authenticate({
  username: "USERNAME-country-kr-session-pp1-ttl-30",
  password: "PASSWORD",
});
await page.setExtraHTTPHeaders({ "Accept-Language": "ko-KR,ko;q=0.9" });
await page.goto("https://ipinfo.io/json");
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();
```

## Come uso il proxy in un browser o su un telefono?

- **Firefox:** Impostazioni → Impostazioni di rete → Configurazione manuale proxy. Inserisci `gw.japanproxies.com` e porta 7777 per HTTP, seleziona "Usa anche questo proxy per HTTPS", poi digita username e password quando Firefox lo richiede.
- **Chrome e Edge:** usano le impostazioni proxy di sistema; un’estensione proxy con autenticazione è più comoda per cambiare paese.
- **iPhone e iPad:** Impostazioni → Wi-Fi → (i) accanto alla rete → Configura Proxy → Manuale, con server, porta e autenticazione.
- **Android:** la configurazione proxy Wi-Fi integrata non richiede username e password, quindi usa un’app o uno strumento di test che supporti l’autenticazione proxy.

Apri una pagina di verifica IP dopo il cambio per confermare il paese.

## Cosa significano gli errori comuni?

- **407 Autenticazione Proxy Richiesta:** username o password errati, oppure un carattere speciale nella password non è codificato.
- **Timeout di connessione:** un firewall blocca il traffico in uscita sulla porta 7777 o 7778, oppure la connessione domestica dietro l’IP è andata offline; riprova con un nuovo ID sessione.
- **Paese errato su pagina di verifica IP:** alcune banche dati geolocalizzano gli IP in modo errato; vedi [perché un proxy mostra una posizione sbagliata](https://japanproxies.com/it/guides/check-proxy-location/).
- **Sito rifiuta la connessione:** verifica i termini del sito. Portali bancari, governativi, di pagamento e porte SMTP sono bloccate in ogni piano.

Ancora problemi? Scrivi a support@japanproxies.com indicando orario, codice paese, strumento e errore esatto. Risposte email entro 12 ore, 7 giorni su 7.

## Domande sulla configurazione

### Posso usare l’allowlisting IP invece di una password?

Puoi aggiungere fino a 10 IP a una lista di consentiti; le connessioni da quegli IP non richiedono password. Username e password funzionano da ogni rete e in ogni strumento. I sub-user hanno proprie credenziali e limiti di traffico, e le API key possono essere revocate in qualsiasi momento.

### Come ottengo un nuovo IP?

Senza sessione, ogni nuova connessione riceve un IP dal pool, solitamente diverso. Per avere un IP nuovo a ogni richiesta, invia una richiesta per connessione (disattiva keep-alive): browser, `requests.Session` e undici mantengono le connessioni aperte. Con sessione sticky, cambia l’ID sessione: `session-a1` diventa `session-a2`.

### Posso usare più paesi contemporaneamente?

Sì. Esegui più connessioni con codici paese diversi nell’username, tutti pagati dallo stesso piano.

### Esiste un’API?

Sì. Gli endpoint per account, ricarica, ordini e utilizzo sono documentati nella [API reference](https://japanproxies.com/docs/api/), con chiavi API che puoi revocare in qualsiasi momento.

### Questi esempi sono stati testati?

Il codice è stato verificato per la sintassi e segue le opzioni proxy documentate di ogni libreria. Sostituisci USERNAME e PASSWORD con le tue credenziali, poi esegui prima il test curl.

### Un collega o uno script può avere credenziali proprie?

Crea un sub-user: ottiene username, password e limite traffico propri, prelevati dal tuo piano, e puoi rimuoverlo in qualsiasi momento. Le chiavi API possono essere revocate in qualsiasi momento.

**Pronto a connetterti?** 1 GB per 2,62 USD copre i tuoi primi test in tutti e quattro i paesi. Senza KYC, paga in crypto. [Inizia ora](https://japanproxies.com/it/pricing/) · [Vedi i controlli locali del sito](https://japanproxies.com/it/local-checks/)

---

JapanProxies: JapanProxies è un provider di proxy residenziali per Giappone, Corea del Sud, Taiwan e Hong Kong: IP residenziali rotanti fatturati per GB, con traffico che non scade mai, pagati in crypto senza KYC — niente ID, selfie o documenti.