故障排除

手册
获取 Tunna

故障排除

按步骤排查 Tunna 的设置、连接、路由、订阅、资产和日志问题。

2433 字 11 分钟
支持 故障排除日志重置冲突 zh-Hans

把本页当作排查清单使用。先选择一个已知节点和简单路由，做一次干净的尝试，再查看 Tunna 给出的最新信息。大多数问题来自已选节点、路由方案、Apple Network Extension、服务商更新、资产、导入流程，或日志级别过低。

先看现象，不要逐项乱改

选择与你能复现的现象最接近的分支；在继续改动更多字段前，先收集 Tunna 提供的最新证据。

将这些卡片作为此视图中可见标签的地图。每张卡片都会说明一个字段、控件或状态项，并在你更改或依赖它之前解释它的用途。

页面上能看到的项目

这些是页面里的控件、状态或测量值。把它们当作识别界面的参考，不要当作额外功能承诺。

隧道无法保持运行

检查手动 电源、Apple Network Extension 状态、一个已选节点和最新日志行。

流量使用了错误路由

检查规则顺序、暂停状态、默认路由、Proxy 与 Freedom，以及条件能否匹配该流量。

订阅或资产已过期

检查获取状态、服务商元数据、更新时间、资产处理状态，以及 资源 是否还在等待你检查。

日志或统计信息太少

先做一次干净复现，再对照 日志、调试、可观察性、延迟、丢包和数据计数器。

需要社区支持？

复现问题一次后，再发布一份聚焦报告。请写明 Tunna 版本、节点是本地节点还是订阅节点、已选协议、预期路由，以及尝试后的最新日志条目。

社区支持

分享前请遮盖 UUID、密码、Reality 密钥、节点链接和订阅 URL。

任何连接问题都先这样检查

  1. 选择一个已知节点

    使用本地节点或具有近期延迟的订阅节点。不要在同一次测试中切换多个节点。

  2. 使用简单路由

    测试时将 Proxy 作为 默认路由，并暂停自定义规则。这会将节点问题与规则问题分开。

  3. 手动启动

    在基本连接可用前，先搁置自动启动。点按一次 电源 并等待尝试完成。

  4. 清除并复现

    清除日志。只有第一次尝试信息太少时才启用 调试；复现一次后，先看最新条目。

  5. 一次恢复一个部分

    节点可用后，慢慢重新打开规则、资产、自动启动和高级设置。

常见症状

症状先检查可以尝试什么
没有可用的 出站出站和订阅添加本地节点、扫描或粘贴节点链接，或更新订阅配置。
连接失败Protocol、传输和安全设置将节点与服务商配置对照。Server Name 和 Address 经常不是同一个值。
保存 被禁用手动节点字段为已选协议填写必需的地址、端口和凭据值。
隧道启动后停止最新日志条目清除日志，为一次尝试启用 调试，手动启动，然后阅读最新条目，寻找第一个启动错误或配置冲突。
隧道无法启动节点和路由配置只为一次复现启用 调试。出现冲突通常表示已选节点、传输、安全设置、路由、DNS 或隧道设置没有组成同一套配置。
电源 看起来卡住Network Extension 状态如果可见 电源 控件在仍在连接或断开时接受长按，请用它重新初始化 Network Extension。如果 电源 已关闭、失败、无响应或无法长按，请改用 重置 屏幕。
流量未被代理路由确认 默认路由 是 Proxy，或在更宽泛的直连规则上方添加 Proxy 规则。
已连接，但页面仍不加载流量流向将 默认路由 设为 Proxy，测试一个已知节点；如果路由或名称查询不清楚，再为一次尝试使用 Access 或 DNS 日志。
本地设备消失私有子网检查私有子网流量是否应进入 VPN 隧道。测试一个路由器、打印机、NAS 或本地服务地址。
只有 DNS、TLS、HTTP、QUIC 或应用协议规则失败抓包 和 域 战略先使用简单域名规则，然后只启用该规则实际需要的识别功能。
启用 IPv6 后站点变化IPv6 路由方案先关闭 IPv6，并重复同一个网站测试。只有网络、服务商、规则和资产都支持这条路径时，再重新开启。
规则未匹配规则顺序和条件将规则上移、取消暂停、检查域名类型，并为应用协议规则使用 抓包。
资产规则找不到记录已安装资产添加预定义资产或更新远程资产，等待处理完成，然后再次搜索 资产 标签页。
订阅失败、过期或太旧状态页脚、网络和来源 URL检查网络连接、服务商 URL、User Agent、服务商到期时间，以及获取到的配置是否仍包含可用节点链接。
资源 中的 导入 被禁用选择和待处理获取至少选择一项，然后等待订阅节点或规则资产完成获取。导入前取消选择失败或不需要的项目。
未找到日志日志 控件提高日志级别，只为这次测试启用 Access 或 DNS，复现问题后再降低日志详细度。
电量、数据或存储用量感觉偏高日志 和探测测试后关闭 调试、Access 和 DNS 日志。不主动比较节点时，请拉长探测间隔或降低并发。
服务商更新改变了路由订阅清理服务商刷新后如果移除或重命名了节点，请检查曾指向这些订阅节点的规则。

