@fastify/proxy-addr determines the address of a proxied request. It provides `proxyaddr(req, trust)` to return the closest untrusted address, and `proxyaddr.all(req, trust)` to return the full ordered list of request addresses. It can take a trust callback, a string, or lists of trusted IP and CIDR ranges, and supports IPv6 normalization.
Project status
- Actively maintained: The source shows very recent updates (last push 2026-09-15, latest version v5.1.1 on 2026-09-15), indicating ongoing maintenance rather than dormancy.
- Cadence: Updates arrive regularly in the last year (notably v5.1.1 in 2026, and v5.1.0 in 2025-09-28), with earlier years showing longer gaps (2024 to 2025, and multi-year gaps before that).
AI summary generated
Recent updates
v5.1.1
v5.1.1 includes a security-focused change to how proxy-addr trust matching treats IPv4-mapped IPv6 addresses and subnets. The code also updates TypeScript tooling for type tests (tsd to tstyche) and adjusts CI/dependabot/staleness-related configuration.
BreakingSecurityv5.1.0
v5.1.0 focuses on refactoring and performance micro-optimizations in the main proxyaddr implementation, along with substantial dev tooling and CI updates. The release notes describe the functional code changes (Object.hasOwn usage, loop refactors, and minor perf improvements) and separate build/test/tooling dependency bumps.
v5.0.0
v5.0.0 updates the project primarily through dependency and tooling bumps, along with a few small internal code tweaks (regex refactor, require cache optimization, CI workflow adjustments). The included code diff shows changes to runtime dependencies (notably ipaddr.js), plus a switch in the unit test toolchain from tap to tape with c8 coverage.
v4.1.0
v4.1.0 is a maintenance release focused on NodeNext (ESM/CommonJS interop) compatibility, plus CI tightening via license checking. The code diff shows additional packaging and TypeScript-related changes that are not explicitly called out in the release notes.
Featuresv4.0.0
v4.0.0 release notes describe only CI and tooling updates, mainly GitHub Actions version bumps and workflow changes. There are no documented runtime/API changes or fixes to library behavior in the provided notes.