corsis/PortFusion

![pf] [pf]: http://fusion.corsis.tech/i/h.png "PortFusion"

Download 1.2.1 (for Windows, Linux, OS X and FreeBSD, ...)

PortFusion is a minimalistic, cross-platform, transport-layer distributed reverse / forward proxy and tunneling solution for TCP released under GPLv3.

A single package that makes the most of each platform by tapping into their unique capabilities, combining this power with an intuitive interface, beautiful design and Haskell's excellent support for unprecedented levels of concurrency and parallelism.

It strives for the smallest source code size while delivering maximum throughput with near-zero overhead.

Today, a growing number of companies and institutions around the world use PortFusion.

Use

PortFusion is a tiny command line application.

Distributed Reverse Proxy Mode	Distributed Forward Proxy Mode
Work from home using remote desktop services circumventing corporate firewalls.	Connect to the internet through a http proxy via a gateway to a friend's intranet.
↓ home ↓ PortFusion ] 2000 [ PortFusion 3389 localhost - 2000 home [ 3389 ↑ work ↑	↓ friend ↓ PortFusion ] 2000 [ PortFusion 3128 ] friend 2000 - server 3128 ↑ you ↑
Connections to home:3389 will now be tunnelled and reach work:3389. You only need to make home:2000 accessible from work.	Connections to you:3128 will now be tunnelled and reach server:3128. Your friend only needs to make friend:2000 accessible.

Build

Prerequisites

You need only one of the following rows for compilation.

Remarks	OS	Compilers
recommended and used for official binaries	, , , , , ,	GHC >= 7.4 LLVM >= 3
easy to install for all Haskell newbies	, ,	Haskell Platform >= 2012.2.0.0

Instructions

cabal update
cabal install    splice

git   clone      git://github.com/corsis/PortFusion.git -b master
cd    PortFusion
cabal configure
cabal build

Flags

Following flags can be activated when using cabal configure -f <FLAG> or cabal install -f <FLAG>.

Download

Binaries

x86-64	Get	Get	Get	Get
x86-32	Get	Get
ARM		Get
MIPS		Get
Other

CORSIS Research
builds official binaries
will build official binaries on demand
can cooperate with community for builds

Support

If you have access to an OS+CPU combination lacking official binaries, please contact us to join our build team!

Packages

PortFusion is available and can be very easily installed from Hackage:

cabal update
cabal install splice      -f llvm
cabal install PortFusion  -f llvm

If you do not have LLVM installed, you can drop -f llvm.

Compare

This is the new Haskell source code repository of the latest ]-[ayabusa version
– a complete rewrite of the initial Windows-only versions developed in F# / C#.

What is new in ]-[ayabusa?

PortFusion	1.2.1 – ]-[ayabusa	0.9.3 – old
Memory at Start-up	~0.7 MB	~14 MB
Memory at 1 Fusion	~1.0 MB (constant)	~30 MB (lots of jumps)
Official Binaries	, , ,
OS Support	, , , , , ,
CPU Support	x86-64, x86-32, ARM, MIPS	x86
Source Code Size	< 500 lines (1 file)	778 lines (multiple files)
Language	Haskell (GHC / LLVM)	F# / C#
Dependencies	none	.NET 4.0 + F# 2.0 Runtime
Deployment	1 unified, native code binary for each platform	2 x .NET 4.0 managed binaries
Binary Size	1-2 MB (~400 KB compressed)	78.3 KB (34.3 KB + 44 KB)
Concurrency Model	1 Haskell thread per connection	1 OS thread per connection
Distribution Technique	native sockets API and system calls of each OS	Windows Communication Foundation
Distributed Proxy Modes	reverse, forward	reverse
Local Proxy Modes	forward
Native IPv6 Support	yes	yes
Interactive Mode	REPL in GHCi
License
Availability	SourceForge.net (binary) GitHub (source) corsis.tech (commercial)	SourceForge.net

Remember

Trademark

PortFusion™ is a trademark of Corsis Research (corsis.tech).

Trademark Policy

You may only distribute unchanged official binaries using the
PortFusion and Corsis Marks.

If you're taking full advantage of the open-source nature of Corsis
products and making significant functional changes, you may not
redistribute the fruits of your labor under any Corsis trademark,
without prior written consent from Corsis. For example, if you've
modified PortFusion, you may not use Corsis or PortFusion, in whole
or in part, in your product name. Also, it would be inappropriate
for you to say "based on Corsis PortFusion". Instead, in the interest
of complete accuracy, you could describe your executables as "based on
PortFusion technology", or "incorporating PortFusion source code."
In addition, a "Powered by PortFusion" logo will be made available.

Copyright

CORSIS PortFusion ]-[ayabusa
© 2011 - 2013     Cetin Sert

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

Know

Principles

Development follows simple principles:

1. Be concise: PortFusion is a single-file with less than 500 lines of code
2. Be relentless: refactor and prune constantly
3. Be open: share everything
4. Create fully documented reusable libraries that cover common needs
5. Use the most permissive licenses possible
6. Report bugs in external code and work on fixes
7. Illustrate every concept in publication-worthy detail
8. Be friendly: provide excellent support to users

Japanese Influence: ]-[ayabusa (はやぶさ) (Hayabusa)

I had already spent a great deal of time contemplating a nice and intuitive syntax and it was only when I watched the Japanese movie Hayabusa about the same-named space probe sent to extract and bring to Earth pieces from the asteroid Itokawa that everything just fell into place:

# command line  # source file

  ] [             :><:          # serve
  - [             :-<:          # reverse
  ] -             :>-:          # forward

# > and < are reserved characters at command line
# ] and [ are reserved characters in Haskell

PortFusion owes its design goals, ambitions and 1.0 release name ]-[ayabusa to the great Japanese culture and friends.

Family

We hope to grow a whole family of software-defined networking solutions reaching all network layers, technologies and devices.

Thanks

For their continuing support and inspiration, we extend our heart-felt thanks to:

Contact

[email protected]