跳到主要内容
项目档案应用项目

xinggaoya/sing-box-windows 是什么?用途、安装与使用指南

Sing-Box Windows 是基于 Tauri 2 + Vue 3 的现代化桌面客户端,为 sing-box 提供图形界面。支持 Windows、Linux、macOS 系统,提供订阅导入、代理模式切换、实时流量监控等功能。本页包含项目介绍、安装下载、使用教程及技术架构说明。

889RustStar 于 2026年1月15日2026年9月18日 更新

AI 总结

Sing-Box Windows 是基于 Tauri 2 + Vue 3 开发的跨平台桌面客户端,为 sing-box 代理核心提供图形化界面,支持订阅导入、代理模式切换、实时流量监控与桌面集成,覆盖 Windows、Linux、macOS 系统。

中文项目介绍

Sing-Box Windows 是专为 sing-box 代理核心设计的现代化跨平台桌面客户端,旨在降低用户使用门槛,提供直观的图形化操作界面。 项目解决了 sing-box 命令行工具配置复杂、不易监控的问题,将订阅管理、代理切换、状态监控等操作可视化,使用户无需记忆命令即可完成日常使用。 适用于需要图形化管理代理配置的跨平台用户,特别是那些希望集中管理多种订阅格式(sing-box JSON、Clash YAML、URI 列表)、实时查看流量与连接状态、并享受系统托盘、自动启动等桌面集成功能的场景。 技术层面,项目采用 Tauri 2 + Vue 3 架构,前端使用 Naive UI 组件库与 Pinia 状态管理,后端 Rust 模块按核心、网络、存储、系统、托盘分层设计,通过 Tauri invoke 与 events 实现双向通信,并利用 SQLite 在本地持久化配置、订阅与日志数据,确保数据安全与离线可用。

详细信息与使用说明

1. 项目定位与用途

Sing-Box Windows 是一款专为 sing-box 代理核心设计的现代化跨平台桌面客户端,通过图形化界面简化配置管理与操作流程。项目提供订阅导入、代理模式切换、运行态监控、内核管理及桌面集成等功能,使用户无需命令行即可高效使用 sing-box。适用于 Windows、Linux、macOS 系统,是 sing-box 官方命令行工具的友好图形前端,旨在提升用户体验与操作效率。

2. 解决的问题

项目主要解决 sing-box 命令行工具配置复杂、学习成本高的问题,以及缺乏直观的运行状态监控与桌面集成能力。通过图形界面将订阅解析、节点选择、模式切换、流量统计、日志查看等操作可视化,并内置内核资源管理与自动更新机制,显著降低使用门槛,提升可靠性与用户体验,让代理管理更简单、更直观。

3. 适用场景

主要面向需要图形化界面管理代理配置的跨平台用户;需要导入和管理多种格式订阅(sing-box JSON、Clash YAML、URI 列表)的用户;需要实时监控流量、连接、规则匹配与日志的用户;希望实现系统代理/TUN 模式切换、托盘控制、自动启动等桌面集成的用户。适合个人及小型团队在桌面环境中稳定使用代理服务,尤其适合不熟悉命令行的用户。

4. 安装方式

从 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 启动开发服务器。仓库中未明确给出命令行直接安装的脚本,仅提供图形安装包。

5. 使用方式

启动应用后,在 Subscription 页面导入订阅配置(支持粘贴 JSON/YAML 或 URI 列表);在 Proxy 页面选择节点并设置代理模式(系统代理、TUN 或手动);在 Home 页面启动 sing-box 内核;通过 Runtime、Connections、Rules、Logs 页面监控实时状态;在 Settings 页面配置自动启动、更新检查、语言等偏好。托盘模式支持最小化到系统托盘并快速切换节点。具体操作可参考 README 中的 Quick Start 部分。

6. 补充说明与实现特点

项目数据完全本地存储,不依赖云端服务。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 包装,负责在编译前注入目标平台的内核资源,确保各平台正确打包。

思维导图

Sing-Box Windows
前端 UI 层
Vue 3 + Naive UI
Pinia 状态管理
Vue Router 路由
Vue I18n 国际化
桥接层
Tauri invoke 命令
Tauri events 事件
后端核心层
core 模块(内核生命周期)
network 模块(订阅处理)
订阅网络层
订阅下载
格式解析(JSON/YAML/URI)
自动更新
配置回滚
存储层
SQLite 数据库
配置持久化
订阅存储
日志记录
系统与托盘层
系统代理
TUN 模式
自动启动
更新检查
托盘菜单
备份恢复
构建脚本层
tauri-wrapper.mjs
内核资源注入
开发/构建命令

常见问题

Sing-Box Windows 支持哪些操作系统平台?

项目支持 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 数据库、配置、日志及备份文件。

如何更新 sing-box 内核版本?

应用内置内核资源管道,可自动检测并下载最新内核版本;同时支持手动导入内核文件。开发环境下可通过 pnpm kernel:fetch 命令获取内核资源。

项目是否开源?使用什么许可证?

项目完全开源,代码托管于 GitHub,采用 MIT 许可证,允许自由使用、修改与分发。