为什么需要代理IP？
在Node.js开发中，尤其是进行数据采集、API调用或自动化测试时，直接使用本地网络可能会遇到一些问题。比如，目标网站对单一IP的访问频率有限制，频繁请求容易被封；或者某些服务对地域有要求，需要特定地区的IP才能访问。这时，使用代理IP就成为一个非常实用的解决方案。它能让你的请求“改头换面”，从另一个网络出口发出，从而规避限制，提高任务成功率。
在众多代理协议中，SOCKS5因其支持TCP和UDP连接，且认证方式灵活，成为很多开发者的首选。接下来，我们就聚焦于如何在Node.js中，通过配置SOCKS5代理来发送HTTP请求。
核心工具：socks-proxy-agent
要在Node.js中实现经由SOCKS5代理发出请求，最直接的方法是使用一个名为 socks-proxy-agent 的库。它可以将一个普通的HTTP/HTTPS请求，通过一个SOCKS代理服务器进行转发。这个库非常轻量，且与流行的HTTP客户端（如Axios、Got、Node.js内置的`http`/`https`模块）兼容性很好。
你需要在你的Node.js项目中安装它：
npm install socks-proxy-agent axios
这里我们同时安装了Axios，因为它是一个广泛使用的、基于Promise的HTTP客户端，使用起来非常方便。
Axios配置SOCKS5代理实战
假设你已经从可靠的代理服务商（例如ipipgo）获取到了一个可用的SOCKS5代理信息，格式通常为：host:port，可能还包含用户名和密码。下面我们来看具体的配置示例。
场景一：无需认证的SOCKS5代理
const axios = require('axios');
const { SocksProxyAgent } = require('socks-proxy-agent');
// 你的SOCKS5代理地址，例如从ipipgo后台获取
const proxyHost = 'gateway.ipipgo.com';
const proxyPort = 20000;
const proxyOptions = `socks5://${proxyHost}:${proxyPort}`;
// 创建代理Agent实例
const agent = new SocksProxyAgent(proxyOptions);
// 配置Axios实例，使用这个代理Agent
const axiosInstance = axios.create({
httpAgent: agent,
httpsAgent: agent, // HTTPS请求也需要配置
});
// 使用配置了代理的Axios实例发送请求
async function makeRequest() {
try {
const response = await axiosInstance.get('http://httpbin.org/ip');
console.log('通过代理获取到的IP信息:', response.data);
} catch (error) {
console.error('请求失败:', error.message);
}
}
makeRequest();
场景二：需要用户名密码认证的SOCKS5代理
const axios = require('axios');
const { SocksProxyAgent } = require('socks-proxy-agent');
// 包含认证信息的代理地址
const proxyUsername = '你的用户名';
const proxyPassword = '你的密码';
const proxyHost = 'gateway.ipipgo.com';
const proxyPort = 20001;
// 注意URL的格式
const proxyOptions = `socks5://${proxyUsername}:${proxyPassword}@${proxyHost}:${proxyPort}`;
const agent = new SocksProxyAgent(proxyOptions);
const axiosInstance = axios.create({
httpAgent: agent,
httpsAgent: agent,
});
// 后续发送请求的代码与场景一相同
通过以上代码，你的所有通过`axiosInstance`发出的请求，都会自动经由你指定的SOCKS5代理服务器，目标网站看到的将是代理服务器的IP地址，而非你本机的真实IP。
选择可靠的代理IP服务：为什么是ipipgo？
代码实现只是第一步，代理IP的质量直接决定了项目的成败。一个不稳定的代理IP会导致请求频繁失败、延迟高，甚至泄露你的真实IP。选择一个专业的代理服务商至关重要。
ipipgo在代理IP领域提供了专业、稳定的解决方案，其产品能很好地匹配Node.js开发中的各种场景：
- 动态住宅代理：拥有海量真实家庭住宅IP资源，覆盖220多个国家和地区。对于需要模拟不同地区真实用户访问、进行大规模数据采集或社交媒体管理的项目，动态IP池能有效避免IP被封禁。它支持按流量计费和灵活的会话控制（轮换或粘性会话）。
- 静态住宅代理：提供纯净、稳定的长效住宅IP，可用性高达99.9%。非常适合需要长期稳定维持同一IP身份的业务，例如账号管理、长期监控等。它同样支持精准的城市级定位。
- 全协议支持：无论是动态还是静态住宅代理，ipipgo都同时支持HTTP(S)和SOCKS5协议，为开发者提供了最大的灵活性。本文介绍的SOCKS5配置方法可以无缝对接其服务。
使用ipipgo这类专业服务的优势在于，IP纯净度高、网络稳定、有完善的管理后台和API接口，可以便捷地获取、更换和管理代理IP，让开发者能更专注于业务逻辑本身。
常见问题与解答（QA）
Q1: 我配置了代理，但请求报错“连接超时”或“无法建立隧道”，可能是什么原因？
A1: 这通常有几个排查方向：1) 检查代理IP和端口是否填写正确；2) 确认你的本地网络环境能否访问到该代理服务器（某些代理服务需要你先具备海外网络环境才能使用）；3) 如果代理需要认证，检查用户名和密码是否正确；4) 尝试在ipipgo后台更换一个代理IP，可能是当前IP节点临时不可用。
Q2: 使用代理后请求速度变慢了，正常吗？
A2: 这是正常现象。请求数据需要先经过代理服务器中转，必然会增加一些网络延迟。速度取决于代理服务器的带宽、负载以及其到目标服务器的网络质量。选择像ipipgo这样提供高速、稳定线路的服务商，可以将延迟影响降到最低。
Q3: 我可以让一部分请求走代理，另一部分不走吗？
A3: 当然可以。你可以创建多个Axios实例，一个配置了`SocksProxyAgent`，另一个不配置。根据不同的业务逻辑，选择使用不同的实例即可实现分流。
const axios = require('axios');
const { SocksProxyAgent } = require('socks-proxy-agent');
// 创建带代理的实例
const proxyAgent = new SocksProxyAgent('socks5://代理地址:端口');
const axiosWithProxy = axios.create({ httpsAgent: proxyAgent, httpAgent: proxyAgent });
// 创建不带代理的默认实例
const axiosDefault = axios;
// 分别使用
axiosWithProxy.get('https://需要代理的目标.com');
axiosDefault.get('https://本地直接访问的目标.com');
Q4: 除了Axios，Node.js内置的`https`模块能使用SOCKS5代理吗？
A4: 可以。`socks-proxy-agent`库生成的Agent对象，同样可以传递给`https.request`或`http.request`方法的`agent`选项，实现原理完全相同。
总结
在Node.js中通过SOCKS5代理发送请求，核心在于使用`socks-proxy-agent`库创建一个代理Agent，并将其配置到HTTP客户端（如Axios）中。这个过程并不复杂，但却是实现IP伪装、规避访问限制的关键一步。
技术的实现需要可靠的基础设施来支撑。一个像ipipgo这样提供高质量、高匿名性、覆盖的代理IP服务，能够确保你的爬虫、自动化工具或业务系统稳定、高效地运行。建议根据你的具体业务场景（是需要频繁更换IP，还是需要长期稳定的IP），在ipipgo的动态住宅代理和静态住宅代理中选择最适合的套餐，从而为你的Node.js项目提供强大的网络能力支持。
简体中文 
English 
Español 
Deutsch 
Français