New Feature: Configurable Transports

[fortuna]

Configurable transports simplifies the way you create and manage transports. With the x/config package, you can now use config.NewPacketDialer(config) and config.NewStreamDialer(config) to create transports using a simple text string.

Key Benefits

• Ease of Use: Create transports effortlessly by providing a textual configuration, reducing boilerplate code.
• Serialization: Easily share configurations with users or between different parts of your application, including your Go backend.
• Dynamic Configuration: Set your app's transport settings at runtime.
• DPI Evasion: Advanced nesting and configuration options help you evade Deep Packet Inspection (DPI).

How to Get Started

The configuration string is composed of parts separated by the | symbol, which define nested dialers. For example, A|B means dialer B takes dialer A as its input. Each dialer configuration follows a URL format, where the scheme defines the type of Dialer. Supported formats include:

• Shadowsocks: ss://[USERINFO]@[HOST]:[PORT]?prefix=[PREFIX] (compatible with Outline's access keys)

• SOCKS5: socks5://[HOST]:[PORT] (common proxy configuration)

• Stream Split: split:[PREFIX_LENGTH]

• Direct Dial (TCP/UDP): Represented by an empty string

Examples

Packet splitting

To split outgoing streams on bytes 8 and 123, you can use:

split:8|split:123

Onion Routing with Shadowsocks

To route your traffic through three Shadowsocks servers, similar to Onion Routing, use:

ss://[USERINFO1]@[HOST1]:[PORT1]|ss://[USERINFO2]@[HOST2]:[PORT2]|ss://[USERINFO3]@[HOST3]:[PORT3]

In that case, [HOST1] will be your entry node, and [HOST3] will be your exit node.

DPI Evasion

To add packet splitting to a Shadowsocks server for enhanced DPI evasion, use:

split:3|ss://[USERINFO]@[HOST]:[PORT]

[fortuna]

You can play with the config using the example apps.

Local Proxy

Start the local webproxy:

go run github.com/Jigsaw-Code/outline-sdk/x/examples/http2transport@latest -transport split:3 -localAddr localhost:8080

Fetch a page with curl:

curl -x http://localhost:8080 https://ipinfo.io

Page Fetch

go run github.com/Jigsaw-Code/outline-sdk/x/examples/outline-fetch@latest -transport 'split:3|split:123' https://example.com