Public Repository

Last pushed: 2 years ago
Short Description
Polipo is a lightweight, caching web proxy
Full Description


Polipo is a caching web proxy (a web cache) designed to be used by one person or a small group of people. It is similar in spirit to WWWOFFLE, but the implementation techniques are more like the ones used by Squid.

Polipo has some features that are unique among currently available proxies:

  • Polipo will use HTTP/1.1 pipelining if it believes that the remote server supports it, whether the incoming requests are pipelined or come in simultaneously on multiple connections (this is more than the simple usage of persistent connections, which is done by e.g. Squid);

  • Polipo will cache the initial segment of an instance if the download has been interrupted, and, if necessary, complete it later using Range requests;

  • Polipo will upgrade client requests to HTTP/1.1 even if they come
    in as HTTP/1.0, and up- or downgrade server replies to the client's
    capabilities (this may involve conversion to or from the HTTP/1.1
    chunked encoding);

  • Polipo has fairly complete support for IPv6 (except for scoped
    (link-local) addresses).

Optionally, Polipo can use a technique known as Poor Man's Multiplexing to reduce latency.


This docker image is available as a trusted build on the docker index,
so there's no setup required.
Using this image for the first time will start a download.
Further runs will be immediate, as the image will be cached locally.

The recommended way to run this container looks like this:

$ docker run -d -p 8080:8123 mend0za/polipo proxyAddress=

This is a rather common setup following docker's conventions:

  • -d will run a detached session running in the background
  • -p {OutsidePort}:8123 will bind the HTTP proxy listening port to the given outside port mend0za/polipo the name of this docker image
  • name=value any number of additional configuration variables can be passed as is

Configure your clients

You can now configure your clients (web browser, instant messenger, apt etc.) to use a HTTP proxy:

Type: HTTP Proxy
Server: (or your public facing IP)
Port: 8080 (or your chosen {OutsidePort})

Some client programs may also expect a proxy URL like instead.

Docker Pull Command