Open Source · Rust · Evidence First

看清网络故障发生在哪一层。

PathTrial 将 DNS、TCP、TLS、HTTP、UDP、QUIC 和 HTTP/3 检查分层执行，用真实测量证据解释网站打不开、VPS 端口异常、代理连接失败及 IPv4/IPv6 差异。

Open-source network diagnostics CLI with local MCP integrations for Codex and Claude Code.

下载 v1.5.0-rc.1 测试版 ↗ 查看源码与 README ↗

macOS / Linux 免 Rust 安装 Codex + Claude Code MCP 插件 JSON 证据报告默认拒绝未授权网络探测

为真实的网络排障场景而设计

把“连不上”拆解成可以验证的具体步骤，而不是依赖一次 Ping 或猜测运营商行为。

网站与 DNS 故障

单独观察域名解析、TCP 建连、TLS 握手和 HTTP 响应，区分传输连接异常与应用层问题。

VPS、端口和代理排障

检查网络可达性、SOCKS5 / HTTP CONNECT 代理链路与 UDP Echo、QUIC、HTTP/3 的不同协议行为。

IPv4 / IPv6 对照

用相同目标、端口、轮次和超时比较双栈连通性和延迟，避免从不一致的测试设置得出错误结论。

v1.5 综合诊断已正式发布为 Release Candidate

新增 pathtrial diagnose，提供 11 种引导式场景，覆盖 DNS、TCP、TLS、HTTP、延迟、丢包、IPv4/IPv6、UDP/QUIC、代理及本地网络状态。结果区分实际观察、可能原因、未证实项和下一步排障建议。

# v1.5.0-rc.1 预编译包直接支持 diagnose
pathtrial diagnose --scenario web example.com
pathtrial diagnose --scenario latency example.com --rounds 10
pathtrial diagnose --scenario local

公开预发布版：v1.5.0-rc.1 已提供 macOS ARM64、macOS Intel 和 Linux x86_64 预编译安装包，包含 diagnose 及 10 个 MCP 工具。安装无需 Rust；三平台 Release 构建与 MCP smoke 已通过。历史 v1.4.0-rc.1 仍可下载（9 个 MCP 工具）。

查看 v1.5 命令与安装说明 →

CLI 直接运行；无需 AI 账号

在自己的 Mac 或 Linux 机器上执行测试。无需云端账号、无后台服务，不会自动修改系统 DNS、代理、路由或防火墙。

诊断结果包含 PASS、WARN、FAIL、SKIP、INCONCLUSIVE，并能导出带 probe ID 的 JSON 报告。

查看完整 CLI 指南 →

# 下载并检查官方安装脚本后执行
$ pathtrial --version
# 1.5.0-rc.1

$ pathtrial scan example.com \
    --profile web --rounds 5 \
    --redact-ips

# 报告按协议阶段记录测量证据
# 具体结果取决于真实网络环境

常见网络故障排查

从真实测量区分 VPS 端口故障、QUIC/HTTP3 超时与 IPv4/IPv6 问题。以下技术全文目前为英文。

连接 Codex 和 Claude Code

v1.5.0-rc.1 预编译核心通过本地 MCP 提供 10 个工具，包含引导式诊断与报告解释。插件版本 0.3.0，请使用与之匹配的核心二进制。

OpenAI Codex 插件

从 GitHub 默认分支添加 Marketplace，安装 PathTrial 插件并检查本地 MCP 连接。

codex plugin marketplace add \
  gaochenyang666-droid/PathTrial
codex plugin add pathtrial@pathtrial

Claude Code 插件

通过 Claude Code 自带的插件命令添加 Marketplace，安装插件后使用 /mcp 检查工具。

# 在 Claude Code 会话内输入
/plugin marketplace add gaochenyang666-droid/PathTrial
/plugin install pathtrial@pathtrial

安全默认设置：网络目标必须明确授权。MCP 默认拒绝所有网络探测；解释和比较已有报告不需要网络目标授权。阅读 MCP 安装及授权指南。

从下载到第一份报告

最新公开版本为 Release Candidate，不是稳定正式版。预编译包附 SHA-256 校验文件。

选择系统安装包

提供 macOS Apple Silicon、macOS Intel、Linux x86_64；可以直接下载压缩包或审阅安装脚本。

验证 CLI 和 MCP

运行 pathtrial --version、pathtrial mcp --help，必要时安装 AI 客户端插件。

测量并分享脱敏结果

对有权测试的目标执行扫描，使用 --redact-ips 脱敏后分享报告、复现步骤或 Issue。

前往下载页面 →参与社区测试 ↗

常见问题

PathTrial 和 ping、curl 有什么不同？

PathTrial 不只检查单一协议；它按 DNS、TCP、TLS、HTTP、UDP、QUIC 等阶段记录证据，并明确区分无法确认的原因。单次网络失败不等于准确的根因定位。

安装 PathTrial 是否需要 Rust？

macOS ARM64、macOS Intel、Linux x86_64 用户可以直接下载 v1.5.0-rc.1 预编译版本，不需要 Rust。v1.5 的引导式诊断已经包含在预编译包中，无需从源码构建。

是否会主动探测未授权设备？

本地 MCP 网络探测默认拒绝，必须显式授权目标。请仅测量你有权限访问的系统，分享诊断报告前移除 IP、令牌、代理凭据等敏感内容。