Choose an Echo Server选择 Echo Server
Use a saved WebSocket endpoint or add a compatible server on your LAN or the internet. 选择已保存的 WebSocket 端点,或添加局域网/互联网中的兼容服务器。
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 获取帮助。
A useful session takes only three steps. Keep the app in the foreground for continuous samples. 只需三个步骤即可开始。为保证样本连续,诊断期间请将 App 保持在前台。
Use a saved WebSocket endpoint or add a compatible server on your LAN or the internet. 选择已保存的 WebSocket 端点,或添加局域网/互联网中的兼容服务器。
Precise Location is optional for latency tests and is only needed by iOS to provide SSID/BSSID for roaming detection. 精确位置权限并非时延诊断所必需,仅因 iOS 要求而用于提供 SSID/BSSID 和检测漫游。
Stop the session, save the result, then inspect the timeline, roaming, dropouts and CSV/JSON export. 停止后保存结果,即可查看时间线、漫游、断连详情并导出 CSV/JSON。
Monitor TCP round-trip time, echo loss, late responses, real disconnections and recovery. 持续监测 TCP 往返时延、回显丢失、迟到回包、真实断连与恢复。
Record BSSID changes on the same SSID and place roaming events beside latency and dropout data. 记录同一 SSID 下的 BSSID 变化,并将漫游事件与时延和断连放在同一时间线上。
Review the local IP, subnet, gateway, DNS, proxy and VPN information that iOS makes available. 查看 iOS 允许访问的本地 IP、子网、网关、DNS、代理和 VPN 等信息。
Keep complete sessions on your device and export selected diagnostic data as CSV or JSON. 将完整诊断会话保存在本机,并按需导出为 CSV 或 JSON。
The answers below cover the most common permission, server and background-execution issues. 以下内容涵盖最常见的权限、服务器兼容性和后台运行问题。
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 或检测漫游。
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 会在您作出选择后才记录第一个样本,避免把等待授权的时间计入无效诊断数据。
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 连接。
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 保持在前台;恢复运行后会继续会话并记录中断。
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 往返表现与连接连续性,不是下载/上传测速工具、射频扫描器、频道扫描器或信号强度分析工具。
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 →
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,其中仅包含序号和时间戳。
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。您可以在详情页删除单次会话,也可以从“诊断历史”或“设置”清空全部记录;确认后删除不可恢复。
Contact PinFong Limited and we will help you investigate. We do not need your password, precise location or geographic coordinates. 请联系 PinFong Limited,我们会协助您排查问题。我们不会要求您提供密码、精确位置或经纬度。