# 如何设置日本及东亚住宅代理

> 在 curl、Python、Node.js、Playwright、Puppeteer 和浏览器中设置日本、韩国、台湾或香港的住宅代理：用户名格式与会话设置。

- URL: https://japanproxies.com/zh/guides/setup/
- 最后更新: 2026-10-14
- Publisher: JapanProxies (https://japanproxies.com)

所有信息都放在代理用户名中：国家代码，如果你想保持一个IP一段时间，还有会话ID和持续时间。为最常用工具提供复制粘贴示例。

**快速回答 — 如何连接日本住宅代理？**

将你的工具指向端口为 7777 的 `gw.japanproxies.com` 用于 HTTP 和 HTTPS，或端口 7778 用于 SOCKS5，使用你的 **JapanProxies** 密码及用户名 `USERNAME-country-jp`。南韩、台湾或香港使用 `kr`、`tw` 或 `hk`。加上 `-session-ID-ttl-30` 可保持一个IP 30分钟。套餐起价为 US$2.62，按加密货币支付，无需 KYC。

## 连接详情

| 属性 | 数值 |
| --- | --- |
| 主机 | `gw.japanproxies.com` |
| HTTP / HTTPS 端口 | 7777 |
| SOCKS5 端口 | 7778 |
| 用户名格式 | `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}` |
| 国家代码 | `jp` 日本 · `kr` 韩国 · `tw` 台湾 · `hk` 香港 |
| 会话ID | 字母和数字，由你选择；相同的ID会在出口在线时保持同一个IP |
| 会话时长（ttl） | 您设置的时间（ttl，单位为分钟），最长 30 分钟；IP 可能提前更换，例如住宅设备下线时 |
| 密码 | 从你的控制面板获取 |

## 用户名中都写什么？

*USERNAME 是您的仪表板中显示的基础用户名。目前东亚地区不支持城市区段。*

| 用户名 | 你将获得 |
| --- | --- |
| `USERNAME-country-jp` | 一个日本住宅 IP；每次新连接通常会变换IP |
| `USERNAME-country-jp-city-osaka` | 当在线时，获得大阪住宅代理IP（城市可用性可能不同） |
| `USERNAME-country-kr-asn-4766` | 在KT网络（ASN 4766）上的韩国IP，无额外费用 |
| `USERNAME-country-kr-session-a1-ttl-30` | 只要复用会话 `a1`，最多可保持一韩国IP 30分钟 |
| `USERNAME-country-tw-session-b7-ttl-30` | 单个台湾IP最长可用30分钟；设备离线时可能提前更换 |
| `USERNAME-country-hk-session-c2-ttl-10` | 单个香港IP最长可用10分钟 |

## 如何用 curl 测试连接？

先运行这些命令。前两个打印出口IP及其国家（HTTP，然后是 SOCKS5）；第三个显示粘性会话保持相同IP。如果两者显示正确国家，任何工具都能正常工作。

*curl：HTTP 与 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
```

## 如何在 Python 中使用代理？

使用 `requests`，把相同的代理 URL 传给 `http` 和 `https`：网关通过 CONNECT 处理 HTTPS。如果密码含有 `@`或`:`等字符，请进行 URL 编码。对于 SOCKS5，安装 `requests[socks]` 并使用 `socks5h://`，确保 DNS 在出口解析。

*Python（requests）：轮换与粘性*

```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）通过 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
```

## 如何在 Node.js 中使用代理？

为 Node 内置的 `fetch` 提供支持的 `undici` 包有一个适用于 HTTP 代理的 `ProxyAgent`。用 `npm install undici` 安装它，并作为 `dispatcher` 传入代理。

*Node.js（undici）：通过台湾IP访问*

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

## 如何在 Playwright 或 Puppeteer 中使用代理？

浏览器分别接受服务器和凭证。在 Playwright 中，将它们传入 `launch()` 的`proxy` 选项；设置上下文的 `locale` 和 `timezoneId`，以匹配测试本地化时的国家。Puppeteer 中，启动时传入 `--proxy-server` ，且首次请求前调用 `page.authenticate()`。

*Playwright（Python）：一个日本浏览器上下文*

```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）：一个韩国页面*

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

## 如何在浏览器或手机上使用代理？

- **Firefox：** 设置 → 网络设置 → 手动代理配置。输入 HTTP 的服务器 `gw.japanproxies.com` 和端口 7777，勾选“也用于 HTTPS”，Firefox 询问时输入用户名和密码。
- **Chrome 与 Edge：** 使用系统代理设置；支持认证的代理扩展便于切换国家。
- **iPhone 和 iPad：** 设置 → Wi-Fi → 网络旁的 (i) → 配置代理 → 手动，填写服务器、端口和认证。
- **Android：** 内置 Wi-Fi 代理不要求用户名密码，需使用支持认证的应用或测试工具。

切换后打开IP检查页面，确认国家位置。

## 常见错误是什么意思？

- **407 代理认证需要：** 用户名或密码错误，或密码中未编码的特殊字符。
- **连接超时：** 防火墙阻止了对端口 7777 或 7778 的外发流量，或IP背后的家庭连接离线；尝试使用新会话ID重试。
- **IP检测页面显示错误国家：** 一些地理位置数据库有误差；详情见[为何代理显示错误位置](https://japanproxies.com/zh/guides/check-proxy-location/)。
- **网站拒绝连接：** 请检查网站条款。银行、政府和支付门户以及SMTP端口在所有套餐中均被封锁。

仍有问题？请邮件 support@japanproxies.com，附带时间、国家代码、工具及具体错误。电子邮件回复时间为12小时内，全年7天服务。

## 设置问题

### 我可以用IP白名单代替密码吗？

您可添加最多10个IP至白名单，从这些IP连接无需密码。用户名和密码适用于任何网络和所有工具。子用户有自己的凭据和流量限制，API密钥随时可注销。

### 如何获取新IP？

未使用会话时，每次新连接都会从IP池分配，通常不同。要每次请求新IP，关闭 keep-alive，确保每个请求使用独立连接：浏览器、`requests.Session` 和 undici 默认保持连接。使用粘性会话，则更换会话ID：`session-a1` 变为 `session-a2`。

### 能同时使用多个国家吗？

可以，同时用不同国家代码的用户名开启多个连接，流量均计入同一套餐。

### 有 API 吗？

有。账户、充值、订单和使用情况端点见[API参考](https://japanproxies.com/docs/api/)，API密钥可随时注销。

### 这些示例经过测试吗？

代码经过语法检查，并遵循各库的代理文档。替换 USERNAME 和 PASSWORD 为您的凭据，先运行 curl 测试。

### 同事或脚本能有自己的凭据吗？

创建子用户：它有自己的用户名、密码和流量限制，来源于您的套餐，您可随时删除。API密钥也可随时注销。

**准备连接了？** 1 GB 用于 US$2.62，覆盖您在四个国家的首次测试。无需 KYC，支持加密货币支付。 [开始使用](https://japanproxies.com/zh/pricing/) · [查看本地网站检测](https://japanproxies.com/zh/local-checks/)

---

JapanProxies: JapanProxies 是一家面向日本、韩国、台湾和香港的住宅代理供应商：旋转住宅代理 IP，按 GB 计费，流量永不过期，支持加密货币支付且无需 KYC — 无需身份证，无需自拍，无需任何文件。