pingtest

August 25, 2026 · View on GitHub

Hits

全方位的网络连通性测试工具

功能特性

  • 三网延迟测试 - 基于speedtestnet、speedtestcn、icmp_targets的数据
  • Telegram DC 检测 - 测试所有 Telegram 数据中心的连通性和延迟（参考 OctoGramApp）
  • 流行网站测试 - 测试 Google、YouTube、Netflix、OpenAI 等主流网站的连通性 UnlockTests
  • TCP 握手延迟测试 - 对主流平台执行真实 TCP 建连，显示成功率、丢包、延迟分位数和失败类型
  • 无系统 DNS 回退 - 默认保留系统 DNS，只有确认本地 DNS 不可用时才使用进程内 DoH/DoT，不改写系统 resolver 文件
  • 支持调用本机ping进行测试
  • 支持使用官方pro-bing库进行测试
  • 主体逻辑借鉴了ecsspeed

使用

下载及安装

curl https://raw.githubusercontent.com/oneclickvirt/pingtest/main/pt_install.sh -sSf | bash

或

curl https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/pingtest/main/pt_install.sh -sSf | bash

在线但本地 DNS 不可用时，使用支持 DoH 的 curl（例如 curl 7.62+）先拉取安装脚本：

curl --doh-url https://cloudflare-dns.com/dns-query --resolve cloudflare-dns.com:443:1.1.1.1,1.0.0.1 -sSfL https://raw.githubusercontent.com/oneclickvirt/pingtest/main/pt_install.sh | bash

安装脚本会保留 wget 优先顺序；下载失败且 curl 支持 DoH 时，会自动通过内置 DoH 重试。

基本使用

pt              # 默认模式: 测试国内三网延迟
pt -tm ori      # 测试国内三网延迟（与默认相同）
pt -tm tgdc     # 测试 Telegram 数据中心
pt -tm web      # 测试流行网站连通性
pt -tm tcp      # 测试主流平台 TCP 握手延迟
pt -tm china    # 测试国内三网 + TG + 网站
pt -tm global   # 测试 TG + 网站（不含三网）
pt -dns-mode doh # 强制使用内置 DoH
pt -dns-mode dot # 强制使用内置 DoT；默认 auto 仅在本地 DNS 确认不可用时回退
pt -log         # 启用详细日志

测试模式说明

1. ori - 国内三网延迟测试（默认）

测试国内移动、联通、电信三大运营商各省份节点的 ICMP 延迟

pt
# 或
pt -tm ori

注意: 测试失败的节点将显示延迟为 999ms

2. tgdc - Telegram DC 测试

测试 Telegram 5个数据中心的连通性和延迟：

  • DC1 - Miami, USA
  • DC2 - Amsterdam, Netherlands
  • DC3 - Miami, USA
  • DC4 - Amsterdam, Netherlands
  • DC5 - Singapore
pt -tm tgdc

注意: 测试失败的数据中心将显示延迟为 999ms

3. web - 流行网站测试

测试以下类别的网站连通性和响应时间：

  • 搜索引擎: Google, Bing
  • 社交媒体: Facebook, Twitter, Instagram, Reddit, TikTok
  • 视频流媒体: YouTube, Netflix, Disney+, Prime Video, Spotify, Twitch, Bilibili, iQIYI
  • AI 服务: OpenAI, Claude, Gemini, Sora, Meta AI
  • 开发平台: GitHub, GitLab, Stack Overflow, Docker Hub
  • 云服务: AWS, Azure, Google Cloud, DigitalOcean
  • 电商平台: Amazon, eBay, AliExpress
  • 游戏平台: Steam
  • 新闻媒体: CNN, BBC, NYTimes
  • 科技公司: Apple, Microsoft
  • 工具网站: Wikipedia
pt -tm web

注意: 测试失败的网站将显示延迟为 999ms

4. china - 国内全面测试

依次运行国内三网 + Telegram DC + 网站测试

pt -tm china

5. global - 全球测试

仅运行 Telegram DC + 网站测试（不含国内三网）

pt -tm global

6. tcp - TCP 握手延迟测试

