Total Pageviews

Thursday 14 June 2018

tun2socks

A tun2socks framework with Swift wrapper 

Build Status GitHub release Carthage compatible GitHub license
tun2socks is designed to work with the NetworkExtension framework. It is based on the latest stable lwip with minimal modification.

Feature

The whole stack is based on GCD which is efficient and fast.
Only TCP protocol is supported.
All other protocols (UDP, ICMP, IGMP, ...) will not be supported since they are stateless or can not be supported in NetworkExtension.

Usage

The overall structure of tun2socks:
╔═══════════════════════╗                                                       
║sourceAddress: X.X.X.X ║                                                       
║    sourcePort: XX     ║                    writeData(_:)                      
╚═══════════════════════╝                          │                            
                                                   │            ┌──────────────┐
┌─────────────┐  ┌───────┐  ┌────────────┐  ┌──────▼──────┐     │TSTCPSocketDel│
│    Local    ◀──▶  TUN  ◀──▶ TSIPStack  ◀──▶ TSTCPSocket ├─────▶egate.didReadD│
└─────────────┘  └───────┘  └────────────┘  └─────────────┘     │    ata()     │
                                                                └──────────────┘
Fully documented API reference can be found here.
Carthage is recommended to integrate tun2socks by adding
github "zhuhaow/tun2socks"
to the Cartfile.
Another alternative may be NEKit which uses tun2socks and provides many features to build a proxy app.

No comments:

Post a Comment