sing-box
安装与使用指南
了解 sing-box 图形客户端、远程配置和日常连接管理。 涵盖安装、订阅导入、日常使用与问题排查。
准备好，再开始
- 一个可登录的 WahooVPN 账号，以及有效的套餐与剩余流量。
- 为当前设备创建独立订阅链接，格式选择 sing-box JSON。
- 安装第三方客户端期间，不要把账号密码交给陌生人。
本教程使用 sing-box JSON 远程配置，不能直接将 Clash YAML 或 V2Ray 节点列表作为完整 JSON 配置导入。核心版本与配置字段必须匹配；VLESS、REALITY、XHTTP 等具体传输能力还需逐项核验。本教程未完成 WahooVPN 订阅的跨平台实机验证。
选择系统对应的图形客户端
按设备系统打开下方官方说明，选择适配设备的图形客户端并安装。各平台界面和授权方式不同。
sing-box 是代理核心，也有面向不同系统的图形客户端。Android 可按官方页面选择 SFA；iOS / macOS 按 Apple 平台页面下载对应应用；Windows 使用桌面客户端页面。系统版本、架构及下载渠道以对应官方页面为准，不要只下载命令行核心就期待出现图形界面。
获取 sing-box 格式订阅
登录 WahooVPN「订阅链接」管理页，选择 sing-box 格式，创建后复制完整 URL。请使用服务端提供的配置，不要将敏感链接交给在线转换工具。
打开 WahooVPN 订阅管理链接仅在创建时完整显示。丢失或泄露时在后台管理旧链接并创建新链接。
添加 Remote 远程配置
进入客户端的配置 / Profiles 页面，新建配置并选择 Remote / 远程类型，填写名称和订阅 URL 后保存。具体按钮名称以所安装客户端版本为准。
下载配置并设为当前配置
更新或下载该远程配置，确认没有 JSON 解析、未知字段或下载错误，再将它选为当前配置。若报错，先核对 sing-box 格式和核心版本。
启动服务并选择出口
启动当前配置，按系统提示允许所需的 VPN 或网络权限。配置包含可选择的出站组时，可在仪表盘中选择节点；分组和模式选项取决于配置内容。
验证目标网站和日常应用
检查服务状态及错误信息，访问目标网站，再测试本地常用网站。服务显示运行只代表配置已启动，仍需确认实际连接和分流效果。
日常使用指南
连接以后，按需要切换节点、维护订阅并检查路由设置。
维护远程配置
- 节点需要刷新时，在原远程配置上执行更新，并查看是否成功。
- 自动更新能力和间隔以客户端设置为准，必要时手动更新后重新选择当前配置。
- 不要直接编辑远程配置作为长期定制方案，后续下载可能覆盖本地修改。
理解模式与节点分组
- 只有配置中定义了对应模式与可选择出站组，仪表盘才会提供相关选项。
- 看到节点分组时，确认当前选择是你打算使用的出口；没有分组时先查看配置是否设计为固定出口。
- 不要把其他客户端的规则模式、全局模式菜单名称机械套用到所有 sing-box 客户端。
升级前核对核心与配置
- 在客户端信息中记录实际 sing-box 核心版本，阅读官方变更和迁移说明后再升级。
- 遇到未知或弃用字段时，核对服务端输出与核心版本，不要任意删除字段让配置勉强加载。
- 需要帮助时只提供脱敏报错、应用版本和系统信息，不要分享整个配置或订阅 URL。
遇到问题？先检查这些。
sing-box 为什么提示 JSON 解析失败或未知字段？
先确认后台选择的是 sing-box 格式，再核对配置所需核心版本。Clash YAML、V2Ray 节点列表和完整 sing-box JSON 不是同一格式。保留脱敏错误信息供排查，不要跳过校验。
为什么没有节点选择或模式切换？
仪表盘选项取决于配置是否定义了相应的出站组和模式。没有这些配置时，不能仅靠客户端界面生成。先确认远程配置正确加载并已启用。
下载后为什么找不到图形界面？
sing-box 命令行核心与图形客户端是不同发行物。请回到对应平台官方客户端页面，按系统和架构选择图形应用，不要使用第三方重新打包的安装程序。
什么是订阅链接？
订阅链接是机场服务商提供给用户的专属配置地址，里面包含节点信息、线路配置、流量套餐等内容。
通用代理软件和 WahooVPN App 有什么区别？
两者使用相同的 WahooVPN 服务器资源，主要区别在于使用方式和功能。WahooVPN App 是官方应用，登录账号后即可一键连接，支持自动选线、智能分流等功能。通用代理软件（如 Clash、v2rayN）通过导入订阅链接获取服务器配置，无需登录 WahooVPN 账号，具体功能取决于软件本身。
新手应该选择哪个客户端？
对于新手，可以按设备选择一款客户端：iOS 使用 Shadowrocket，Android 使用 v2rayNG，macOS 和 Windows 使用 Clash Verge Rev。选好 App 后，打开本站对应的客户端教程，我们会根据 App 自动提供匹配的订阅格式。
更新失败或节点列表为空怎么办？
检查 URL 是否完整、格式是否匹配，以及订阅链接是否启用、过期或撤销。再检查账户有效期与剩余流量。确认当前网络可访问订阅服务，不要将凭证粘贴到第三方在线检测工具。
导入成功，为什么仍然无法连接？
先确认选中了活动节点并启动代理，再检查系统代理或 VPN 权限、路由和其他 VPN 冲突。某些节点可能使用当前核心不支持的传输参数；订阅解析成功不等于协议兼容。
系统代理和 TUN 有什么区别？
系统代理供遵循系统代理设置的应用使用。TUN 通过虚拟网络接口处理流量，通常需要额外权限；实际接管范围仍受路由与应用排除规则影响，不保证所有流量都会经过代理。
链接丢失、泄露或到期了怎么办？
完整链接仅在创建时显示。丢失时请新建链接；怀疑泄露时在管理页撤销旧链接，再创建并导入新链接。撤销不可恢复。链接有效期与账户套餐有效期分别检查。
教程依据与验证状态
文字参考客户端官方资料整理。本文尚未完成对应设备的实机验证；界面名称可能随版本变化，真实操作截图与测试版本记录待补充。
查看客户端官方资料