住宅代理设置指南：如何连接住宅代理

在注册页面创建账户后，您会获得一个格式为 pm_XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX 的访问令牌。同一个令牌既用于登录网站，也作为代理密码。

服务器只保存令牌的哈希值和最后4个字符。离开页面之前，请把它保存到密码管理器或其他安全的地方。

令牌丢失后无法找回。在代码中请从环境变量读取令牌，避免它被提交到代码仓库。

每个IP地址最多可创建3个账户，登录每10分钟最多可尝试10次。

代理从余额中扣费，因此请先充值。一个余额即可用于动态住宅代理、静态ISP代理、数据中心代理和移动代理。

动态住宅流量 $0.80/GB起，移动流量 $4.00/GB起，按使用量扣费。例如，把 $100 用于动态住宅，可获得 $100 除以 $0.80/GB 的流量。充值金额和赠送请查看价格页面。

用户名以 user 开头，再用 - 连接可选部分。密码始终是您的访问令牌。不添加任何部分时，您会获得一个未指定国家的动态住宅IP。

按类型、国家、城市、会话的顺序书写，便于阅读。user-country-jp-city-tokyo-session-shop1 表示在会话名 shop1 下保持一个东京IP。

移动代理只能按国家定位，因此使用 type-mobile 时请不要加城市。国家代码和城市列表请查看覆盖地区页面。

HTTP和SOCKS5共用同一个主机 gate.proxymay.com 和端口 7000。从以下三种格式中选择您的工具支持的一种。

http://user-country-jp:[email protected]:7000
socks5://user-country-jp:[email protected]:7000
gate.proxymay.com:7000:user-country-jp:YOUR_TOKEN

控制台会生成相同的字符串供您复制。前两行是URL格式；最后一行适用于需要 host:port:user:password 格式的工具。

写代码之前，先在终端测试，可以快速缩小问题范围。请确认响应中的ip、country和city与您的用户名一致。

curl -x http://user-country-us:[email protected]:7000 https://ipinfo.io/json

# Same check over SOCKS5
curl -x socks5h://user-country-us:[email protected]:7000 https://ipinfo.io/json

使用socks5h时，DNS查询也会经过代理。

在requests中，把同一个URL同时放到proxies字典的http和https下。此示例在会话shop1下保持一个日本IP。

import requests

proxy = "http://user-country-jp-session-shop1:[email protected]:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30)
print(r.status_code, r.json())

使用SOCKS5时，请运行 pip install requests[socks]，并把协议改为 socks5h://。

在Scrapy中，在请求的meta里设置proxy，内置中间件会处理认证。如果希望每个页面使用不同的IP，请为每个请求设置各自的会话名称。

import scrapy

class IpSpider(scrapy.Spider):
    name = "ipcheck"

    def start_requests(self):
        proxy = "http://user-country-gb:[email protected]:7000"
        yield scrapy.Request("https://ipinfo.io/json", meta={"proxy": proxy})

    def parse(self, response):
        yield response.json()

在Node.js 18或更高版本中，把undici的ProxyAgent作为fetch的dispatcher传入。如果使用axios，把同一个URL交给https-proxy-agent包即可。

// npm install undici
import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-de:[email protected]:7000");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

浏览器自动化工具会分别接收服务器和认证信息。把定位部分写在用户名里，把令牌写在密码里。

// Playwright
const { chromium } = require("playwright");

const browser = await chromium.launch({
  proxy: {
    server: "http://gate.proxymay.com:7000",
    username: "user-country-fr-city-paris-session-web1",
    password: "YOUR_TOKEN",
  },
});
const page = await browser.newPage();
await page.goto("https://ipinfo.io/json");

// Puppeteer
const browser2 = await puppeteer.launch({ args: ["--proxy-server=http://gate.proxymay.com:7000"] });
const page2 = await browser2.newPage();
await page2.authenticate({ username: "user-country-fr", password: "YOUR_TOKEN" });

对于需要保持登录的任务，请加上会话名称，让每个页面都从同一个IP打开。

没有会话部分时，每个请求都会获得新的IP。这适合排名查询或价格采集等相互独立的请求。

登录、购物车和多步骤流程可能会在IP变化时出错。加上 session-name，即可保持同一IP最长 120 分钟。

• 为每个任务设置各自的会话名称（例如 cart1、cart2）。
• 要切换IP，只需更改会话名称。
• 如果需要整月使用同一IP，静态ISP代理更合适。

• 407 Proxy Authentication Required：用户名格式或令牌有误。请检查是否以user开头、各部分是否用 - 分隔，以及令牌是否带有多余空格。
• 连接被拒绝或超时：请再次确认主机 gate.proxymay.com 和端口 7000，并确保防火墙没有阻止对该端口的出站连接。同时确认余额是否充足。
• 显示的国家不对：请检查国家代码是否为两个字母，城市是否为小写并使用 _。先运行curl检查，再排查代码中的缓存或其他代理设置。
• 会话在 120 分钟后变化：这是正常现象，因为固定会话最长持续 120 分钟。请把工作拆分到这个时间范围内，或用新的会话名称重新开始。

更多解答汇总在常见问题中。

请将ProxyMay用于公开数据采集、广告验证、SEO排名查询、价格监控、网站和本地化测试，以及自有账户管理。禁止未经授权访问他人账户、垃圾信息、欺诈、攻击、违法内容，以及任何违反法律或侵犯目标网站权利的行为。

控制请求节奏并遵守各网站的规则，也能让您的任务顺利运行。完整规则请查看服务条款。