Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
N

Nowhere

> 编程语言
Open source

Split-direction TLS / QUIC relay in Rust

338 stars0 likes0 views
WebsiteGitHub

About

Split-direction TLS / QUIC relay in Rust

One relay. Two carriers. Independent directions.

A cross-platform relay that composes TLS/TCP and QUIC/UDP

independently for every flow.

Architecture · Quick start · Live operations · Documentation · Wire protocol

Nowhere joins TLS/TCP and QUIC/UDP behind one service edge. Vector accepts local SOCKS5 traffic; Portal authenticates carriers and reaches the target. Each flow selects its uplink and downlink independently.

Core property What it means
Unified edge TLS/TCP and QUIC/UDP share one identity and lifecycle
Split routing Uplink and downlink choose their carrier independently
Optional Morph A keyed transform masks the TLS/QUIC wire image
TCP and UDP SOCKS5 CONNECT and UDP ASSOCIATE are both supported
Native chaining Portal forwards directly to Portal with no local proxy loop
Built-in telemetry The same binary discovers and inspects live instances

How it works

 Application
  TCP / UDP
      |
    SOCKS5
      |
      v
+------------+  Uplink carrier   +--------------+  Native `next` uplink   +-------------+
|   Vector   |==================>| Entry Portal |========================>| Next Portal |
|            | server   [ nonce 12B ][ ChaCha20-XOR(TLS stream) ]
     server -> client                [ ChaCha20-XOR(TLS stream) ]

UDP  each datagram      [ nonce 12B ][ ChaCha20-XOR(QUIC datagram) ]

Both endpoints on a hop must enable it. Morph is wire masking, with no protocol camouflage or added security semantics. See Protocol.

Native chaining

A Portal can open the next Nowhere hop directly:

bash
nowhere \
  'portal://relay-key@:[email protected]:2000&up=udp&down=udp'

next is lazy, mutually exclusive with outbound socks, and bounded to seven hops.

Quick start

Use a stable Rust toolchain on a supported target.

1. Build

bash
cargo build --release --locked

2. Start Portal

Listen on TLS/TCP and QUIC/UDP at port 2000:

bash
./target/release/nowhere 'portal://[email protected]:2000'

3. Start Vector

Expose SOCKS5 on 127.0.0.1:1080:

bash
./target/release/nowhere \
  'vector://[email protected]:2000?up=tcp&down=tcp&socks=127.0.0.1:1080'

More examples are available in Configuration and the extended quick start.

4. Inspect

Open the local TUI from another terminal:

bash
./target/release/nowhere tui

Live operations

The read-only TUI discovers local Portal and Vector instances and presents traffic, carrier, process, and log data without controlling their lifecycle.

Public deployment

The local examples disable certificate verification by omitting sni. Public deployments should use a trusted certificate and verified server name:

bash
nowhere 'portal://change-me@:2000?tls=2&crt=/etc/nowhere/cert.pem&key=/etc/nowhere/key.pem'
nowhere 'vector://[email protected]:2000?sni=relay.example&socks=127.0.0.1:1080'

Certificate pinning is also available. Review Security and Configuration before exposing a Portal.

Platform scope

Portal, Vector, relay, TUI, and discovery share the supported platform matrix; process telemetry varies by operating system. See Platforms and Operations.

Documentation

The documentation index covers configuration, protocol, security, operations, platforms, and integrations.

Development

Run the standard checks on a supported host:

bash
cargo fmt --all -- --check
cargo test --all-targets --locked
cargo clippy --all-targets --locked -- -D warnings
cargo build --release --locked

On macOS, Apple Container provides the reusable Linux check environment:

bash
./scripts/check-linux.sh

CI covers Linux, macOS, and Windows. Release packaging covers Linux GNU/musl on x86-64 and AArch64, macOS on Apple Silicon, and Windows x86-64 MSVC. Protocol changes must update the wire document and protocol vectors together.

License

Nowhere is licensed under the GNU General Public License v3.0.


© 2026 NodePassProject. All rights reserved.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rustnetworkingproxyquicrelay

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 18, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言