如何为Socket.io客户端配置SOCKS代理？

正确配置步骤（Node.js环境） #

1. 安装依赖包

npm install socks-proxy-agent socket.io-client

2. 编写配置代码

import { io } from 'socket.io-client';
import { SocksProxyAgent } from 'socks-proxy-agent';

// 代理URL格式：socks://用户名:密码@代理地址:端口
const proxyUrl = 'socks://your-username:your-password@proxy-host:proxy-port';
const proxyAgent = new SocksProxyAgent(proxyUrl);

const socket = io('wss://example.com/', {
  agent: proxyAgent // Node.js环境下直接传入Agent对象即可
});

socket.onAny((eventName, ...args) => {
  console.log(`事件：${eventName}`, args);
});

关键说明 #

• 你遇到的参数类型报错，大概率是代理地址格式错误或混淆了环境差异：Socket.io客户端在Node.js环境下完全支持传入Agent对象，包括SocksProxyAgent。
• 必须使用标准socks://协议开头的完整URL，不要拆分host、账号密码单独传入。
• 浏览器环境受限于同源策略和安全机制，无法通过代码直接配置SOCKS代理，需依赖系统全局代理或浏览器扩展实现。

排错提示 #

• 检查socket.io-client版本：建议使用最新稳定版，避免旧版本的参数兼容问题。
• 先验证代理可用性：用curl等工具测试代理能否正常访问目标WebSocket地址，排除代理自身故障。

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