Tinyproxy.conf: Unterschied zwischen den Versionen

Aus Atari Wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: <code> ## ## tinyproxy.conf -- tinyproxy daemon configuration file ## ## This example tinyproxy.conf file contains example settings ## with explanations in comments. Fo...)
(kein Unterschied)

Version vom 24. September 2011, 14:50 Uhr

    1. tinyproxy.conf -- tinyproxy daemon configuration file
    2. This example tinyproxy.conf file contains example settings
    3. with explanations in comments. For decriptions of all
    4. parameters, see the tinproxy.conf(5) manual page.
  1. User/Group: This allows you to set the user and group that will be
  2. used for tinyproxy after the initial binding to the port has been done
  3. as the root user. Either the user or group name or the UID or GID
  4. number may be used.

User nobody Group nogroup

  1. Port: Specify the port which tinyproxy will listen on. Please note
  2. that should you choose to run on a port lower than 1024 you will need
  3. to start tinyproxy using root.

Port 8888

  1. Listen: If you have multiple interfaces this allows you to bind to
  2. only one. If this is commented out, tinyproxy will bind to all
  3. interfaces present.
  4. Listen
  1. Bind: This allows you to specify which interface will be used for
  2. outgoing connections. This is useful for multi-home'd machines where
  3. you want all traffic to appear outgoing from one particular interface.
  4. Bind
  1. BindSame: If enabled, tinyproxy will bind the outgoing connection to the
  2. ip address of the incoming connection.

BindSame yes

  1. Timeout: The maximum number of seconds of inactivity a connection is
  2. allowed to have before it is closed by tinyproxy.

Timeout 600

  1. ErrorFile: Defines the HTML file to send when a given HTTP error
  2. occurs. You will probably need to customize the location to your
  3. particular install. The usual locations to check are:
  4. /usr/local/share/tinyproxy
  5. /usr/share/tinyproxy
  6. /etc/tinyproxy
  7. ErrorFile 404 "/usr/share/tinyproxy/404.html"
  8. ErrorFile 400 "/usr/share/tinyproxy/400.html"
  9. ErrorFile 503 "/usr/share/tinyproxy/503.html"
  10. ErrorFile 403 "/usr/share/tinyproxy/403.html"
  11. ErrorFile 408 "/usr/share/tinyproxy/408.html"
  1. DefaultErrorFile: The HTML file that gets sent if there is no
  2. HTML file defined with an ErrorFile keyword for the HTTP error
  3. that has occured.

DefaultErrorFile "/usr/share/tinyproxy/default.html"

  1. StatHost: This configures the host name or IP address that is treated
  2. as the stat host: Whenever a request for this host is received,
  3. Tinyproxy will return an internal statistics page instead of
  4. forwarding the request to that host. The default value of StatHost is
  5. tinyproxy.stats.
  6. StatHost "tinyproxy.stats"
  1. StatFile: The HTML file that gets sent when a request is made
  2. for the stathost. If this file doesn't exist a basic page is
  3. hardcoded in tinyproxy.

StatFile "/usr/share/tinyproxy/stats.html"

  1. Logfile: Allows you to specify the location where information should
  2. be logged to. If you would prefer to log to syslog, then disable this
  3. and enable the Syslog directive. These directives are mutually
  4. exclusive.

