programmable proxy for censorship circumvention https://fteproxy.org/
- homepage: https://fteproxy.org
- source code: https://github.com/kpdyer/fteproxy
- publication: https://kpdyer.com/publications/ccs2013-fte.pdf
Overview
fteproxy provides transport-layer protection to resist keyword filtering, censorship and discrimantory routing policies. Its job is to relay datastreams, such as web browsing traffic, by encoding the stream into messages that satisfy a user-specified regular expression.
fteproxy is powered by Format-Transforming Encryption [1] and was presented at CCS 2013.
[1] Protocol Misidentification Made Easy with Format-Transforming Encryption, Kevin P. Dyer, Scott E. Coull, Thomas Ristenpart and Thomas Shrimpton
Quick Start
On Linux/OSX, use pip to install fteproxy.
pip install fteproxy
On Windows, download pre-compiled binaries, located at: https://fteproxy.org/download
Dependencies
Dependencies for building from source:
- Python 2.7.x: https://python.org/
- fte 0.0.x: https://pypi.python.org/pypi/fte
- pyptlib 0.0.x: https://gitweb.torproject.org/pluggable-transports/pyptlib.git
- obfsproxy 0.2.x: https://gitweb.torproject.org/pluggable-transports/obfsproxy.git
- Twisted 13.2.x: https://twistedmatrix.com/
Running
For platform-specific examples of how to install dependencies see BUILDING.md.
There is nothing to build for fteproxy --- it is Python-only project. To run fteproxy, you need to do only the following.
git clone https://github.com/kpdyer/fteproxy.git
cd fteproxy
./bin/fteproxy
Documentation
-------------------------
cross-platform build automation for fteproxy https://fteproxy.org/
fteproxy-builder
This is a collection of scripts that build fteproxy for all of its target platforms.
The initial release of fteproxy-builder requires OSX, and has been tested on OSX 10.9.
Overview
This project's purpose is to streamline the process of building fteproxy for 32-bit and 64-bit systems, for Linux, OSX and Windows. Specifically, you can use it as follows:
$ git clone https://github.com/kpdyer/fteproxy-builder.git
$ cd fteproxy-builder
$ make all
[wait a bit]
$ ls dist/*
dist/fteproxy-X.Y.Z-darwin-i386.tar.gz
dist/fteproxy-X.Y.Z-linux-i386.tar.gz
dist/fteproxy-X.Y.Z-linux-x86_64.tar.gz
dist/fteproxy-X.Y.Z-src.tar.gz
dist/fteproxy-X.Y.Z-windows-i386.zip
If you wish to build a specific version or tag of fteproxy, set
FTEPROXY_TAG
and/or FTEPROXY_VER
in the Makefile.Requirements
For details on how to setup your environment, please see
INSTALL
. In addition, the following four requirements must be met to do full builds for all target platforms.- OSX 10.9.x
- Vagrant: http://www.vagrantup.com/
- VirtualBox: https://www.virtualbox.org
- Three vagrants boxes:
ubuntu-12.04-i386
- used to cross-compile for windows platformdebian-7.1.0-i386
- used to produce 32-bit linux binariesdebian-7.1.0-amd64
- used to produce 64-bit linux binaries
- wget
No comments:
Post a Comment