TCP 模式不请求平台页面内容，只进行 DNS 解析并建立 TCP 连接，因此可用于观察比 ICMP Ping 更接近实际访问的连接延迟。默认逻辑如下：

  1. 合并项目内置的平台目标与定时更新的扩展目标，并按主机和端口去重。
  2. 每个平台默认尝试 3 次，每次握手最多等待 5 秒，最多同时测试 16 个目标。
  3. 根据成功样本计算 Min、Avg、P50、P95、Max，表格中的延迟单位统一为毫秒；数值越低且越稳定越好。
  4. D、R、T、O 分别表示 DNS 解析失败、连接被拒绝、超时和其他错误次数。失败次数为 0 不代表平台内容一定可访问，只代表 TCP 建连成功。
  5. 默认按平台名称稳定排序；-tcp-sort=latency 会优先显示失败、丢包和高延迟目标。
pt -tm tcp
pt -tm tcp -attempts 5 -timeout 3s -concurrency 8
pt -tm tcp -tcp-sort latency
pt -tm tcp -target example.com:443

当前内置目标覆盖下表平台。同一平台可能配置多个独立端点，因此实际测试目标数可能高于表内平台数；定时更新也可能补充新的有效目标。

平台平台平台平台平台平台
AdobeAliExpressAmazonAppleAWSAzure
BBCBilibiliBingCanvaChatGPTClaude
CloudflareCNNCoinbaseCopilotCourseraDeepL
DigitalOceanDiscordDisneyPlusDocker HubDropboxeBay
edXEpicGamesFacebookFigmaGeminiGitHub
GitLabGmailGoogleGoogle CloudGoogleCloudInstagram
iQIYIKhanAcademyMediumMetaAIMicrosoftMidjourney
NetflixNotionNYTimesOpenAIOracleOutlook
PayPalPerplexityPlayStationPrimeVideoProtonMailReddit
SalesforceShopifySlackSoraSpotifyStackOverflow
SteamStripeTelegramTheGuardianTikTokTrello
TVB AnywhereTwitchTwitter/XUdemyVercelViuTV
WhatsAppWikipediaXboxYahooMailYouTubeZoom

命令行参数

用法: pt [选项]

选项:
  -h           显示帮助信息
  -v           显示版本信息
  -log         启用日志记录
  -l string    输出语言与目标范围: zh 或 en
  -attempts int
               TCP 模式每个目标的尝试次数（默认 3）
  -timeout duration
               TCP 模式单次握手超时（默认 5s）
  -concurrency int
               TCP 模式最大并发数（默认 16）
  -json
               TCP 模式输出结构化 JSON
  -target string
               TCP 模式仅测试一个 host[:port] 目标
  -tcp-sort string
               TCP 平台排序: name 或 latency
  -tcp-format string
               兼容参数: compact 或 full；当前均显示完整平台表格
  -tcp-details int
               兼容参数；当前 TCP 文本始终显示全部平台
  -ping-sort string
               Ping 排序: latency 或 name
  -ping-scope string
               Ping 目标范围: auto、china 或 international
  -dns-mode string
               DNS 模式: auto、system、doh 或 dot
  -tm string   测试模式:
                 ori    - 国内三网延迟测试（默认）
                 tgdc   - Telegram 数据中心连通性测试
                 web    - 流行网站连通性测试
                 tcp    - TCP 握手延迟与可用性测试
                 china  - 国内三网 + TG + 网站全测试
                 global - 全球测试（TG + 网站，不含三网）

示例:
  pt              # 默认模式: 测试国内三网延迟
  pt -tm ori      # 测试国内三网延迟（与默认相同）
  pt -tm tgdc     # 测试 Telegram 数据中心
  pt -tm web      # 测试流行网站连通性
  pt -tm tcp      # 测试主流平台 TCP 握手延迟
  pt -tm china    # 测试国内三网 + TG + 网站
  pt -tm global   # 测试 TG + 网站（不含三网）
  pt -log         # 启用详细日志

系统兼容性

无环境依赖，理论上适配所有系统和主流架构

更多架构请查看: https://github.com/oneclickvirt/pingtest/releases/tag/output

卸载

rm -rf /root/pt
rm -rf /usr/bin/pt

在 Golang 中使用

go get github.com/oneclickvirt/pingtest@v0.0.28