Product support 产品支持

Diagnose with confidence. 让每一次诊断更清晰。

Learn how WiFi Diag measures latency, connection stability and Wi‑Fi roaming. Find quick answers or contact PinFong Limited for help. 了解 WiFi Diag 如何测量网络时延、连接稳定性与 Wi‑Fi 漫游。您可以在这里查找常见问题,或联系 PinFong Limited 获取帮助。

Start a diagnosis 开始一次诊断

A useful session takes only three steps. Keep the app in the foreground for continuous samples. 只需三个步骤即可开始。为保证样本连续,诊断期间请将 App 保持在前台。

1

Choose an Echo Server选择 Echo Server

Use a saved WebSocket endpoint or add a compatible server on your LAN or the internet. 选择已保存的 WebSocket 端点,或添加局域网/互联网中的兼容服务器。

2

Grant only what you need按需授权

Precise Location is optional for latency tests and is only needed by iOS to provide SSID/BSSID for roaming detection. 精确位置权限并非时延诊断所必需,仅因 iOS 要求而用于提供 SSID/BSSID 和检测漫游。

3

Save and review保存并查看

Stop the session, save the result, then inspect the timeline, roaming, dropouts and CSV/JSON export. 停止后保存结果,即可查看时间线、漫游、断连详情并导出 CSV/JSON。

What WiFi Diag can help with WiFi Diag 可以帮您做什么

Latency and stability时延与稳定性

Monitor TCP round-trip time, echo loss, late responses, real disconnections and recovery. 持续监测 TCP 往返时延、回显丢失、迟到回包、真实断连与恢复。

Mesh and AP roamingMesh 与 AP 漫游

Record BSSID changes on the same SSID and place roaming events beside latency and dropout data. 记录同一 SSID 下的 BSSID 变化,并将漫游事件与时延和断连放在同一时间线上。

Network context网络上下文

Review the local IP, subnet, gateway, DNS, proxy and VPN information that iOS makes available. 查看 iOS 允许访问的本地 IP、子网、网关、DNS、代理和 VPN 等信息。

History and export历史与导出

Keep complete sessions on your device and export selected diagnostic data as CSV or JSON. 将完整诊断会话保存在本机,并按需导出为 CSV 或 JSON。

Common questions 常见问题

The answers below cover the most common permission, server and background-execution issues. 以下内容涵盖最常见的权限、服务器兼容性和后台运行问题。

Why is the Wi‑Fi name or BSSID unavailable? 为什么无法显示 Wi‑Fi 名称或 BSSID?

iOS only provides the current SSID/BSSID after Location is allowed and Precise Location is enabled. WiFi Diag uses this permission only to read the Wi‑Fi name and access-point identifier; it does not request or read your geographic coordinates. iOS 只有在允许定位权限并开启“精确位置”后,才会向 App 提供当前 SSID/BSSID。WiFi Diag 仅使用该权限读取 Wi‑Fi 名称和接入点标识,不会请求或读取您的经纬度。

You can continue without permission. Latency and stability diagnostics still work, but Wi‑Fi identification and roaming detection are unavailable. 您可以不授权并继续使用。时延和稳定性诊断仍可运行,但无法识别 Wi‑Fi 或检测漫游。

Why does the first diagnosis wait for a system prompt? 为什么首次诊断会等待系统授权弹窗?

iOS may present Local Network or other system permission prompts the first time a network feature is used. WiFi Diag waits for your response before recording the first sample so permission time is not counted as invalid diagnostic data. 首次使用网络功能时,iOS 可能显示“本地网络”等系统授权弹窗。WiFi Diag 会在您作出选择后才记录第一个样本,避免把等待授权的时间计入无效诊断数据。

Why is packet loss 100% with a server that appears connected? 为什么服务器看起来已连接,但丢包率仍为 100%?

WiFi Diag requires an application-message Echo Server: every message sent by the app must be returned unchanged. A WebSocket server may accept the connection yet send greetings, status messages or transformed payloads instead of echoing the original message. Those responses cannot be matched to probes and are counted as timeouts. WiFi Diag 要求服务器具备应用消息回显能力:App 发送的每条消息都必须原样返回。某些 WebSocket 服务器虽然能建立连接,却会发送欢迎消息、状态信息或修改后的数据,无法与探测包匹配,因此会被计为超时。

