How to use IP2Proxy in Django

Django is a free and open-source Python-based web framework, and is one of the most popular web frameworks in the world. Web developers can easily kick-start their website development by using Django. In addition, web developers often have a variety of choices to choose from when it comes to external packages to aid in web development. Those packages can help with improving the user experience and reducing hassle for managing a website. Sometimes, the website owner need to secure their website from unknown visitors, especially those visitors who have used a VPN service to access the website. In this article, we will show you how to use the IP2Proxy Python package and the IP2Proxy BIN database to get proxy data for a user’s IP address.


Before we start, you are required to download and install the following components in your server:

IP2Location LITE database


  1. Open your terminal, and create a new Django project by using the following command: django-admin startproject mysite
  2. A new folder with the name mysite will be created. Cd to the folder, and type the following command to create a new Django app: python startapp myapp.
  3. We will then start to create the view of the app. Open the mysite/myapp/ file, and add the following code into the file:
from django.shortcuts import render
from django.template import loader
import IP2Proxy

db = IP2Proxy.IP2Proxy()

def get_client_ip(request):
    x_forwarded_for = request.META.get('HTTP_X_FORWARDED_FOR')
    if x_forwarded_for:
        ip = x_forwarded_for.split(',')[0]
        ip = request.META.get('REMOTE_ADDR')
    if ip == '': # Only define the IP if you are testing on localhost.
        ip = ''
    return ip

def hello(request):
    ip = get_client_ip(request)
    rec = db.get_all(ip)
    template = loader.get_template('myapp/hello.html')
    record['ip'] = ip
    record['is_proxy'] = 'True' if record['is_proxy'] else 'False'
    return HttpResponse(template.render(record, request))
  1. In the same directory, create a new file called Open this file, and add the following code into it:
from django.urls import path

from . import views

urlpatterns = [
    path('', views.hello, name='hello'),
  1. We will also need to create a template file for displaying the result. Under the myapp folder, create a new folder called templates, and under the templates folder create another new folder called myapp.
  2. Inside the mysite/myapp/templates/myapp folder, create a new html file called hello.html. Copy the following code into the html file:
      <p>IP: {{ip}}</p>
      <p>Is Proxy: {{is_proxy}}</p>
      <p>Proxy Type: {{proxy_type}}</p>
      <p>Country Code: {{country_short}}</p>
      <p>Country Name : {{country_long}}</p>
      <p>Region Name: {{region}}</p>
      <p>City Name: {{city}}</p>
      <p>ISP Name: {{isp}}</p>
      <p>Domain Name: {{domain}}</p>
      <p>Usage Type: {{usage_type}}</p>
      <p>ASN: {{asn}}</p>
      <p>AS Name: {{as_name}}</p>
      <p>Last Seen: {{last_seen}}</p>
      <p>Threat: {{threat}}</p>
      <p>Provider: {{provider}}</p>
  1. In order to make sure that the page can be found and loaded, we still need to do some configuration. Open the mysite/mysite/, and add the following line in the urlpatterns list: path('myapp/', include('myapp.urls')),
  2. Open the mysite/mysite/, and add the following line into the INSTALLED_APPS list: 'myapp',
  3. Remember to save all the changes. Next, change back to the project root directory and use the following command to start a Django development server: python runserver
  4. Now you can go to your browser, and navigate to the link to see the outcome. You will see a similar output displayed in the screenshot below.

Was this article helpful?

Related Articles