IPQuality

面向 VPS、代理节点与服务器出口 IP 的一键体检脚本，集中报告 IP 信誉、类型、风险、流媒体解锁与邮件黑名单。

#type / resource #status / evergreen #tech / network #resource / ipquality #media / tool #interface / cli #platform / linux #platform / macos #platform / server

[!info] related notes

IPQuality

这是什么

IPQuality 是一个面向 VPS、代理节点和服务器出口 IP 的「一键体检脚本」。它不测 CPU、硬盘、带宽或延迟，而是回答：

  • 这个 IP 被数据库识别为家宽、商业网络还是机房 IP？
  • 是否被识别成 VPN、代理、Tor、机器人或滥用来源？
  • 风险评分高不高？
  • 能不能访问 Netflix、Disney+、YouTube Premium、ChatGPT 等服务？
  • 服务器能不能连接 Gmail、Outlook、QQ、163 等邮件服务器？
  • IP 是否进入垃圾邮件或滥用黑名单？

一句话定位：给 VPS 出口 IP 做「征信报告」的工具。

项目支持 IPv4、IPv6、中英文输出，以及 Ubuntu、Debian、CentOS、Alpine、Arch、macOS 等系统；Windows 主要通过 Docker 使用。当前主脚本版本标注为 v2026-03-29，采用 AGPL-3.0 许可证。

适用平台

平台方式
Linux（Ubuntu/Debian/CentOS/Alpine/Arch）原生 bash 脚本
macOS原生 bash 脚本
Windows通过 Docker 运行
多网卡 / 代理 / WireGuard / Tailscale / WARP支持 -i 指定网卡、-x 指定代理出口

检测内容

1. IP 基础信息

ASN 自治系统号、IP 所属组织、国家/城市/时区、经纬度与地图位置、注册地区与实际使用地区、以及所谓「原生 IP / 广播 IP」。

地理信息主要由 MaxMind 提供；相关服务不可用时进入精简模式改用其他数据源。

注意：「原生 IP」不是严格统一的互联网技术标准，在这类脚本中一般指 IP 注册国家、GeoIP 识别国家、实际出口地区三者一致。「广播 IP」通常指 IP 注册在一地、通过 BGP 在另一地使用（如注册美国、实际使用日本）——这不代表一定不好，只是部分风控库可能识别不一致。

2. IP 类型判断

综合 IPinfo、IP2Location、ipapi、ipregistry 等来源，把 IP 归类为家宽 ISP、机房 Hosting、商业网络、移动网络、教育/政府/组织、CDN、爬虫等。因此报告里可能出现不同数据库归类不一致（如 IPinfo 标 Hosting、IP2Location 标 ISP）。对 VPS 最常见的是 Hosting / Data Center / Server，这只说明属于云服务器地址，不等于已被封禁。

3. 风险评分

综合 IPinfo、ipregistry、ipapi、AbuseIPDB、IP2Location、IPQualityScore、DB-IP、Scamalytics、ipdata 等多库结果。例如 IPQS 大致逻辑：低于 75 低风险、75–84 可疑、85–89 存在风险、90 以上高风险。

不同库的数据采集时间、黑名单来源、算法、更新速度都不同，不应把分数当成精确结论。更可靠的观察角度是：是否有多家数据库同时判定为高风险。只有一家报高风险可能是误判或历史；5～6 家都判代理/滥用/高风险，实际可用性通常确实差。

4. 风险因子

逐个检查 IP 是否被识别为 Proxy、VPN、Tor、Server、Abuser、Robot，并把多个数据库横向排列观察一致性（IP2Location、ipapi、IPQS、Scamalytics、ipdata、IPinfo、DB-IP 等）。例如数据中心 IP 常被标记为 Server，部分库视为 VPN，个别库发现历史滥用——整体未必不能用，但可能比住宅 IP 更容易触发验证码。

5. 流媒体与 AI 服务检测

检测 TikTok、Disney+、Netflix、YouTube Premium、Amazon Prime Video、Reddit、ChatGPT 等。不只显示能否连接，还尝试判断解锁/屏蔽、识别到的国家地区、是否仅网页/仅 App 可用、是否只允许自制内容、是否受 DNS 影响。

这部分属于模拟访问与启发式检测，服务商接口、网页结构和风控策略变化后结果可能暂时失准。「ChatGPT：解锁」只代表测试时接口正常，不保证注册成功、登录不触发验证、API 允许使用或账号长期不被风控。

6. 邮件连通性与黑名单

检测本机 TCP 25 端口能否出站、Gmail/Outlook/Yahoo/Apple/QQ/163 等邮件服务连通性、IP 是否出现在 DNSBL 黑名单（README 声称覆盖 400+ 黑名单库）。

  • 本地 25 端口出站：阻断 通常意味着云厂商封锁 SMTP 25 端口，即使 IP 干净也无法直接投递邮件。
  • DNSBL：Blacklisted 说明已进入某些垃圾邮件黑名单；数量少不一定严重，但 Spamhaus 等重要库收录会严重拉低送达率。

适合判断 VPS 能否用于自建邮件服务器（Postal / Mailcow / Poste.io）、SMTP 中继或邮件通知。

运行方式

推荐：只测 IPv4 + 隐私模式

