v2ray节点购买

GUI for SingBox 别下错客户端：下载安装、订阅导入与节点为空排查

更新于 2026-10-24 · v2ray.christmas

简答：GUI for SingBox 的正确流程是先确认客户端和系统架构，再安装 sing-box 内核，导入兼容的订阅或 JSON 出站配置，创建 Profile 后启动内核，最后用系统代理或 TUN 验证连接。若节点为 0，先检查订阅格式和更新结果。

定义：GUI for SingBox 是 GUI-for-Cores 项目的第三方图形界面，用来管理订阅、生成配置并调用 sing-box 内核运行，不等于 sing-box 核心，也不自带节点服务。

先确认客户端：GUI for SingBox 不是官方 sing-box for Desktop

如果你保存订阅后节点数量为 0，或开了系统代理仍然打不开网页，先确认下载的软件名称。本站是第三方使用指南站，不冒充任何客户端项目的官方网站。GUI.for.SingBox 属于 GUI-for-Cores 项目，用图形界面管理订阅、Profile、代理组和配置，并调用 sing-box 内核运行；官方 sing-box 项目另有 sing-box for Desktop，官方客户端列表将它列为 Windows 和 Linux 的桌面客户端。两者的界面、配置入口和权限流程不能混用。详情可查看 GUI.for.Cores 项目手册、sing-box 图形客户端列表 和 sing-box for Desktop 说明。

截至2026年10月24日，GUI.for.SingBox Releases 页面标记为 Latest 的是 v1.27.0。界面可能随发布版本变化，本文使用 Settings、Kernel、Subscriptions、Profiles、Overview 等页面名称说明，实际菜单以当前安装版本为准。

看到的名称它是什么操作原则
GUI.for.SingBoxGUI-for-Cores 项目的图形客户端使用 GUI-for-Cores 文档和 Releases 页面
sing-box for Desktopsing-box 项目维护的桌面客户端使用 sing-box 官方客户端文档
sing-box 核心压缩包命令行核心或内核运行文件不能直接当作图形客户端启动
GUI.for.ClashGUI-for-Cores 项目的另一款图形客户端不要把它的配置入口套到 GUI.for.SingBox

第一步：下载匹配系统的程序并检查文件

优先从 GUI.for.SingBox Releases 下载，不要使用来历不明的二次打包文件。项目安装文档列出的资产包括 Windows-amd64、Windows-arm64、Windows-386、macOS-amd64、macOS-arm64 和 Ubuntu-amd64；如果当前发布页的文件名称有所变化，以 Releases 页面实际资产为准。项目手册明确提醒，除 GitHub Releases 外的下载来源存在安全风险。

  1. 确认系统和架构。Windows 在“设置—系统—系统信息”查看系统类型；macOS 在“关于本机”查看 Intel 或 Apple 芯片；Linux 根据发行版和 CPU 架构选择对应文件。
  2. 解压到独立目录。Windows 和 Linux 路径尽量只使用英文、数字和短横线，避免中文和空格。不要只把主程序复制出来后删除同目录的数据文件。
  3. 确认主程序能写入数据。订阅、配置、内核和缓存都需要保存到应用数据目录；如果目录只读，后续可能出现订阅保存成功但更新失败。
  4. macOS 首次打开。若系统提示无法验证开发者，先取消打开，再到“系统设置—隐私与安全性”中允许该应用，并将程序移动到可写位置后重试。
  5. Windows 先不开 TUN。第一次使用建议先用系统代理完成基础验证，确认订阅和内核正常后，再处理 TUN 权限。

GUI-for-Cores 的安装页列出了不同系统和 CPU 架构的选择方法，具体文件仍应以当前 项目安装文档 和 Releases 页面为准。

第二步：安装或更新 sing-box 内核

GUI.for.SingBox 的图形界面和 sing-box 内核是两个部分。打开 Settings 中的 Kernel 页面，检查本地是否已有可运行内核；如果没有，使用客户端提供的内核下载或更新入口。内核未安装、文件不可执行或配置格式与内核不兼容时，Profile 通常无法正常启动。

  1. 进入 Kernel 页面，确认内核状态不是空白或错误。
  2. 执行安装或更新后，重新打开页面确认文件状态。
  3. 创建 Profile 后启动，先观察日志中的配置加载和监听结果。
  4. 如果启动失败，先记录日志中的第一条错误，再检查内核、配置和端口，不要同时修改 DNS、MTU、TUN 和规则。

