网络诊断

在浏览器里运行 Ping、路由追踪、端口探测、DNS 查询、测速与局域网扫描。菜单位置：侧边栏「工具 → 网络诊断」。

后台任务

每次点击「开始」创建一个后台任务，接口立即返回任务 ID，界面轮询输出。

• 同时运行的任务最多 4 个，超出时提示稍后再试；
• 单个任务最长运行 5 分钟，超时自动取消；
• 保留最近 50 个任务，运行中的任务不会被清理；每个任务最多保留 500 行输出；
• 运行中可点击「停止」取消；页面下方「最近任务」列出历史任务，点击可查看输出；
• 任务状态：运行中、完成、失败、已取消。

Ping

向目标发送 ICMP 回显请求，输出每次往返时间、丢包率与最小 / 平均 / 最大延迟。

参数	说明
目标	主机名或 IP，支持 IPv4 与 IPv6
次数	默认 4，最多 20

每个请求超时 2 秒，间隔约 0.7 秒。优先使用无特权的 UDP 型 ICMP 套接字，失败再尝试原始套接字。Docker 容器内需要 NET_RAW 权限或设置 net.ipv4.ping_group_range；权限不足时可改用端口探测。目标无任何响应时任务状态为失败。

路由追踪

调用系统命令追踪路径，输出命令原样结果。

• Windows 使用 tracert；其他系统优先使用 traceroute，其次 tracepath；
• 最多 20 跳，不做反向解析（直接显示 IP）；
• 系统中没有对应命令时任务报错，Docker 镜像可安装 traceroute 包。

端口探测

对目标做 TCP 连接探测，只列出开放的端口。

参数	说明
目标	主机名或 IP
端口	如 22,80,443,8000-8100，支持逗号分隔与范围，端口范围 1-65535

• 一次最多探测 1024 个端口；
• 并发 100，单个端口连接超时 1.5 秒；
• 对常见端口显示服务名（ssh、http、https、mysql、redis、postgres、rdp 等）和连接耗时。

DNS 查询

参数	说明
域名 / IP	要查询的名称；PTR 类型填写 IP
类型	A、AAAA、CNAME、MX、TXT、NS、PTR，默认 A
DNS 服务器	留空使用系统解析器；可填 223.5.5.5、223.5.5.5:5353 或 DoH 地址 https://dns.alidns.com/dns-query

查询超时 8 秒，输出记录与耗时。

测速

下载测速，4 路并发，每秒输出一次当前速率（Mbps），结束时输出总下载量与平均速率。

参数	说明
下载地址	完整的 http(s):// URL，留空使用 Cloudflare 测速节点（https://speed.cloudflare.com/__down?bytes=200000000）
时长	秒，界面范围 2 至 30，默认 8

测速请求不跟随重定向，避免被引导到禁止探测的地址。

局域网扫描

扫描网段内的在线设备，结果以表格呈现：IP、MAC、主机名、开放端口。

参数	说明
网段	CIDR，如 192.168.1.0/24；留空使用本机第一个私有 IPv4 网卡所在网段（下拉框列出本机可用网段，过大的网段收缩为 /24）

限制与原理：

• 只支持 IPv4 私有网段（10.0.0.0/8、172.16.0.0/12、192.168.0.0/16）；
• 一次最多 1024 个地址，相当于 /22；网络地址与广播地址自动排除；
• 对每个地址探测常见端口 80、443、22、445、139、3389、8080、62078、5000、53，连接成功或被拒绝均视为在线；
• MAC 地址来自系统邻居表，邻居表中有记录但没有开放常见端口的主机同样列为在线；
• 主机名通过反向 DNS 解析（超时 1.5 秒）；
• 有 MAC 的设备可点击「加入唤醒」，加入 网络唤醒 的设备列表。

禁止探测列表

页面右上角「禁止探测列表」设置不允许诊断工具访问的目标。

• 云厂商元数据地址始终禁止：169.254.169.254/32、100.100.100.200/32、fd00:ec2::254/128，防止工具被用于窃取实例凭据；
• 可追加 IP 或网段，每行一个，如 10.0.0.0/8；
• 目标主机名解析出的任一地址命中列表，任务即报错；测速的下载地址同样检查；扫描会跳过命中的地址。

TIP

诊断工具运行在 Gately 所在的主机或容器内，探测结果反映该环境的网络状况。需要限制可探测范围时，把内网敏感网段加入禁止探测列表。

网络自检

概览页的「网络自检」按钮（首次启动引导中也有入口）会一次性检查常见的网络与配置问题，问题项排在前面并给出处理建议：

检查项	说明
公网地址	通过 DDNS 使用的公网 IP 查询地址获取出口 IPv4 / IPv6
NAT	本机是否直接持有公网 IPv4 / IPv6；网卡上出现 100.64.0.0/10 地址时提示可能处于运营商 NAT 之后（Tailscale 等组网网卡会被排除）
系统时间	根据查询服务的响应时间估算时钟偏差，超过 60 秒会导致两步验证码与证书校验失败
80 / 443 端口	是否空闲、已被占用或没有监听权限
DDNS 解析	使用动态地址的记录，其域名当前解析结果是否等于本机出口地址
证书	已过期或 14 天内到期的证书
HTTPS 站点证书	启用的 HTTPS 监听中，哪些站点的域名没有匹配的证书（这些域名会在 TLS 握手时失败）
frp 冲突	frpc 中重名的代理，以及近 30 分钟日志中 frps 报告的代理名、域名或远程端口冲突（常见于多台设备复制了同一份 frpc 配置）
各模块状态	总览中处于警告或错误状态的模块

自检会访问配置的公网 IP 查询服务，只在点击时运行，只读账号与 API 令牌不可使用。