常见问题

把这里当作手册的压缩版。每个答案都会指向负责该工作的屏幕或设置类别。

设置

启动和导入

Tunna 连接前我需要准备什么？
你需要本地节点、订阅 URL、QR 码、服务商链接、Tunna 分享链接，或手动服务器详情。之后第一次点按 电源 会安装 Apple Network Extension 条目。
资源 有什么用？
资源 是在保存任何内容前，用于检查导入节点、规则、订阅、重复警告和所需获取的屏幕。
什么时候应使用本地节点而不是订阅？
你自己维护的一台服务器适合用本地节点；由服务商管理会变化的节点列表、配额、到期时间、轮廓 或 支持 链接时，请用订阅。
哪些链接是私密的？
把节点链接、QR 码、订阅 URL、Tunna 分享链接、UUID、密码和 Reality 密钥都视为凭据。
出站

节点和服务商

我应该选择哪个协议？
选择服务商写明的协议：VLESS、VMess、Trojan 或 Shadowsocks。不要把一种协议当成另一种协议。
address、port、server name 和 path 应放在哪里？
Address 和 Port 指向服务器监听端；传输路径、TLS server name、Reality 密钥和 fingerprints 应位于对应的传输或安全字段中。
延迟点和数值是什么意思？
它们汇总近期可达性和 RTT。点按它们可打开 Stats；在信任 ZAP、Top 10 或排序前，让检查先预热。
为什么订阅会失败或看起来过期？
检查 来源 URL、网络、User Agent、服务商到期时间、获取状态，以及获取到的配置是否仍包含支持的节点链接。
规则

路由决策

默认路由 有什么作用？
默认路由 处理没有被任何规则命中的流量。用 Proxy 做宽范围Proxy，用 Freedom 直连，用 Blackhole 阻止。
为什么规则不匹配？
将规则移动到更宽泛规则上方，取消暂停，确认域名类型或 IP 范围；当规则依赖 HTTP、TLS 或 BT 应用协议识别时，检查 抓包。
应该如何阅读规则编辑标签页？
从结果开始，然后只添加需要的条件：域名、IP 范围、端口、网络类型、协议、应用协议或资产。
什么可以唤醒 On-Demand？
使用带普通域名条目或可用 GeoSite 记录的未暂停 Proxy 规则；默认路由、仅 IP、仅 GeoIP、端口和暂停规则不会唤醒隧道。
资产

资产和匹配

GeoSite 和 GeoIP 有什么区别？
GeoSite 分组域名；GeoIP 分组 IP 范围。主机名使用 GeoSite，只有在有意按 IP 路由时才使用 GeoIP。
为什么资产支持的规则找不到记录？
安装预定义 GeoSite 或 GeoIP 资产，更新受信任远程资产，并在搜索 资产 标签页或判断规则前等待获取和处理完成。
什么时候应更改 域 战略？
普通域名路由保持 AsIs；只有当 IP 规则必须看到 DNS 结果且你接受额外 DNS 工作时，才使用 IPIfNonMatch 或 IPOnDemand。
抓包 增加了什么？
抓包 可以从受支持流量中识别目标名称和应用协议；它帮助匹配，但本身不决定 Proxy 或 Direct。
隧道

隧道行为

连接 应设为什么？
测试时使用 Never；节点可靠后使用 Always On；只有当路由规则准备好唤醒隧道时才使用 On-Demand。
断开连接 On Sleep 有什么作用？
它会请求 Apple 在设备睡眠时停止 VPN 隧道。它适合省电，不适合用来修复坏节点。
可信网络 如何工作？
可信网络 定义 Tunna 应避免或停止隧道的 Wi-Fi 或蜂窝条目；保存 提交子表单，取消 保持不变。
我应该启用 IPv6 或网络路由开关吗？
只开启你的设备、网络、服务商和规则都能处理的流量类别和 IPv6 路径。进入 VPN 不等于自动走 Proxy。
可观察性

