A fast, custom encrypted transport protocol written in Rust.
Go to file
ospab 514bae94cd fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00
.github/workflows fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00
docs docs: add official specifications for OSTP 2026-05-15 18:51:13 +03:00
ostp chore: implement keep-alive, config comments, validation and CI/CD improvements 2026-05-16 18:20:53 +03:00
ostp-client fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00
ostp-core fix: throw error on ARQ max_retries exceeded to prevent silent deadlock that caused infinite upload timeouts 2026-05-15 20:04:07 +03:00
ostp-gui chore: implement keep-alive, config comments, validation and CI/CD improvements 2026-05-16 18:20:53 +03:00
ostp-jni feat(gui): implement real-time atomic status polling and multi-state UI feedback (Stopped/Handshaking/Established) and update JNI/core layers 2026-05-15 22:37:50 +03:00
ostp-server feat: resolve flow control, tun crash route cleanup, log pollution, padding caps 2026-05-15 18:34:32 +03:00
ostp-tun-helper chore: implement keep-alive, config comments, validation and CI/CD improvements 2026-05-16 18:20:53 +03:00
scripts fix(installer): use rename trick to bypass file locks and ensure all bundled files (tun2socks, wintun) are copied 2026-05-15 20:24:01 +03:00
.gitattributes chore: enforce LF line endings on bash scripts via gitattributes to fix 'bad interpreter' on Linux 2026-05-15 19:08:03 +03:00
.gitignore fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00
Cargo.lock chore: implement keep-alive, config comments, validation and CI/CD improvements 2026-05-16 18:20:53 +03:00
Cargo.toml fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00
Cross.toml CI/CD: Resolve MIPS Tier-3 compilation by instructing Cross to dynamically build-std library from source 2026-05-14 23:57:19 +03:00
LICENSE Initial public release: Ospab Stealth Transport Protocol v0.1.0 2026-05-14 21:41:54 +03:00
README.md fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00
README.ru.md fix: resolve build errors and remove GUI from main release; docs: improve READMEs 2026-05-16 19:15:04 +03:00

README.md

🌌 OSTP (Ospab Stealth Transport Protocol)

GitHub Release License: BSL 1.1 Platform: Windows | Linux | macOS | Android Rust: 1.75+

OSTP is a next-generation, high-performance stealth transport protocol engineered for absolute privacy and network resilience. It transforms your data streams into high-entropy, featureless noise, making it virtually undetectable by statistical network analysis (DPI).

Whether you are navigating restrictive network environments, securing industrial telemetry, or just seeking a robust personal tunnel, OSTP provides the stability and speed you need.


Core Features

🛡️ Indistinguishable Traffic (Stealth)

Unlike traditional VPNs (OpenVPN, WireGuard) that have distinct packet signatures, OSTP uses advanced Keystream Scrambling and Adaptive Block Shaping. Your traffic looks like random bytes, bypassing even the most aggressive firewalls.

🚀 Extreme Performance

Written from the ground up in Rust and utilizing the gVisor network stack, OSTP is optimized for zero-copy data processing and high-throughput multiplexing. It easily handles 1Gbps+ streams with minimal CPU overhead.

📱 Cross-Platform Dominance

  • Windows: Full support for TUN mode via Wintun and SOCKS5/HTTP proxying.
  • Linux: Native high-performance daemon with systemd integration.
  • Android: Integrated JNI core for mobile applications.
  • macOS/FreeBSD: Standard CLI support for proxying and routing.

🔄 Intelligent Multiplexing (Mux)

Handle hundreds of concurrent streams over a single connection. OSTP includes a built-in Arq-based reliable transport layer that manages retransmissions and flow control automatically.

🏠 Robust Liveness (Keep-Alive)

Stays connected where others fail. The intelligent heartbeat system keeps NAT mappings alive and ensures the tunnel stays active even during long periods of idle time or network handoffs.


🛠️ Architecture

The project is organized into a modular workspace:

  • ostp-core: The base cryptographic and framing library.
  • ostp-client: High-level client logic, proxy servers, and TUN management.
  • ostp-server: High-performance multi-tenant server implementation.
  • ostp: The main CLI binary (The "Core").
  • ostp-jni: Android/Mobile bindings.
  • Note: The experimental GUI is currently in a separate testing phase.

📥 Getting Started

🐧 Linux (One-Line Installer)

bash <(curl -Ls https://raw.githubusercontent.com/ospab/ostp/master/scripts/install.sh)

🪟 Windows (One-Line Installer)

# Run as Administrator
irm https://raw.githubusercontent.com/ospab/ostp/master/scripts/install.ps1 | iex

⚙️ Configuration

Generate your template first:

./ostp --init server # On VPS
./ostp --init client # On Local PC

Server Example (config.json)

{
  "_comment": "OSTP Server Configuration",
  "mode": "server",
  "listen": "0.0.0.0:50000",
  "access_keys": [
    "YOUR_GENERATED_KEY"
  ],
  "_comment_outbound": "Optional: forward traffic to another proxy (e.g. Tor)",
  "outbound": {
    "enabled": false,
    "protocol": "socks5",
    "address": "127.0.0.1",
    "port": 9050,
    "default_action": "proxy"
  }
}

Client Example (config.json)

{
  "_comment": "OSTP Client Configuration",
  "mode": "client",
  "server": "SERVER_IP:50000",
  "access_key": "YOUR_GENERATED_KEY",
  "socks5_bind": "127.0.0.1:1088",
  "tun": {
    "enable": false,
    "wintun_path": "./wintun.dll",
    "ipv4_address": "10.1.0.2/24",
    "dns": "1.1.1.1"
  }
}

OSTP is published under the Business Source License 1.1 (BSL).

  • Personal/Private use: Free and unrestricted.
  • Commercial use: Requires a separate agreement until the change date.
  • Change Date: May 14, 2030 (converts to MIT License).

See the LICENSE file for more details.