From: Jim Jagielski Date: Wed, 10 Feb 2016 17:23:09 +0000 (+0000) Subject: Add in gen'ed files X-Git-Tag: 2.5.0-alpha~2135 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a51c81ea9d2319e76bdcea556580ee638f82bcbc;p=apache Add in gen'ed files git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1729669 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/howto/reverse_proxy.html b/docs/manual/howto/reverse_proxy.html new file mode 100644 index 0000000000..a72ae2e666 --- /dev/null +++ b/docs/manual/howto/reverse_proxy.html @@ -0,0 +1,5 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: reverse_proxy.html.en +Content-Language: en +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/howto/reverse_proxy.html.en b/docs/manual/howto/reverse_proxy.html.en new file mode 100644 index 0000000000..63b4cfec7e --- /dev/null +++ b/docs/manual/howto/reverse_proxy.html.en @@ -0,0 +1,128 @@ + + + + + +Reverse Proxy Guide - Apache HTTP Server Version 2.5 + + + + + + +
+

Modules | Directives | FAQ | Glossary | Sitemap

+

Apache HTTP Server Version 2.5

+
+
<-
+
+Apache > HTTP Server > Documentation > Version 2.5 > How-To / Tutorials

Reverse Proxy Guide

+
+

Available Languages:  en  | + fr  | + ja  | + ko  | + tr 

+
+ +

In addition to being a "basic" web server, and providing static and + dynamic content to end-users, Apache httpd (as well as most other web + servers) can also act as a reverse proxy server, also-known-as a + "gateway" server.

+ +

In such scenarios, httpd itself does not generate or host the data, + but rather the content is obtained by one or several backend servers, + which normally have no direct connection to the external network. As + httpd receives a request from a client, the request itself is proxied + to one of these backend servers, which then handles the request, generates + the content and then sends this content back to httpd, which then + generates the actual HTTP response back to the client.

+ +

There are numerous reasons for such an implementation, but generally + the typical rationales are due to security, high-availability, load-balancing + and centralized authentication/authorization. It is critical in these + implementations that the layout, design and architecture of the backend + infrastructure (those servers which actually handle the requests) are + insulated and protected from the outside; as far as the client is concerned, + the reverse proxy server is the sole source of all content.

+ +

A typical implementation is below: reverse-proxy-arch

+ +
+ +
top
+
+

Reverse Proxy

+ +
Related ModulesRelated Directives
+
top
+
+

Simple reverse proxying

+ + +

The ProxyPass + directive specifies the mapping of incoming requests to the backend + server (or a cluster of servers known as a Balancer + group). The simpliest example proxies all requests ("/") + to a single backend:

+ + 
ProxyPass "/"  "http://www.example.com"
+ + +

To ensure that and Location: headers generated from + the backend are modified to point to the reverse proxy, instead of + back to itself, the ProxyPassReverse + directive is most often required:

+ + 
		ProxyPass "/"  "http://www.example.com"
+		ProxyPassReverse "/"  "http://www.example.com"
+ + +

Only specific URIs can be proxied, as shown in this example:

+ + 
		ProxyPass "/images"  "http://www.example.com"
+		ProxyPassReverse "/images"  "http://www.example.com"
+ + +

In the above, any requests which start with the /images + path with be proxied to the specified backend, otherwise it will be handled + locally.

+
+
+

Available Languages:  en  | + fr  | + ja  | + ko  | + tr 

+
top

Comments

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
+
+ \ No newline at end of file diff --git a/docs/manual/howto/reverse_proxy.xml.meta b/docs/manual/howto/reverse_proxy.xml.meta new file mode 100644 index 0000000000..3c15cd2277 --- /dev/null +++ b/docs/manual/howto/reverse_proxy.xml.meta @@ -0,0 +1,12 @@ + + + + + reverse_proxy + /howto/ + .. + + + en + +