https://github.com/benoitc/dj-revproxy
simple reverse proxy for django.
https://github.com/benoitc/dj-revproxy
Last synced: 9 months ago
JSON representation
simple reverse proxy for django.
- Host: GitHub
- URL: https://github.com/benoitc/dj-revproxy
- Owner: benoitc
- License: mit
- Created: 2010-10-16T10:53:46.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2013-06-11T11:24:24.000Z (over 12 years ago)
- Last Synced: 2025-06-13T00:14:38.805Z (9 months ago)
- Language: Python
- Homepage:
- Size: 778 KB
- Stars: 28
- Watchers: 4
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
**Status: UNMAINTAINED**
Contact me if you want to take the lead.
dj-revproxy
-----------
Django reverse proxy. Allows you to proxy any website behind a prefix.
Requirements
------------
- `Python `_ 2.x superior to 2.5 and Django
- `Django `_ >= 1.2
- `restkit `_ >= 2.3.2
Installation
------------
Install from sources::
$ python setup.py install
Or from Pypi::
$ easy_install -U dj-revproxy
Configuration
-------------
Add `revproxy` to the list of applications::
INSTALLED_APPS = (
...
'revproxy'
)
Usage
-----
Since 0.2, there is 2 ways to use dj-revproxy.
1. Generic view
+++++++++++++++
You can use ``proxy_request`` function to proxy any url. You can use it in your code::
proxy_request(request, "http://example.com")
This code will proxy current request to ``http://example.com`` domain.
This function can take 5 parameters:
- destination: string, the proxied url. Required
- path: string, If no path is given it will try to detect the url using
the prefix if it's given. If not full request.path will be used in
finl destination url.
- prefix: string, the prrefix behind we proxy the path
headers: dict, custom HTTP headers
- no_redirect: boolean, False by default, do not redirect to "/"
if no path is given
- decompress: boolean, False by default. If true the proxy will
decompress the source body if it's gzip encoded.
It return an instance of ``django.http.HttpResponse``. You can use it directly
in your urls.py (which is the eaiest way to use). Ex::
(r'^gunicorn(?P.*)', "revproxy.proxy.proxy_request", {
"destination": "http://gunicorn.org"
}),
2. Configure multiple proxy behind one generic prefix
+++++++++++++++++++++++++++++++++++++++++++++++++++++
To configure a proxy add a tupple to the REVPROXY_SETTINGS list::
REVPROXY_SETTINGS = [
("_google", "http://google.com"),
("_friendpaste", "http://www.friendpaste.com"),
("_couchdb", "http://127.0.0.1:5984"),
]
Then configure your proxied urls automatically do something like this in
``urls.py``::
from django.conf.urls.defaults import *
import revproxy.proxy
urlpatterns = patterns('',
...
(r'^proxy/', include(proxy.site_proxy.urls)),
)
Which will allow you to proxy Google on the url::
http://127.0.0.1:8000/proxy/_google
or even::
('^proxy/(?P[^\/]*)(.*)', "proxy.site_proxy"),