TCPing API

对指定主机的一个端口建立 TCP 连接测延迟与丢包，适合不响应 ICMP 的服务器

数据来源：本服务器发起的 TCP 连接

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

TCP 端口连通性与延迟测试（每次只测一个端口）

GET /api/tcping

请求参数

  • host（必填）：域名或公网 IP；不允许内网和保留地址，示例 github.com
  • port：端口，1~65535，示例 443
  • count：测试次数，1~4，示例 4

返回字段

  • host（string）：测试的主机（ASCII 形式，中文域名为 punycode）或 IP
  • ip（string）：实际连接的 IP（域名解析后的第一个地址，所有测试都连这个 IP）
  • port（number）：测试的端口
  • count（number）：测试次数
  • results（array）：每次测试的结果，按顺序排列；每次都新建连接，连上后立即断开，单次超时 3 秒
  • results[].seq（number）：第几次测试（从 1 开始）
  • results[].ok（boolean）：是否成功建立连接
  • results[].ms（number|null）：TCP 建连耗时（毫秒，保留两位小数）；失败时为 null
  • results[].error（string|null）：失败原因的中文说明（如"连接被拒绝（端口未开放或服务未启动）""连接超时（3 秒）"）；成功时为 null
  • sent（number）：发起的连接次数（等于 count）
  • received（number）：成功的次数
  • lossRate（number）：丢失率（百分比，0~100，保留两位小数）：失败次数 / 总次数 × 100
  • min（number|null）：成功连接中的最小耗时（毫秒）；全部失败时为 null
  • max（number|null）：成功连接中的最大耗时（毫秒）；全部失败时为 null
  • avg（number|null）：成功连接的平均耗时（毫秒，保留两位小数）；全部失败时为 null