{"id":33249380,"url":"https://github.com/oneohcloud/onebox","last_synced_at":"2026-05-30T03:01:19.937Z","repository":{"id":282229512,"uuid":"947866420","full_name":"OneOhCloud/OneBox","owner":"OneOhCloud","description":"OneBox is a cross-platform GUI client based on the sing-box kernel. \\n Onebox 是一个基于sing-box 内核的跨平台图形客户端","archived":false,"fork":false,"pushed_at":"2026-05-19T13:50:55.000Z","size":4133,"stargazers_count":609,"open_issues_count":6,"forks_count":30,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-05-19T13:59:33.181Z","etag":null,"topics":["sing-box","sing-box-client","sing-box-desktop","sing-box-ui","tauri-app"],"latest_commit_sha":null,"homepage":"https://sing-box.net","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OneOhCloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.MD","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-13T11:21:52.000Z","updated_at":"2026-05-19T08:36:52.000Z","dependencies_parsed_at":"2026-03-09T14:03:21.679Z","dependency_job_id":null,"html_url":"https://github.com/OneOhCloud/OneBox","commit_stats":null,"previous_names":["oneohcloud/onebox"],"tags_count":94,"template":false,"template_full_name":null,"purl":"pkg:github/OneOhCloud/OneBox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OneOhCloud%2FOneBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OneOhCloud%2FOneBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OneOhCloud%2FOneBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OneOhCloud%2FOneBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OneOhCloud","download_url":"https://codeload.github.com/OneOhCloud/OneBox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OneOhCloud%2FOneBox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33678271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sing-box","sing-box-client","sing-box-desktop","sing-box-ui","tauri-app"],"created_at":"2025-11-16T22:04:03.775Z","updated_at":"2026-05-30T03:01:19.926Z","avatar_url":"https://github.com/OneOhCloud.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./.github/assets/brand/readme-hero.png\" alt=\"OneBox banner\" width=\"100%\"\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"./README_CN.md\"\u003e简体中文\u003c/a\u003e\n    ·\n    \u003ca href=\"#screenshots\"\u003eScreenshots\u003c/a\u003e\n    ·\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\n    ·\n    \u003ca href=\"#download\"\u003eDownload\u003c/a\u003e\n    ·\n    \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/SagerNet/sing-box\"\u003e\u003cimg alt=\"sing-box latest version\" src=\"https://repology.org/badge/version-for-repo/homebrew/sing-box.svg?header=sing-box\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/OneOhCloud/OneBox/releases\"\u003e\u003cimg alt=\"GitHub release\" src=\"https://img.shields.io/github/v/release/OneOhCloud/OneBox?display_name=tag\u0026sort=semver\"\u003e\u003c/a\u003e\n    \u003ca href=\"./LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/badge/license-Apache--2.0-blue\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://play.google.com/store/apps/details?id=cloud.oneoh.networktools\"\u003e\u003cimg alt=\"Get it on Google Play\" src=\"./.github/assets/store/google-play-en.png\" width=\"185\" height=\"56\" align=\"middle\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://apps.apple.com/us/app/oneboxm/id6759716475\"\u003e\u003cimg alt=\"Download on the App Store\" src=\"./.github/assets/store/app-store-en.svg\" width=\"185\" height=\"56\" align=\"middle\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## About\n\nOneBox is a cross-platform desktop client built with Tauri, React, Rust, and the [sing-box](https://github.com/SagerNet/sing-box) network core.\n\nIt 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.\n\n\u003e [!NOTE]\n\u003e 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.\n\n## Screenshots\n\n| Home | Configuration | Settings |\n| :---: | :---: | :---: |\n| \u003cimg src=\"./.github/assets/en/Home.png\" alt=\"OneBox home screen\" width=\"240\"\u003e | \u003cimg src=\"./.github/assets/en/Config.png\" alt=\"OneBox configuration screen\" width=\"240\"\u003e | \u003cimg src=\"./.github/assets/en/Settings.png\" alt=\"OneBox settings screen\" width=\"240\"\u003e |\n\n## Features\n\n| Capability | What OneBox does |\n| --- | --- |\n| Subscription-first workflow | Imports remote configuration links, tracks traffic metadata, refreshes subscriptions, and supports deep-link based setup. |\n| Route modes | Provides mixed and TUN modes with rule/global templates maintained for supported sing-box versions. |\n| System integration | Includes tray controls, system proxy helpers, autostart, updater flow, and platform-specific service handling. |\n| Privacy-conscious storage | Stores sensitive values through system-backed mechanisms instead of treating secrets as plain UI state. |\n| Developer visibility | Ships log, generated config, and config-template views for debugging without exposing casual users to noise. |\n| Built on Rust and Tauri | Keeps the desktop shell lightweight while delegating network execution to the sing-box core. |\n\n\u003e [!WARNING]\n\u003e 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.\n\n## Platform Support\n\n| Tier | Platform | Status |\n| --- | --- | --- |\n| Tier 1: Official | macOS | Production-ready and maintained by the core team with priority fixes. |\n| Tier 2: Community | Windows, Ubuntu | Stable, with fixes and feature parity depending on community maintenance. |\n| Tier 3: Experimental | Linux | Beta quality. Expect incomplete behavior and use at your own risk. |\n\n## Download\n\nGet the latest build from the [GitHub Releases page](https://github.com/OneOhCloud/OneBox/releases), or install the mobile companion from the store badges above.\n\nThe macOS build is notarized by Apple, so it can be installed without manual security overrides.\n\n## Development\n\nInstall dependencies:\n\n```bash\nbun install\n```\n\nStart the desktop frontend during development:\n\n```bash\nbun run dev\n```\n\nBuild the web bundle:\n\n```bash\nbun run build\n```\n\nRun the frontend test suite:\n\n```bash\nbun run test\n```\n\nRun Rust tests with captured output shown:\n\n```bash\ncargo test -- --nocapture\n```\n\n## Project Notes\n\n- Config templates are synchronized before `dev` and `build` through `scripts/sync-templates.ts`.\n- The Windows TUN service is built through `scripts/build-tun-service.ts`.\n- Platform-specific Tauri settings live under `src-tauri/tauri.*.conf.json`.\n- Human-facing protocol notes are available under `docs/spec/zh/`.\n\n## License \u0026 Brand Usage\n\nThis software is licensed under the [Apache License 2.0](./LICENSE).\n\nThe **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](./NOTICE) policy.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foneohcloud%2Fonebox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foneohcloud%2Fonebox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foneohcloud%2Fonebox/lists"}