在Node.js的网络请求体系中，http模块扮演着基础且核心的角色。当我们在服务端发起大量的外部HTTP请求时，如果每次请求都建立新的TCP连接，将会消耗大量的系统资源并导致延迟增加。为了解决这个问题，Node.js引入了Agent机制来管理连接的复用。默认情况下，Node.js提供了一个全局的代理实例，即http.globalAgent，它负责调度所有通过http.request或http.get发起的默认请求。理解这个全局代理的工作原理，对于构建高并发的Node.js应用至关重要。
http.globalAgent的核心原理解析
Agent的核心价值在于连接池的管理。当HTTP请求启用Keep-Alive时，Agent会在底层维护一个TCP套接字池。请求结束后，底层的Socket并不会立即销毁，而是被保存在连接池中，供下一次对同一主机和端口的请求复用。这种机制避免了反复进行TCP三次握手和TLS握手，大幅降低了请求延迟。默认的http.globalAgent其实已经开启了连接池管理，但它的默认配置相对保守，例如maxSockets属性默认值为Infinity，这意味着如果不加限制，并发请求可能会耗尽系统的文件描述符。
此外，默认的http.globalAgent并不会自动处理代理服务器的转发。如果你的服务器处于内网环境，需要通过公司统一网关访问外网，直接使用默认的全局代理是无法成功的。此时，开发者往往会在每个请求的options中硬编码proxy参数，或者引入第三方库如http-proxy-agent。然而，这种分散式的配置方式不仅难以维护，还容易因为遗漏导致部分请求网络不通。因此，我们需要深入理解并接管http.globalAgent，将其改造为能够统一处理代理转发的全局调度器。
如何自定义Agent并替换全局代理
要实现全局代理管理，最直接的方法是创建一个自定义的Agent实例，并将其赋值给http.globalAgent。在Node.js较新的版本中，我们可以直接使用内置的http.Agent构造函数，并传入keepAlive、maxSockets等参数来优化连接池。对于代理服务器的支持，虽然Node.js核心模块没有直接提供HTTP代理协议的解析，但我们可以通过监听Agent的createConnection方法，或者借助社区成熟的代理库来构建一个具备代理转发能力的Agent实例。
下面展示一段如何使用内置http.Agent并结合代理库来接管全局请求的代码示例。我们将创建一个支持代理转发的Agent，设置合理的连接池参数，并将其挂载到全局对象上。这样，后续所有未显式指定agent的http请求，都会自动走我们配置的代理通道。
const http = require('http');
const { HttpProxyAgent } = require('http-proxy-agent');
// 代理服务器地址
const proxyUrl = 'http://127.0.0.1:8080';
// 创建自定义Agent实例，开启Keep-Alive并限制最大连接数
const customAgent = new HttpProxyAgent({
keepAlive: true,
maxSockets: 100,
maxFreeSockets: 10,
timeout: 60000,
}, proxyUrl);
// 替换全局代理
http.globalAgent = customAgent;
// 测试全局代理是否生效
http.get('http://ipipp.com/api/test', (res) => {
let data = '';
res.on('data', chunk => { data += chunk; });
res.on('end', () => {
console.log('请求成功，响应数据:', data);
});
}).on('error', err => {
console.error('请求失败:', err.message);
});
通过上述代码，我们将全局的http.globalAgent替换为了一个具备代理转发能力的实例。这种做法的最大优势在于对业务代码的零侵入性。业务层依然使用熟悉的http.get或http.request方法，完全不需要感知代理的存在。同时，通过设置maxSockets为100，我们限制了同时对同一目标主机的并发连接数，防止在突发流量下耗尽系统资源；而keepAlive和maxFreeSockets的配置则确保了连接池的高效复用。
结合HTTPS请求与第三方库的代理接管
在现代Web开发中，绝大多数外部请求都是基于HTTPS协议的。因此，仅仅接管http.globalAgent是不够的，我们还需要处理https.globalAgent。Node.js的https模块拥有独立的全局Agent实例。如果忽略了这一点，你会发现通过https模块发起的请求依然无法走代理通道。解决方法与HTTP类似，我们需要引入支持HTTPS代理的库，比如https-proxy-agent，并替换掉https.globalAgent。
除了原生模块，服务端开发经常使用axios等第三方HTTP客户端。axios默认会使用Node.js提供的http和https模块发起请求，因此它也会遵循globalAgent的配置。但是，如果axios实例被配置了自定义的proxy属性，或者使用了httpsAgent配置，那么这些局部配置的优先级会高于全局代理。为了确保全局代理的绝对控制权，建议在初始化axios实例时，显式地将全局Agent传递给它，或者干脆不配置局部的代理参数，让其回落到全局配置上。
在生产环境中，全局代理管理还需要考虑异常处理与性能监控。当代理服务器出现故障时，全局Agent可能会导致所有外部请求阻塞。因此，在自定义Agent时，合理设置timeout参数是非常必要的。此外，可以通过监听Agent实例的free和createConnection事件，来统计连接池的使用情况，从而在控制台或监控系统中输出当前活跃的Socket数量。这种端到端的全局代理管理方案，不仅提升了代码的整洁度，更为Node.js服务的网络层稳定性提供了坚实的保障。
Node.jshttp.globalAgent全局代理修改时间：2026-08-23 18:25:24