tinyproxy - a light-weight HTTP/HTTPS proxy daemon for POSIX operating systems
Go to file
gary-wzl77 f8407b5f7b Enable tinyproxy packaging as a snap.
This PR enable tinyproxy to package as a snap. Also added conditional
for snap packaging by testing "--enable-snap". The reason here for
'--enable-snap' is that all services run as root thanks to confinement
in snap world and regarding system call(setuid, setgid) will trigger
apparmor "DENIED" error when running tinyproxy snap in confined mode.
Please refer to syslog here http://paste.ubuntu.com/24063282/.
2017-02-25 15:02:47 +08:00
data data: Cleanup installation of templates 2009-09-13 04:08:06 +05:30
docs Merge pull request from gmp216/pull 2017-01-04 16:21:27 +01:00
etc Bug : Move files installed in /etc/ to /etc/tinyproxy/ 2011-08-23 14:46:04 +05:30
m4macros build: Update CFLAGS and also check if they are supported 2009-09-20 13:32:46 +05:30
snap Enable tinyproxy packaging as a snap. 2017-02-25 15:02:47 +08:00
src Enable tinyproxy packaging as a snap. 2017-02-25 15:02:47 +08:00
tests [BB#83] Use output of id instead of $USER 2010-04-21 21:02:57 +05:30
.gitignore add 'compile' to gitignore 2016-12-24 03:04:50 +01:00
.travis.yml Enable travis-ci: add .travis.yml 2016-12-24 02:54:26 +01:00
AUTHORS Update authors 2012-01-23 16:32:35 +05:30
authors.dtd Update the AUTHORS file 2010-01-18 17:35:51 +05:30
authors.xml Update authors 2012-01-23 16:32:35 +05:30
authors.xsl Make note about auto-generated file an asciidoc comment 2010-01-18 18:42:10 +05:30
autogen.sh Remove AM_MAINTAINER_MODE 2009-12-08 10:52:17 +05:30
ChangeLog Add placeholder ChangeLog to keep automake happy 2016-12-20 19:22:17 +01:00
configure.ac Enable tinyproxy packaging as a snap. 2017-02-25 15:02:47 +08:00
COPYING [BB#53] Add a GPLv2 COPYING file 2009-08-04 04:21:46 +05:30
Makefile.am build: add README.md to the bundled files 2016-12-20 19:26:48 +01:00
NEWS Reset the NEWS file for the master branch 2010-01-17 21:05:13 +05:30
README README: add README pointing to README.md to make automake happy 2016-12-20 19:22:17 +01:00
README.md Enable tinyproxy packaging as a snap. 2017-02-25 15:02:47 +08:00
tinyproxy-indent.sh Add Tinyproxy indent script 2009-09-15 01:00:50 +05:30
TODO Remove suggester (see Banu RT ) 2014-05-01 13:58:54 +05:30

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.

Installation

Tinyproxy uses a standard GNU configure script based on the automake system. If compiling from a git checkout, you need to first run

./autogen.sh

from the top level directory to generate the configure script. The release tarball contains the pre-created configure script, so when building fom a release, you can skip this step. Then basically all you need to do is

./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.

  • --enable-reverse: Enable reverse proxying.

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

  • --enable-snap: Enable snap packaging and running tinyproxy in snap world.

For more information about the build system, read the INSTALL file that is generated by autogen.sh and comes with the release tar ball.

Snap

If you would like to build tinyproxy as a snap package, please make sure you have snapd and snapcraft packages installed firstly.

sudo apt-get install snapd snapcraft
sudo snap install core

Then run the following command to create a snap package.

cd snap && snapcraft

After it's done, you can simply run the following command to install it locally.

sudo snap install --dangerous tinyproxy-snap_[VER]_[ARCH].snap

Also you can install tinyproxy from the store by running the following command.

sudo snap install tinyproxy

Support

If you are having problems with Tinyproxy, please raise an issue on github.

Contributing

If you would like to contribute a feature, or a bug fix to the Tinyproxy source, please clone the git repository from github and create a pull request.

Community

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