Tutorial
GUI.for.SingBox 新手完整使用教程
GUI.for.SingBox 的新手路径按真实第一次使用写：先装对软件，导入 sing-box 配置，选择基本模式，启动代理，再用 52.mk IP 检测确认出口。
先跑通
只用这 6 步跑通
先照这 6 步做。配置能启动以后，再看 JSON、入站、出站、路由和日志。
01
安装核对
GUI.for.SingBox 是 sing-box 图形壳，先确认客户端和内核能正常启动。
02
复制订阅
机场后台找 sing-box 配置，不要复制登录页、付款页或邀请链接。
03
导入配置
导入机场提供的 sing-box 配置，或在界面里生成配置；Clash 订阅通常不能直接当 sing-box JSON。
04
选择模式
先保留默认出站和规则，把一个 Selector 或默认出站跑通。
05
启动代理
启动核心后确认本机监听端口和系统代理状态，再测试浏览器。
06
IP 检测
用 IP 检测确认出口，日志里没有 JSON 解析错误才算配置被正确读取。
准备工作
默认先看 Windows / macOS / Linux 桌面端
准备 sing-box 配置，确认它和 GUI.for.SingBox 的格式匹配。
下载或打开入口优先看 GitHub Releases / GUI.for.Cores 文档，不要从不明网盘或二次打包站开始。
准备 52.mk IP 检测页，用来确认出口 IP、DNS、共享人数和服务连通性。
操作步骤
按顺序操作，出问题时回到当前步骤的检查点，不要同时改多个地方。
Step 1
下载和准备
先把软件定位、设备路径和配置格式分清楚。
1.1
确认软件定位和下载来源
GUI.for.SingBox 是 sing-box 图形壳，先确认客户端和内核能正常启动。
点哪里
点哪里：打开 GitHub Releases / GUI.for.Cores 文档 或软件详情页，核对名称、平台、维护状态和下载入口。
成功标志
成功标志：设备上能打开 GUI.for.SingBox，并且能看到配置、Profile、订阅或状态入口。
卡住先查
卡住先查：下载前先看系统版本、CPU 架构、移动端权限和官方发布页说明。
这个客户端适合愿意理解 sing-box 的人；纯新手如果只有 Clash 订阅，先用 Hiddify 或 Clash 系客户端更省心。
下载前核对
本图看哪里
图源：52.mk 站内步骤图
1.2
准备正确的配置格式
导入机场提供的 sing-box 配置，或在界面里生成配置；Clash 订阅通常不能直接当 sing-box JSON。
点哪里
点哪里：机场后台找 sing-box 配置，优先复制当前软件明确支持的订阅入口。
成功标志
成功标志：你手里有一条完整订阅 URL、二维码或 sing-box 配置 文件。
卡住先查
卡住先查：如果只有登录页、付款页、邀请链接或截图，就还没有拿到可导入配置。
订阅链接要当密码保管，不要发到公开群里排错。
配置来源
本图看哪里
图源：52.mk 站内步骤图
Step 2
导入配置和选择模式
先用最少变量跑通，不要一开始研究高级功能。
2.1
导入配置
导入机场提供的 sing-box 配置，或在界面里生成配置；Clash 订阅通常不能直接当 sing-box JSON。
点哪里
点哪里：Profiles、Config、订阅管理、Add Profile 或 Import from URL。
成功标志
成功标志：节点、策略组、Profile 或配置名称已经出现在客户端里。
卡住先查
卡住先查：导入为空时先检查链接是否完整、订阅是否过期、当前网络能否访问订阅域名。
导入成功不等于已经接管流量，后面还要启动代理层。
导入配置
本图看哪里
图源：52.mk 站内步骤图
2.2
选择基础模式和节点
先保留默认出站和规则，把一个 Selector 或默认出站跑通。
点哪里
点哪里：Mode、Proxies、策略组、Selector、Auto 或主代理组。
成功标志
成功标志：你能说清当前是规则模式、全局模式、直连模式还是只监听本地端口。
卡住先查
卡住先查：如果停在 Direct / 直连，或者没有任何入站端口，实际流量可能没有经过代理。
新手先只改一个主代理组或一个模式，不要同时动 DNS、规则集、脚本和 TUN。
模式和节点
本图看哪里
图源：52.mk 站内步骤图
Step 3
启动和验证
启动以后用真实出口说话，不只看按钮颜色。
3.1
启动代理层
启动核心后确认本机监听端口和系统代理状态，再测试浏览器。
点哪里
点哪里：连接按钮、START、System Proxy、TUN、VPN 权限或 Enabled。
成功标志
成功标志：系统出现 VPN 标识、System Proxy 已开启，或日志显示核心正常运行。
卡住先查
卡住先查：只导入配置但没开启代理层，浏览器仍然会按原网络直连。
这一步只确认代理层接管，不代表所有流媒体和 AI 服务都能用。
启动代理层
本图看哪里
图源：52.mk 站内步骤图
3.2
用 IP 检测确认出口
用 IP 检测确认出口，日志里没有 JSON 解析错误才算配置被正确读取。
点哪里
点哪里：打开 52.mk IP 检测页，看出口 IP、地理位置、DNS、共享人数和服务连通性。
成功标志
成功标志：出口地区符合你选择的节点，DNS 不明显泄漏，常用服务连通性有结果。
卡住先查
卡住先查：出口没变时，回头检查当前配置、节点、模式和代理层是否真的开启。
IP 检测正常，才算从配置、节点到实际访问完整跑通。
结果验收
本图看哪里
图源：52.mk 站内步骤图
Step 4
跑通以后再看什么
把进阶动作放到基础链路之后，新手排错会轻很多。
4.1
暂时别叠太多高级功能
这个客户端适合愿意理解 sing-box 的人；纯新手如果只有 Clash 订阅，先用 Hiddify 或 Clash 系客户端更省心。
点哪里
点哪里：高级设置、DNS、TUN、脚本、模块、规则集或外部控制这些入口先只看不改。
成功标志
成功标志：基础访问稳定后，你再一次只打开一个进阶功能做对比。
卡住先查
卡住先查：改了多个高级功能后再出问题，很难知道是哪一项造成的。
新手排错最重要的是少变量，一次只改一处。
进阶顺序
本图看哪里
图源：52.mk 站内步骤图
4.2
记录可复现的排错信息
如果还是不能用，先记录当前客户端、配置格式、节点、模式、错误提示和 IP 检测结果。能说清这些信息，才好判断是订阅、节点、规则、DNS 还是设备权限问题。
点哪里
点哪里：日志、测试结果、当前 Profile、当前节点和 52.mk IP 检测页。
成功标志
成功标志：你能把问题描述成具体环节，而不是只说“连不上”。
卡住先查
卡住先查：没有错误提示时，先换节点、换网络，再看订阅是否过期。
排错信息不要包含完整订阅链接，公开截图前先打码。
排错记录
本图看哪里
图源：52.mk 站内步骤图
排错清单
GUI.for.SingBox 卡住时先查什么
现象
订阅导入后没有节点
先查
确认复制的是订阅链接，不是登录页、邀请链接、付款页面或单个说明页面。
处理
回到机场后台重新复制对应客户端的订阅地址，再手动更新一次订阅。
现象
节点能看到，但网页打不开
先查
先看系统代理、TUN 或 VPN 权限是否真的开启，再看当前模式是不是直连。
处理
关闭后重新开启代理层，必要时换一个节点和网络环境交叉测试。
现象
部分网站能打开，部分 App 不行
先查
多半是规则分流命中不同路径，或者目标服务限制了当前出口 IP。
处理
临时切全局代理对比，再用 IP 检测看出口地区、DNS 和服务连通性。
现象
更新订阅失败
先查
检查订阅是否过期、当前网络能否访问订阅域名、系统时间是否异常。
处理
换网络后再更新；仍失败就带着错误提示联系机场客服，不要把订阅链接发到公开群。
现象
客户端显示已启动但出口没变
先查
检查当前模式、系统代理、VPN 权限、TUN 或监听端口。
处理
重新选择节点并重启代理层，再用 IP 检测确认。
善意提醒
订阅链接要当密码保管，里面可能包含你的套餐身份和节点权限。
客户端只是工具，不承诺线路质量；线路稳定性要看机场本身。
下载软件和导入订阅是两件事。软件装好以后，还需要有效订阅或节点。
模块、覆写、TUN 和自定义路由属于进阶玩法，基础访问没跑通前先不要叠加。
遵守所在地法律和服务条款，本站教程只做软件使用和网络诊断说明。
这个客户端适合愿意理解 sing-box 的人；纯新手如果只有 Clash 订阅，先用 Hiddify 或 Clash 系客户端更省心。