fteproxy

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

See: https://fteproxy.org/documentation

from https://github.com/kpdyer/fteproxy

-------------------------

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 platform
  • debian-7.1.0-i386 - used to produce 32-bit linux binaries
  • debian-7.1.0-amd64 - used to produce 64-bit linux binaries
• wget

from https://github.com/kpdyer/fteproxy-builder