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

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: