tinyproxy - a light-weight HTTP/HTTPS proxy daemon for POSIX operating systems
Go to file
Michael Adam 60d738626b conf: fix ipv6 regex patterns, take three
This extends the pattern by an alternative where there are no double colons.
This is for instance the case for and IPv6 address of the form
1111:222:33:4:55:666:7777:888

Michael
2009-11-10 00:55:39 +01:00
data data: Cleanup installation of templates 2009-09-13 04:08:06 +05:30
docs Document DisableViaHeader in the tinyproxy.conf(5) manpage. 2009-10-11 02:00:44 +02:00
etc Clean tinyproxy.conf in make clean. 2009-10-11 13:21:13 +02:00
m4macros build: Update CFLAGS and also check if they are supported 2009-09-20 13:32:46 +05:30
packaging packaging: Update summary and description in spec file 2009-09-13 17:26:38 +05:30
src conf: fix ipv6 regex patterns, take three 2009-11-10 00:55:39 +01:00
tests tests:webclient: add option to send a request entity (body) 2009-10-12 02:01:25 +02:00
.gitignore gitignore add file tags (from ctags) 2009-10-25 23:33:37 +01:00
AUTHORS Rewrote the "early history" of the project, and added a section for 2004-02-17 19:49:54 +00:00
autogen.sh Remove obsolete comment 2009-09-27 08:09:24 +05:30
ChangeLog Merged in changes from 1.6.3 2004-08-10 21:24:24 +00:00
configure.ac Bump micro version 2009-11-09 01:14:03 +05:30
COPYING [BB#53] Add a GPLv2 COPYING file 2009-08-04 04:21:46 +05:30
Makefile.am make: add targets "test" and "valgrind-test" 2009-09-27 11:18:52 +02:00
NEWS Add more bugs to NEWS 2009-09-28 19:08:54 +05:30
README Remove section on debugging from README 2009-09-27 19:09:51 +05:30
tinyproxy-indent.sh Add Tinyproxy indent script 2009-09-15 01:00:50 +05:30
TODO TODO: add a reference to a bugzilla entry 2009-10-13 23:52:02 +02:00

Tinyproxy
=========

Tinyproxy is a small, efficient HTTP/SSL proxy daemon released under the
GNU General Public License.  Tinyproxy is very useful in a small network
setting, where a larger proxy would either be too resource intensive, or
a security risk.  One of the key features of Tinyproxy is the buffering
connection concept.  In effect, Tinyproxy will buffer a high speed
response from a server, and then relay it to a client at the highest
speed the client will accept.  This feature greatly reduces the problems
with sluggishness on the Internet.  If you are sharing an Internet
connection with a small network, and you only want to allow HTTP
requests to be allowed, then Tinyproxy is a great tool for the network
administrator.

For more info, please visit:

	https://www.banu.com/tinyproxy/


Installation
------------

To install this package under a UNIX derivative, read the INSTALL file.
Tinyproxy uses a standard GNU `configure` script. Basically you should
be able to do:

----
./configure
make
make install
----

in the top level directory to compile and install Tinyproxy. There are
additional command line arguments you can supply to `configure`. They
include:

	--enable-debug		If you would like to turn on full
				debugging support
	--enable-xtinyproxy	Compile in support for the XTinyproxy
				header, which is sent to any web
				server in your domain.
	--enable-filter		Allows Tinyproxy to filter out certain
				domains and URLs.
	--enable-upstream	Enable support for proxying connections
				through another proxy server.
	--enable-transparent-proxy
				Allow Tinyproxy to be used as a
				transparent proxy daemon
	--enable-static		Compile a static version of Tinyproxy

        --with-stathost=HOST	Set the default name of the stats host


Support
-------

If you are having problems with Tinyproxy, please submit a bug report
using Tinyproxy as the component at:

	https://www.banu.com/bugzilla/

You may also wish to subscribe to the Tinyproxy mailing lists. To do so
please visit:

	https://www.banu.com/mailman/listinfo/tinyproxy-announce-list
	https://www.banu.com/mailman/listinfo/tinyproxy-users-list
	https://www.banu.com/mailman/listinfo/tinyproxy-developers-list

for more information on how to subscribe and post messages to the lists.


Contributing
------------

If you would like to contribute a feature, or a bug fix to the Tinyproxy
source, please send a patch (preferably as a unified diff. i.e. `diff
-u` against the "master" branch of the Tinyproxy source code git
repository to tinyproxy-developers-list.  Please include a description
of what your patch does.

Tinyproxy's git repository is git://www.banu.com/tinyproxy.git. The
following command creates a local copy:

----
git clone git://www.banu.com/tinyproxy.git
----

The easiest and preferred way to create a patch for submission is to
check in your changes locally and use `git format-patch` to generate a
mbox-style commit file that contains the diff along with the commit
message and author information.  Such a format-patch file can be
integrated into the upstream repository, automatically keeping the
commit message and author information.

You can also meet developers and discuss development issues and patches
in the #tinyproxy IRC channel on Freenode (irc.freenode.net).