开源 · 免费 · 一行命令即用

为 AI agent 而生的
VPS 巡检工具

本地一条命令，批量体检所有机器：IP 纯净度、流媒体 / AI 解锁、DNS 泄露、IPv6、延迟、测速——结果直接喂给 agent。

$bash <(curl -sL https://raw.githubusercontent.com/Genuifx/NetPulse/main/install.sh)
单文件 Python只依赖 requests结构化 JSON 输出
root@vps — netpulse
Features

一次体检，覆盖六个维度

不再在十几个脚本之间来回切换。NetPulse 把选购与运维 VPS 时最关心的网络指标，整合进一份报告。

01

IP 信息

出口 IP、地理位置、ASN、运营商。先看清这台机器的真实身份，再谈别的。

IPASN归属地
02

IP 纯净度

机房 IP / 家宽 IP / 代理特征三档判定，并给场景建议：建站、做节点，还是跑账号业务。

机房识别代理检测
03

DNS 泄露检测

对比 DNS 解析出口属地与 IP 属地，揪出悄悄暴露真实位置的解析配置。

DNS泄露检测
04

解锁检测 × 11

Netflix、Disney+、YouTube Premium、HBO Max、Hulu、Prime Video、TikTok、Spotify、ChatGPT、Claude、Gemini 一次测完。

流媒体AI 服务
05

网络质量

IPv6 出口有无、到 Cloudflare / Google / 百度的 TCP 延迟、双节点下载测速。

IPv6延迟测速
06

分享报告

--share 一键生成 Markdown 体检报告，发群里、贴工单都方便。

Markdown可分享
For Agents

为 AI Agent 而设计

让你的 Agent 直接调用 NetPulse，拿到稳定、可解析的网络体检结果，再由它完成选购建议、故障诊断或自动巡检。

1

本地发起，批量巡检

--host 可重复指定，一次体检整个 fleet，多机自动输出对比表。

2

非交互、可脚本化

无确认、无彩色（JSON 模式），失败给清晰错误与非零退出码，agent 不会卡住。

3

远端零配置

缺 requests 自动安装，远端只需有 python3 + SSH key 登录。

# 本地发起：经 SSH 在远端执行，结果拿回本地
python3 netpulse.py --host root@1.2.3.4 --json | jq .

# 批量巡检整个 fleet
python3 netpulse.py --host root@vps-a --host root@vps-b --json \
  | jq '.[] | {host, purity, ipv6}'
import json, subprocess

def netpulse_check(host) -> dict:
    """供 Agent 调用的 VPS 网络体检：本地发起，远端执行"""
    out = subprocess.run(
        ["python3", "netpulse.py", "--host", host, "--json"],
        capture_output=True, text=True, timeout=300,
    )
    return json.loads(out.stdout)

report = netpulse_check("root@1.2.3.4")
unlocked = sum(1 for v in report["unlock"].values() if v == 200)
print(report["purity"], f"{unlocked}/11 解锁")
{
  "tool": "netpulse", "version": "0.3.0",
  "host": "root@1.2.3.4", "timestamp": "2026-10-02T10:30:00",
  "ip": { "query": "203.0.113.10", "country": "Japan", … },
  "purity": "机房 IP（数据中心）",
  "dns": { "leak": false, "resolver_geo": "Japan" },
  "unlock": { "Netflix": 200, "Disney+": 200, … },
  "ipv6": "2a04:4e41::d33b:6ea1",
  "latency": { "Cloudflare": 12, "Google": 15 },
  "speed": { "Cloudflare": 88.2 },
  "summary": [ "…" ]
}
FAQ

常见问题

NetPulse 支持哪些系统？
有 Python 3 就行：主流 Linux 发行版和 macOS。单文件，只依赖 requests（缺失时自动安装）。
运行一次需要多长时间？
完整体检通常 1–2 分钟，主要耗时在下载测速；其余检测项都是秒级。
会消耗很多流量吗？
测速会下载约 30MB 数据（Cloudflare 20MB + CacheFly 10MB），其余检测项流量可忽略。按量计费的机器请留意。
安装脚本安全吗？
NetPulse 完全开源，安装脚本与源码都可以在 GitHub 上审阅。建议在运行任何远程脚本前先阅读其内容。
检测数据会被上传吗？
检测结果默认只在本地终端显示并保存，不会被收集到任何第三方服务。测试过程中只会访问必要的测速与检测节点。
解锁检测准吗？
状态码只是初步判断（200 ≈ 可访问，403/451 ≈ 疑似区域限制）。Netflix 等建议用专项脚本二次确认，NetPulse 的定位是快速初筛。
如何让 AI Agent 使用 NetPulse？
让 Agent 以非交互方式执行命令并读取 JSON 输出即可，参考上方 Agent 专区的示例，把它封装为一个工具函数。

现在就给你的 VPS 做一次体检

复制命令，粘贴到终端，剩下的交给 NetPulse。

$bash <(curl -sL https://raw.githubusercontent.com/Genuifx/NetPulse/main/install.sh)