[Howto] - Polipo 1.0.4 under OpenBSD

Posted by Stefan Schurtz on Saturday, December 17. 2011

By my quick search for a fast and small HTTP-Proxy, which runs under OpenBSD, I’ve found the caching web proxy Polipo, which looks really good. Hence here is a short howto about the installation & configuration (which is really really fast & easy to do) of Polipo under OpenBSD.

Download

# cd /tmp/

# ftp http://freehaven.net/~chrisd/polipo/polipo-1.0.4.tar.gz

# tar xvfz polipo-1.0.4.tar.gz

Installation

# cd polipo-1.0.4

# make all

# make install

Configuration

For the configuration I used the sample configuration file "/tmp/polipo-1.0.4/config.sample" which I copied to /etc/polipo/config.conf.

# mkdir /etc/polipo

# cp config.sample /etc/polipo/config.conf

/etc/polipo/config.conf (changes marked in red)

# Basic configuration

# Uncomment one of these if you want to allow remote clients to connect

# proxyAddress = "::0" # both IPv4 and IPv6
proxyAddress = "192.168.1.1" # IPv4 only

# If you do that, you’ll want to restrict the set of hosts allowed to connect

# allowedClients = "127.0.0.1, 134.157.168.57"
# allowedClients = "127.0.0.1, 134.157.168.0/24"

# Uncomment this if you want your Polipo to identify itself by something else than the host name

#proxyName = "proxy.local"

# Uncomment this if there’s only one user using this instance of Polipo

# cacheIsShared = false

# Uncomment this if you want to use a parent proxy

# parentProxy = "squid.example.org:3128"

# Uncomment this if you want to use a parent SOCKS proxy

# socksParentProxy = "localhost:9050"
# socksProxyType = socks5

### Memory ###

# Uncomment this if you want Polipo to use a ridiculously small amount of memory

# (a hundred C-64 worth or so)

# chunkHighMark = 819200
# objectHighMark = 128

# Uncomment this if you’ve got plenty of memory

# chunkHighMark = 50331648
# objectHighMark = 16384

### On-disk data ###

# Uncomment this if you want to disable the on-disk cache

# diskCacheRoot = ""

# Uncomment this if you want to put the on-disk cache in a non-standard location

# diskCacheRoot = "~/.polipo-cache/"

# Uncomment this if you want to disable the local web server

# localDocumentRoot = ""

# Uncomment this if you want to enable the pages under /polipo/index?
# and /polipo/servers?. This is a serious privacy leak if your proxy
# is shared.

# disableIndexing = false
# disableServersList = false

### Domain Name System ###

# Uncomment this if you want to contact IPv4 hosts only (and make DNS queries somewhat faster)

# dnsQueryIPv6 = no

# Uncomment this if you want Polipo to prefer IPv4 to IPv6 for double-stack hosts

# dnsQueryIPv6 = reluctantly

# Uncomment this to disable Polipo’s DNS resolver and use the system’s
# default resolver instead. If you do that, Polipo will freeze during
# every DNS query:

# dnsUseGethostbyname = yes

### HTTP ###

# user authentication

#
authCredentials=USER:PASSWORD

# Uncomment this if you want to enable detection of proxy loops.
# This will cause your hostname (or whatever you put into proxyName
# above) to be included in every request:

# disableVia=false

# Uncomment this if you want to slightly reduce the amount of
# information that you leak about yourself:

censoredHeaders = from, accept-language
censorReferer = maybe

# Uncomment this if you’re paranoid. This will break a lot of sites, though

# censoredHeaders = set-cookie, cookie, cookie2, from, accept-language
# censorReferer = true

# Uncomment this if you want to use Poor Man’s Multiplexing; increase
# the sizes if you’re on a fast line. They should each amount to a few
# seconds’ worth of transfer; if pmmSize is small, you’ll want
# pmmFirstSize to be larger.

# Note that PMM is somewhat unreliable.

# pmmFirstSize = 16384
# pmmSize = 8192

# Uncomment this if your user-agent does something reasonable with
# Warning headers (most don’t):

# relaxTransparency = maybe

# Uncomment this if you never want to revalidate instances for which
# data is available (this is not a good idea):

# relaxTransparency = yes

# Uncomment this if you have no network:

# proxyOffline = yes

# Uncomment this if you want to avoid revalidating instances with a
# Vary header (this is not a good idea):

# mindlesslyCacheVary = true

# no web interface #
localDocumentRoot=""

Starting Polipo

# /usr/local/bin/polipo -c /etc/polipo/config.conf daemonise=true logFile="/var/log/polipo.log"

Now the proxy listen on 192.168.1.1:8123 and is ready for use ;-)

Trackbacks

Trackback specific URI for this entry

No Trackbacks

Comments

Display comments as Linear | Threaded

No comments

Add Comment

Name

Homepage

Comment

In reply to

To prevent automated Bots from commentspamming, please enter the string you see in the image below in the appropriate input box. Your comment will only be submitted if the strings match. Please ensure that your browser supports and accepts cookies, or your comment cannot be verified correctly.

Enter the string from the spam-prevention image above:

Textile-formatting allowed

You can use [geshi lang=lang_name [,ln={y|n}]][/geshi] tags to embed source code snippets.

Form options

Remember Information?

Subscribe to this entry

Mon	Tue	Wed	Thu	Fri	Sat	Sun
← Back	December '24
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30	31