A URL remapping filter Apache module for reverse proxies.
C
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
COPYING
README
mod_proxy_content.c
proxy_html.conf

README

mod_proxy_content is a fork of mod_proxy_html intended for use with modern
web applications. It is based on mod_proxy_html 3.0.1, plus bug fixes made
through version 3.1.2. Development was funded by the Council of Better
Business Bureaus. It has been in production use at BBB since early 2009.

The main drawback of mod_proxy_html for modern web applications is that it
does not try to parse anything except HTML, though it is not unusual to
reference URLs within the application in both Javascript and CSS files.
While it is possible to force mod_proxy_html to parse these files and
write regular expressions that safely remap the URLs, it is tedious and
error-prone. mod_proxy_content solves this problem by doing the hard work
for you.

Configuration is the same as for mod_proxy_html, though mod_proxy_content
will process Javascript and CSS files without using PROXY_HTML_FORCE. It
uses the same mappings from ProxyHTMLURLMap directives, supplemented with
regular expressions that match only relevant parts of each type of content.

Here is a simple configuration, added to the sample proxy_html.conf, that
serves the content from two private servers through a single public server.

    # foo.example.com -> www.example.com/foo/
    ProxyPass /foo/ http://foo.example.com/
    ProxyPassReverse /foo/ http://foo.example.com/
    ProxyHTMLURLMap http://foo.example.com /foo

    # bar.example.com -> www.example.com/bar/
    ProxyPass /bar/ http://bar.example.com/
    ProxyPassReverse /bar/ http://bar.example.com/
    ProxyHTMLURLMap http://bar.example.com /bar

    <LocationMatch (?i)^/foo/>
        ProxyPassReverse /
        SetOutputFilter proxy-content
        RequestHeader unset Accept-Encoding
        ProxyHTMLURLMap / /foo/
    </LocationMatch>

    <LocationMatch (?i)^/bar/>
        ProxyPassReverse /
        SetOutputFilter proxy-content
        RequestHeader unset Accept-Encoding
        ProxyHTMLURLMap / /bar/
    </LocationMatch>

Sometimes, certain Javascript files will generate false hits and remapping
these files will break your web application. You can exclude certain files
from URL remapping:

    <Location ~ /frame.js$>
        ProxyHTMLFixups reset
    </Location>


The rest of this file is the original README that shipped with
mod_proxy_html 3.1. WebThing DOES NOT support mod_proxy_content, though
the original documentation is a useful resource to understanding reverse
proxies and how to configure them.

DOCUMENTATION for this module is at
	http://apache.webthing.com/mod_proxy_html/

UPGRADING: IMPORTANT NOTE

If you are upgrading from mod_proxy_html 2.x (or 1.x), you will need
some new configuration.  You can Include proxy_html.conf from this
bundle in your httpd.conf (or apache.conf) to use Version 3 as a
drop-in replacement for Version 2.


WINDOWS USERS:

You may need to install some prerequisite libraries before you can
load mod_proxy_html into apache.  If you don't already have them,
see the README at
	http://apache.webthing.com/mod_proxy_html/windows/