Plack::...rseProxy(3)

πŸ’– Plack::Middleware::ReverseProxy β€” the manual page, bestie edition πŸ’–

okay so real talk, this is the manual for Plack::Middleware::ReverseProxy, and it lives in section 3 of the User Contributed Perl Documentation (iykyk, that's the perl manpage collection). It's giving very "small module, big responsibilities" energy and honestly? we're obsessed. 🫢

✨ NAME ✨

Plack::Middleware::ReverseProxy β€” bestie, this one supports an app to run as a reverse proxy backend. that's literally the whole job. no notes. πŸ’…


🌸 SYNOPSIS 🌸

builder {
    enable_if { $_[0]->{REMOTE_ADDR} eq '127.0.0.1' }
        "Plack::Middleware::ReverseProxy";
    $app;
};

see how cute that is? that's the whole setup, she's lowkey elegant πŸŽ€


πŸ¦‹ DESCRIPTION πŸ¦‹

So Plack::Middleware::ReverseProxy resets some HTTP headers that got changed by the reverse proxy. like, the proxy came in and rearranged the furniture and this middleware puts it back where it belongs. 🧹✨

And here's the part where you get to be a little paranoid (affectionately): you can specify the reverse proxy address, and you can stop fake requests, by using the 'enable_if' directive up in your app.psgi. Yes bestie, the enable_if thing is your bouncer at the door. πŸšͺπŸ’ͺ no fake requests allowed, periodt.


πŸ‘‘ LICENSE πŸ‘‘

This software is licensed under the same terms as Perl itself. iconic behavior, fr fr. 🌈


Copyright 2009-2019 Tatsuhiko Miyagawa</>, holding it down since 2009 πŸ˜­πŸ‘‘


🌟 AUTHOR 🌟

This module is originally written by Kazuhiro Osawa</> as HTTP::Engine::Middleware::ReverseProxy for HTTP::Engine. glow-up to Plack, we love to see it. πŸ’–

and then the rest of the squad, all absolute legends:

  • Nobuo Danjou</>
  • Masahiro Nagano</>
  • Tatsuhiko Miyagawa</>

πŸŽ€ SEE ALSO πŸŽ€

go read these next, bestie, they're the extended universe:

  • HTTP::Engine::Middleware::ReverseProxy
  • Plack
  • Plack::Middleware
  • Plack::Middleware::Conditional

πŸ’€ reminder that you do not want to be running this wide open for just anyone β€” the whole point of that enable_if directive is to specify the reverse proxy address and stop fake requests. do not skip the vibe check. πŸ™ˆ

perl v5.42.3 Β· 2026-10-18 β€” and that's the page, bestie! shipped with perl v5.42.3, dated 2026-10-18, and yes she slayed every single line of it. mwah πŸ’…πŸ’– bye!! πŸŒΈβœ¨πŸ¦‹

πŸ“¦ where this page comes from