# Comment configurer des proxies résidentiels au Japon et en Asie de l'Est

> Configurez des proxies résidentiels au Japon, en Corée, à Taïwan ou à Hong Kong avec curl, Python, Node.js, Playwright, Puppeteer et navigateurs : format du nom d'utilisateur et sessions.

- URL: https://japanproxies.com/fr/guides/setup/
- Dernière mise à jour: 2026-10-14
- Publisher: JapanProxies (https://japanproxies.com)

Tout ce qui concerne le proxy est dans le nom d’utilisateur : le code pays et, si vous souhaitez une IP fixe temporairement, un ID session avec une durée. Exemples prêts à copier-coller pour les outils les plus utilisés.

**Réponse rapide — Comment me connecter à un proxy résidentiel japonais ?**

Configurez votre outil pour `gw.japanproxies.com` sur le port 7777 pour HTTP et HTTPS, ou le port 7778 pour SOCKS5, avec votre mot de passe **JapanProxies** et le nom d’utilisateur `USERNAME-country-jp`. Utilisez `kr`, `tw` ou `hk` pour la Corée du Sud, Taïwan ou Hong Kong. Ajoutez `-session-ID-ttl-30` pour garder une IP pendant 30 minutes. Les forfaits commencent à 2,62 $US pour 1 GB, paiement en crypto sans KYC.

## Détails de connexion

| Attribut | Valeur |
| --- | --- |
| Hôte | `gw.japanproxies.com` |
| Port HTTP / HTTPS | 7777 |
| Port SOCKS5 | 7778 |
| Format du nom d’utilisateur | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Codes pays | `jp` Japon · `kr` Corée du Sud · `tw` Taïwan · `hk` Hong Kong |
| ID de session | Lettres et chiffres que vous choisissez ; le même ID conserve la même IP tant que la session reste active |
| Durée de la session (ttl) | le temps que vous définissez (ttl, en minutes), jusqu’à 30 minutes ; l’IP peut changer plus tôt, par exemple si l’appareil résidentiel passe hors ligne |
| Mot de passe | Depuis votre tableau de bord |

## Que faut-il mettre dans le nom d’utilisateur ?

*USERNAME est le nom d'utilisateur principal affiché dans votre tableau de bord. Les segments de ville ne sont pas encore pris en charge en Asie de l'Est.*

| Nom d’utilisateur | Ce que vous obtenez |
| --- | --- |
| `USERNAME-country-jp` | Une IP résidentielle japonaise ; chaque nouvelle connexion obtient généralement une IP différente |
| `USERNAME-country-jp-city-osaka` | Une IP résidentielle à Osaka quand elle est disponible (la disponibilité varie selon les villes) |
| `USERNAME-country-kr-asn-4766` | Une IP coréenne sur le réseau KT (ASN 4766), sans coût supplémentaire |
| `USERNAME-country-kr-session-a1-ttl-30` | Une IP coréenne pour une durée maximale de 30 minutes, à condition de réutiliser la session `a1` |
| `USERNAME-country-tw-session-b7-ttl-30` | Une IP taïwanaise pour jusqu'à 30 minutes ; elle peut changer plus tôt si l'appareil se déconnecte |
| `USERNAME-country-hk-session-c2-ttl-10` | Une IP hongkongaise pour jusqu'à 10 minutes |

## Comment tester la connexion avec curl ?

Exécutez d'abord ces commandes. Les deux premières affichent l'IP de sortie et son pays (HTTP, puis SOCKS5) ; la troisième montre qu'une session fixe garde la même IP. Si les deux affichent le bon pays, n'importe quel outil fonctionnera.

*curl : tests HTTP et 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
```

## Comment utiliser le proxy en Python ?

Avec `requests`, passez la même URL de proxy pour `http` et `https` : la passerelle gère HTTPS via CONNECT. Si votre mot de passe contient des caractères comme `@` ou `:`, encodez-les en URL. Pour SOCKS5, installez `requests[socks]` et utilisez `socks5h://` pour que le DNS soit résolu à la sortie.

*Python (requests) : rotation et session fixe*

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

## Comment utiliser le proxy en Node.js ?

Le paquet `undici`, qui alimente le module natif `fetch` de Node, possède un `ProxyAgent` pour les proxies HTTP. Installez-le avec `npm install undici` et passez l'agent comme `dispatcher`.

*Node.js (undici) : fetch via une IP taïwanaise*

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

## Comment utiliser le proxy dans Playwright ou Puppeteer ?

Les navigateurs prennent le serveur et les identifiants séparément. Dans Playwright, passez-les dans l'option `proxy` de `launch()` ; réglez `locale` et `timezoneId` du contexte pour correspondre au pays lors du test de localisation. Dans Puppeteer, passez `--proxy-server` au lancement et appelez `page.authenticate()` avant la première requête.

*Playwright (Python) : un contexte navigateur japonais*

```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) : une page coréenne*

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

## Comment utiliser le proxy dans un navigateur ou sur un téléphone ?

- **Firefox :** Paramètres → Réseau → Configuration manuelle du proxy. Entrez `gw.japanproxies.com` et le port 7777 pour HTTP, cochez "Utiliser aussi ce proxy pour HTTPS", puis saisissez votre nom d'utilisateur et mot de passe quand Firefox le demande.
- **Chrome et Edge :** ils utilisent les paramètres proxy système ; une extension proxy avec authentification facilite le changement de pays.
- **iPhone et iPad :** Paramètres → Wi-Fi → (i) à côté de votre réseau → Configurer le proxy → Manuel, avec serveur, port et authentification.
- **Android :** le paramètre proxy Wi-Fi intégré ne demande pas nom d'utilisateur ni mot de passe, utilisez donc une application ou outil de test supportant l'authentification proxy.

Ouvrez une page de vérification IP après changement pour confirmer le pays.

## Que signifient les erreurs courantes ?

- **407 Proxy Authentication Required :** nom d'utilisateur ou mot de passe incorrect, ou un caractère spécial dans le mot de passe non encodé.
- **Timeout de connexion :** un firewall bloque le trafic sortant vers le port 7777 ou 7778, ou la connexion domestique derrière l'IP est hors ligne ; réessayez avec un nouvel ID de session.
- **Mauvais pays sur une page de vérification IP :** certaines bases de données géolocalisent mal les IP ; voir [pourquoi un proxy affiche un mauvais emplacement](https://japanproxies.com/fr/guides/check-proxy-location/).
- **Un site refuse la connexion :** vérifiez les conditions du site. Banques, sites gouvernementaux, portails de paiement et ports SMTP sont bloqués sur tous les forfaits.

Toujours un problème ? Envoyez un e-mail à support@japanproxies.com avec l'heure, le code pays, l'outil et l'erreur précise. Réponses par email sous 12 heures, 7 jours sur 7.

## Questions sur la configuration

### Puis-je utiliser une liste blanche d'IP au lieu d'un mot de passe ?

Vous pouvez ajouter jusqu'à 10 IP à une liste blanche ; les connexions depuis ces IPs n'ont pas besoin de mot de passe. Un nom d'utilisateur et mot de passe fonctionnent depuis n'importe quel réseau et outil. Les sous-utilisateurs ont leurs propres identifiants et plafonds de trafic, et les clés API peuvent être révoquées à tout moment.

### Comment obtenir une nouvelle IP ?

Sans session, chaque nouvelle connexion reçoit une IP du pool, généralement différente. Pour obtenir une nouvelle IP à chaque requête, envoyez une requête par connexion (désactivez keep-alive) : navigateurs, `requests.Session` et undici gardent les connexions ouvertes. Avec une session fixe, changez l'ID de session : `session-a1` devient `session-a2`.

### Puis-je utiliser plusieurs pays en même temps ?

Oui. Lancez plusieurs connexions avec des codes pays différents dans le nom d'utilisateur, toutes payées via le même forfait.

### Y a-t-il une API ?

Oui. Les endpoints compte, recharge, commande et usage sont documentés dans la [référence API](https://japanproxies.com/docs/api/), avec des clés API que vous pouvez révoquer à tout moment.

### Ces exemples ont-ils été testés ?

Le code a été vérifié pour la syntaxe et suit les options proxy documentées de chaque bibliothèque. Remplacez USERNAME et PASSWORD par vos propres identifiants, puis lancez le test curl d'abord.

### Un coéquipier ou un script peut-il avoir ses propres identifiants ?

Créez un sous-utilisateur : il reçoit son propre nom d'utilisateur, mot de passe et plafond de trafic issus de votre forfait, et vous pouvez le supprimer à tout moment. Les clés API peuvent aussi être révoquées à tout moment.

**Prêt à vous connecter ?** 1 GB pour 2,62 $US couvre vos premiers tests dans les quatre pays. Sans KYC, payer en crypto. [Commencez maintenant](https://japanproxies.com/fr/pricing/) · [Voir les vérifications locales des sites](https://japanproxies.com/fr/local-checks/)

---

JapanProxies: JapanProxies est un fournisseur de proxy résidentiel pour le Japon, la Corée du Sud, Taiwan et Hong Kong : IPs résidentiels rotatifs facturés par GB, avec un trafic qui n'expire jamais, payé en crypto sans KYC — pas d'ID, pas de selfie, pas de documents.