Puppeteer配置Socks5代理报错NO SUPPORTED PROXY的解决求助

常见错误原因 #

• 代理URL未添加socks5://前缀，Puppeteer无法识别代理类型
• 代理地址、端口填写错误，导致无法建立连接
• 需要认证的Socks5代理未正确传入用户名和密码
• Puppeteer版本过旧，对Socks5代理的支持存在兼容性问题

正确配置示例 #

1. proxy.json配置文件 #

无认证的Socks5代理

{
  "host": "127.0.0.1",
  "port": 1080,
  "username": "",
  "password": "",
  "type": "socks5"
}

带认证的Socks5代理

{
  "host": "127.0.0.1",
  "port": 1080,
  "username": "proxy_user",
  "password": "proxy_pass",
  "type": "socks5"
}

2. action.js中Person类的正确实现 #

const puppeteer = require('puppeteer');
const proxyConfig = require('./proxy.json');

class Person {
  async launchBrowser() {
    // 构建符合要求的Socks5代理URL
    let proxyUrl;
    if (proxyConfig.username && proxyConfig.password) {
      proxyUrl = `socks5://${proxyConfig.username}:${proxyConfig.password}@${proxyConfig.host}:${proxyConfig.port}`;
    } else {
      proxyUrl = `socks5://${proxyConfig.host}:${proxyConfig.port}`;
    }

    try {
      return await puppeteer.launch({
        args: [
          `--proxy-server=${proxyUrl}`,
          // 绕过本地地址代理（可选，根据需求添加）
          '--proxy-bypass-list=<-loopback>'
        ],
        headless: false // 调试时开启可视模式，生产环境可改为true
      });
    } catch (err) {
      console.error('浏览器启动失败:', err);
      throw err;
    }
  }

  async verifyProxy() {
    const browser = await this.launchBrowser();
    const page = await browser.newPage();
    
    try {
      // 访问IP检测接口验证代理是否生效
      await page.goto('https://api.ipify.org');
      const currentIp = await page.$eval('body', el => el.textContent);
      console.log('当前代理IP:', currentIp);
    } catch (err) {
      console.error('代理验证失败:', err);
    } finally {
      await browser.close();
    }
  }
}

// 执行代理验证
const person = new Person();
person.verifyProxy();

错误解决步骤 #

1. 校验代理URL格式：确保URL以socks5://开头，带认证的代理必须包含用户名:密码@段
2. 验证代理服务可用性：用curl测试代理连通性，命令示例：curl --socks5 127.0.0.1:1080 https://api.ipify.org
3. 升级Puppeteer版本：执行npm install puppeteer@latest更新到最新稳定版，修复旧版本的代理兼容问题
4. 配置代理绕过规则：若需访问本地服务，添加--proxy-bypass-list=<-loopback>参数，避免代理本地请求
5. 检查代理服务端设置：确认Socks5代理服务已正常启动，且未限制客户端IP或需要额外权限

内容的提问来源于stack exchange，提问作者innocent mutemwa