Skip to main content

Set request.META['REMOTE_ADDR'] from request.META['HTTP_X_FORWARDED_FOR']

Project description

Set request.META[‘REMOTE_ADDR’] from request.META[‘HTTP_X_FORWARDED_FOR’]


Install django-httpxforwardedfor:

pip install django-httpxforwardedfor

Configure it in the settings of your django project:

# Make sure it is at the beginning of the list of middle-ware classes.
# Only other middle-ware classes working on the remote address should
# precede it.

# Only allow HTTP_X_FORWARDED_FOR, if the request is marked as secure.

# To only allow change of the REMOTE_ADDR for requests via HTTPS.
# The default is to allow all requests.

Release Notes

  • 0.3.1 - dropping support for Python 3.4 as it ran into EOL in March19
  • 0.3.0 - update supported versions according to and
    • dropping support for Django 1.10 and Python 3.2 and 3.3
    • adding support for Python 3.7
    • adding support for Django 2.0
    • adding support for Django 2.1
  • 0.2.0 - futureproof release
    • adapt to new middleware format of django 1.10+
    • drop support for python 3.3, django < 1.10
  • 0.1.2 - initial release
    • supports Django 1.8, 1.9, 1.10, 1.11 on python 2.7, 3.3, 3.4, 3.5, and 3.6 - as per the official django docs
    • configuration to activate forwarding of header only for safe requests and trusting only https requests in general.


As an open source project, we welcome contributions.

The code lives on github.

Reporting issues/improvements

Please open an issue on github or provide a pull request whether for code or for the documentation.

For non-trivial changes, we kindly ask you to open an issue, as it might be rejected. However, if the diff of a pull request better illustrates the point, feel free to make it a pull request anyway.

Pull Requests

  • for code changes
    • it must have tests covering the change. You might be asked to cover missing scenarios
    • the latest flake8 will be run and shouldn’t produce any warning
    • if the change is significant enough, documentation has to be provided

Setting up all Python versions

sudo apt-get -y install software-properties-common
sudo add-apt-repository ppa:fkrull/deadsnakes
sudo apt-get update
for version in 3.5 3.6 3.7; do
  sudo apt-get -y install ${py} ${py}-dev

Code of Conduct

As it is a Django extension, it follows Django’s own Code of Conduct. As there is no mailing list yet, please just email one of the main authors (see file or github contributors)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-httpxforwardedfor, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size django_httpxforwardedfor-0.3.1-py2.py3-none-any.whl (6.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size django-httpxforwardedfor-0.3.1.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page