bash <(curl -Ls https://IP.Check.Place) -4 -p
  • -4：只检测 IPv4
  • -p：不上传报告生成分享链接（仍会向 check.place、IPinfo、DB-IP、流媒体/AI 服务、DNSBL 等发起查询）

常用参数

-4              只检测 IPv4
-6              只检测 IPv6
-f              展示完整 IP
-j              输出 JSON
-o 文件路径      保存报告
-i eth0          指定网卡
-x 代理地址      通过指定代理检测
-p              隐私模式
-y              自动安装缺失依赖
-n              跳过依赖和系统检测
-E              英文输出

检测双栈

bash <(curl -Ls https://IP.Check.Place)

默认分别检测 IPv4 与 IPv6 出口。部分 VPS 两者可能属于不同 ASN、不同地区、不同风控等级（如 IPv4 日本、IPv6 美国），会导致某些服务地区判断异常。

输出 JSON（自动化）

bash <(curl -Ls https://IP.Check.Place) -4 -p -j
bash <(curl -Ls https://IP.Check.Place) -4 -p -o ip-report.json

适合批量检测 VPS、接入管理面板、定期检查代理池、写入数据库、筛选低风险节点。

指定网卡

bash <(curl -Ls https://IP.Check.Place) -i eth0 -p

代码把指定网卡传给 curl --interface，使请求从对应网卡发出。适合多网卡、WireGuard、Tailscale、WARP、多代理线路、策略路由。

检测代理节点

bash <(curl -Ls https://IP.Check.Place) -x socks5://127.0.x.x:1080 -4 -p
# 也支持 http/https/socks5 带账号密码：
# -x http://用户名:密码@服务器:端口
# -x https://用户名:密码@服务器:端口
# -x socks5://用户名:密码@服务器:端口

对 Resin 代理池、VPS 出口节点很实用：同一台机器逐个检测不同代理出口，无需登录每台代理服务器。但不要把含密码的代理 URL 长期留在 Shell 历史、CI 日志、截图或共享终端输出中。

隐私与安全注意

  1. 默认会上传报告：脚本默认把 JSON/文本报告 POST 到 upload.check.place 生成分享链接；只有 -p 才关闭。注意 -p 只是关闭报告上传，不是让整个检测离线——为查询 IP 风险仍需访问外部接口，待检测 IP 也会传给 ipinfo.check.place、IPinfo、DB-IP 等服务。它本质上不可能是完全匿名或离线的检测。

  2. curl | bash 有供应链风险：官方默认命令每次运行都下载并立即执行远程脚本。更稳妥：

    curl -L https://IP.Check.Place -o ipquality.sh
less ipquality.sh
bash ipquality.sh -4 -p

    或克隆仓库固定版本：

    git clone https://github.com/xykt/IPQuality.git
cd IPQuality
bash ip.sh -4 -p

  3. 脚本可能安装系统依赖：依赖 curl、jq、bc、netcat、dig、iproute2 等。缺依赖时会识别发行版并调用 apt/dnf/yum/pacman/apk/zypper 安装，默认询问，-y 自动安装。不希望改系统时用 -n（前提依赖已自装）。

  4. 终端会显示赞助内容：脚本从仓库 ref/ad*.ans 与 ref/sponsor.ans 下载广告/赞助商内容并在终端展示，不影响主要检测功能。

适用与不适用

适合

  • 购买 VPS 后验货：Oracle 日本、Azure 日韩港、DigitalOcean 美国、新购代理 VPS —— 重点看实际地区、注册地区、IP 类型、风险因子、ChatGPT、DNSBL、25 端口。
  • 搭建代理池前筛选出口：哪些节点风险低、能访问 ChatGPT、被识别成 VPN、数据库地区不一致、已进入黑名单。
  • 检查服务器 IP 被污染：ChatGPT 无法访问、Google 验证码增加、Reddit 403、邮件进垃圾箱、某些网站拒绝访问时，重跑观察数据库是否开始标记该 IP。
  • 自动化采集：-j 输出 JSON 接入哪吒面板旁自定义检测、VPS 资产管理系统、Resin 代理池健康检查、定时任务、Prometheus 转换脚本、自建节点质量仪表盘。

不适合（不能替代）

  • speedtest：带宽测速
  • ping：延迟
  • mtr / NextTrace：路由与丢包、跨境路由
  • iperf3：实际吞吐
  • YABS：CPU、磁盘、网络性能
  • 专门的 SMTP 投递测试
  • 浏览器真实登录与账号风控测试

最完整的 VPS 验收一般是：YABS → CPU/磁盘/带宽 + NextTrace/mtr → 路由/延迟/丢包 + IPQuality → IP 风险/解锁/邮件 + 实际业务测试 → 最终可用性。

维护情况与许可证

仓库在 2026-07-21 仍有提交，但最近提交主要是 README 新增赞助商信息，不一定代表核心检测逻辑同步更新。因此：项目未归档、仍有人维护仓库内容，但流媒体与 ChatGPT 检测随外部接口变化可能阶段性失效。许可证为 AGPL-3.0——可修改与再分发，但若把修改版作为网络服务提供给用户，通常需按 AGPL 向服务用户提供对应源代码。

评价

优点：检测项目全；中文输出友好；多数据库横向比较比单一评分可靠；支持 IPv4/IPv6/代理/指定网卡；JSON 适合自动化；对 VPS 购买验货实用。

缺点：默认上传报告需主动加 -p；依赖多个第三方接口，部分结果随接口变化；「原生 IP」「风险评分」易被新手当绝对结论；curl | bash 默认方式不够保守；脚本体积大、检测过程产生大量外部请求；单次测试不能完全代表真实账号风控。

最终建议：作为 VPS 固定验收工具，但用「先下载、再执行、只测 IPv4、关闭报告上传」：

curl -L https://IP.Check.Place -o ipquality.sh
bash ipquality.sh -4 -p

相关链接 / 官方入口

  • GitHub / 仓库：xykt/IPQuality
  • 一键脚本域名：https://IP.Check.Place
创建于 2026/7/30 更新于 2026/7/30