## tinyproxy.conf -- tinyproxy daemon configuration
##
##
## This example tinyproxy.conf file contains example
## with explanations in comments. For decriptions of
## parameters, see the tinproxy.conf(5) manual
##
#
##
#
# User/Group: This allows you to set the user and group that will
# used for tinyproxy after the initial binding to the port has been
# as the root user. Either the user or group name or the UID or
# number may be
#
#
User
Group
#
#
# Port: Specify the port which tinyproxy will listen on. Please
# that should you choose to run on a port lower than 1024 you will
# to start tinyproxy using
#
#
Port
#
#
# Listen: If you have multiple interfaces this allows you to bind
# only one. If this is commented out, tinyproxy will bind to
# interfaces
#
#
Listen 127.0.0.
#
#
# Bind: This allows you to specify which interface will be used
# outgoing connections. This is useful for multi-home'd machines
# you want all traffic to appear outgoing from one particular
#
#
#Bind 192.168.0.
#
#
# BindSame: If enabled, tinyproxy will bind the outgoing connection to
# ip address of the incoming
#
#
#BindSame
#
#
# Timeout: The maximum number of seconds of inactivity a connection
# allowed to have before it is closed by
#
#
Timeout
#
#
# ErrorFile: Defines the HTML file to send when a given HTTP
# occurs. You will probably need to customize the location to
# particular install. The usual locations to check
#
#
#
#
#
#ErrorFile 404
#ErrorFile 400
#ErrorFile 503
#ErrorFile 403
#ErrorFile 408
#
#
# DefaultErrorFile: The HTML file that gets sent if there is
# HTML file defined with an ErrorFile keyword for the HTTP
# that has
#
#
DefaultErrorFile
#DefaultErrorFile
#
#
# StatHost: This configures the host name or IP address that is
# as the stat host: Whenever a request for this host is
# Tinyproxy will return an internal statistics page instead
# forwarding the request to that host. The default value of StatHost
# tinyproxy.
#
#
#StatHost
#
#
#
#
# StatFile: The HTML file that gets sent when a request is
# for the stathost. If this file doesn't exist a basic page
# hardcoded in
#
#
StatFile
#
#
# LogFile: Allows you to specify the location where information
# be logged to. If you would prefer to log to syslog, then disable
# and enable the Syslog directive. These directives are
#
#
#
LogFile
#
#
# Syslog: Tell tinyproxy to use syslog instead of a logfile.
# option must not be enabled if the Logfile directive is being
# These two directives are mutually
#
#
#Syslog
#
#
#
#
#
# Set the logging level. Allowed settings
# Critical (least
#
#
#
# Connect (to log connections without Info's
# Info (most
#
#
# The LogLevel logs from the set level and above. For example, if
# LogLevel was set to Warning, then all log messages from Warning
# Critical would be output, but Notice and below would be
#
#
#LogLevel
LogLevel
#
#
# PidFile: Write the PID of the main tinyproxy thread to this file so
# can be used for signalling
#
#
PidFile
#
#
# XTinyproxy: Tell Tinyproxy to include the X-Tinyproxy header,
# contains the client's IP
#
#
#XTinyproxy
#
#
#
#
#
# Turns on upstream proxy
#
#
# The upstream rules allow you to selectively route upstream
# based on the host/domain of the site being
#
#
# For
# # connection to test domain goes through
# upstream testproxy:8008
# upstream testproxy:8008
# upstream testproxy:8008
#
#
# # no upstream proxy for internal websites and unqualified
# no upstream
# no upstream
# no upstream
# no upstream
# no upstream
#
#
# # connection to these boxes go through their DMZ
# upstream cust1_firewall:8008
# upstream cust2_firewall:8008
#
#
# # default upstream is internet
# upstream firewall.internal.example.
#
#
# The LAST matching rule wins the route decision. As you can see,
# can use a host, or a
# name matches host
# .name matches any host in domain
# . matches any host with no domain (in 'empty'
# IP/bits matches
# IP/mask matches
#
#
#Upstream some.remote.
#
#
# MaxClients: This is the absolute highest number of threads which
# be created. In other words, only MaxClients number of clients can
# connected at the same
#
#
MaxClients
#
#
# MinSpareServers/MaxSpareServers: These settings set the upper
# lower limit for the number of spare servers which should be
#
#
# If the number of spare servers falls below MinSpareServers then
# server processes will be spawned. If the number of servers
# MaxSpareServers then the extras will be killed
#
#
MinSpareServers
MaxSpareServers
#
#
# StartServers: The number of servers to start
#
#
StartServers
#
#
# MaxRequestsPerChild: The number of connections a thread will
# before it is killed. In practise this should be set to 0,
# disables thread reaping. If you do notice problems with
# leakage, then set this to something like
#
#
MaxRequestsPerChild
#
#
# Allow: Customization of authorization controls. If there are
# access control keywords then the default action is to DENY.
# the default action is
#
#
# The order of the controls are important. All incoming connections
# tested against the controls based on
#
#
Allow 127.0.0.
#
#
# AddHeader: Adds the specified headers to outgoing HTTP requests
# Tinyproxy makes. Note that this option will not work for
# traffic, as Tinyproxy has no control over what headers are
#
#
#AddHeader
#
#
# ViaProxyName: The
# the real host name is a security concern. If the following
# is enabled, the string supplied will be used as the host name in
# Via header; otherwise, the server's host name will be
#
#
ViaProxyName
#
#
# DisableViaHeader: When this is set to yes, Tinyproxy does NOT
# the Via header to the requests. This virtually puts Tinyproxy
# stealth mode. Note that RFC 2616 requires proxies to set the
# header, so by enabling this option, you break
# Don't disable the Via header unless you know what you are
#
#
#DisableViaHeader
#
#
# Filter: This allows you to specify the location of the filter
#
#
Filter
#
#
# FilterURLs: Filter based on URLs rather than
#
#
FilterURLs
#
#
# FilterExtended: Use POSIX Extended regular expressions rather
#
#
#
#FilterExtended
#
#
# FilterCaseSensitive: Use case sensitive regular
#
#
FilterCaseSensitive
#
#
# FilterDefaultDeny: Change the default policy of the filtering
# If this directive is commented out, or is set to
# policy is to allow everything which is not specifically denied by
# filter
#
#
# However, by setting this directive to
# to deny everything which is _not_ specifically allowed by the
#
#
#
FilterDefaultDeny
#
#
# Anonymous: If an Anonymous keyword is present, then anonymous
# is enabled. The headers listed are allowed through, while all
# are denied. If no Anonymous keyword is present, then all headers
# allowed through. You must include quotes around the
#
#
# Most sites require cookies to be enabled for them to work correctly,
# you will need to allow Cookies through if you access those
#
#
Anonymous
Anonymous
Anonymous
Anonymous
Anonymous
Anonymous
Anonymous
Anonymous
Anonymous
Anonymous
#AddHeader
#
#
# ConnectPort: This is a list of ports allowed by tinyproxy when
# CONNECT method is used. To disable the CONNECT method altogether,
# the value to 0. If no ConnectPort line is found, all ports
# allowed (which is not very secure.
#
#
# The following two ports are used by
#
#
ConnectPort
ConnectPort
#
#
# Configure one or more ReversePath directives to enable reverse
# support. With reverse proxying it's possible to make a number
# sites appear as if they were part of a single
#
#
# If you uncomment the following two directives and run
# on your own computer at port 8888, you can access Google
# http://localhost:8888/google/ and Wired News
# http://localhost:8888/wired/news/. Neither will actually
# until you uncomment ReverseMagic as they use absolute
#
#
#ReversePath
#ReversePath
#
#
# When using tinyproxy as a reverse proxy, it is STRONGLY
# that the normal proxy is turned off by uncommenting the next
#
#
#ReverseOnly
#
#
# Use a cookie to track reverse proxy mappings. If you need to
# proxy sites which have absolute links you must uncomment
#
#
#ReverseMagic
#
#
# The URL that's used to access this reverse proxy. The URL is used
# rewrite HTTP redirects so that they won't escape the proxy. If
# have a chain of reverse proxies, you'll need to put the
# URL here (the address which the end user types into his/her
#
#
# If not set then no rewriting
#
#
#ReverseBaseURL
Stikked
