| ss.6nn1.net · 推荐代理独享平台 |
|---|
sing-box VT（现为 sing-box MT）
iPhone 旧版迁移、配置导入与日志排错教程
| 适用平台 | iPhone / iPad · iOS / iPadOS |
|---|---|
| 系统要求 | 现行 sing-box MT 要求 iPhone/iPad 使用 iOS/iPadOS 15.0 或更高版本。 |
| 官方下载 | https://apps.apple.com/us/app/sing-box-mt/id6785326793 |
| 线路与服务 | https://ss.6nn.net/ |
一、软件介绍与系统准备
sing-box VT 是 sing-box 早期的 Apple 平台客户端名称。官方迁移 Apple 开发者账号后，iOS 与 tvOS 客户端已经以 sing-box MT 重新上架；旧 VT 用户需要安装新应用，原来的配置和设置不会自动继承。本教程保留 VT 名称方便旧用户检索，实际安装与操作以 MT 为准。
安装前先在旧 VT 中导出配置文件，记录远程配置 URL、自定义路由和 DNS，不要只依赖应用内部缓存。随后从 sing-box 官方 Apple 平台文档进入 App Store，核对应用为 sing-box MT；当前要求 iOS 15.0 或更高版本。首次启动时允许添加 VPN 配置。
若旧 VT 仍在设备上，可以暂时保留用于对照，但两款应用不能同时连接。确认 MT 的配置、出口和自动重连均正常后，再删除旧应用。远程配置必须直接返回有效的 sing-box JSON，不能把普通网页地址或其他客户端订阅强行导入。
二、安装、配置与连接步骤
1. 认识现行仪表盘
打开 sing-box MT，在 Dashboard 查看 Mode、Profile、Status、Connections 和流量。首次测试保持 rule 模式，先不要修改核心与隧道高级参数。
图1 步骤1：查看现行 sing-box MT 仪表盘的模式、配置与连接状态。
2. 导入远程或本地配置
在 Profile 区域点击“+”，选择从文件导入、本地新建或添加远程配置。保存后先检查 JSON 语法，再将该配置设为当前 Profile。
图2 步骤2：从 Profile 区域添加远程地址或导入本地 JSON 配置。
3. 启动并查看日志
返回 Dashboard 启动服务，首次连接允许 VPN。随后进入 Logs，确认出现服务已启动与配置加载成功信息，不应持续快速重复报错。
图3 步骤3：启动服务后进入日志页查看加载过程和运行错误。
4. 核对核心与隧道设置
在 Settings 查看 Core、Packet Tunnel、On Demand Rules 和 Profile Override。新用户先保持默认，每次只调整一个项目并重新测试。
图4 步骤4：检查 Core、Packet Tunnel、按需规则与配置覆盖。
5. 验证状态与流量
回到 Dashboard，确认 Status、Connections、Inbound 和 Outbound 数值开始变化，再用浏览器测试域名与纯 IP，验证 DNS 和路由。
图5 步骤5：在 Dashboard 核对连接状态、连接数与上下行流量。
三、连接与连通性测试
连接后访问 https://ss.6nn.net/ 与合规 IP 查询页，确认出口和规则预期一致；随后分别测试域名、纯 IP、Wi‑Fi 与蜂窝网络，观察切网后能否自动重连。Logs 中若持续出现相同错误，应立即停止，按字段路径修正配置，而不是反复点击启动。
四、常见问题与排查
VT 配置没有出现在 MT 中属于正常迁移现象，需要手工导入或重新添加远程 URL。启动时报 JSON 错误时，按日志中的字段路径检查版本差异和废弃字段。能连 IP 但域名失败多与 DNS server、route rule 或 FakeIP 有关，应先用最小配置验证。后台断开时检查低电量模式、按需规则与系统 VPN 状态。
五、安全使用与维护
迁移测试应从最小配置开始：只保留一个出站、系统 DNS 和默认路由，确认稳定后再逐步恢复规则集、远程资源、分应用路由及按需连接。每一步都记录启动时间、出口、日志中的第一条错误和修改字段；不要一次粘贴多个旧版片段，否则很难分辨是字段废弃、规则冲突还是远程文件不可达。确认稳定后导出 MT 配置，并保留旧 VT 备份至少一周，确保按需连接与切网重连没有遗漏。
迁移前后都应保存独立备份，并记录当前客户端与配置版本。不要拼接不同年代教程里的 JSON 片段，也不要导入陌生远程规则。订阅 URL、UUID、服务器域名和日志公开前必须打码，仅在合法授权环境中使用。
| 重要提示：软件界面会随版本更新，本教程以核验日期可见的官方页面和原界面素材为准。 |
|---|
七、参考与下载来源
sing-box Apple 平台官方文档：https://sing-box.sagernet.org/clients/apple/
官方发布与 VT→MT 迁移说明：https://github.com/SagerNet/sing-box/releases
Apple App Store：sing-box MT：https://apps.apple.com/us/app/sing-box-mt/id6785326793
配套线路与服务入口：https://ss.6nn.net/