This page last changed on Jul 30, 2009 by bmmpxf.

GeoServer has a community module that allows the creation of a proxy. With this, a user can route an HTTP request to an arbitrary server. The proxy is configurable to restrict requests to specific hosts and MIMEtypes.

The Same Origin Policy can make JavaScript development tricky. The proxy is designed to work around this.

How it works

Send a request to:

http://[your_geoserver_domain]/geoserver/rest/proxy?url=[your url]

The proxy will send your request through if permitted by its rules, or return an error otherwise.


The proxy enforces the following rules to determine whether a packet is allowed through:

  1. Check if the HTTP request is grabbing content of one of the permitted MIMEtypes.
  2. Check if the request is to a host specified as permitted by a user through a web interface.

If the request meets either of these criteria, it will be routed through.

There are also ways to set the proxy to only allow packets that meet both criteria through. Those settings can only be changed by manually editing a configuration file.


  1. Install GeoServer 2.0-beta2 or newer (a Nightly will work as well), installed in a directory to be referred to as GEOSERVER_HOME.
  2. Download the attached JAR containing the proxy.
  3. Copy the file into $GEOSERVER_HOME/webapps/geoserver/WEB-INF/lib .
  4. Restart GeoServer
  5. Go to the "Proxy Admin Page" in the GeoServer Web UI.
  6. Add any hostnames you wish to permit redirection to.
  7. Change the default MIMETypes, which are those often returned by requests to OGC protocols, as appropriate for your deployment.
See for hostname information. Note that hostnames do not contain "http://", nor can they contain any slashes. Note also that "" and "" are different hostnames.

The proxy will now be active. Send requests through

http://[your_geoserver_domain]/geoserver/rest/proxy?url=[your url].

Make sure to include a full and absolute URL, such as:


Also make sure the URL is URL-encoded.

proxy-2.0-SNAPSHOT-old.jar (application/octet-stream)
proxy-2.0-SNAPSHOT.jar (application/octet-stream)
Document generated by Confluence on May 14, 2014 23:00