# Como configurar proxies residenciais no Japão e Ásia Oriental

> Configure proxies residenciais no Japão, Coreia, Taiwan ou Hong Kong em curl, Python, Node.js, Playwright, Puppeteer e navegadores: formato de nome de usuário e sessões.

- URL: https://japanproxies.com/pt/guides/setup/
- Última atualização: 2026-10-14
- Publisher: JapanProxies (https://japanproxies.com)

Tudo vai no nome de usuário do proxy: o código do país e, se quiser um IP fixo por um tempo, um ID de sessão e duração. Exemplos para copiar e colar nas ferramentas mais usadas.

**Resposta rápida — Como me conecto a um proxy residencial japonês?**

Aponte sua ferramenta para `gw.japanproxies.com` na porta 7777 para HTTP e HTTPS, ou porta 7778 para SOCKS5, com sua senha **JapanProxies** e o nome de usuário `USERNAME-country-jp`. Use `kr`, `tw` ou `hk` para Coreia do Sul, Taiwan ou Hong Kong. Adicione `-session-ID-ttl-30` para manter um IP por 30 minutos. Planos a partir de US$ 2,62 para 1 GB, pagando com cripto e sem KYC.

## Detalhes de conexão

| Atributo | Valor |
| --- | --- |
| Host | `gw.japanproxies.com` |
| Porta HTTP / HTTPS | 7777 |
| Porta SOCKS5 | 7778 |
| Formato de nome de usuário | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Códigos dos países | `jp` Japão · `kr` Coreia do Sul · `tw` Taiwan · `hk` Hong Kong |
| ID da sessão | Letras e dígitos que você escolhe; o mesmo ID mantém o mesmo IP enquanto a saída permanecer ativa |
| Duração da sessão (ttl) | O tempo que você definir (ttl, em minutos), até 30 minutos; o IP pode mudar antes, por exemplo, se o dispositivo residencial ficar offline |
| Senha | Do seu painel |

## O que vai no nome de usuário?

*USERNAME é o nome base mostrado no seu painel. Segmentos por cidade ainda não são suportados na Ásia Oriental.*

| Nome de usuário | O que você recebe |
| --- | --- |
| `USERNAME-country-jp` | Um IP residencial japonês; cada nova conexão normalmente recebe um diferente |
| `USERNAME-country-jp-city-osaka` | Um IP residencial em Osaka quando disponível (disponibilidade por cidade pode variar) |
| `USERNAME-country-kr-asn-4766` | Um IP coreano na rede da KT (ASN 4766), sem custo extra |
| `USERNAME-country-kr-session-a1-ttl-30` | Um IP coreano por até 30 minutos, enquanto você reutiliza a sessão `a1` |
| `USERNAME-country-tw-session-b7-ttl-30` | Um IP taiwanês por até 30 minutos; pode mudar antes se o dispositivo ficar offline |
| `USERNAME-country-hk-session-c2-ttl-10` | Um IP de Hong Kong por até 10 minutos |

## Como testar a conexão com curl?

Execute esses comandos primeiro. Os dois primeiros mostram o IP de saída e seu país (HTTP, depois SOCKS5); o terceiro mostra que uma sessão sticky mantém o mesmo IP. Se ambos mostrarem o país correto, qualquer ferramenta funcionará.

*curl: testes 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
```

## Como usar o proxy em Python?

Com `requests`, passe a mesma URL do proxy para `http` e `https`: o gateway gerencia HTTPS via CONNECT. Se sua senha tiver caracteres como `@` ou `:`, codifique-a em URL. Para SOCKS5, instale `requests[socks]` e use `socks5h://` para que o DNS seja resolvido na saída.

*Python (requests): rotativo 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) via 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
```

## Como usar o proxy em Node.js?

O pacote `undici`, que alimenta o `fetch` embutido no Node, tem um `ProxyAgent` para proxies HTTP. Instale com `npm install undici` e passe o agente como `dispatcher`.

*Node.js (undici): fetch por um IP taiwanês*

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

## Como usar o proxy no Playwright ou Puppeteer?

Os navegadores recebem servidor e credenciais separadamente. No Playwright, passe-os na opção `proxy` de `launch()`; ajuste `locale` e `timezoneId` do contexto para corresponder ao país ao testar localização. No Puppeteer, passe `--proxy-server` no lançamento e chame `page.authenticate()` antes da primeira requisição.

*Playwright (Python): 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): uma 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();
```

