Tunna 手册
了解如何设置 Tunna、导入提供商配置、选择代理节点、构建路由规则，并排查 Apple VPN 隧道问题。
Tunna 是一款适用于 iPhone、iPad 和 Mac 的代理隧道应用。它基于 Xray 驱动、兼容 V2Ray 的配置，但本手册会先用日常语言说明：准备你的服务商配置或服务器信息，选择一个节点，决定哪些流量使用它，然后启动 Apple Network Extension 隧道。
使用手册前
可用的设置始于服务商或服务器资料。Tunna 不销售服务器、账号或订阅。
- 请先准备好节点链接、QR 码、订阅 URL、服务商配置，或手动填写所需的服务器信息。
- 请确保协议、传输、安全、地址、端口和凭据都来自同一个服务商配置。
- 第一次测试时只选择一个节点，并使用简单路由；确认可用后再加入自动化。
- 请把节点链接、订阅 URL、Reality 密钥、UUID 和密码都当作私密凭据处理。
手册如何组织
这些区域需要配合使用：出站用于验证节点，路由决定流量结果，设置控制隧道行为。
出站
添加本地节点、扫描 QR 码、粘贴提供商链接、维护订阅、阅读延迟，并选择 Proxy 使用的节点。
路由
为域名、IP 范围、端口、TCP 或 UDP、HTTP 或 TLS，以及 GeoSite 或 GeoIP 资产构建有序规则。
隧道设置
控制手动 电源、Always On、On-Demand、受信任网络、IPv6，以及哪些内容进入 Apple VPN 隧道。
故障排除
从启动失败、错误路由、陈旧订阅、缺失资产、安静日志或卡住的 VPN 条目等症状入手。
日常使用流程
设置配置、测试连接，再加入更多自动化时，按这个顺序来。
路由
路由是 Tunna 决定流量去向的页面，也是核心功能之一。默认路由负责处理没有命中规则的流量，可选 Proxy、Freedom 或 Blackhole。Proxy 使用当前选中的出站节点。规则会从上到下检查，已暂停的规则会跳过，最先命中的规则生效。
隧道和路由是两层不同决定
隧道设置控制 Apple VPN 隧道的生命周期。它和路由分开：隧道设置决定哪些流量进入 VPN 隧道；流量进入 Tunna 后，路由再决定匹配的流量使用 Proxy、Freedom 还是 Blackhole。On-Demand 和睡眠行为，是 Tunna 的自动化和省电设计与 Apple Network Extension 系统配合的地方。
订阅
订阅是一份服务商配置，可以包含很多节点和可选资料。Tunna 会获取这份配置、处理其中的节点，并把它们放在 出站 的对应订阅下。这样你不用手动编辑每台服务器，也能让托管节点列表保持可用。
资产
资产是可复用的目标记录列表。GeoSite 记录表示一组域名；GeoIP 记录表示一组 IP 范围。添加资产后，规则编辑器可以搜索这些记录，并把匹配项加入路由规则。
路由结果
选择默认路由或某条规则的结果时，可以用这张表对照。
| 结果 | 含义 | 用于 |
|---|---|---|
| Proxy | 通过当前选中的出站节点发送流量。 | 普通全隧道使用，或必须使用服务商节点的指定流量。 |
| Freedom | 不使用已选节点，直接发送流量。 | 需要绕过已选节点的可信目标、本地服务或网站。 |
| Blackhole | 丢弃命中的流量。 | 阻止不需要的域名、网络、端口或类别。 |
连接生命周期选项
Never（从不）
只有你手动启动时，Tunna 才会连接。
适合 你正在测试、排查问题，或只是偶尔使用隧道。
不适合 你希望网络变化后 Tunna 自动重新连接。
Always On（始终开启）
Tunna 会尽量保持隧道连接。
适合 你希望设备唤醒或连接中断后，隧道能自动恢复。
不适合 你还在验证节点是否可用。
按需
当 Apple 从符合条件的路由材料中检查到匹配域名时，系统可以启动隧道。路由变化时，Tunna 会刷新交给 Apple 的 On-Demand 规则。在移动设备上，Apple 的 On-Demand 行为也可能让隧道失败或重启；如果发生这种情况，先回到手动启动，验证节点，再只为稳定的域名唤醒方案重新启用 On-Demand。
适合 未暂停的 Proxy 规则包含 Tunna 可以交给系统的普通主机、Base 或 Full 域名条目，或非 RegEx GeoSite 记录。
不适合 你的方案依赖 默认路由、RegEx 模式、短关键词、IP 范围、端口、TCP 或 UDP 规则、应用协议规则、直连规则或阻止规则；这些都不是可靠的唤醒触发条件。
按下 电源 之前
- 出站 中至少能看到一个本地节点或订阅节点。
- 节点信息仍然与服务商配置一致：协议、传输、安全设置、地址、端口和凭据都要匹配。
- 首次测试时，默认路由 保持简单，通常使用 Proxy。
- 如果订阅或资产需要先更新，请确认当前网络可用。
- 确认 可信网络 不会在你当前使用的 Wi-Fi 或蜂窝网络上立刻停止隧道。
Network Extension 是系统隧道入口
Apple 会把 Tunna 显示成 VPN，因为 Tunna 使用 Network Extension 接收流量。这个系统条目只决定流量能不能进入 Tunna；路由规则仍然决定流量是走 Proxy、走 Freedom，还是被 Blackhole 阻止。
一次获取会更新什么
获取时，Tunna 会发送所选 User Agent，下载服务商配置；如果配置里有元数据，就读取它；然后从响应中解析节点链接。如果没有找到可用节点，订阅会标记为 错误。如果服务商发送元数据，Tunna 可以更新用量、到期时间、轮廓 链接、支持 链接、配置标题和配置更新间隔。
故障排除
把本页当作排查清单使用。先选择一个已知节点和简单路由，做一次干净的尝试，再查看 Tunna 给出的最新信息。大多数问题来自已选节点、路由方案、Apple Network Extension、服务商更新、资产、导入流程，或日志级别过低。
优先通俗语言 (Plain)，必要时使用技术术语
本手册会先说明用户在 Tunna 中能看到的行为，再解释服务商配置中可能出现的技术术语，包括 VLESS、VMess、Trojan、Shadowsocks、Xray、路由规则、GeoSite、GeoIP、TLS、REALITY 和 Network Extension。