Also check that the URL path and port are correct, the server supports the selected ws:// or wss:// scheme, and no proxy or firewall is closing idle or high-frequency WebSocket traffic. 还应检查 URL 路径和端口是否正确、服务器是否支持所选的 ws:// 或 wss:// 协议,以及代理或防火墙是否会关闭高频 WebSocket 连接。

Why does a diagnosis pause after locking the screen or switching apps? 为什么锁屏或切换 App 后诊断会暂停?

iOS may suspend an app shortly after it enters the background. WiFi Diag continues while the process is allowed to run, but it cannot override the system suspension policy. Keep the app in the foreground for continuous diagnostic data. When iOS resumes the app, the session can continue and the interruption is recorded. App 进入后台后,iOS 可能很快将其挂起。只要进程仍被允许运行,WiFi Diag 就会继续诊断,但无法绕过系统的挂起策略。需要连续数据时,请将 App 保持在前台;恢复运行后会继续会话并记录中断。

Does WiFi Diag test internet speed or Wi‑Fi signal strength? WiFi Diag 是否测试网速或 Wi‑Fi 信号强度?

No. WiFi Diag measures TCP round-trip behavior and connection continuity. It is not a download/upload speed test, RF scanner, channel scanner or signal-strength analyzer. 不测试。WiFi Diag 测量 TCP 往返表现与连接连续性,不是下载/上传测速工具、射频扫描器、频道扫描器或信号强度分析工具。

Which Echo Server should I use? 应该使用哪个 Echo Server?

Choose based on what you want to measure. A server on your LAN is useful for isolating local Wi‑Fi and roaming quality. An internet server includes the local network, ISP and remote route in the result. For repeatable comparisons, keep the endpoint unchanged between sessions. 应根据诊断目标选择。局域网服务器更适合隔离观察本地 Wi‑Fi 与漫游质量;互联网服务器的结果还会包含运营商和远程链路。需要对比多次结果时,请保持服务器端点不变。

Download the open-source WiFi Diag Echo Server → 下载开源 WiFi Diag Echo Server →

Where is my diagnostic history stored? 诊断历史保存在哪里?

History is stored locally on your device. WiFi Diag does not include your SSID, BSSID or saved history in Echo Server probes. Saved diagnostic records leave the device only when you intentionally export and share a CSV or JSON file. Probe messages necessarily travel to the selected Echo Server and contain a sequence number and timestamp. 诊断历史保存在您的设备本地。WiFi Diag 不会在 Echo Server 探测包中包含 SSID、BSSID 或已保存的历史。只有当您主动导出并分享 CSV/JSON 文件时,已保存的诊断记录才会离开设备。探测消息会发送至您选择的 Echo Server,其中仅包含序号和时间戳。

How do I export or delete diagnostic data? 如何导出或删除诊断数据?

Open Diagnosis History, choose a session, then use CSV or JSON export on the detail page. Delete one session from its detail page, or clear all history from Diagnosis History or Settings. Deletion is permanent after confirmation. 打开“诊断历史”并选择一个会话,即可在详情页导出 CSV 或 JSON。您可以在详情页删除单次会话,也可以从“诊断历史”或“设置”清空全部记录;确认后删除不可恢复。

What information should I include in a support request? 联系支持时应提供哪些信息?
  • WiFi Diag version and revisionWiFi Diag 的版本和代码版本
  • iPhone/iPad model and iOS versioniPhone/iPad 型号和 iOS 版本
  • The time of the issue and whether the app was in the foreground问题发生时间,以及当时 App 是否在前台
  • Echo Server scheme, host, port and path, with any private address redacted if neededEcho Server 的协议、主机、端口和路径;必要时可隐藏私有地址
  • Screenshots and an exported session, only if you are comfortable sharing them截图和导出的会话数据;请仅在您愿意分享时提供
System requirement:系统要求: WiFi Diag requires iOS or iPadOS 16.0 or later. Some network details depend on the device, connection type and information made available by iOS. WiFi Diag 需要 iOS 或 iPadOS 16.0 及以上版本。部分网络详情取决于设备、连接类型以及 iOS 实际提供的信息。

Still need help? 仍然需要帮助?

Contact PinFong Limited and we will help you investigate. We do not need your password, precise location or geographic coordinates. 请联系 PinFong Limited,我们会协助您排查问题。我们不会要求您提供密码、精确位置或经纬度。

Contact support 联系支持