# Cómo configurar proxies residenciales de Japón y Asia Oriental

> Configura proxies residenciales de Japón, Corea, Taiwán o Hong Kong con curl, Python, Node.js, Playwright, Puppeteer y navegadores: formato de usuario y sesiones.

- URL: https://japanproxies.com/es/guides/setup/
- Última actualización: 2026-10-14
- Publisher: JapanProxies (https://japanproxies.com)

Todo va en el nombre de usuario del proxy: el código del país y, si quieres una IP fija por un tiempo, un ID de sesión y una duración. Ejemplos listos para copiar y pegar con las herramientas más usadas.

**Respuesta rápida — ¿Cómo me conecto a un proxy residencial japonés?**

Apunta tu herramienta a `gw.japanproxies.com` en el puerto 7777 para HTTP y HTTPS, o al puerto 7778 para SOCKS5, con tu contraseña **JapanProxies** y el nombre de usuario `USERNAME-country-jp`. Usa `kr`, `tw` o `hk` para Corea del Sur, Taiwán o Hong Kong. Añade `-session-ID-ttl-30` para mantener una IP durante 30 minutos. Los planes comienzan en 2,62 US$ por 1 GB, pagados con criptomonedas y sin KYC.

## Detalles de conexión

| Atributo | Valor |
| --- | --- |
| Host | `gw.japanproxies.com` |
| Puerto HTTP / HTTPS | 7777 |
| Puerto SOCKS5 | 7778 |
| Formato de nombre de usuario | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Códigos de país | `jp` Japón · `kr` Corea del Sur · `tw` Taiwán · `hk` Hong Kong |
| ID de sesión | Letras y números que elijas; el mismo ID mantiene la misma IP mientras la salida esté activa |
| Duración de la sesión (ttl) | El tiempo que configures (ttl, en minutos), hasta 30 minutos; la IP puede cambiar antes, por ejemplo si el dispositivo residencial se desconecta |
| Contraseña | Desde tu panel de control |

## ¿Qué va en el nombre de usuario?

*USERNAME es el nombre base que aparece en tu panel. Los segmentos por ciudad no se soportan aún en Asia Oriental.*

| Nombre de usuario | Lo que obtienes |
| --- | --- |
| `USERNAME-country-jp` | Una IP residencial japonesa; cada conexión nueva suele obtener una diferente |
| `USERNAME-country-jp-city-osaka` | Una IP residencial en Osaka cuando está disponible (la ciudad puede variar) |
| `USERNAME-country-kr-asn-4766` | Una IP coreana en la red KT (ASN 4766), sin costo adicional |
| `USERNAME-country-kr-session-a1-ttl-30` | Una IP coreana durante hasta 30 minutos, mientras reutilices la sesión `a1` |
| `USERNAME-country-tw-session-b7-ttl-30` | Una IP taiwanesa por hasta 30 minutos; puede cambiar antes si el dispositivo se desconecta |
| `USERNAME-country-hk-session-c2-ttl-10` | Una IP de Hong Kong por hasta 10 minutos |

## ¿Cómo pruebo la conexión con curl?

Primero ejecuta estos comandos. Los dos primeros muestran la IP de salida y su país (HTTP, luego SOCKS5); el tercero demuestra que una sesión sticky mantiene la misma IP. Si ambos indican el país correcto, cualquier herramienta funcionará.

*curl: pruebas HTTP y 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
```

## ¿Cómo uso el proxy en Python?

Con `requests`, pasa la misma URL del proxy para `http` y `https`: la puerta maneja HTTPS por CONNECT. Si tu contraseña contiene caracteres como `@` o `:`, codifícala en URL. Para SOCKS5, instala `requests[socks]` y usa `socks5h://` para que el DNS se resuelva en la salida.

*Python (requests): rotación y sesión 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) sobre 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
```

## ¿Cómo uso el proxy en Node.js?

El paquete `undici`, que impulsa el `fetch` nativo de Node, tiene un `ProxyAgent` para proxies HTTP. Instálalo con `npm install undici` y pasa el agente como `dispatcher`.

*Node.js (undici): fetch usando una IP taiwanesa*

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

## ¿Cómo uso el proxy en Playwright o Puppeteer?

Los navegadores reciben servidor y credenciales por separado. En Playwright, pásalos en la opción `proxy` de `launch()`; configura `locale` y `timezoneId` del contexto para coincidir con el país cuando pruebes localización. En Puppeteer, pasa `--proxy-server` al iniciar y llama `page.authenticate()` antes de la primera petición.

*Playwright (Python): un contexto de navegador japonés*

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

## ¿Cómo uso el proxy en un navegador o teléfono?

- **Firefox:** Configuración → Configuración de red → Configuración manual del proxy. Ingresa `gw.japanproxies.com` y puerto 7777 para HTTP, activa "También usar este proxy para HTTPS", luego ingresa usuario y contraseña cuando Firefox lo solicite.
- **Chrome y Edge:** usan la configuración proxy del sistema; una extensión que soporte autenticación facilita cambiar de país.
- **iPhone y iPad:** Configuración → Wi-Fi → (i) junto a tu red → Configurar proxy → Manual, con servidor, puerto y autenticación.
- **Android:** la configuración proxy integrada en Wi-Fi no pide usuario ni contraseña, usa una app o herramienta que soporte autenticación proxy.

Abre una página para verificar IP luego de cambiar para confirmar país.

## ¿Qué significan los errores comunes?

- **407 Proxy Authentication Required:** usuario o contraseña incorrectos, o un carácter especial no codificado en la contraseña.
- **Tiempo de conexión agotado:** un firewall bloquea el tráfico saliente a puerto 7777 o 7778, o la conexión tras la IP quedó offline; intenta con un nuevo ID de sesión.
- **País incorrecto en página de verificación IP:** algunas bases de datos geolocalizan IPs erróneamente; mira [por qué un proxy muestra ubicación errónea](https://japanproxies.com/es/guides/check-proxy-location/).
- **Un sitio rechaza la conexión:** revisa los términos del sitio. Bancos, portales gubernamentales, métodos de pago y puertos SMTP están bloqueados en todos los planes.

¿Sigues con problemas? Escribe a support@japanproxies.com con hora, código país, herramienta y error exacto. Respuestas por email en menos de 12 horas, 7 días a la semana.

## Preguntas de configuración

### ¿Puedo usar allowlisting de IP en vez de contraseña?

Puedes añadir hasta 10 IPs a una allowlist; desde esas IPs no se necesita contraseña. Usuario y contraseña funcionan desde cualquier red y herramienta. Los subusuarios tienen sus propias credenciales y límite de tráfico, y las claves API pueden revocarse en cualquier momento.

### ¿Cómo obtengo una IP nueva?

Sin sesión, cada conexión nueva recibe una IP del pool, usualmente distinta. Para una IP nueva en cada petición, envía una petición por conexión (desactiva keep-alive): navegadores, `requests.Session` y undici mantienen conexiones abiertas. Con sesión sticky, cambia el ID de sesión: `session-a1` pasa a `session-a2`.

### ¿Puedo usar varios países a la vez?

Sí. Ejecuta varias conexiones con distintos códigos de país en el usuario, todos con cargo en el mismo plan.

### ¿Hay una API?

Sí. Los endpoints de cuenta, recarga, pedido y uso están documentados en la [referencia API](https://japanproxies.com/docs/api/), con claves API que puedes revocar cuando quieras.

### ¿Estos ejemplos están probados?

El código fue revisado en sintaxis y sigue las opciones de proxy documentadas de cada librería. Cambia USERNAME y PASSWORD por tus credenciales y primero prueba con curl.

### ¿Un compañero o script puede tener sus propias credenciales?

Crea un subusuario: tiene usuario, contraseña y límite de tráfico propios, incluidos en tu plan, y puedes eliminarlo cuando quieras. Las claves API también pueden revocarse en cualquier momento.

**¿Listo para conectarte?** 1 GB para 2,62 US$ cubre tus primeras pruebas en los cuatro países. Sin KYC, paga con criptomonedas. [Comienza ahora](https://japanproxies.com/es/pricing/) · [Ver verificaciones locales de sitios](https://japanproxies.com/es/local-checks/)

---

JapanProxies: JapanProxies es un proveedor de proxy residencial para Japón, Corea del Sur, Taiwán y Hong Kong: IPs residenciales rotativas facturadas por GB, con tráfico que nunca expira, pagado en criptomonedas y sin KYC — sin ID, sin selfie, sin documentos.