不要把 GUI.for.SingBox 的版本号与 sing-box 内核版本号混为一谈。前者对应图形程序发布页，后者对应 Kernel 页面中的内核文件；排查时分别记录。

第三步：准备正确的订阅或本地配置

“订阅链接”不是统一格式。GUI.for.SingBox 的项目指南说明，Subscriptions 至少需要能提供 sing-box 配置中的 outbounds 数据；本地 Manual 方式也可以填写 JSON 出站列表的保存路径。Clash YAML、Base64 节点文本、单条分享链接和完整 sing-box 配置并不等价，不能因为都被称为订阅就直接粘贴到同一个入口。

手里的内容处理方式判断标准
兼容 sing-box 的远程 JSON添加远程订阅后点击 Update订阅卡片显示正确节点数量
本地 JSON 出站列表选择 Manual，填写保存路径更新后能读取 outbounds
完整 sing-box 配置按配置或 Profile 入口导入不能默认当作订阅 URL
Clash YAML先确认来源是否提供 sing-box 格式不能默认直接作为 JSON 使用
Base64 文本或单条分享链接需要来源提供兼容转换结果或本地配置不能默认直接导入
  1. 打开 Quick Start 或 Subscriptions 页面。
  2. 添加订阅名称，粘贴完整 URL，或选择 Manual 填写本地 JSON 路径。
  3. 保存后进入 Subscriptions 页面手动点击 Update。
  4. 确认订阅卡片出现节点数量，再进入 Profile 配置。

项目文档说明，保存远程订阅后，GUI 会获取订阅并读取代理信息；如果获取失败，需要在 Subscriptions 页面手动更新。因此，订阅“保存成功”不等于节点已经读取成功。不要公开完整订阅 URL，也不要把包含令牌的链接提交到不明在线转换站。

以上流程可对照 GUI.for.SingBox 项目指南 中的 Subscriptions Settings 和 工作原理说明。

第四步：创建 Profile、启动内核并验证代理

  1. 创建 Profile。进入 Profiles 页面新建配置，使用容易识别的名称。
  2. 选择模式。Rule 按规则分流，Global 统一使用代理，Direct 直连。首次排查可先用 Rule；需要做对比时临时切换 Global，验证后恢复原模式。
  3. 设置入站。配置 Mixed、HTTP 或 SOCKS5 入站。端口不要套用其他客户端的默认值，应以当前 Profile 的设置页为准。
  4. 配置代理组。把订阅节点加入 Selector 或 URLTest 等代理组。节点显示出来但代理组没有引用它，启动后仍可能无法使用。
  5. 启动 Profile。点击启动或开始运行，等待日志显示配置成功加载、内核启动和监听端口成功。
  6. 开启系统代理。项目文档说明，GUI 默认不会自动配置系统代理，需要在 Overview 页面手动点击 System Proxy；客户端会读取配置中的 HTTP 或 Mixed 端口。
  7. 验证实际流量。查看连接日志是否命中预期策略或出站组，并对比开启前后的出口 IP。只看到内核运行中，不能证明浏览器流量已经经过代理。

系统代理适合支持 HTTP 或 SOCKS 代理设置的应用；TUN 通过虚拟网卡接管更多系统流量，适合没有代理设置入口的程序。TUN 不是首次使用的必选项，先完成系统代理验证更容易区分订阅问题和权限问题。

第五步：节点为空、内核失败和 TUN 失败怎么排查

现象先查什么可执行处理
订阅保存后节点为 0URL 是否完整、返回格式是否兼容、是否完成 Update重新复制 URL，手动更新，确认返回内容包含可识别的 outbounds
节点为空或全灰节点是否加入代理组编辑 Profile，把节点加入 Selector 或 URLTest，再重新生成配置
内核启动失败内核状态、配置生成结果、端口占用更新内核，查看第一条错误，检查端口是否已有监听进程
系统代理开启但浏览器无变化浏览器代理设置、监听端口、策略命中核对端口，查看日志命中情况，对比出口 IP
TUN 启动失败管理员权限、核心授权、其他 TUN 软件按系统补齐权限，关闭冲突客户端后重新启动
能启动但连接不稳定模式、DNS、出口接口、MTU 和节点本身先用 Global 对比，再逐项检查；MTU 先保持当前设置

检查端口占用时，Windows 可在 PowerShell 执行 Get-NetTCPConnection -State Listen，或在命令提示符执行 netstat -ano | findstr LISTENING；Linux 可执行 sudo ss -lntup；macOS 可执行 lsof -nP -iTCP -sTCP:LISTEN。这些命令只能确认本机监听状态，不能证明远程节点可用。

