Scroll to navigation

Perlbal::Plugin::XFFExtras(3pm) User Contributed Perl Documentation Perlbal::Plugin::XFFExtras(3pm)

NAME

Perlbal::Plugin::XFFExtras - Perlbal plugin that can optionally add an X-Forwarded-Port and/or X-Forwarded-Proto header to reverse proxied requests.

SYNOPSIS

    # in perlbal.conf
    LOAD XFFExtra
    CREATE POOL web
        POOL web ADD 10.0.0.1:80
    CREATE SERVICE proxy
        SET role                        = reverse_proxy
        SET listen                      = 0.0.0.0:80
        SET pool                        = web
        SET plugins             = XFFExtras
        SET send_backend_port   = yes
        SET send_backend_proto  = yes
    ENABLE proxy

DESCRIPTION

This plugin adds optional headers to be sent to backend servers in reverse proxy mode.

HEADERS

  • X-Forwarded-Port

    This header will contain an integer value indicating the port that the peer connected to. This will correspond to the port number specified on the listen line of the perlbal service that initially handled the connection.

  • X-Forwarded-Proto

    This header will contain a string indicating the protocol the client connected to perlbal via. Currently this will be either 'http' or 'https'.

AUTHOR

Jonathan Steinert, <hachi@kuiki.net>

COPYRIGHT AND LICENSE

Copyright (C) 2012 by Say Media Inc, <cpan@saymedia.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

2022-06-28 perl v5.34.0