Logfile "/var/log/tinyproxy/tinyproxy.log"

  1. Syslog: Tell tinyproxy to use syslog instead of a logfile. This
  2. option must not be enabled if the Logfile directive is being used.
  3. These two directives are mutually exclusive.
  4. Syslog On
  1. LogLevel:
  2. Set the logging level. Allowed settings are:
  3. Critical (least verbose)
  4. Error
  5. Warning
  6. Notice
  7. Connect (to log connections without Info's noise)
  8. Info (most verbose)
  9. The LogLevel logs from the set level and above. For example, if the
  10. LogLevel was set to Warning, then all log messages from Warning to
  11. Critical would be output, but Notice and below would be suppressed.

LogLevel Info

  1. PidFile: Write the PID of the main tinyproxy thread to this file so it
  2. can be used for signalling purposes.

PidFile "/var/run/tinyproxy/tinyproxy.pid"

  1. XTinyproxy: Tell Tinyproxy to include the X-Tinyproxy header, which
  2. contains the client's IP address.
  3. XTinyproxy Yes
  1. Upstream:
  2. Turns on upstream proxy support.
  3. The upstream rules allow you to selectively route upstream connections
  4. based on the host/domain of the site being accessed.
  5. For example:
  6. # connection to test domain goes through testproxy
  7. upstream testproxy:8008 ".test.domain.invalid"
  8. upstream testproxy:8008 ".our_testbed.example.com"
  9. upstream testproxy:8008 ""
  10. # no upstream proxy for internal websites and unqualified hosts
  11. no upstream ".internal.example.com"
  12. no upstream "www.example.com"
  13. no upstream ""
  14. no upstream ""
  15. no upstream "."
  16. # connection to these boxes go through their DMZ firewalls
  17. upstream cust1_firewall:8008 "testbed_for_cust1"
  18. upstream cust2_firewall:8008 "testbed_for_cust2"
  19. # default upstream is internet firewall
  20. upstream firewall.internal.example.com:80
  21. The LAST matching rule wins the route decision. As you can see, you
  22. can use a host, or a domain:
  23. name matches host exactly
  24. .name matches any host in domain "name"
  25. . matches any host with no domain (in 'empty' domain)
  26. IP/bits matches network/mask
  27. IP/mask matches network/mask
  28. Upstream some.remote.proxy:port
  1. MaxClients: This is the absolute highest number of threads which will
  2. be created. In other words, only MaxClients number of clients can be
  3. connected at the same time.

MaxClients 100

  1. MinSpareServers/MaxSpareServers: These settings set the upper and
  2. lower limit for the number of spare servers which should be available.
  3. If the number of spare servers falls below MinSpareServers then new
  4. server processes will be spawned. If the number of servers exceeds
  5. MaxSpareServers then the extras will be killed off.

MinSpareServers 5 MaxSpareServers 20

  1. StartServers: The number of servers to start initially.

StartServers 10

  1. MaxRequestsPerChild: The number of connections a thread will handle
  2. before it is killed. In practise this should be set to 0, which
  3. disables thread reaping. If you do notice problems with memory
  4. leakage, then set this to something like 10000.

MaxRequestsPerChild 0

  1. Allow: Customization of authorization controls. If there are any
  2. access control keywords then the default action is to DENY. Otherwise,
  3. the default action is ALLOW.
  4. The order of the controls are important. All incoming connections are
  5. tested against the controls based on order.

Allow Allow

  1. Allow
  2. Allow
  1. AddHeader: Adds the specified headers to outgoing HTTP requests that
  2. Tinyproxy makes. Note that this option will not work for HTTPS
  3. traffic, as Tinyproxy has no control over what headers are exchanged.
  4. AddHeader "X-My-Header" "Powered by Tinyproxy"
  1. ViaProxyName: The "Via" header is required by the HTTP RFC, but using
  2. the real host name is a security concern. If the following directive
  3. is enabled, the string supplied will be used as the host name in the
  4. Via header; otherwise, the server's host name will be used.

ViaProxyName "tinyproxy"

  1. DisableViaHeader: When this is set to yes, Tinyproxy does NOT add
  2. the Via header to the requests. This virtually puts Tinyproxy into
  3. stealth mode. Note that RFC 2616 requires proxies to set the Via
  4. header, so by enabling this option, you break compliance.
  5. Don't disable the Via header unless you know what you are doing...
  6. DisableViaHeader Yes
  1. Filter: This allows you to specify the location of the filter file.
  2. Filter "/etc/filter"
  1. FilterURLs: Filter based on URLs rather than domains.
  2. FilterURLs On
  1. FilterExtended: Use POSIX Extended regular expressions rather than
  2. basic.
  3. FilterExtended On
  1. FilterCaseSensitive: Use case sensitive regular expressions.
  2. FilterCaseSensitive On
  1. FilterDefaultDeny: Change the default policy of the filtering system.
  2. If this directive is commented out, or is set to "No" then the default
  3. policy is to allow everything which is not specifically denied by the
  4. filter file.
  5. However, by setting this directive to "Yes" the default policy becomes
  6. to deny everything which is _not_ specifically allowed by the filter
  7. file.
  8. FilterDefaultDeny Yes
  1. Anonymous: If an Anonymous keyword is present, then anonymous proxying
  2. is enabled. The headers listed are allowed through, while all others
  3. are denied. If no Anonymous keyword is present, then all headers are
  4. allowed through. You must include quotes around the headers.
  5. Most sites require cookies to be enabled for them to work correctly, so
  6. you will need to allow Cookies through if you access those sites.
  7. Anonymous "Host"
  8. Anonymous "Authorization"
  9. Anonymous "Cookie"
  1. ConnectPort: This is a list of ports allowed by tinyproxy when the
  2. CONNECT method is used. To disable the CONNECT method altogether, set
  3. the value to 0. If no ConnectPort line is found, all ports are
  4. allowed (which is not very secure.)
  5. The following two ports are used by SSL.

ConnectPort 443 ConnectPort 563

  1. Configure one or more ReversePath directives to enable reverse proxy
  2. support. With reverse proxying it's possible to make a number of
  3. sites appear as if they were part of a single site.
  4. If you uncomment the following two directives and run tinyproxy
  5. on your own computer at port 8888, you can access Google using
  6. http://localhost:8888/google/ and Wired News using
  7. http://localhost:8888/wired/news/. Neither will actually work
  8. until you uncomment ReverseMagic as they use absolute linking.
  9. ReversePath "/google/" "http://www.google.com/"
  10. ReversePath "/wired/" "http://www.wired.com/"
  1. When using tinyproxy as a reverse proxy, it is STRONGLY recommended
  2. that the normal proxy is turned off by uncommenting the next directive.
  3. ReverseOnly Yes
  1. Use a cookie to track reverse proxy mappings. If you need to reverse
  2. proxy sites which have absolute links you must uncomment this.
  3. ReverseMagic Yes
  1. The URL that's used to access this reverse proxy. The URL is used to
  2. rewrite HTTP redirects so that they won't escape the proxy. If you
  3. have a chain of reverse proxies, you'll need to put the outermost
  4. URL here (the address which the end user types into his/her browser).
  5. If not set then no rewriting occurs.
  6. ReverseBaseURL "http://localhost:8888/"