1. 项目定位与用途
Sing-Box Windows 是一款专为 sing-box 代理核心设计的现代化跨平台桌面客户端,通过图形化界面简化配置管理与操作流程。项目提供订阅导入、代理模式切换、运行态监控、内核管理及桌面集成等功能,使用户无需命令行即可高效使用 sing-box。适用于 Windows、Linux、macOS 系统,是 sing-box 官方命令行工具的友好图形前端,旨在提升用户体验与操作效率。
Sing-Box Windows 是基于 Tauri 2 + Vue 3 的现代化桌面客户端,为 sing-box 提供图形界面。支持 Windows、Linux、macOS 系统,提供订阅导入、代理模式切换、实时流量监控等功能。本页包含项目介绍、安装下载、使用教程及技术架构说明。
Sing-Box Windows 是基于 Tauri 2 + Vue 3 开发的跨平台桌面客户端,为 sing-box 代理核心提供图形化界面,支持订阅导入、代理模式切换、实时流量监控与桌面集成,覆盖 Windows、Linux、macOS 系统。
Sing-Box Windows 是一款专为 sing-box 代理核心设计的现代化跨平台桌面客户端,通过图形化界面简化配置管理与操作流程。项目提供订阅导入、代理模式切换、运行态监控、内核管理及桌面集成等功能,使用户无需命令行即可高效使用 sing-box。适用于 Windows、Linux、macOS 系统,是 sing-box 官方命令行工具的友好图形前端,旨在提升用户体验与操作效率。
项目主要解决 sing-box 命令行工具配置复杂、学习成本高的问题,以及缺乏直观的运行状态监控与桌面集成能力。通过图形界面将订阅解析、节点选择、模式切换、流量统计、日志查看等操作可视化,并内置内核资源管理与自动更新机制,显著降低使用门槛,提升可靠性与用户体验,让代理管理更简单、更直观。
主要面向需要图形化界面管理代理配置的跨平台用户;需要导入和管理多种格式订阅(sing-box JSON、Clash YAML、URI 列表)的用户;需要实时监控流量、连接、规则匹配与日志的用户;希望实现系统代理/TUN 模式切换、托盘控制、自动启动等桌面集成的用户。适合个人及小型团队在桌面环境中稳定使用代理服务,尤其适合不熟悉命令行的用户。
从 GitHub Releases 页面(https://github.com/xinggaoya/sing-box-windows/releases)下载对应平台的安装包(Windows 为 .msi/.exe,Linux 为 .rpm/.deb 等,macOS 为 .dmg)。运行安装包按向导完成安装即可。开发环境需先安装 Node.js 与 pnpm,然后执行 pnpm install 安装依赖,再通过 pnpm tauri dev 启动开发服务器。仓库中未明确给出命令行直接安装的脚本,仅提供图形安装包。
启动应用后,在 Subscription 页面导入订阅配置(支持粘贴 JSON/YAML 或 URI 列表);在 Proxy 页面选择节点并设置代理模式(系统代理、TUN 或手动);在 Home 页面启动 sing-box 内核;通过 Runtime、Connections、Rules、Logs 页面监控实时状态;在 Settings 页面配置自动启动、更新检查、语言等偏好。托盘模式支持最小化到系统托盘并快速切换节点。具体操作可参考 README 中的 Quick Start 部分。
项目数据完全本地存储,不依赖云端服务。Windows 数据目录为 %LOCALAPPDATA%\sing-box-windows\,Linux 为 ~/.local/share/sing-box-windows/,macOS 为 ~/Library/Application Support/sing-box-windows/,包含 SQLite 数据库、生成配置、日志、备份及内核元数据。内置多语言支持(zh-CN、en-US、ja-JP、ru-RU),并遵循 MIT 许可证开源。构建流程由 scripts/tauri-wrapper.mjs 包装,负责在编译前注入目标平台的内核资源,确保各平台正确打包。
项目支持 Windows、Linux、macOS 三大桌面平台,并提供对应平台的安装包(.msi/.exe、.rpm/.deb、.dmg),确保跨平台一致性体验。
在应用的 Subscription 页面中,支持直接粘贴 sing-box JSON 格式、Clash/Mihomo YAML 格式或 URI 列表(如 vmess://、vless:// 等),系统会自动解析并转换为可用节点。
所有数据均本地存储:Windows 在 %LOCALAPPDATA%\sing-box-windows\,Linux 在 ~/.local/share/sing-box-windows/,macOS 在 ~/Library/Application Support/sing-box-windows/,包含 SQLite 数据库、配置、日志及备份文件。
应用内置内核资源管道,可自动检测并下载最新内核版本;同时支持手动导入内核文件。开发环境下可通过 pnpm kernel:fetch 命令获取内核资源。
项目完全开源,代码托管于 GitHub,采用 MIT 许可证,允许自由使用、修改与分发。