日志、检查和统计

探测应该多久运行一次？
只在选择节点时使用短间隔；延迟和状态稳定后，较长间隔可节省电量和数据。
节点颜色是什么意思？
颜色概括近期探测结果：快、慢、失败或未知。未知通常表示这个节点最近还没检查过。
什么时候应启用 调试 日志？
只在一次干净复现时，或支持人员要求时启用 调试。之后请降低日志级别，并关闭 Access 或 DNS 日志，因为它会消耗电量、存储和数据。
日志里应该先读什么？
阅读失败启动或流量测试后的最新条目。第一个具体错误通常比旧噪声更有价值。
恢复

重置和支持

什么时候应重置 Network Extension？
只有在连接或断开卡住时才使用 电源 长按；否则从 重置 页面使用 重置 Network Extension。
什么时候应该重置用户数据？
只重置出问题的区域，例如 路由、出站、资产、订阅、日志、隧道 或 可观察性。全部重置 是最后手段。
我应该给支持人员发送什么？
发送 Tunna 版本、节点来源、协议、传输、安全、预期路由、网络类型、最新日志，以及近期导入、更新或重置。
我应该遮盖什么？
请遮盖节点密码、UUID、Reality 密钥、订阅 URL、服务器链接，以及包含凭据的 调试 JSON 副本。

谨慎使用 重置

重置 Network Extension 会重建系统 VPN 条目。重置用户数据 可能移除选定应用设置且无法撤销。请优先使用定向 reset 选项，而不是 全部重置。

电源 的含义取决于隧道状态

根据 Tunna 实际所处状态使用点按和长按操作。隧道健康时，长按是便捷操作；只有隧道卡住时，它才是恢复操作。

将这些卡片作为此视图中可见标签的地图。每张卡片都会说明一个字段、控件或状态项，并在你更改或依赖它之前解释它的用途。

页面上能看到的项目

这些是页面里的控件、状态或测量值。把它们当作识别界面的参考，不要当作额外功能承诺。

第一次点按

当还没有系统 VPN 条目时，第一次点按 电源 会安装 Tunna 的 Apple Network Extension 条目。先批准系统 VPN 提示，再期待流量通过。

通过 Always On 连接

长按会禁用 Always On 并停止隧道。它不会禁用 On-Demand。如果 On-Demand 导致重启循环，请在诊断期间将 隧道 设置中的 连接 设回 Never。

在受信任网络上断开

只有当 电源 断开时，长按才能将当前受信任网络标记为不受信任。如果隧道仍在受信任网络上连接，请等待自动断开、在诊断期间将相关自动连接模式设回 Never，或从 可信网络 移除该网络。

正在连接或断开

如果 电源 停留在连接或断开状态，并且可见控件接受长按，请长按 电源 重新初始化 Network Extension。如果 电源 已关闭、失败、无响应或无法长按，请使用 重置 屏幕。

用简单话说明重置用户数据选项

只重置出问题的部分。全部重置 会把 Tunna 应用数据恢复到新安装状态，应作为最后手段。

将这些卡片作为此视图中可见标签的地图。每张卡片都会说明一个字段、控件或状态项，并在你更改或依赖它之前解释它的用途。

流量方案

这些选项影响 Tunna 用于连接的内容，以及流量如何排序。

路由

移除你的路由方案，并把规则行为恢复为默认设置。

出站

移除已保存节点，并恢复内置 direct、block 和 DNS 条目。指向已移除节点的规则可能回退到当前 Proxy 节点，因此重新连接前请暂停或重新分配这些规则。如果也想移除路由计划，请同时 重置 路由。

订阅

移除服务商配置及其订阅节点。指向这些节点的规则可能回退到当前 Proxy 节点，所以重新连接前请暂停或重新分配这些规则。如果也想移除路由方案，请同时 重置 路由。

资产

移除 GeoSite 和 GeoIP 记录。只依赖这些记录的规则会被暂停，以免变成宽泛的空规则。

隧道行为

这些选项会将连接识别和隧道默认值恢复为原始值。

隧道

重置 连接 和 断开连接 选择、受信任网络、网络路由控件和 IPv6 行为。

抓包

重置目标识别、排除域名、仅元数据行为和仅路由行为。

Inbound（入站）

把 Tunna 在隧道内使用的本地入口点恢复为默认状态。

网络策略

将超时、缓冲和资源策略行为恢复为默认值。

Protocol

