107 lines
3.8 KiB
Plaintext
107 lines
3.8 KiB
Plaintext
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
tinyproxy is a small, efficient HTTP proxy daemon released under the
|
|
GNU General Public Licence (GPL). tinyproxy is very useful in a small
|
|
network setting, where a larger proxy like Squid 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.
|
|
|
|
|
|
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-socks This turns on SOCKS support for using
|
|
tinyproxy across a fire wall.
|
|
--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-tunnel Provides the option of having
|
|
tinyproxy act as TCP tunnel, rather
|
|
than a HTTP proxy.
|
|
--enable-upstream Enable support for proxying connections
|
|
through another proxy server.
|
|
--enable-static Compile a static version of tinyproxy
|
|
|
|
|
|
Options for file locations etc.
|
|
--with-stathost=HOST Set the default name of the stats host
|
|
--with-config=FILE Set the default location of the
|
|
configuration file
|
|
|
|
Once you have completed your installation, if you would like to
|
|
report your success please execute the report.sh script in the doc
|
|
directory. This will send an email to the authors reporting your
|
|
version, and a few bits of information concerning the memory usage of
|
|
tinyproxy. Alternatively, you could just send an email stating the
|
|
version, whichever you prefer.
|
|
|
|
|
|
SUPPORT
|
|
-------
|
|
|
|
If you are having problems with tinyproxy, please report the problem
|
|
to either:
|
|
|
|
Robert James Kaes <rjkaes@users.sourceforge.net>
|
|
Steven Young <sdyoung@users.sourceforge.net>
|
|
|
|
You may also wish to subscribe to the tinyproxy-user mailing list. To
|
|
do so please visit:
|
|
|
|
http://lists.sourceforge.net/lists/listinfo/tinyproxy-users
|
|
|
|
for more information on how to subscribe and post messages to the
|
|
list.
|
|
|
|
Please recompile tinyproxy with full debug support (--enable-debug)
|
|
and include a copy of the log file, and any assert errors reported by
|
|
tinyproxy. Note that tinyproxy will output memory statistics to
|
|
standard error if compiled with debugging support so you might want
|
|
to redirect the output to a file for later examination. Also, if you
|
|
feel up to it, try running tinyproxy under your debugger and report
|
|
the error your received and a context listing of the location. Under
|
|
gdb you would run tinyproxy like so:
|
|
|
|
gdb tinyproxy
|
|
|
|
(gdb) run -c location_of_tinyproxy_conf -d 2>/dev/null
|
|
|
|
Now access the port tinyproxy is on until you receive a break in the
|
|
gdb. You can now type:
|
|
|
|
(gbd) l
|
|
|
|
to produce a context listing of the location of the error. Send a
|
|
copy to the authors.
|
|
|
|
|
|
HOW TO CONTRIBUTE TO tinyproxy
|
|
------------------------------
|
|
|
|
If you would like to contribute a feature, or a bug fix to the
|
|
tinyproxy source, please send a diff (preferable a unified
|
|
diff. i.e. "diff -u") against the latest release of tinyproxy. Also,
|
|
if you could include a brief description of what your patch does.
|