sing-box 订阅怎么导入手机客户端？安卓与 iPhone 完整步骤
简答：sing-box 手机端导入订阅，核心是把服务商提供的 sing-box 配置 URL 添加为 Remote Profile，再更新配置、选择节点并启动 VPN。Android 通常在 Profiles 中新建 Remote，iPhone 使用对应的 sing-box Apple 客户端后按同样思路导入；如果导入成功但不能联网，应继续检查配置格式、节点分组、VPN 权限和订阅是否过期。
定义：sing-box 订阅导入，是把一个可远程访问的 sing-box 配置地址保存为 Remote Profile，由手机客户端按 URL 获取、更新并运行配置。
先判断订阅链接：不要把普通订阅地址直接当成 sing-box 配置
sing-box 官方客户端使用的是配置文件概念，其中 Remote Profile 表示以 URL 作为更新来源的远程配置；官方文档还说明，图形客户端应支持通过 URL Scheme 导入远程配置，并提供配置查看和自动更新能力。可先阅读sing-box 图形客户端通用文档确认这一点。
| 你拿到的内容 | 通常适合的导入方式 | 新手判断方法 |
|---|---|---|
| 标注 sing-box、JSON、Remote 的订阅 URL | 在 Profiles 中新建 Remote Profile | 复制后应是一条完整的 https 或 http 地址，而不是一大段配置文本 |
直接显示以 { 开头的 JSON 文本 | 保存为本地 JSON，再用 Local Profile 导入 | 浏览器打开后看到的是配置内容，而不是网页登录页 |
| Clash、通用订阅、Base64 或其他客户端专用链接 | 先回到服务商后台确认兼容格式 | 不要因为链接能复制就默认它能被 sing-box 解析 |
| 打开后是登录页、验证码或 HTML 错误页 | 不能直接作为 Remote 配置 | 常见原因是未登录、链接失效、权限不足或地址复制不完整 |
如果你是在服务商后台找链接，应优先查看“订阅”“客户端”“配置文件”或类似入口，并选择明确写有 sing-box、JSON 或 Remote 的选项。具体按钮名称和后台路径需以当前页面为准，本文无法核实 moontoday.store 当前后台是否提供这些名称。
订阅 URL 往往包含账号凭据。不要把完整链接发到群聊、截图或公开工单；如果怀疑泄露，优先在服务商后台重新生成或更换订阅链接。
Android 手机导入 sing-box 订阅
Android 官方客户端在 Project S 的客户端列表中列为 sing-box for Android，项目仓库将其称为 SFA。安装来源和当前版本可能变化，建议从sing-box 官方图形客户端页面进入 Android 客户端说明，再按页面提供的渠道安装；不要仅凭应用图标或第三方改版名称判断是否为目标客户端。
- 打开 Profiles。进入客户端的配置文件页面，查找新增配置、加号或类似入口。
- 选择 Remote。Remote 的含义是从 URL 获取远程 sing-box 配置，不要选择 Local 后把 URL 当作 JSON 粘贴。
- 填写名称和 URL。名称可以写“手机订阅”，URL 粘贴完整订阅地址。若页面提供自动更新选项，可先保持默认；官方通用规范给出的远程配置默认自动更新间隔为 60 分钟，但不同构建的界面和可选项可能不同。
- 保存后手动更新一次。返回 Profiles，点击刚创建的配置，使用更新、刷新或同步按钮。先手动更新是为了立即确认 URL 能访问，不要把“已保存”误认为“已解析”。
- 检查配置内容。如果客户端能显示配置内容、节点或分组，说明请求和基本解析至少已经完成；如果出现 JSON parse、invalid configuration 或 HTTP 错误，直接进入本文的异常分流。
- 回到 Dashboard 启动。选择需要使用的配置，点击启动或开关。Android 可能弹出 VPN 权限确认，选择允许；官方 Android 功能说明显示，客户端在需要 TUN 时通过 Android VpnService 运行。
- 选择节点或分组。如果 Dashboard 显示 Groups，进入分组选择具体节点或自动选择项。官方通用文档说明，配置包含 Selector 或 URLTest 等分组时，Dashboard 应提供分组选择能力。
启动后不要只看开关是否变色。用手机浏览器打开一个平时能访问的网页，再关闭客户端重复打开；如果只有开启客户端时网络路径发生变化，才说明启动和系统接管至少已经生效。
iPhone 导入 sing-box 订阅：Remote、快捷导入和本地文件怎么选
Apple 平台客户端由 Project S 的 sing-box for Apple 项目维护，官方页面说明其可管理本地或远程 sing-box 配置，并在 Apple 平台使用 NetworkExtension 提供 TUN 能力。当前应用名称、商店显示和地区可用性可能变化，安装前应以sing-box for Apple 官方页面为准。
- 安装对应的 Apple 平台客户端。确认设备系统和应用要求符合当前官方说明。本文不提供未经核实的第三方下载入口。
- 进入 Profiles。点击新增配置或加号，选择 Remote，而不是 Local。
- 粘贴订阅 URL。填写名称和完整地址后保存，再执行一次更新。Remote Profile 的关键不是“保存一串文字”，而是让客户端能够通过 URL 获取远程配置。
- 需要快捷导入时，使用官方 URL Scheme。sing-box 通用文档给出的格式是
sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName。其中 URL 必须经过 URL 编码；如果服务商只给了普通订阅地址，直接在浏览器地址栏手写这个 Scheme 可能因编码问题失败，优先使用客户端页面中的导入功能。 - 如果只有 JSON 文件，使用 Local。把配置文件保存到“文件”应用后，在 Profiles 中选择 Local 或导入本地文件。Local 和 Remote 不同：Local 依赖手机上的文件内容，Remote 依赖 URL 后续更新。
- 启动并允许 Network Extension。回到 Dashboard 或主界面启动配置，首次运行时按系统提示允许 VPN 或网络扩展权限。Apple 客户端官方功能说明明确使用 NetworkExtension 运行服务。
- 验证节点和访问。先确认配置内出现节点或分组，再启动连接，最后分别测试网页、应用和需要稳定连接的业务。只看到 Profile 名称不代表订阅已经解析成功。
| 导入方式 | 适用情况 | 主要限制 |
|---|---|---|
| Remote URL | 服务商提供长期使用的订阅地址 | 依赖 URL 可访问，地址失效后需重新生成 |
| 快捷导入 | 已有经过编码的 sing-box 导入链接 | 编码、系统拦截或应用版本差异可能导致唤起失败 |
| Local JSON | 手上只有配置文件或需要固定版本配置 | 不会自动从远程地址更新，文件改动需重新导入或编辑 |
导入失败、没有节点或启动后无法联网：按现象分流
现象一：提示 403、401、404 或网页 HTML。先在手机浏览器中打开订阅 URL，观察是否要求登录、返回权限错误或已不存在。403/401 通常优先检查授权和链接是否复制完整；404 优先检查地址是否过期或路径错误；如果看到登录页、验证码或网站错误页，说明客户端拿到的不是可直接解析的配置。
现象二：JSON 解析错误或配置无效。先确认你选择的是 sing-box 配置，而不是其他客户端格式。不要把网页内容、Base64 文本或一整段错误提示保存成 JSON。若服务商提供多个格式，选择明确标注 sing-box 或 JSON 的版本；如果仍失败，记录完整错误文本、客户端版本和配置更新时间，再向配置提供方核对。
现象三：Profile 已保存，但没有节点或分组为空。这通常说明保存动作完成，但更新请求、格式解析、配置结构或订阅内容仍有问题。重新执行手动更新，查看配置内容预览；如果能看到配置但没有可选分组，可能是该配置没有 Selector 或 URLTest 等分组，也可能是服务端返回内容不适合当前客户端，需核对订阅格式。
现象四：启动后立即断开或手机无法联网。先关闭其他 VPN、网络过滤器或同类连接工具，避免多个 VPN 服务同时争用系统通道。然后停止 sing-box、重新打开配置并再次启动；Android 检查系统电池限制和后台活动权限，iPhone 检查 VPN/网络扩展授权是否仍然有效。若只有部分应用受影响，再检查配置中的路由规则，而不是先修改 DNS 或 MTU。
现象五：更新不及时。先手动更新并记录页面显示的最后更新时间，再检查自动更新开关。官方通用文档规定远程配置应支持自动更新，默认间隔为 60 分钟，但实际客户端构建可能存在界面差异；如果手动更新正常、自动更新异常，应暂时以手动更新为准，并核对当前客户端版本和已知问题。
回滚方法：在修改前保留原订阅 URL 或原 JSON 文件；如果新配置导入后无法启动，停止服务，切回旧 Profile 或重新导入备份文件。不要在没有备份的情况下覆盖唯一可用配置。
导入成功后的三项核验
- 配置核验：Profile 能正常更新，且能看到配置内容、节点或分组；不是只显示一个自定义名称。
- 服务核验：Dashboard 显示运行状态，并且系统出现 VPN 或网络扩展已启用的状态提示。
- 访问核验：分别测试浏览器和实际需要使用的应用；关闭客户端后再次测试，记录“开启”和“关闭”两种结果。单个网页能打开，不等于所有应用、DNS 请求或长连接都正常。
如果需要进一步判断是 TUN、DNS 还是系统网络问题，可继续查看本站的sing-box TUN 模式开启与断网排查，或使用连接问题排查指南按现象分流。
常见问题
sing-box 订阅链接可以直接粘贴到手机客户端吗？
可以，但前提是它确实是 sing-box 可读取的远程配置 URL。建议在 Profiles 中选择 Remote，再粘贴地址；如果打开后是登录页、HTML、Base64 或其他客户端格式，就不能默认直接兼容。
Android 和 iPhone 导入 sing-box 订阅的方法一样吗？
核心流程相同，都是创建 Remote Profile、填写 URL、更新配置并启动系统 VPN。差异主要在客户端名称、权限提示和界面位置：Android 使用 VpnService，Apple 平台使用 NetworkExtension，具体按钮名称应以当前客户端为准。
导入后只有订阅名称，没有节点怎么办？
先进入该 Profile 手动更新并查看错误信息，再确认订阅地址返回的是 sing-box 配置而不是网页或其他格式。如果配置能打开但没有分组，可能是配置本身未提供可选择的分组，也可能是当前客户端与配置结构不兼容。
订阅更新失败提示 403 或 404 怎么处理？
403 或 401 优先核对授权、登录状态和链接是否完整；404 优先核对地址是否过期或已被撤销。若浏览器打开也是错误页，应回到服务商后台重新复制或生成链接，而不是反复修改客户端设置。
启动 sing-box 后仍然无法联网，应该先改 DNS 吗？
不建议一开始就改 DNS。先确认 VPN 或 Network Extension 权限、是否有其他 VPN 同时运行、配置是否真正更新成功，再按应用范围判断路由或 DNS 问题。修改前保留原配置，便于回滚。