在 Node.js 中使用代理：分步指南

最新推荐文章于 2026-07-04 18:46:18 发布

原创最新推荐文章于 2026-07-04 18:46:18 发布 · 233 阅读

本内容遵循CC 4.0 BY-SA版权协议

在 Node.js 中使用代理：分步指南

在本指南中，我将带你了解在 Node.js 中使用代理的基础知识。我们会介绍不同类型的代理、它们的工作原理，以及如何结合常见的 Node.js 库进行实际使用。读完后，你将清楚地理解如何在 Node.js 项目中配置代理，以及它们为何有用。无论你是刚入门，还是想优化现有配置，本指南都会让你轻松掌握代理。

什么是代理？

代理服务器是一种中间服务器：它接收客户端的请求并将其转发到目标服务器，然后再把响应转发回客户端。这种架构可以隐藏客户端的 IP 地址，并提供匿名性、安全性或内容过滤等能力。

代理有多种类型，但本文将重点介绍常见的正向代理，它们主要用于网页抓取：

数据中心代理：托管在数据中心，速度快、成本低，适合抓取大量数据，但更容易被检测到。
ISP 代理：使用由 ISP 提供的 IP，兼具速度与“真实度”，比数据中心代理更不容易被封锁。
移动代理：使用分配给移动设备的 IP，具备高匿名性与轮换能力，非常适合绕过严格的反机器人措施。
住宅代理：绑定真实用户设备，匿名性高，适合从具有严格地理封锁与安全过滤的网站抓取数据。

我们将聚焦这些正向代理，因为它们对于网页抓取与绕过限制至关重要。

为什么在 Node.js 中使用代理？

代理能为 Node.js 应用带来多种优势，例如：

绕过地理限制：你可以访问受地理位置限制的内容或 API。
负载均衡与流量分发：反向代理可将流量分配到不同的服务器实例，从而提升应用的可靠性与性能。
缓存：代理可以缓存数据，减少从源站重复获取相同内容的次数。
增强安全性：代理可作为安全层，在恶意请求或攻击到达你的服务器之前进行拦截。

在 Node.js 中配置代理

要在 Node.js 中实现代理，你可以使用 http-proxy、node-fetch 等库。我们先从 http-proxy 开始，它是 Node.js 生态中很受欢迎的代理库。

第 1 步：安装 http-proxy

先在项目目录中安装 http-proxy 包。

npm install http-proxy

第 2 步：使用 http-proxy 进行基础代理配置

安装完成后，你可以创建一个简单的代理服务器。下面是一个正向代理示例：

const http = require('http');

const httpProxy = require('http-proxy');

const proxy = httpProxy.createProxyServer({});

const server = http.createServer((req, res) => {

proxy.web(req, res, { target: 'http://example.com' }, (err) => {

res.writeHead(500, { 'Content-Type': 'text/plain' });

res.end('Something went wrong.');

});

server.listen(3000, () => {

console.log('Proxy server is running on http://localhost:3000');

});

在这个示例中，代理会将所有传入请求转发到 http://example.com。如果你访问 http://localhost:3000，请求将被转发到目标站点。

第 3 步：处理错误与事件

代理经常会遇到错误，例如连接问题或无效请求。你可以通过监听 error 事件来处理这些情况。

proxy.on('error', (err, req, res) => {

console.error('Proxy error:', err);

res.writeHead(502, { 'Content-Type': 'text/plain' });

res.end('Bad Gateway.');

});

这样可以确保当代理出现问题时，客户端能收到有意义的响应。

第 4 步：在 Node.js 中实现反向代理

要配置反向代理（将流量导向多个服务器），你可以按如下方式修改代码：

const servers = ['http://localhost:3001', 'http://localhost:3002'];

const server = http.createServer((req, res) => {

const target = servers[Math.floor(Math.random() * servers.length)];

proxy.web(req, res, { target });

});

server.listen(3000, () => {

console.log('Reverse proxy running on http://localhost:3000');

});

在 node-fetch 中使用代理

node-fetch 库常用于在 Node.js 应用中发起 HTTP 请求。你可以使用 http-proxy-agent 为 HTTP 代理添加支持，或使用 https-proxy-agent 为 HTTPS 代理添加支持。

第 1 步：安装 node-fetch 与代理 Agent

npm install node-fetch http-proxy-agent

第 2 步：在 node-fetch 中实现代理

下面展示如何为 node-fetch 配置代理：

const fetch = require('node-fetch');

const HttpProxyAgent = require('http-proxy-agent');

const proxyAgent = new HttpProxyAgent('http://your-proxy-server:8080');

fetch('http://example.com', { agent: proxyAgent })

.then(res => res.text())

.then(body => console.log(body))

.catch(err => console.error('Fetch error:', err));

在这个示例中，所有通过 node-fetch 发起的请求都会经由指定的代理服务器（http://your-proxy-server:8080）进行转发。

企业级 Node.js 应用中的代理

代理不仅适用于小项目。在大型 Node.js 应用中，尤其是基于微服务的架构，反向代理经常用于路由与负载均衡。Nginx 和 HAProxy 是常见的、用于 Node.js 应用的反向代理工具。

在微服务中，反向代理可以：

管理流量：根据路由将传入请求转发到不同的微服务。
提升安全性：隐藏真实服务器 IP 地址，并在流量进入内部网络前实施安全措施。
实现可扩展性：将请求分配到多个实例，确保服务具备高可用性。

代理认证

在某些情况下，代理服务器需要认证。你可以使用 Node.js 为代理请求添加认证头。

const options = {

target: 'http://example.com',

headers: {

'Proxy-Authorization': 'Basic ' + Buffer.from('username:password').toString('base64'),

};

proxy.web(req, res, options);

这会发送一个包含 base64 编码凭据（username:password）的授权头，从而让你能够访问需要认证的代理。

适用于 Node.js 的最佳代理服务器

Bright Data
Bright Data 提供顶级代理服务，包括数据中心代理、住宅代理和移动代理，非常适合需要高扩展性、IP 轮换以及高级验证码破解能力的 Node.js 应用。其庞大的网络确保了可靠性与合规性。
ScraperAPI
以易于与 Node.js 集成而闻名，ScraperAPI 提供自动 IP 轮换、CAPTCHA 破解以及反机器人保护，非常适合大规模网页抓取。
Oxylabs
Oxylabs 提供强大的代理服务，包括数据中心代理和住宅代理。它安全性高，并且非常适合在 Node.js 中用于抓取与 API 驱动的项目。
NetNut
NetNut 提供可靠且快速的住宅代理，是需要稳定性能与尽量减少停机时间、用于抓取或 API 任务的 Node.js 用户的优秀选择。
Smartproxy
Smartproxy 提供价格实惠的住宅代理与数据中心代理，提供大量 IP 供网页抓取使用，并为 Node.js 用户提供简单直接的配置流程。