Wisp
Wisp 新手入门：从下载到第一次连接
围绕 Wisp 配置导入、系统 VPN 权限、首次连接与本地记录整理的上手文章。
Wisp 新手入门最重要的顺序，是先准备自己的配置，再完成系统授权，最后发起第一次连接。它是一款连接配置客户端，不销售 VPN 服务，也不提供服务器，你使用自己已有的配置。把这两件事分开看，很多困惑会立刻变少：下载和安装只是前半程，粘贴配置链接、扫码或从消息应用打开链接才是内容来源，而系统 VPN 权限属于连接前的授权环节。下面按首次使用场景拆解，帮助你把第一次连接走顺。
先准备配置，再打开 Wisp
首次使用前，请先确认你手里有可用的配置。它可能是一条配置链接，也可能是一张二维码，或来自消息应用里的链接。这个准备动作决定后续流程能否继续，因为 Wisp 本身并不生成服务器；配置从哪里来，需要由你自己安排好。
准备时不必研究复杂选项，只做三件事：
- 找到配置链接，确认能完整复制；
- 如果有二维码，确认能正常显示；
- 如果配置在消息应用里，确认能从那里直接打开链接。
这一步的目标不是立即连接，而是让 Wisp 能读到配置。把准备与连接分开，可以避免把“没有配置”误当成“连接失败”。
Wisp 配置链接导入的常见入口
在首次导入时，Wisp 给出几种来源方式。主屏可以粘贴配置链接，也可以使用内置扫描器读取二维码；如果配置来自消息应用，可以从那里打开链接。三条路径对应不同来源，选你手头最方便的一种即可。
操作时按顺序检查：先确认链接完整粘贴，或二维码处于可扫描状态；再确认导入后配置出现在客户端中；最后再点击连接。这里不需要猜测客户端里每个页面叫什么，也不必把导入动作当成连接动作。导入完成只代表 Wisp 拿到了配置，真正建立连接还要经过下一步授权。
如果你习惯先复制再检查，可以先粘贴到临时位置确认链接没有断裂，再粘贴进 Wisp。二维码方式同样先保证画面清晰、完整。导入成功的判断标准很简单：配置已被客户端接收到，而不是立刻期待网络已经连通。
Wisp 第一次连接与系统授权
配置准备好后，点击连接。此时需要允许系统 VPN 权限。这个授权是系统层面的必要动作，不是 Wisp 在替你选择服务器。允许后，客户端才会继续尝试建立连接。若你拒绝授权，连接流程不会真正开始，这和配置本身是否有效是两件事。
第一次连接时，建议按“配置已导入、权限已允许、连接已发起”的顺序查看。不要在这一步同时修改多个设置，也不要因为一次未连通就反复更换配置。保持单一变量，才能判断问题出在授权、配置来源，还是网络环境。
连接后看什么：实时日志、流量与会话统计
连接发起后，可以观察客户端提供的反馈。App Store 功能列表提到实时流量统计、会话统计、连接历史、带级别筛选的实时日志、TCP ping、代理检查、一键连接、kill switch 和自动服务器选择。对新手来说，先看两类信息就够：一类是连接状态是否保持，另一类是实时流量是否变化。
Wisp 实时日志适合在出问题时查看，但不要把它当成故障原因的自动结论。日志带有级别筛选，可以帮助你缩小观察范围；连接历史则会记录过往会话，方便回头对照。官网隐私页说明，服务器列表、连接历史与应用偏好保存在设备本地，并使用匿名汇总的崩溃和稳定性诊断。也就是说，Wisp 连接历史本地保存，便于你在本机回看，而不是把历史记录当成云端服务。
流量统计和会话统计是观察项，不是质量保证。它们能告诉你连接期间有没有数据变化，但不能替代对配置来源、权限状态和网络环境的检查。
遇到问题时，按这个顺序排查
第一次连接不顺时，优先检查准备与授权，而不是先猜原因。建议顺序如下：
- 配置是否完整：链接是否粘贴全，二维码是否可读，消息应用里的链接是否成功打开；
- 导入是否完成：配置是否已被 Wisp 接收；
- 系统权限是否允许：点击连接后是否出现并允许了 VPN 权限；
- 连接状态是否变化：结合实时日志和连接历史，看是否只是停留在未连接状态；
- 检测项只作观察：TCP ping、代理检查、实时流量统计能提供线索，但不等于故障诊断结论。
不要在排查中一次性更换配置、权限和网络环境，否则很难判断哪一步起了作用。若问题反复出现，先回到“配置来源是否可用”这一层，再检查授权是否被系统拦截。Wisp 不提供服务器，因此不要期待在客户端内寻找可用节点；它负责接收并使用你的配置。
把首次使用拆成两段，后续就简单了
Wisp 新手入门可以记成两段：第一段是准备配置并完成 Wisp 配置链接导入，第二段是允许系统 VPN 权限并发起 Wisp 第一次连接。连接后，用实时流量、会话统计、连接历史和 Wisp 实时日志做观察；遇到问题，按“配置完整性—导入完成—系统授权—连接状态—检测项”的顺序排查。这样既不会把客户端当成服务提供方，也不会在第一次连接时把多个问题混在一起。
站内相关阅读建议：
- 《Wisp 配置从哪里来：导入前需要想清楚的几件事》
- 《第一次连接失败时，先查授权还是先查配置》
- 《看懂 Wisp 实时日志与连接历史：新手观察清单》