github.com/OneOhCloud/OneBox @v1.4.35

<a href="https://github.com/OneOhCloud/OneBox/raw/v1.4.35/README_CN.md">简体中文</a>
·
<a href="#screenshots">Screenshots</a>
·
<a href="#features">Features</a>
·
<a href="#download">Download</a>
·
<a href="#development">Development</a>







<a href="https://github.com/SagerNet/sing-box"><img alt="sing-box latest version" src="https://repology.org/badge/version-for-repo/homebrew/sing-box.svg?header=sing-box"></a>
<a href="https://github.com/OneOhCloud/OneBox/releases"><img alt="GitHub release" src="https://img.shields.io/github/v/release/OneOhCloud/OneBox?display_name=tag&sort=semver"></a>
<a href="https://github.com/OneOhCloud/OneBox/raw/v1.4.35/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue"></a>







<a href="https://play.google.com/store/apps/details?id=cloud.oneoh.networktools"><img alt="Get it on Google Play" src="https://github.com/OneOhCloud/OneBox/raw/v1.4.35/github/assets/store/google-play-en.png" width="185" height="56" align="middle"></a>
<a href="https://apps.apple.com/us/app/oneboxm/id6759716475"><img alt="Download on the App Store" src="https://github.com/OneOhCloud/OneBox/raw/v1.4.35/github/assets/store/app-store-en.svg" width="185" height="56" align="middle"></a>

About

OneBox is a cross-platform desktop client built with Tauri, React, Rust, and the sing-box network core.

It is designed for people who want a clean daily-driver client instead of a configuration workshop: add a subscription, pick a route mode, start the service, and let the app handle the platform details.

[!NOTE] OneBox is not a playground for wish-list driven sing-box customization. Requests for full manual control, endless knobs, or niche behavior are out of scope, and related PRs are not guaranteed to be accepted. If you need that workflow, fork the project, build your own copy, and maintain it yourself.

Screenshots

Home	Configuration	Settings

Features

[!WARNING] OneBox applies multiple security and privacy controls, but vulnerabilities in the underlying network core are handled by the upstream sing-box project. Track upstream advisories when assessing operational risk.

Platform Support

Download

Get the latest build from the GitHub Releases page, or install the mobile companion from the store badges above.

The macOS build is notarized by Apple, so it can be installed without manual security overrides.

Development

Install dependencies:

deno install
deno task prepare

Start the desktop frontend during development:

deno task tauri dev

Build the web bundle:

deno task build

Run the frontend test suite:

deno task test

Run Rust tests with captured output shown:

cargo test -- --nocapture

Project Notes

• Config templates are synchronized before dev and build through scripts/sync-templates.ts.
• The Windows TUN service is built through scripts/build-tun-service.ts.
• Platform-specific Tauri settings live under src-tauri/tauri.*.conf.json.
• Human-facing protocol notes are available under docs/spec/zh/.

License & Brand Usage

This software is licensed under the Apache License 2.0.

The OneBox name, logos, icons, and other brand assets are proprietary assets of OneOh Cloud LLC. The Apache License does not grant permission to use those branding elements in derivative works. Any use of these assets or the product name must follow the NOTICE policy.