outline-go-tun2socks

Go package for building go-tun2socks-based clients for Outline and Intra (now with support for Choir metrics). For macOS, iOS, and Android, the output is a library; for Linux and Windows it is a command-line executable.

Prerequisites

macOS host (iOS, macOS)
make
Go >= 1.18
A C compiler (e.g.: clang, gcc)

Android

Set up

sdkmanager
1. Download the command line tools from https://developer.android.com/studio.
2. Unzip the pacakge as ~/Android/Sdk/cmdline-tools/latest/. Make sure sdkmanager is located at ~/Android/Sdk/cmdline-tools/latest/bin/sdkmanager
Android NDK 23
1. Install the NDK with ~/Android/Sdk/cmdline-tools/latest/bin/sdkmanager "platforms;android-30" "ndk;23.1.7779620" (platform from outline-client, exact NDK 23 version obtained from sdkmanager --list)
2. Set up the environment variables:
```
export ANDROID_NDK_HOME=~/Android/Sdk/ndk/23.1.7779620 ANDROID_HOME=~/Android/Sdk
```
gomobile (installed as needed by make)

Build

make clean && make android

This will create build/android/{tun2socks.aar,tun2socks-sources.jar}

If needed, you can extract the jni files into build/android/jni with:

unzip build/android/tun2socks.aar 'jni/*' -d build/android

Apple (iOS and macOS)

Set up

Xcode
gomobile (installed as needed by make)

Build

make clean && make apple

This will create build/apple/Tun2socks.xcframework.

Linux and Windows

We build binaries for Linux and Windows from source without any custom integrations. xgo and Docker are required to support cross-compilation.

Set up

Docker (for xgo)
xgo (installed as needed by make)
ghcr.io/crazy-max/xgo Docker image. This is pulled automatically by xgo and takes ~6.8 GB of disk space.

Build

For Linux:

make clean && make linux

This will create build/linux/tun2socks.

For Windows:

make clean && make windows

This will create build/windows/tun2socks.exe.

Intra (Android)

Same set up as for the Outline Android library.

Build with:

make clean && make intra

This will create build/intra/{tun2socks.aar,tun2socks-sources.jar}

youcaihuaf / outline-go-tun2socks Goto Github PK