GitHubHelp

KIDA-MNESIA/sing-boot

一个简单的windows sing-box裸核启动工具

★ 0Forks 0C#GitHub ↗Compare

README

sing-boot

Windows 系统托盘工具，用于在后台运行和管理 sing-box。

运行环境为 Windows x64 和 .NET Framework 4.8。

功能

  • 托盘图标显示运行状态
  • 左键点击或右键菜单控制启动/停止
  • 开机自启动
  • 自动识别同目录 sing-box 部署
  • 自动保存核心 stdout 到 logs/ 目录

安装

  1. 从 Releases 下载 sing-boot.exe
  2. 准备 sing-box 核心文件
  3. 将核心和配置按下面的布局放在 sing-boot.exe 同目录
  4. 运行 sing-boot.exe，托盘区会出现图标

sing-box 部署

sing-boot.exe
sing-box.exe
config.json

sing-box 仍使用 sing-box run -c stdin，程序会读取并规范化同目录 config.json 后通过 stdin 传给核心。JSONC 支持注释和对象、数组内的尾随逗号；其他非法 JSON 会被拒绝，不会被自动改写。

配置

程序启动核心前会自动识别同目录的 sing-box.exe 和 config.json。修改配置后需先停止再启动才能生效。

日志

日志会按天追加保存到程序同目录的 logs/ 文件夹：

logs/<core>-stdout-yyyy-MM-dd.log
logs/sing-boot-yyyy-MM-dd.log

<core>-stdout 文件仅包含核心进程写出的 stdout。sing-boot 日志记录启动模式、自动恢复判定、默认网关等待、提权前的启动准备和退出时是否保留恢复意图，不记录完整代理配置。

开机自启

在右键菜单中勾选「Auto-start」即可启用。

启用后，成功接受核心启动请求会记住“应保持运行”的意图，下次开机会在可用的 IPv4 默认网关稳定后自动启动。只有明确点击 Stop、Quit 或取消「Auto-start」才会清除该意图；系统关机不会再根据关机瞬间的进程状态覆盖它。

等待网络期间取消「Auto-start」会同时取消本次待执行的自动启动。

开发

需要 Windows、.NET 8 或更高版本 SDK，以及 .NET Framework 4.8 targeting pack。

dotnet restore src/SingBoot.sln
dotnet build src/SingBoot.sln -c Release
dotnet test src/SingBoot.sln -c Release
dotnet publish src/SingBoot/SingBoot.csproj -c Release

发布结果位于 publish/。除系统提供的 .NET Framework 4.8 外，sing-boot.exe 无第三方运行时依赖，部署时只需复制该 EXE。GitHub Actions 会在 push、pull request 和手工发布前执行 Release 构建与测试。

注意

  • TUN 模式需要管理员权限，启动时会弹出 UAC 提示
  • 崩溃或强制结束时，受管理的核心进程也会一同终止
  • sing-box 配置请参考 sing-box 官方文档

Contributors

KIDA-MNESIA

Issues