summaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorMichael Adam <obnox@samba.org>2016-12-20 18:38:33 +0100
committerMichael Adam <obnox@samba.org>2016-12-20 19:04:56 +0100
commit0d3ca13398e267b7b006059e93414b35b38c5bca (patch)
treeb3958b121ef2eb93f6ceff758e73d760be8224be /README.md
parent82ce991b3de42a0e2ad37ccde7ba18b4914f7d5f (diff)
README: Rename README --> README.md
Signed-off-by: Michael Adam <obnox@samba.org>
Diffstat (limited to 'README.md')
-rw-r--r--README.md78
1 files changed, 78 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3bef8b7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+# 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 [the Tinyproxy web site](https://tinyproxy.github.io/).
+
+
+## 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`:
+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 raise an
+[issue on github](https://github.com/tinyproxy/tinyproxy/issues).
+
+
+## Contributing
+
+If you would like to contribute a feature, or a bug fix to the Tinyproxy
+source, please clone the
+[git repository from github](https://github.com/tinyproxy/tinyproxy.git)
+and create a [pull request](https://github.com/tinyproxy/tinyproxy/pulls).
+
+
+## Community
+
+You can meet developers and users to discuss development,
+patches and deployment issues in the `#tinyproxy` IRC channel on
+Freenode (`irc.freenode.net`).