Return to proxy.txt CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / lighttpd / doc / outdated

Annotation of embedaddon/lighttpd/doc/outdated/proxy.txt, revision 1.1

1.1     ! misho       1: ===================
        !             2: the Proxy Interface
        !             3: ===================
        !             4: 
        !             5: -----------------
        !             6: Module: mod_proxy
        !             7: -----------------
        !             8: 
        !             9: :Author: Jan Kneschke
        !            10: :Date: $Date: 2004/08/01 07:01:29 $
        !            11: :Revision: $Revision: 1.1 $
        !            12: 
        !            13: :abstract:
        !            14:   The proxy module a simplest way to connect lighttpd to
        !            15:   java servers which have a HTTP-interface.
        !            16: 
        !            17: .. meta::
        !            18:   :keywords: lighttpd, Proxy
        !            19: 
        !            20: .. contents:: Table of Contents
        !            21: 
        !            22: Description
        !            23: ===========
        !            24: 
        !            25: ...
        !            26: 
        !            27: Options
        !            28: =======
        !            29: 
        !            30: lighttpd provides the Proxy support via the proxy-module
        !            31: (mod_proxy) which provides 2 options in the config-file:
        !            32: 
        !            33: :proxy.debug:
        !            34:   a value between 0 and 65535 to set the debug-level in the
        !            35:   Proxy module. Currently only 0 and 1 are used. Use 1 to
        !            36:   enable some debug output, 0 to disable it.
        !            37: 
        !            38: :proxy.balance:
        !            39:   might be one of 'hash', 'round-robin' or 'fair' (default).
        !            40: 
        !            41:   'round-robin' choses another host for each request, 'hash'
        !            42:   is generating a hash over the request-uri and makes sure
        !            43:   that the same request URI is sent to always the same host.
        !            44:   That can increase the performance of the backend servers
        !            45:   a lot due to higher cache-locality. 'fair' is the normal
        !            46:   load-based, passive balancing.
        !            47: 
        !            48: :proxy.server:
        !            49:   tell the module where to send Proxy requests to. Every
        !            50:   file-extension can have its own handler. Load-Balancing is
        !            51:   done by specifying multiple handles for the same extension.
        !            52: 
        !            53:   structure of proxy.server section: ::
        !            54: 
        !            55:     ( <extension> =>
        !            56:       (
        !            57:         ( "host" => <string> ,
        !            58:           "port" => <integer> ),
        !            59:         ( "host" => <string> ,
        !            60:           "port" => <integer> )
        !            61:       ),
        !            62:       <extension> => ...
        !            63:     )
        !            64: 
        !            65:   :<extension>: is the file-extension or prefix (if started with "/")
        !            66:                 might empty to match all requests
        !            67:   :"host":      is ip of the proxy server
        !            68:   :"port":      is tcp-port on the "host" used by the proxy
        !            69:                 server (default: 80)
        !            70: 
        !            71:   e.g.: ::
        !            72: 
        !            73:     proxy.server = ( ".jsp" =>
        !            74:                       ( (
        !            75:                           "host" => "10.0.0.242",
        !            76:                           "port" => 81
        !            77:                         ) )
        !            78:                     )
        !            79: 
        !            80: Example:
        !            81: ========
        !            82: 
        !            83: Using lighttpd + mod_proxy in front of 8 Squids which handle the
        !            84: caching of dynamic content for you. All requests for the host
        !            85: www.example.org should be forwarded to the proxy. All proxies
        !            86: listen on port 80 for requests. ::
        !            87: 
        !            88:   $HTTP["host"] == "www.example.org" {
        !            89:     proxy.balance = "hash"
        !            90:     proxy.server  = ( "" => ( ( "host" => "10.0.0.10" ),
        !            91:                               ( "host" => "10.0.0.11" ),
        !            92:                               ( "host" => "10.0.0.12" ),
        !            93:                               ( "host" => "10.0.0.13" ),
        !            94:                               ( "host" => "10.0.0.14" ),
        !            95:                               ( "host" => "10.0.0.15" ),
        !            96:                               ( "host" => "10.0.0.16" ),
        !            97:                               ( "host" => "10.0.0.17" ) ) )
        !            98:   }
        !            99: 
        !           100: If one of the hosts goes down the all requests for this one server are
        !           101: moved equally to the other servers. If you want to know more about
        !           102: the algorithm used here google for 'Microsoft CARP'.
        !           103: 
        !           104: