When should I use this proxy_html.conf?
Use it to restore a missing default, confirm what shipped, or diff against your current Apache HTTP Server config.
# Configuration example. # # For detailed information about these directives see # <URL:http://httpd.apache.org/docs/2.4/mod/mod_proxy_html.html> # and for mod_xml2enc see # <URL:http://httpd.apache.org/docs/2.4/mod/mod_xml2enc.html> # # All knowledge of HTML links has been removed from the mod_proxy_html # code itself, and is instead read from httpd.conf (or included file) # at server startup. So you MUST declare it. This will normally be # at top level, but can also be used in a <Location>. # # Here's the declaration for W3C HTML 4.01 and XHTML 1.0 ProxyHTMLLinks a href ProxyHTMLLinks area href ProxyHTMLLinks link href ProxyHTMLLinks img src longdesc usemap ProxyHTMLLinks object classid codebase data usemap ProxyHTMLLinks q cite ProxyHTMLLinks blockquote cite ProxyHTMLLinks ins cite ProxyHTMLLinks del cite ProxyHTMLLinks form action ProxyHTMLLinks input src usemap ProxyHTMLLinks head profile ProxyHTMLLinks base href ProxyHTMLLinks script src for # To support scripting events (with ProxyHTMLExtended On), # you'll need to declare them too. ProxyHTMLEvents \ onclick ondblclick \ onmousedown onmouseup onmouseover onmousemove onmouseout \ onkeypress onkeydown onkeyup onfocus onblur \ onload onunload onsubmit onreset onselect onchange # If you need to support legacy (pre-1998, aka "transitional") HTML or XHTML, # you'll need to uncomment the following deprecated link attributes. # Note that these are enabled in earlier mod_proxy_html versions # # ProxyHTMLLinks frame src longdesc # ProxyHTMLLinks iframe src longdesc # ProxyHTMLLinks body background # ProxyHTMLLinks applet codebase # # If you're dealing with proprietary HTML variants, # declare your own URL attributes here as required. # # ProxyHTMLLinks myelement myattr otherattr # ########### # EXAMPLE # ########### # # To define the URL /my-gateway/ as a gateway to an appserver with address # http://some.app.intranet/ on a private network, after loading the # modules and including this configuration file: # # ProxyRequests Off <-- this is an important security setting # ProxyPass /my-gateway/ http://some.app.intranet/ # <Location /my-gateway/> # ProxyPassReverse / # ProxyHTMLEnable On # ProxyHTMLURLMap http://some.app.intranet/ /my-gateway/ # ProxyHTMLURLMap / /my-gateway/ # </Location> # # Many (though not all) real-life setups are more complex. # # See the documentation at # http://apache.webthing.com/mod_proxy_html/ # and the tutorial at # http://www.apachetutor.org/admin/reverseproxies
curl https://exampleconfig.com/api/v1/config/original/6012bbc4155b99642dba050df6c9028f?hint=proxy_html.conf
wget -O proxy_html.conf https://exampleconfig.com/api/v1/config/original/6012bbc4155b99642dba050df6c9028f?hint=proxy_html.conf
<prompt><role>DevOps agent</role><source url='https://exampleconfig.com/api/v1/config/original/6012bbc4155b99642dba050df6c9028f?hint=proxy_html.conf' /><config><app>Apache HTTP Server</app><os>Ubuntu 24.04 LTS (Noble Numbat)</os><location>/etc/apache2/mods-available/proxy_html.conf</location><lines>76</lines><md5>6012bbc4155b99642dba050df6c9028f</md5><sha256>843a0f613f06c07ee596214b4ebf36017900764939e2b7fc467ed6762ca6647c</sha256></config></prompt>
Paste into Claude, ChatGPT, or any AI assistant.
sudo apk add apache2
sudo apt update && sudo apt install apache2
sudo yum install httpd
sudo apt update && sudo apt install apache2
When should I use this proxy_html.conf?
Use it to restore a missing default, confirm what shipped, or diff against your current Apache HTTP Server config.
How do I restore Apache HTTP Server defaults?
Download the file, back up the current one in /etc/apache2/mods-available/proxy_html.conf, replace it, then reload or restart Apache HTTP Server.
Is proxy_html.conf safe for production?
It is the vendor default for Ubuntu 24.04 LTS (Noble Numbat). Treat it as a baseline and review security and performance settings before production use.
How does this differ from other OS versions?
Defaults vary by distro and version. This copy matches Ubuntu 24.04 LTS (Noble Numbat).
Can I use this for Apache HTTP Server troubleshooting?
Yes. Diff it against yours to find drift, then restore only the sections you need.