Awesome
![pf] [pf]: http://fusion.corsis.tech/i/h.png "PortFusion"
<a href='http://sourceforge.net/projects/portfusion/files/1.2.1/#files'><img src='http://fusion.corsis.tech/i/down_16.png' /> Download 1.2.1</a> <span style="font-size: small">(for Windows, Linux, OS X and FreeBSD, ...)</span>
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 |
|---|---|
| <p>Work from home using remote desktop services circumventing corporate firewalls.</p> | <p>Connect to the internet through a http proxy via a gateway to a friend's intranet.</p> |
↓ home ↓ <pre>PortFusion ] 2000 [</pre><pre>PortFusion 3389 localhost - 2000 home [ 3389</pre> ↑ work ↑ | ↓ friend ↓ <pre>PortFusion ] 2000 [</pre><pre>PortFusion 3128 ] friend 2000 - server 3128</pre> ↑ you ↑ |
<p>Connections to home:3389 will now be tunnelled and reach work:3389.</p> <p>You only need to make home:2000 accessible from work.</p> | <p>Connections to you:3128 will now be tunnelled and reach server:3128.</p> <p>Your friend only needs to make friend:2000 accessible.</p> |
| <a name='illustrate' class='anchor' href='#illustrate' /> <img src="http://portfusion.sourceforge.net/w/wp-content/uploads/2012/05/dr1.png" /> | <img src="http://portfusion.sourceforge.net/w/wp-content/uploads/2012/05/df2.png" /> |
| <img width='100%' src="http://portfusion.sourceforge.net/i/reverse-fusion-msc-8.png" alt="DR" /> | <img width='100%' src="http://portfusion.sourceforge.net/i/forward-fusion-msc-8.png" alt="DF" /> |
Build
Prerequisites
You need only one of the following rows for compilation.
| Remarks | OS | Compilers |
|---|---|---|
| recommended and <br /> used for official binaries |  ,  ,  ,  ,  ,  ,  | GHC >= 7.4 <br /> LLVM >= 3 |
| easy to install for <br /> 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>.
| Flag | Effect | Default | Official Binaries |
|---|---|---|---|
llvm | compile via LLVM | false | true |
static | link system libraries statically | false | See OS and CPUs |
Download
Binaries
| <img height='48px' alt='CPU' title='CPU' src='http://a.fsdn.com/sd/topics/hardware_64.png' /> | | | | | | | |
|---|---|---|---|---|---|---|---|
| x86-64 | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> |  | | |
| x86-32 | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | | | | | |
| ARM |  | <a href='http://fusion.corsis.tech'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | | | | | |
| MIPS | <a href='https://sourceforge.net/projects/portfusion/files/1.2.1/compressed/'><img src='http://fusion.corsis.tech/i/down_16.png' /> Get</a> | ||||||
| Other | | | | | |
CORSIS Research <br />
builds official binaries <br />
will build official binaries on demand <br />
can cooperate with community for builds <br />
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) <br /> GitHub (source) <br /> 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:
- Be concise: PortFusion is a single-file with less than 500 lines of code
- Be relentless: refactor and prune constantly
- Be open: share everything
- Create fully documented reusable libraries that cover common needs
- Use the most permissive licenses possible
- Report bugs in external code and work on fixes
- Illustrate every concept in publication-worthy detail
- 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:
<div style='vertical-align: middle'> <img alt='Internet Initiative Japan' title='Internet Initiative Japan' src='http://www.iij.ad.jp/en/common/images/hd_logo01.png' /> <img alt='Commercial Users of Functional Programming' title='Commercial Users of Functional Programming' height='96px' src='http://portfusion.sourceforge.net/w/wp-content/uploads/2012/05/cufp.png' /> <img alt='Japan Aerospace Exploration Agency' title='Japan Aerospace Exploration Agency' src='https://upload.wikimedia.org/wikipedia/commons/8/85/Jaxa_logo.svg' /> </div>Contact
