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

为 AI Agent 而生的
VPS 巡检工具

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

请从 GitHub 克隆 Genuifx/NetPulse，然后用 python3 netpulse.py --host root@<你的VPS_IP> --json 巡检这台 VPS，把结果转成中文总结发我
$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 / 未标记 / 代理特征三档判定；通过 Team Cymru 查询 ASN 注册国家，与 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

远端要求透明

远端只需 python3 + requests（`pip install requests`）+ 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 解锁")
{
  "schema": 1, "tool": "netpulse",
  "version": "0.4.0", "generated_at": "2026-10-03T17:30:00+08:00",
  "results": [{
    "host": "root@1.2.3.4", "status": "ok",
    "checks": {
      "purity": {"status": "ok", "value": "机房 IP（数据中心）"…},
      "unlock": {"status": "ok",
        "value": {"ChatGPT": {"status": "ok",
          "value": "API 可达（需自备 key）"}…}…},
      "dns": {"status": "ok", "evidence": {"leak": false}…}
    },
    "summary": ["AI 服务 API 均可达…"]
  }]
}
FAQ

常见问题

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

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

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

请从 GitHub 克隆 Genuifx/NetPulse，然后用 python3 netpulse.py --host root@<你的VPS_IP> --json 巡检这台 VPS，把结果转成中文总结发我
$bash <(curl -sL https://raw.githubusercontent.com/Genuifx/NetPulse/main/install.sh)