Tutorial
sing-box for Apple 新手完整使用教程
拿到机场订阅后，默认先看 iPhone / iPad。先照这 6 步做：下载核对、复制订阅、新建 Remote Profile、启动 Enabled、选择 Rule 模式、选 Groups 节点、打开 52.mk IP 检测验收。跑通以后再看 JSON、route 和 dns，不要第一天就手搓配置。
先跑通
只用这 6 步跑通
先照这 6 步做。网页能打开、IP 检测对得上以后，再看 JSON、route、dns、TUN 和 clash_mode。
01
下载核对
App Store 里核对 sing-box VT，官方文档把 Apple 客户端分成 SFI、SFM、SFT。iPhone / iPad 先按 SFI 走。
02
复制订阅
机场后台找 Sing-Box、sing-box、SFI、Remote Profile 或 JSON 订阅。别复制登录页、付款页、邀请链接。
03
新建 Remote Profile
Profiles -> New Profile，Type 选 Remote，把订阅 URL 粘进去，Create 后等待更新。
04
启动 Enabled
回 Dashboard，确认 Profile 选的是刚才那条，再打开 Enabled。看得见 Profile 不等于已经上网。
05
选择 Rule 模式
Dashboard 的 Mode 里先选 Rule。Direct 是直连，Global 是全局代理，第一次日常使用先别选错。
06
选 Groups 节点
Groups 里先改主 Selector 或 URLTest 分组，选香港、日本、美国这类常见节点，再做 IP 检测验收。
准备工作
一台可以安装 sing-box VT 的 iPhone 或 iPad；官方要求写着 iOS 15.0+、macOS 13.0+、Apple tvOS 17.0+。
一个能下载该 App 的非中国大陆 Apple ID；官方文档也明确写了这个门槛。
机场后台提供的 sing-box / Sing-Box / SFI 可用订阅。最好是 Remote Profile URL 或直接返回 sing-box JSON 的链接。
打开 52.mk IP 检测页，最后用出口 IP、DNS、Google、YouTube、TikTok、Netflix、ChatGPT、Claude Code 等结果验收。
操作步骤
按顺序操作，出问题时回到当前步骤的检查点，不要同时改多个地方。
Step 1
下载和订阅准备
sing-box for Apple 不是机场账号登录器。它读取的是本地、iCloud 或 Remote Profile，Remote Profile 才是新手最常见的订阅入口。
1.1
下载核对：先确认是 sing-box VT
App Store 里的 Apple 客户端叫 sing-box VT。官方文档里 SFI 是 iOS，SFM 是 macOS，SFT 是 tvOS；它们都围绕 sing-box 配置运行。先核对 App 名称、图标、免费价格、设备兼容和系统版本，不要把第三方同名工具当成官方客户端。
点哪里
点哪里：App Store 搜索 sing-box VT -> 打开应用页 -> 核对图标、名称、价格、系统版本和设备兼容。
成功标志
成功标志：手机上能打开 sing-box VT，能看到 Profiles 和 Dashboard 入口。
卡住先查
卡住先查：商店搜不到时先看 Apple ID 地区。官方要求包含非中国大陆 Apple ID 这个门槛。
下载客户端只解决软件本体，不包含机场节点、线路、订阅或流量。
App Store 官方图标：sing-box VT
本图看哪里
1.2
复制订阅：找 Sing-Box / Remote Profile 入口
登录机场后台，找 Sing-Box、sing-box、SFI、Remote Profile、JSON 配置、通用订阅这些入口。真正要复制的是一串 URL。别复制登录页、付款页、邀请链接；如果后台只给 Clash、Surge、Quantumult X 链接，不要直接当成 sing-box 配置粘进去。
点哪里
点哪里：机场后台 -> 客户端订阅 / 订阅节点 -> Sing-Box / sing-box -> 复制 Remote Profile URL。
成功标志
成功标志：你拿到的是一条完整 URL，通常可以被 sing-box 当作远程配置下载。
卡住先查
卡住先查：后台没有 sing-box 入口时，先问机场是否支持；订阅转换可以用，但转换后的 JSON 质量取决于规则模板。
别复制登录页、付款页、邀请链接。Remote Profile 不是 Clash 订阅万能入口，格式错了就会启动失败。
站内操作示意：复制 sing-box 订阅
本图看哪里
图源：52.mk 站内操作示意
Step 2
iPhone / iPad 端：只用这 6 步跑通
第一次使用只做 Remote Profile、Enabled、Rule、Groups 和 IP 检测。JSON、route、dns、TUN 先放后面。
2.1
新建 Remote Profile：Type 选 Remote
打开 sing-box VT，进 Profiles，点 New Profile。Name 写机场名，Type 选 Remote，URL 粘贴刚才复制的 sing-box 订阅链接，其他选项先不动，点 Create。Local Profile 是本地手写配置，iCloud Profile 是 iCloud 同步配置，新手第一次不要选错。
点哪里
点哪里：sing-box VT -> Profiles -> New Profile -> Name -> Type: Remote -> URL -> Create。
成功标志
成功标志：Profiles 里出现新 Profile，并且没有立刻报 JSON 或下载错误。
卡住先查
卡住先查：创建失败先看 URL 是否复制完整、当前网络能不能访问订阅域名、机场是否真的给了 sing-box 配置。
看得见 Profile 不等于已经上网。Profile 只是配置来源，还要去 Dashboard 启动 Enabled。
站内操作示意：新建 Remote Profile
本图看哪里
图源：52.mk 站内操作示意
2.2
启动 Enabled：Dashboard 里选对 Profile
Remote Profile 创建后，回 Dashboard。先确认当前 Profile 是你刚才新建的那条，再打开 Enabled。第一次启动时，iOS 会请求 VPN 权限，选择允许。只有 Enabled 打开并出现 VPN 标识，sing-box 才开始接管网络。
点哪里
点哪里：Dashboard -> Profile 下拉 -> 选刚才的 Profile -> 打开 Enabled -> 允许 VPN。
成功标志
成功标志：iOS 控制中心能看到 VPN 标识，Dashboard 开始显示连接、流量或状态变化。
卡住先查
卡住先查：没有 VPN 标识时，先看 Enabled 是否自动关闭、系统 VPN 权限是否被拒绝。
Profile 下载成功不代表代理已经启动，Dashboard 才是运行入口。
站内操作示意：启动 Enabled
本图看哪里
图源：52.mk 站内操作示意
2.3
选择 Rule 模式：别停在 Direct
Dashboard 里的 Mode 通常来自配置里的 clash_mode。新手先把 Rule、Direct、Global 分清楚：Rule 是按规则分流，Direct 是全部直连，Global 是全部走代理。日常先选 Rule；只有排错时才短暂试 Global。
点哪里
点哪里：Dashboard -> Mode -> 选择 Rule。
成功标志
成功标志：Mode 显示 Rule，访问网站时会按配置里的 route 和 Groups 走。
卡住先查
卡住先查：IP 检测仍是本地出口时，先看是不是停在 Direct。
Rule 模式能出现，说明你的配置里至少有对应的 clash_mode；如果没有 Mode 区域，不代表软件坏了，可能是配置没有提供多模式。
站内操作示意：Rule / Direct / Global
本图看哪里
图源：52.mk 站内操作示意
2.4
选 Groups 节点：先改 Selector 或 URLTest
进入 Groups，先找 Proxy、节点选择、手动选择、Selector、URLTest 这类主分组。Selector 通常是手动选节点，URLTest 通常是测速组。第一次只改主代理组，选香港、日本、美国等常见节点，别把所有 AI、Netflix、TikTok 分组都改一遍。
点哪里
点哪里：Dashboard -> Groups -> 主 Selector / URLTest -> 选择一个常见地区节点。
成功标志
成功标志：Groups 里能看到当前选中的节点，回 Dashboard 仍然 Enabled。
卡住先查
卡住先查：节点很多时只动主分组；如果网页打不开，先换一个节点再判断配置。
Groups 只在配置包含 selector 或 urltest 这类 outbounds 时显示；没有 Groups 时先检查订阅配置质量。
站内操作示意：Groups 选节点
本图看哪里
图源：52.mk 站内操作示意
2.5
IP 检测验收：确认出口真的变了
网页能打开以后，不要只看 Enabled 亮着。打开 52.mk IP 检测，看出口 IP、地理位置、DNS、IP 类型、风控值、原生 IP、共享人数，以及 Google、YouTube、TikTok、Netflix、ChatGPT、Claude Code 等连通性。
点哪里
点哪里：浏览器打开 52.mk IP 检测 -> 对照你刚才选择的节点地区和目标服务结果。
成功标志
成功标志：出口地区对得上，DNS 没明显跑偏，目标服务连通性符合预期。
卡住先查
卡住先查：出口没变时按顺序查 Enabled、Rule 模式、Groups 节点；服务不可用时先换节点再判断机场线路。
sing-box 能启动，不代表 Netflix、TikTok、ChatGPT、Claude Code 都能用，最后要看外部检测结果。
站内操作示意：启动后做验收
本图看哪里
图源：52.mk 站内操作示意
Step 3
跑通以后再看 JSON、route 和 dns
sing-box 强在配置能力，但新手第一天不用手写 JSON。下面这些词，只在你要排错、转换订阅或定制规则时再看。
3.1
先知道 JSON 里几块最重要
sing-box uses JSON for configuration files。新手先认四块：outbounds 是节点和分组，route 决定流量走哪个 outbound，dns 决定域名怎么解析，experimental 常放 Clash API 或缓存相关能力。配置里还可能有 log、inbounds、endpoints、services，但第一次不用都改。
点哪里
点哪里：先不编辑配置。只有在需要排错时，再打开 Profile 的配置内容查看这些字段。
成功标志
成功标志：你能分清 outbounds 是出口，route 是分流，dns 是解析，不会把它们混成一个订阅链接。
卡住先查
卡住先查：看不懂 JSON 时不要手改；先让机场提供可用 sing-box 订阅，或用可信模板转换。
跑通以后再看 JSON、route 和 dns。第一天手搓配置很容易把一个小逗号写坏。
站内示意图：JSON 层级
本图看哪里
图源：52.mk 站内示意图
3.2
TUN、route、dns 不是越多越好
TUN 是更深一层的透明代理能力，Apple 客户端会用系统 VPN / Network Extension 接管流量。route 规则写错会导致网站走错出口，dns 写错会导致解析失败或 DNS 跑偏。普通机场上网先别乱改 TUN、route、dns、experimental。
点哪里
点哪里：这一步不是让你点，而是提醒你先别点。基础访问没跑通前，不要手改 JSON。
成功标志
成功标志：基础访问可用时，JSON 保持机场提供的原样；只在懂含义时改一小处。
卡住先查
卡住先查：手改后启动失败，先回滚到原始 Remote Profile，再看错误信息。
如果某个教程一开始就要求你复制大段陌生 JSON，先停一下。
站内示意图：高级字段放后面
本图看哪里
图源：52.mk 站内示意图
3.3
Mac 和 Apple TV 怎么看
SFM 是 macOS 客户端，SFT 是 Apple tvOS 客户端。Mac 可以走 App Store、GitHub 或命令行安装，但新手仍然先用 Remote Profile；Apple TV 端适合客厅设备，但输入订阅和排错比手机麻烦。先在 iPhone / iPad 上确认配置可用，再迁移到 Mac 或 Apple TV。
点哪里
点哪里：手机端确认 Remote Profile 可用 -> Mac / Apple TV 使用同一条 sing-box 订阅 -> 再按 Dashboard、Mode、Groups 验收。
成功标志
成功标志：你能解释 SFI、SFM、SFT 分别对应哪个平台，也知道电视端不是第一次上手的最佳入口。
卡住先查
卡住先查：Mac 或电视端报错时，先回手机端确认订阅链接本身可用。
跨平台一致不等于每个平台都同样好排错。新手默认从 iPhone / iPad 开始。
App Store 官方图标：平台核对
本图看哪里
排错清单
sing-box for Apple 连不上时先查什么
现象
New Profile 后立刻失败
先查
通常是 URL 不是 sing-box Remote Profile，或者当前网络无法访问订阅地址。
处理
回机场后台找 sing-box / SFI 入口；没有就问客服是否支持，别把 Clash 链接硬塞进去。
现象
Profile 能看到，但没有 VPN 标识
先查
先看 Dashboard 里是否选中了这个 Profile，以及 Enabled 是否真的打开。
处理
回 Dashboard 选择 Profile，打开 Enabled，按系统提示允许 VPN。
现象
Enabled 打开了，但出口 IP 没变
先查
检查 Mode 是否停在 Direct，或者 Groups 没有选择代理节点。
处理
Mode 选 Rule；Groups 里选择一个香港、日本或美国节点再测。
现象
没有 Mode 或 Groups
先查
Mode 依赖配置里的 clash_mode，Groups 依赖 selector 或 urltest 这类 outbounds。
处理
先确认机场给的是完整 sing-box 配置；没有这些字段时，不要强行找界面按钮。
现象
报服务错误或规则下载失败
先查
配置可能引用了远程规则、geo 文件或 GitHub 资源，而当前网络访问不了。
处理
换网络后更新 Profile；仍失败就带错误提示找机场客服，先不要手改 JSON。
现象
手改 JSON 后启动失败
先查
JSON 格式、逗号、字段名或 route / dns 规则可能写错。
处理
回滚到原始 Remote Profile；需要改配置时先用 sing-box check 或可信模板验证。
善意提醒
sing-box 订阅链接要当密码保管，里面可能包含你的套餐身份和节点权限。
第一次使用只做 Remote Profile、Enabled、Rule、Groups、IP 检测，不要同时手改 JSON。
订阅转换不是万能修复。转换后的 route、dns、outbounds 是否合理，要看模板质量。
sing-box for Apple 只是客户端，不保证机场线路质量、流媒体解锁或 AI 服务可用。
本站教程只做软件使用和网络诊断说明，遵守所在地法律和目标服务条款。