恢复多路复用以及 Freedom、Blackhole 和 DNS 的默认值。现有代理节点会保留服务器身份；符合条件的节点会使用默认多路复用行为。

诊断记录

这些选项影响 Tunna 在检查或解释行为时已记住的内容。

日志

将日志详细度选择恢复为默认值。

可观察性

清除健康检查历史以及用量/延迟记录，然后将检查设置恢复为默认值。

隧道启动后停止或无法启动时

当 电源 看起来开始启动隧道但回到断开状态，或隧道拒绝启动时使用。目标是一次新的尝试，以及第一个有用错误。

  1. 让测试保持安静

    选择一个已知节点，保持路由简单，并在调查期间关闭自动启动。如果多个功能同时变化，日志会更难信任。

  2. 为一次尝试启用 调试

    打开 日志 页面，清除旧条目，并把日志级别调到 调试。只有问题与流量流向或名称解析有关时，才打开 Access 或 DNS。

  3. 手动启动

    返回连接屏幕并点按一次 电源。等待 Tunna 完成尝试，不要立即更换节点。

  4. 先阅读最新条目

    查找启动尝试后的第一个错误。如果它指向配置冲突，请把节点协议、传输、安全设置、server name、路由、DNS 和隧道设置与服务商配置对照。

  5. 再次降低日志级别

    测试后请降低日志级别，并关闭额外的 Access 或 DNS 日志，除非支持人员要求保持开启。调试 很快会消耗电量、数据、存储空间，也会制造很多干扰信息。

隧道卡住时重置 Apple Network Extension

当系统 VPN 条目过期或状态混乱时才使用它。它不会修复错误节点配置；请先测试节点和路由。

  1. 控件卡住时尝试长按 电源

    在启动或停止尝试后，如果 电源 仍在连接或断开，并且可见控件接受长按，请长按 电源。Tunna 会移除并重新保存 Network Extension 条目。

  2. 不要把长按用作普通断开状态重置

    当隧道已断开、失败、无响应，或旧版 电源 控件无法在进行中长按时，请使用 重置 页面主动重置 Network Extension。

  3. 使用 设置 重置路径

    打开 重置 页面，然后选择 重置 Network Extension。确认重置。Tunna 会停止隧道、移除系统 VPN 条目，并保存一个新条目。如果 重置 Network Extension 被禁用，说明还没有系统 VPN 条目；点按一次 电源 创建它，在被询问时批准 VPN 权限，然后如仍需要再回到此重置。

  4. 重置后手动启动

    返回 出站，选择一个已知节点，保持路由简单，然后点按 电源。如果系统再次请求 VPN 权限，请批准。

对支持有用的事实

  • 关于 中的 Tunna 应用版本。
  • 你是在询问 Tunna 社区，还是使用订阅配置里的服务商支持链接。
  • 节点是本地节点还是来自订阅。
  • 已选协议、传输和安全名称。
  • 默认路由，以及你预期匹配的任何规则名称。
  • 问题是否只发生在 Wi-Fi、蜂窝网络或受信任网络上。
  • 复现问题后的最新日志条目。
  • 问题刚发生前是否有订阅更新、资产更新、规则编辑、导入或重置。
  • 问题是否来自粘贴链接、QR 码、系统分享链接、命令链接或 Siri 快捷指令。
  • 调试 是否显示 配置 Not Found、配置 Parse 错误 或 配置加载失败。

杂项 中的支持屏幕

只有当 出站、路由、隧道、订阅、资产、可观察性 和 日志 中的普通检查无法解释问题时，才使用这些屏幕。

将这些卡片作为此视图中可见标签的地图。每张卡片都会说明一个字段、控件或状态项，并在你更改或依赖它之前解释它的用途。

页面上能看到的项目

这些是页面里的控件、状态或测量值。把它们当作识别界面的参考，不要当作额外功能承诺。

关于

报告问题时使用 应用版本。社区 会打开 Tunna 社区链接。

重置

危险区域 包含 重置 Network Extension 和 重置用户数据。Tunna 会警告选定应用设置在重置后无法恢复。

调试

调试 将运行中配置显示为可展开 JSON。只有在支持人员要求时，才长按一行复制该部分 JSON。

分享前遮盖敏感信息

发送截图或日志时，请遮盖节点密码、UUID、订阅 URL、Reality 密钥，以及任何可能让别人使用你服务器的链接。

重新关闭 调试

只在一次干净复现时，或支持人员要求时使用 调试。之后请再次降低日志级别，并关闭 Access 或 DNS，除非你仍然需要它们。调试 信息很多，也会消耗电量、存储和数据。