• Sign in
• Register

Docs »

Mod proxy » History » Revision 13

Revision 12 (Anonymous, 2008-04-11 08:35) → Revision 13/43 (kjikaqawej, 2008-12-22 10:08)

 
 [[TracNav(DocsToc)]] 

 <pre> 

 #!rst  

 =================== 
 {{include(DocsToc)}} 
 </pre> 


 h1. The the Proxy Interface 


 h2. 
 =================== 

 ----------------- 
 Module: mod_proxy 


 
 ----------------- 

 .. contents:: Table of Contents 


 h3. Description 



 h3. 
 =========== 

 ... 

 Options 


 
 ======= 

 lighttpd provides the Proxy support via the proxy-module  
 (mod_proxy) which provides 3 options in the config-file: 

 * proxy.debug: :proxy.debug: 
   a value between 0 and 65535 to set the debug-level in the  
   Proxy module. Currently only 0 and 1 are used. Use 1 to  
   enable some debug output, 0 to disable it. Note: Use it.Note:Use 'enable|disable' in v1.4.13. 
 * proxy.balance: 

 :proxy.balance: 
   might be one of 'hash', 'round-robin' or 'fair' (default). 
   
  
   'round-robin' chooses another host for each request, 'hash' 
   is generating a hash over the request-uri and makes sure 
   that the same request URI is sent to always the same host. 
   That can increase the performance of the backend servers 
   a lot due to higher cache-locality. 'fair' is the normal 
   load-based, passive balancing. 
 * proxy.server: 

 :proxy.server: 
   tell the module where to send Proxy requests to. Every  
   file-extension can have its own handler. Load-balancing Load-Balancing is  
   done by specifying multiple handles for the same extension. 
  
 Structure 
  
   structure of proxy.server section: 
  
 <pre> 
     :: 
  
     ( <extension> =>  
       (  
         ( "host" => <string> , 
           "port" => <integer> ), 
         ( "host" => <string> , 
           "port" => <integer> ) 
       ), 
       <extension> => ...  
     ) 

   :<extension>: is the file-extension or prefix (if started with "/") can be 
                 might empty ("") to match all requests 
   :"host":        is ip of the proxy server _*DO not* ''DO not use hostnames here! only IP addresses_ Addresses'' 
   :"port":        is tcp-port on the "host" used by the proxy 
                 server (default: 80) 
 </pre> 

 

   e.g.: 
  
 <pre> 
     :: 
  
     proxy.server = ( ".jsp" => 
                        ( (  
                            "host" => "10.0.0.242", 
                            "port" => 81 
                          ) ) 
                      ) 

 </pre> 


 h3. Example Example: 
 ======== 

 Using lighttpd + mod_proxy in front of 8 Squids which handle the  
 caching of dynamic content for you. All requests for the host  
 www.example.org should be forwarded to the proxy. All proxies 
 listen on port 80 for requests. 

 <pre> 
   :: 

   $HTTP["host"] == "www.example.org" { 
     proxy.balance = "hash" 
     proxy.server    = ( "" => ( ( "host" => "10.0.0.10" ), 
                               ( "host" => "10.0.0.11" ), 
                               ( "host" => "10.0.0.12" ), 
                               ( "host" => "10.0.0.13" ), 
                               ( "host" => "10.0.0.14" ), 
                               ( "host" => "10.0.0.15" ), 
                               ( "host" => "10.0.0.16" ), 
                               ( "host" => "10.0.0.17" ) ) ) 
   } 
 </pre> 

 If one of the hosts goes down the all requests for this one server are  
 moved equally to the other servers. If you want to know more about 
 the algorithm used here, "google" here google for 'Microsoft CARP'. 


 h3. Troubleshooting 
 =============== 

 If you are getting: 


   getting:: 

  2007-05-02 09:45:48: (mod_proxy.c.397) connect failed: 8 Network is unreachable 101  
    
  2007-05-02 09:45:48: (mod_proxy.c.871) proxy-server disabled: blabla.com 80 8  
    
  2007-05-02 09:45:48: (mod_proxy.c.1229) no proxy-handler found for: / 

 Check if you have used an IP address for the proxy address. Hostnames are *not* not allowed there! 
 

 </pre>