sing-box-windows
From public sources🚀 Modern cross-platform desktop client for sing-box|Subscription import, proxy mode switching, runtime monitoring, tray auto-start|Built on Tauri 2 + Vue 3 + Rust|🪟 Windows / 🐧 Linux / 🍎 macOS. A modern cross-platform sing-box GUI client built with Tauri 2 + Vue 3 + Rust, with TUN/system proxy modes and multi-language UI.
Machine translation · Show original
🚀 现代化 sing-box 跨平台桌面客户端|订阅导入・代理模式切换・运行态监控・托盘自动启动|基于 Tauri 2 + Vue 3 + Rust|🪟 Windows / 🐧 Linux / 🍎 macOS。A modern cross-platform sing-box GUI client built with Tauri 2 + Vue 3 + Rust, with TUN/system proxy modes and multi-language UI.
Overview
- cross-platform
- desktop-app
- proxy
- rust
- sing-box
- sing-box-client
- sing-box-ui
- subscription
- tauri
- vue
Installation
Commands are shown, never run by the marketplace. Check them against the official documentation.- Official release filesFrom public sourcesfrom the latest official releasegithub.com/xinggaoya/sing-box-windows/releases/tag/v2.3.2 ↗
- Build from sourceFrom public sourcesfrom catalog metadata
Build from source: no validated build recipe — follow the repository instructions.
github.com/xinggaoya/sing-box-windows ↗
Compatibility
Unknown means no evidence was found — not that the product is incompatible.| Platform | Status | Architecture | Evidence | Confidence |
|---|---|---|---|---|
| Windows | Compatible | arm64 | official build in release v2.3.2: sing-box-windows_2.3.2_arm64-setup.exe | 0.70 |
| Compatible | x86_64 | official build in release v2.3.2: sing-box-windows_2.3.2_x64-setup.exe | 0.70 | |
| Compatible | — | official build in release v2.3.2: sing-box-windows-portable.zip | 0.60 | |
| macOS | Compatible | x86_64 | official build in release v2.3.2: sing-box-windows_2.3.2_x64-macos-intel.dmg | 0.70 |
| Compatible | arm64 | official build in release v2.3.2: sing-box-windows_2.3.2_aarch64-macos-arm64.dmg | 0.70 | |
| Linux | Compatible | x86_64 | official build in release v2.3.2: sing-box-windows-2.3.2-1.x86_64.rpm | 0.70 |
Releases
checked Oct 29, 2026Files in 2.3.2
| File | Platform | Size | SHA-256 | Download from the official source |
|---|---|---|---|---|
| sing-box-windows-2.3.2-1.x86_64.rpm | linux · x86_64 · rpm | 41.3 MB | b4c481361534… | Official source ↗ |
| sing-box-windows-arm64-portable.zip | windows · arm64 · zip | 9.6 MB | 4fbca7683373… | Official source ↗ |
| sing-box-windows-portable.zip | windows · zip | 10.2 MB | c5cd09afbd18… | Official source ↗ |
| sing-box-windows_2.3.2_aarch64-macos-arm64.dmg | macos · arm64 · dmg | 37.9 MB | 0ffc43bb5baa… | Official source ↗ |
| sing-box-windows_2.3.2_amd64.AppImage | linux · x86_64 · appimage | 111 MB | 36dba8f81f3b… | Official source ↗ |
| sing-box-windows_2.3.2_amd64.deb | linux · x86_64 · deb | 41.3 MB | 384fff7b97cb… | Official source ↗ |
| sing-box-windows_2.3.2_arm64-setup.exe | windows · arm64 · exe | 22.1 MB | 854c65fb4d9f… | Official source ↗ |
| sing-box-windows_2.3.2_arm64_en-US.msi | windows · arm64 · msi | 32.8 MB | 80a4f1fc1b14… | Official source ↗ |
| sing-box-windows_2.3.2_x64-macos-intel.dmg | macos · x86_64 · dmg | 40.4 MB | 70bd63ce8f9b… | Official source ↗ |
| sing-box-windows_2.3.2_x64-setup.exe | windows · x86_64 · exe | 25.9 MB | be046d12787c… | Official source ↗ |
| sing-box-windows_2.3.2_x64_en-US.msi | windows · x86_64 · msi | 36.4 MB | f695d8d91052… | Official source ↗ |
Release history
- v2.3.1Jun 17, 2026Official source ↗
- v2.3.0Apr 26, 2026Official source ↗
- v2.2.9Apr 4, 2026Official source ↗
- v2.2.8Mar 21, 2026Official source ↗
- v2.2.6Mar 5, 2026Official source ↗
- v2.2.5Mar 2, 2026Official source ↗
- v2.2.4Feb 12, 2026Official source ↗
Quality profile
algorithm quality-v1.0 · assessed Oct 15, 2026Score components
License
MITThis is the catalog policy status, not legal advice.
Sources
Reviews
No reviews yet.
Alternatives
README
From xinggaoya/sing-box-windows · license MIT · fetched Oct 29, 2026Overview
Sing-Box Windows is a modern desktop client built around the sing-box core. It provides a cleaner workflow for importing subscriptions, switching proxy modes, inspecting runtime state, and managing desktop integration across Windows, Linux, and macOS.
Android users can also check sing-box-windows-android.
Features
- Subscription import: Supports sing-box JSON, Clash/Mihomo YAML, and URI list input (including
tuic://andanytls://). - Proxy modes: Switch between system proxy, TUN mode, and manual mode.
- Runtime visibility: Monitor traffic, active connections, rules, and logs in real time.
- Kernel management: Built-in kernel resource pipeline, version download, and manual kernel import.
- Desktop integration: Tray mode, auto-start, hide-to-tray on autostart, lightweight mode (destroy the main window on close), update checks, and window state persistence.
- Reliability tools: Backup/restore, subscription rollback, update channels, self-heal restart logic, and structured startup diagnostics with actionable failure hints.
- Settings navigation: Tabbed settings grouped by use case (basic preferences, kernel, network/advanced, maintenance, about).
- Localization: Built-in
zh-CN,en-US,ja-JP, andru-RU.
Architecture
- Frontend: Vue 3 + TypeScript + Pinia + Vue Router + Vue I18n + Naive UI.
- Bridge layer: Tauri
invokecommands for request/response, Tauri events for runtime updates. - Backend: Rust + Tauri 2, with modules split into
core,network,storage,system, andtray. - Storage: SQLite-backed local persistence for app settings, subscriptions, locale, theme, and update preferences.
- Build pipeline:
scripts/tauri-wrapper.mjsinjects target-specific kernel resources beforetauri dev/build.
Supported Subscription Formats
| Format | Input | Notes |
|---|---|---|
| sing-box JSON | Raw JSON config | Parses top-level outbounds |
| Clash / Mihomo YAML | YAML subscription | Parses proxies and converts supported nodes |
| URI list | vmess://, vless://, trojan://, ss://, hysteria2://, tuic://, anytls:// | Supports one or multiple nodes |
Supported node types currently include vless, vmess, trojan, shadowsocks, shadowsocksr, socks, http, hysteria2, tuic, and anytls.
Quick Start
- Download the latest package from GitHub Releases.
- Import a subscription on the Subscription page.
- Pick a node on the Proxy page and choose a proxy mode.
- Start the kernel from Home and verify traffic or connections in the related pages.
Screenshots
Development
# Install dependencies
pnpm install
# Recommended on first setup; dev/build also auto-fetches when missing
pnpm kernel:fetch
# Start desktop development
pnpm tauri dev
# Frontend checks
pnpm type-check
pnpm lint
# Backend checks
cd src-tauri && cargo clippy && cargo test
# Build release bundles
pnpm tauri build
Local Data Directory
All data stays on the local machine.
- Windows:
%LOCALAPPDATA%\sing-box-windows\ - Linux:
~/.local/share/sing-box-windows/ - macOS:
~/Library/Application Support/sing-box-windows/
The directory typically contains the SQLite database, generated configs, logs, backups, and downloaded kernel metadata.
Documentation
Contributing
Issues and pull requests are welcome.
- Report bugs in Issues
- Propose ideas in Discussions
- Keep changes aligned with existing architecture and quality gates