Skip to content

v0.0.1

Latest

Choose a tag to compare

@github-actions github-actions released this 08 Sep 03:36
· 70 commits to develop since this release

Zero Core v0.0.1

Zero is a network proxy kernel written in Rust. It can power a desktop client, run as a local gateway, or serve as a remote proxy node. It handles connections, routing decisions, and TCP/UDP forwarding while exposing configuration and observability interfaces to clients and management systems.

Capabilities

Protocols and traffic forwarding

Zero provides implemented capabilities for SOCKS5, HTTP CONNECT, Mixed, VLESS, VMess, Trojan, Shadowsocks, Hysteria2, and Mieru. Configure inbound listeners and outbound connections to combine direct access, proxy nodes, and relay chains. Supported directions, transports, and extensions vary by protocol and are exposed through the runtime capability inventory.

Routing and outbound selection

Route traffic by domain, IP/CIDR, and other supported conditions. Choose direct access, blocking, global proxying, or rule-based routing. Outbound groups support manual selection, fallback, URLTest latency selection, and relay composition. URLTest selection tolerance helps avoid unnecessary switching when latency changes slightly; bypass rules preserve native network paths for selected destinations.

DNS and TUN

Use real-address DNS or Fake-IP, with caching and DNS routing. TUN captures system traffic and manages the corresponding routes and exclusions, with route auditing and an explicit recovery operation. DNS handling and TUN capture are separate configuration choices for desktop, local-network, and gateway deployments.

Configuration and observability

Query status and control the runtime through the CLI, HTTP, or IPC. Inspect sessions, traffic statistics, logs, events, and outbound health to investigate connection problems. Configuration reloads preserve the previous working state when application fails. Connector delivers kernel events to configured webhooks for external accounting and management systems. Configuration and control interfaces use the V1 contract, with capability discovery available to integrations.

Downloads

Platform Archive
Linux x86_64, GNU/glibc zero-linux-x86_64.tar.gz
Linux x86_64, musl zero-linux-x86_64-musl.tar.gz
macOS, Intel zero-darwin-x86_64.tar.gz
macOS, Apple Silicon zero-darwin-aarch64.tar.gz
Windows x86_64 zero-windows-x86_64.zip, including Wintun and its license

Each archive has a matching .sha256 file. Verify the checksum and extract the archive before use.

Getting started

Start with an example configuration, adapt it to your environment, and run:

zero run config.json
zero status --json config.json

Use ZNet Sink for a desktop interface, or ZBoard to manage nodes, users, and subscriptions.

Scope and validation

The five platform builds, automated checks, and published artifact integrity checks passed. Advanced protocol extensions, specialized UDP relay paths, and third-party interoperability have documented limitations; see the capability boundaries.