proxy-addr

中文文档
2.0.8发布于 2026/09/15MIT构建来源已验证近 30 天下载 4.8亿

确定代理请求的地址

中文使用文档
文档目录8 节
  1. 安装
  2. API 密码
  3. 代理addr( req, 信任)
  4. 代理addr.all(req,[信任])
  5. 代理addr.compile( val) (英语)
  6. 测试
  7. 基准
  8. 许可证

代理添加器

NPM Version NPM Downloads Node.js Version Build Status Test Coverage

确定代理请求的地址

安装

这是一个 节点.js 模块 npm 登记。安装使用 npm install 命令数字 :

$ npm install proxy-addr

API 密码

var proxyaddr = require('proxy-addr')

代理addr( req, 信任)

使用给定地址返回请求地址 trust 参数.

这个 trust 参数是返回的函数 true 如果你相信的话 这个地址, false 如果你没有。 最近的无人信任的地址是 已经返回.

proxyaddr(req, function (addr) { return addr === '127.0.0.1' })
proxyaddr(req, function (addr, i) { return i < 1 })

这个 trust 参数也可能是单个 IP 地址字符串或 数组可信任的地址, 如普通IP地址, CIDR 格式化 字符串,或IP/netmask字符串.

proxyaddr(req, '127.0.0.1')
proxyaddr(req, ['127.0.0.0/8', '10.0.0.0/8'])
proxyaddr(req, ['127.0.0.0/255.0.0.0', '192.168.0.0/255.255.0.0'])

本模块还支持IPv6. 您的 IPv6 地址将正常化 自动(即:. fe80::00ed:1 等于 fe80:0:0:0:0:0:ed:1) (中文(简体) ).

proxyaddr(req, '::1')
proxyaddr(req, ['::1/128', 'fe80::/10'])

此模块将自动使用 IPv4- mapped IPv6 地址 在 IPv6 模式下也支持节点.js. 这意味着你这样做 无需同时指明 ::ffff:a00:1 财务报告和审定财务报表 10.0.0.1。 。 。 .

作为方便,本模块还取出某些预定义的名称 除了IP地址之外,还扩展为IP地址:

proxyaddr(req, 'loopback')
proxyaddr(req, ['loopback', 'fc00:ac:1ab5:fff::1/64'])
  • loopback: IPv4和IPv6回回路地址(如 ::1 财务报告和审定财务报表 127.0.0.1) (中文(简体) ).
  • linklocal: IPv4和IPv6链接-本地地址(如 fe80::1:1:1:1 财务报告和审定财务报表 169.254.0.1) (中文(简体) ).
  • uniquelocal: IPv4 私人地址和 IPv6 独有本地地址 地址( 如 fc00:ac:1ab5:fff::1 财务报告和审定财务报表 192.168.0.1) (中文(简体) ).

何时 trust 被指定为函数,将要求每个函数 地址以确定它是否是一个可信任的地址。 函数是 提供了两个论据: addr 财务报告和审定财务报表 i时 addr 是一个字符串 要检查的地址 i 是代表距离的数 从套接字地址.

代理addr.all(req,[信任])

返回请求的所有地址, 可选择在 初无所信. 此数组从最远处命令 (即说. arr[0] === req.connection.remoteAddress) (中文(简体) ).

proxyaddr.all(req)

可选 trust 参数与 trust 显示在 proxyaddr(req, trust)。 。 。 .

proxyaddr.all(req, 'loopback')

代理addr.compile( val) (英语)

编译参数 val 改为 a trust 函数。 此函数需要 相同的论点 trust 显示在 proxyaddr(req, trust) 财务报告和审定财务报表 返回适合的函数 proxyaddr(req, trust)。 。 。 .

var trust = proxyaddr.compile('loopback')
var addr = proxyaddr(req, trust)

此功能旨在针对每个请求优化使用. 建议为受托人预先汇编一个信托职能 配置并传递到 proxyaddr(req, trust) 每个请求.

测试

$ npm test

基准

$ npm run-script bench

许可证

麻省理工学院

版本与发布记录

proxy-addr 共发布 28 个版本,首次发布于 2014/05/05;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.8latest2026/09/151 个月前
2.0.72021/06/015 年前
2.0.62020/02/246 年前
2.0.52019/04/177 年前
2.0.42018/07/278 年前
2.0.32018/02/208 年前

关于 proxy-addr 的常见问题

proxy-addr 是什么?

确定代理请求的地址

如何安装 proxy-addr?

在项目目录运行 npm install proxy-addr,或使用 pnpm add / yarn add / bun add。

proxy-addr 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/proxy-addr 是否存在。

proxy-addr 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 0.10。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

proxy-addr 可以商用吗?

proxy-addr 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

proxy-addr 的下载量有多少?

根据 npm 官方下载统计,proxy-addr 在 2026/10/05 – 2026/11/03 这 30 天内被下载 476,984,256 次,日均约 15,899,475 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

proxy-addr 还在维护吗?

最新版本 2.0.8 发布于 2026/09/15(1 个月前);至今共发布 28 个版本,其中过去 12 个月发布了 1 个;首次发布于 2014/05/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。