## Como usar o proxy no navegador ou no celular?

- **Firefox:** Configurações → Configurações de rede → Configuração manual do proxy. Digite `gw.japanproxies.com` e porta 7777 para HTTP, marque "Também usar esse proxy para HTTPS", depois insira seu usuário e senha quando o Firefox pedir.
- **Chrome e Edge:** usam as configurações de proxy do sistema; uma extensão com suporte a autenticação é mais fácil para trocar países.
- **iPhone e iPad:** Ajustes → Wi-Fi → (i) ao lado da rede → Configurar Proxy → Manual, com servidor, porta e autenticação.
- **Android:** a configuração de proxy Wi-Fi embutida não pede usuário e senha, então use um app ou ferramenta que suporte autenticação.

Abra uma página de verificação de IP após trocar para confirmar o país.

## O que significam erros comuns?

- **407 Proxy Authentication Required:** usuário ou senha errados, ou um caractere especial na senha não foi codificado.
- **Tempo de conexão esgotado:** firewall bloqueia tráfego para porta 7777 ou 7778, ou a conexão residencial saiu do ar; tente repetir com novo ID de sessão.
- **País errado na página de checagem de IP:** alguns bancos de dados de geolocalização colocam IPs errados; veja [por que um proxy mostra local errado](https://japanproxies.com/pt/guides/check-proxy-location/).
- **Site recusa conexão:** confira os termos do site. Bancos, governo, portais de pagamento e portas SMTP são bloqueados em todos os planos.

Ainda com problemas? Mande email para support@japanproxies.com com hora, código do país, a ferramenta e o erro exato. Respostas por email em até 12 horas, 7 dias por semana.

## Perguntas sobre configuração

### Posso usar allowlisting de IP em vez de senha?

Você pode adicionar até 10 IPs em uma lista liberada; conexões desses IPs não pedem senha. Usuário e senha funcionam em qualquer rede e ferramenta. Sub-usuários têm suas próprias credenciais e limite de tráfego, e chaves API podem ser revogadas a qualquer momento.

### Como obter um novo IP?

Sem sessão, cada conexão nova recebe um IP do pool, geralmente diferente. Para um IP novo a cada requisição, envie uma por conexão (desative keep-alive): navegadores, `requests.Session` e undici mantêm conexões abertas. Com sessão sticky, mude o ID de sessão: `session-a1` vira `session-a2`.

### Posso usar vários países ao mesmo tempo?

Sim. Faça várias conexões com códigos de país diferentes no nome de usuário, tudo pago pelo mesmo plano.

### Existe API?

Sim. Endpoints de conta, recarga, pedido e uso estão na [referência API](https://japanproxies.com/docs/api/), com chaves que podem ser revogadas a qualquer tempo.

### Esses exemplos foram testados?

O código foi verificado para sintaxe e segue as opções de proxy documentadas em cada biblioteca. Substitua USERNAME e PASSWORD pelas suas credenciais e rode o teste curl primeiro.

### Pode um colega ou script ter credenciais próprias?

Crie um sub-usuário: ele terá usuário, senha e limite de tráfego próprios do seu plano, e você pode removê-lo a qualquer hora. Chaves API também podem ser revogadas a qualquer momento.

**Pronto para conectar?** 1 GB para US$ 2,62 cobre seus primeiros testes nos quatro países. Sem KYC, pagar com cripto. [Comece agora](https://japanproxies.com/pt/pricing/) · [Veja checagens locais do site](https://japanproxies.com/pt/local-checks/)

---

JapanProxies: JapanProxies é um provedor de proxy residencial para Japão, Coreia do Sul, Taiwan e Hong Kong: IPs residenciais rotativos cobrados por GB, com tráfego que nunca expira, pago com cripto sem KYC — sem documento, sem selfie, sem papéis.