Windows 使用 TUN 时，在 Settings—General 中开启 Run As Admin，退出应用后重新打开，不要只点击应用内部的 Restart。macOS 和 Linux 按项目指南进入 Settings—Kernel—Authorization 授予核心权限。Linux 还要检查程序目录、配置文件和缓存目录对当前用户是否可读写执行。

若系统代理正常而 TUN 失败，优先检查权限、路由、防火墙和虚拟网卡；若 TUN 正常但某个应用无法访问，查看日志中的策略命中、DNS 规则和应用自身代理设置。项目指南还说明，TUN 的 Auto Route、Interface Name、MTU 等选项属于 Profile 设置，应逐项调整，不要一次改动多个变量。

首次使用速查卡与安全清单

从下载到验证的最短路径
阶段通过标准未通过时先查
下载系统、架构和来源正确Releases 页面资产
内核Kernel 页面能识别并运行内核文件和执行权限
订阅Update 后出现节点数量URL、格式和返回内容
Profile代理组引用了订阅节点Selector、URLTest 和出站关系
监听配置端口有进程监听端口占用和配置生成
代理日志命中策略且出口 IP 变化系统代理端口和模式
TUN虚拟网卡和路由正常权限、接口、防火墙和冲突软件
  • 完整订阅 URL 应视为敏感凭据，不要公开粘贴或截图。
  • 程序只从项目 Releases 页面获取，下载后检查系统架构和文件结构。
  • 首次连接先使用系统代理，再考虑 TUN。
  • 多个代理客户端同时运行时，只保留一个程序接管系统代理或 TUN。
  • 升级 GUI 后重新检查内核、订阅、Profile、代理组和端口。
  • 延迟或 URLTest 结果只能作为筛选参考，不等于持续稳定性。

如果仍无法定位，按照“下载文件—内核—订阅更新—Profile—端口—系统代理或 TUN—目标访问”的顺序逐层检查，每次只修改一个设置，并保留对应日志。

常见问题

GUI for SingBox 和 sing-box for Desktop 是同一个软件吗？

不是。GUI.for.SingBox 是 GUI-for-Cores 项目的第三方图形客户端，sing-box for Desktop 是 sing-box 项目维护的另一款桌面客户端。两者的下载页、界面和权限流程不同，不能混用教程。

为什么订阅链接能保存，但节点数量仍然是 0？

保存只代表订阅信息写入本地，不代表内容已经读取成功。进入 Subscriptions 页面手动 Update，检查 URL 是否完整，以及返回内容是否包含兼容 sing-box 的 outbounds 数据。

GUI for SingBox 必须开启 TUN 才能使用吗？

不必须。支持代理设置的应用可以先使用 System Proxy；TUN 主要用于接管没有代理设置入口的程序。启用 TUN 前，应先完成 Windows 管理员权限或 macOS、Linux 核心授权。

节点显示出来了，为什么启动后仍然无法联网？

检查节点是否加入 Profile 的代理组、内核是否启动成功、入站端口是否一致，以及日志是否命中预期策略。可以临时切换 Global 做对比，再恢复 Rule 模式继续排查。

Windows、macOS 和 Linux 的步骤完全一样吗？

主流程相同，但权限不同：Windows 重点检查管理员运行和防火墙，macOS 重点是隐私与安全性放行及核心授权，Linux 重点检查程序、配置和缓存目录的用户权限。

Clash YAML 或 Base64 节点文本能直接导入吗？

不能默认直接导入。GUI.for.SingBox 的订阅入口需要兼容 sing-box 的数据格式；Clash YAML、Base64 文本和单条分享链接应先确认来源是否提供 sing-box 格式或可用的本地 JSON 配置。

相关阅读

参考资料

  1. Releases｜GUI-for-Cores/GUI.for.SingBox
  2. v1.27.0｜GUI-for-Cores/GUI.for.SingBox
  3. GUI.for.Cores Project User Manual（gui-for-cores.github.io）
  4. Installation｜GUI.for.Cores（gui-for-cores.github.io）
  5. A Guide for GUI.for.SingBox｜GUI.for.Cores（gui-for-cores.github.io）
  6. How it works｜GUI.for.Cores（gui-for-cores.github.io）
  7. Graphical Clients｜sing-box
  8. sing-box for Desktop｜sing-box