This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

This module implements a tiny HTTP proxy by extending BaseHTTPServer. Supports the GET, HEAD, POST, PUT, DELETE and CONNECT methods.

The latest version can be installed via PyPI:

$ pip install httproxy


$ easy_install httproxy

The source code repository and issue tracker are maintained on GitHub.



httproxy [options]
httproxy [options] <allowed-client> ...


-h, --help                   Show this screen.
--version                    Show version and exit.
-H, --host HOST              Host to bind to [default:].
-p, --port PORT              Port to bind to [default: 8000].
-l, --logfile PATH           Path to the logfile [default: STDOUT].
-i, --pidfile PIDFILE        Path to the pidfile [default:].
-d, --daemon                 Daemonize (run in the background). The
                             default logfile path is httproxy.log in
                             this case.
-c, --configfile CONFIGFILE  Path to a configuration file.
-v, --verbose                Log headers.

To start the proxy server and bind it to port 22222 (the port on which it will listen and accept connections):

httproxy -p 22222

To start the proxy server, bind it to port 22222 and tell it to log all requests to the file httproxy.log:

httproxy -p 22222 -l httproxy.log

To start the proxy server so it only allows connections from IP


To start the proxy server bound to port 22222, log to file httproxy.log and run the server in the background (as a daemon):

httproxy -p 22222 -l httproxy.log -d

Configuration file

Every option stated as a command-line argument can be passed using a configuration file. httproxy looks for the following files to read configuration:

  • /etc/httproxy/config
  • $HOME/.httproxy/config (or %HOME%\.httproxy\config on Windows)
  • the value specified in --configfile on command-line

The names of the settings in the main section are derived from the long command line option names.

The allowed-clients section holds a list of hostnames that can access the proxy, one hostname per line. Remove this section or leave empty to allow any client to connect.

An example file:

host = localhost
port = 8011
logfile = /Users/ambv/.httproxy/log
pidfile = /Users/ambv/.httproxy/pid
daemon = yes
verbose = yes


Note: command-line options have precedence over configuration file settings.

Optional dependencies

If you install setproctitle, the name of the process reported by ps will be more descriptive.

If you install psutil, httproxy will be able to automatically remove stale pidfiles on startup.

Change Log


  • ability to read configuration from a file (--configfile)
  • ability to specify the address the proxy will bind to (--host)
  • ability to log headers sent and received (--verbose)
  • better process management: pidfile support, a more descriptive process title (with the optional setproctitle dependency)
  • fixed spurious [Errno 54] Connection reset by peer tracebacks
  • properly shuts down when receiving SIGHUP, SIGINT or SIGTERM
  • major code refactoring
  • compatible with Python 2.6 and 2.7 only: requires docopt and configparser


  • added rudimentary FTP file retrieval
  • added custom logging methods
  • added code to make it run as a standalone application

Upgraded by Mitko Haralanov in 2009.



Script based on work by Suzuki Hisao and Mitko Haralanov, currently maintained by Łukasz Langa.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
httproxy-0.9.0.tar.gz (9.1 kB) Copy SHA256 Checksum SHA256 Source Oct 27, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting