DApp 测试代理：用目标国家 IP 测前端与地区规则

为什么测 dApp 要用代理

国内团队测出海 dApp，第一步就卡在网络：GreatFire 显示 app.uniswap.org、polymarket.com 这类 dApp 在中国大陆打不开，国内网络里看不到海外用户看到的页面，测试流量必须从目标国家出去。

dApp 会按国家给出不同结果。以 Polymarket 为例，它公开了地区检测接口，返回识别到的 IP、国家和地区，列出前端和 API 全面限制或只允许平仓的地区，并要求开发者下单前先核对位置。你的 dApp 如果有类似规则，只能用各地区的 IP 实测。

Playwright 支持给整个浏览器或每个上下文单独设置代理，一次运行就能测多个国家；用户名密码只对 HTTP(S) 代理生效，所以生成 IP 时协议选 HTTP。MetaMask 这类钱包插件只能在持久化上下文启动的 Chromium 里加载。静态机房 IP 租期内不变，同一个国家每次都从同一个地址测，结果可以对比。

• GreatFire 检测：dApp 网站在中国大陆的访问情况
• Polymarket 文档：地区限制
• Playwright 文档：HTTP 代理
• Playwright 文档：Chrome 扩展
• Proxy302 静态机房（Web3 场景）配置

DApp 测试推荐配置

可使用方向键横向滚动，阅读完整内容。

下面的「配置 DApp 测试代理」按钮会打开 Web3 场景的静态机房代理，按 IP 和租期计费、默认 HTTP。付款前选好地区、租期和「数量」（一次最多 100 个 IP）。

• Proxy302 静态机房（Web3 场景）配置

买哪种 Proxy302 代理

可使用方向键横向滚动，阅读完整内容。

价格以美元计，用 PTC 余额支付（1 PTC = US$1）。先充值钱包，再购买需要的线路。自动续费暂未开放，静态 IP 请在到期前到「我的资产」手动续费。

• Proxy302 静态机房（Web3 场景）配置
• Proxy302 价格说明

5 步配好 dApp 测试代理

1. 国内网络先开辅助工具

   代理要在海外网络下才能连上。在中国大陆，登录 Proxy302 控制台 → 连接工具 → 辅助工具，下载并运行，使用代理期间保持开着；工具和脚本里用辅助工具显示的本地地址和端口代替代理的主机和端口，用户名密码不变。已有能连海外的 VPN 也可以。

   • 辅助工具使用教程

2. 选择开发配置

   点「配置 DApp 测试代理」打开「静态机房代理」，使用场景已选 Web3。在「连接配置」里选地区和租期，协议保持 HTTP，点「确认费用并生成」。每次购买对应一个地区，测试矩阵里的每个国家各买一次；同一国家要多个 IP 就改「数量」（一次最多 100 个）。

   预期结果 「当前配置」显示按 IP 和租期、Web3、地区和协议。

3. 复制连接信息

   付款后控制台会打开「我的资产」。在新代理上点「查看凭据」，复制出口地址（主机:端口）、用户名和密码。

4. 把出口写进测试配置

   每个国家的主机、端口、用户名和密码存进 CI 密钥，不要提交到仓库。在 Playwright 里作为浏览器或上下文的 proxy 参数传入，写法见下方示例。国内 CI 机器直连代理通常会超时，自动化测试请放在海外的 CI 上跑。

5. 按国家逐个跑

   同一套流程在每个出口上跑一遍：先读出口国家，再看页面状态码，每个国家留一张截图，方便对比差异。

   预期结果 每次运行都输出出口国家、页面状态和截图。

同一个测试按国家逐个跑（Playwright）

可使用方向键横向滚动，阅读完整内容。

// Save as geo-test.mjs and run: node geo-test.mjs
// npm i -D playwright && npx playwright install chromium
import { chromium } from 'playwright'

const DAPP_URL = 'https://app.example.org/' // your dApp
const exits = {
  US: { server: 'http://US_HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
  DE: { server: 'http://DE_HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
}

const browser = await chromium.launch()
for (const [expected, proxy] of Object.entries(exits)) {
  const context = await browser.newContext({ proxy })
  const page = await context.newPage()
  await page.goto('https://ipinfo.io/country')
  const seen = (await page.locator('body').innerText()).trim()
  const response = await page.goto(DAPP_URL, { waitUntil: 'domcontentloaded' })
  console.log(`${expected}: exit ${seen}, status ${response?.status()}`)
  await page.screenshot({ path: `dapp-${expected}.png`, fullPage: true })
  await context.close()
}
await browser.close()

Playwright 支持按浏览器上下文分别设置代理，一次运行测完多个国家。主机和密码放进 CI 密钥，DAPP_URL 换成你的 dApp。在中国大陆本机调试时，server 填辅助工具显示的本地地址和端口。

• Playwright 文档：HTTP 代理

常见问题速查

DApp 测试代理常见问题

相关场景

Playwright 代理

Playwright 代理设置：账号密码认证，一个上下文一条 IP；测试用静态机房 IP，网站封服务器 IP 时用动态住宅，US$1.50/GB 起。

查看配置与价格

MetaMask 钱包代理

MetaMask 代理（小狐狸钱包代理）：metamask.io、WalletConnect 和多数 dApp 在中国大陆打不开。把一条海外静态 ISP IP 设在浏览器上，钱包和 dApp 都走同一个固定出口，支持 HTTP / SOCKS5。

查看配置与价格

测试网开发代理

测试网代理 IP：GitHub 在中国大陆连接不稳，Foundry 安装、Hardhat 编译器下载和 Sepolia RPC 常被卡住。设置一次 HTTPS_PROXY，整套开发工具都走一条静态机房 IP。

查看配置与价格