Express框架中Forwarded头部的处理方案解析

2025-04-29 13:09:37作者：薛曦旖Francesca

Express，一款为Node.js量身定制的快速、无约束、极简主义Web框架。它聚焦高性能路由处理，拥有超级测试覆盖率和HTTP助手功能，如重定向与缓存支持。Express拥抱模块化设计，兼容超过14种模板引擎，让你自由构建理想的Web应用或API。无论是单页应用还是复杂网站，Express都能轻松胜任，是开发者心中的首选。通过简洁的API，你可以迅速搭建并运行自己的服务器，享受开发的乐趣。立即加入Express社区，一同探索无限可能！

项目地址：https://gitcode.com/gh_mirrors/exp/express

背景介绍

在现代Web应用开发中，中间服务器和负载均衡器的使用非常普遍。传统上，Express框架主要依赖X-Forwarded-*系列头部（如X-Forwarded-For）来处理中间服务器后的客户端信息。但随着HTTP标准的演进，Forwarded头部（RFC 7239）正逐渐成为更标准化的替代方案。

问题核心

当使用AWS HTTP API Gateway等新型中间服务时，它们可能只提供Forwarded头部而非传统的X-Forwarded-*头部。Express默认的信任中间服务器(trust proxy)机制无法直接解析这种标准化头部，导致开发者无法正确获取客户端IP和协议信息。

技术解决方案

方案原理

Express提供了请求对象属性覆盖机制，允许开发者自定义req.ip和req.protocol等属性的获取逻辑。通过解析Forwarded头部，我们可以实现与信任中间服务器相同的功能。

实现代码示例

// Forwarded头部解析函数
const parseForwardedHeader = (request) => 
    request.header('Forwarded')
        ?.split(",")
        .flatMap((proxy) => proxy.split(';'))
        .reduce((result, proxyProps) => {
            const [key, value] = proxyProps.split('=');
            if (key && value) {
                result[key] = (result[key] || []).concat(value);
            }
            return result;
        }, {});

// 覆盖Express请求对象属性
Object.defineProperties(app.request, {
    'ip': {
        configurable: true,
        enumerable: true,
        get() {
            const proxies = parseForwardedHeader(this);
            return proxies?.['for']?.[0] ?? this.socket.remoteAddress;
        },
    },
    'protocol': {
        configurable: true,
        enumerable: true,
        get() {
            const proxies = parseForwardedHeader(this);
            return proxies?.['proto']?.[0] ?? this.socket.encrypted ? 'https' : 'http';
        },
    },
});