IPQuality README

The project's README from github.com/xykt/IPQuality. As one markdown file: README.md.

license

IP质量体检脚本 - IP Quality Check Script (EN)

支持OS/Platform:Ubuntu | Debian | Linux Mint | Fedora | Red Hat Enterprise Linux (RHEL) | CentOS | Arch Linux | Manjaro | Alpine Linux | AlmaLinux | Rocky Linux | macOS | Anolis OS | Alibaba Cloud Linux | SUSE Linux | openSUSE | Void Linux | Windows (via Docker)

屏幕截图

截图

使用方法

便捷模式:交互界面

Net

Bash:
bash <(curl -Ls https://Check.Place) -I
Docker:
docker run --rm --net=host -it xykt/check -I && docker rmi xykt/check > /dev/null 2>&1
docker run --rm --net=host -it xykt/check -I & docker rmi xykt/check > NUL 2>&1

高级模式:参数运行

Help

默认双栈检测:
bash <(curl -Ls https://IP.Check.Place)
只检测IPv4结果:
bash <(curl -Ls https://IP.Check.Place) -4
只检测IPv6结果:
bash <(curl -Ls https://IP.Check.Place) -6
指定检测网卡:
bash <(curl -Ls https://IP.Check.Place) -i eth0
指定代理服务器:
bash <(curl -Ls https://IP.Check.Place) -x http://username:password@proxyserver:port
bash <(curl -Ls https://IP.Check.Place) -x https://username:password@proxyserver:port
bash <(curl -Ls https://IP.Check.Place) -x socks5://username:password@socksproxy:port
选择脚本语言为英文(任选其一):
bash <(curl -Ls https://IP.Check.Place) -E
bash <(curl -Ls https://IP.Check.Place) -l en
跳过检测系统及安装依赖:
bash <(curl -Ls https://IP.Check.Place) -n
自动安装依赖:
bash <(curl -Ls https://IP.Check.Place) -y
报告展示完整IP地址:
bash <(curl -Ls https://IP.Check.Place) -f
输出JSON结果(输出示例):
bash <(curl -Ls https://IP.Check.Place) -j
输出报告ANSI/JSON/纯文本至文件:
bash <(curl -Ls https://IP.Check.Place) -o /path/to/file.ansi
bash <(curl -Ls https://IP.Check.Place) -o /path/to/file.json
bash <(curl -Ls https://IP.Check.Place) -o /path/to/file.txtoranyother
基础信息多语言支持:
bash <(curl -Ls https://IP.Check.Place) -l jp|es|de|fr|ru|pt
隐私模式——禁用在线报告生成功能:
bash <(curl -Ls https://IP.Check.Place) -p
Docker(支持运行参数,须在&前插入):
docker run --rm --net=host -it xykt/ipquality && docker rmi xykt/ipquality > /dev/null 2>&1
docker run --rm --net=host -it xykt/ipquality & docker rmi xykt/ipquality > NUL 2>&1

脚本更新

2026/01/24 12:40 将Spotify检测替换为Reddit检测

2026/01/15 17:23 修正不规范的JSON

2025/08/03 00:00 增加Docker运行方式

2025/08/01 16:15 增加-p隐私模式,禁用在线报告生成功能

2025/07/30 16:30 将所有HTTP请求替换为HTTPS以提升脚本安全性

2025/06/02 21:25 修复25端口检测的错误逻辑,规范化邮件服务商连通性检测方法

2025/04/23 18:00 增加-o输出报告ANSI/JSON/纯文本至文件

2025/04/19 21:00 增加-j的JSON输出模式

2025/03/13 23:15 增加-y自动安装依赖,-n跳过操作系统及依赖检查

2024/11/09 00:30 增加Cloudflare风险评分,修复IP2Location偶发IP类型判断BUG

2024/10/06 01:15 修复极个别运行脚本报错问题

2024/07/23 23:50 增加运行参数-f使报告显示完整IP地址

2024/07/22 01:50 安装依赖包前增加询问,修复Disney+解锁类型错误

2024/06/27 01:00 增加Anolis OS | Alibaba Cloud Linux | SUSE Linux | openSUSE系统支持

2024/05/30 01:15 增加macOS系统支持

2024/05/28 18:00 修复了指定网卡/代理服务器仍然检测默认IP的bug

2024/05/17 00:45 增加报告svg图片分享链接,修复一些排版问题

2024/05/11 23:20 修复因网关阻断25端口导致的邮件检测时间过长的问题,修复Tiktok IPv6结果不准确的bug

2024/05/10 17:50 修复未安装sudo系统无法正常安装依赖的bug

2024/05/10 11:00 增加指定网卡及代理服务器检测支持

2024/05/09 15:00 修正不规范内网IP导致的错误,修正其他若干bug

2024/05/08 23:00 修正Netflix澳洲检测结果不正确的bug

2024/05/08 18:10 更新依赖程序dig检测及安装

2024/05/08 00:00 脚本发布

脚本贡献

Acknowledgments:

赞助商 商标 网址
IP2Location ip2location_logo https://ip2location.io
https://ip2location.com
Scamalytics scamalytics_logo https://scamalytics.com

服务器赞助商(排名不分先后)

赞助商 商标 网址
V.PS vps_logo https://v.ps
BAGE bage_logo https://bagevm.com
LisaHost
丽萨主机
lisa_logo https://lisahost.com
RapidProxy
原生IP
rapidproxy_logo https://rapidproxy.io
蔭雲
YINNET
yinnet_logo https://yin-net.com
Swiftproxy
原生IP
swiftproxy_logo https://swiftproxy.net
IPPeak
原生IP
ippeak_logo https://ippeak.com
ColaProxy
原生IP
colaproxy_logo https://colaproxy.com
VMRack vmrack_logo https://vmrack.com
E-Mail: [email protected] Telegram Bot: https://t.me/xythebot

*仅接受长期稳定运营,信誉良好的商家

Stars History:

Stargazers over time

Daily Runs History:

daily_runs_history

IPQuality (xykt/IPQuality)

Searching Database…

10.8K ·GitHub
What is this?IPQuality is a shell script that checks the quality of a server or VPS IP address: geolocation, risk score, blacklist status, streaming unlock status, and mail provider connectivity, all in one report.
Is this a standalone script or does it need a framework?It is a standalone bash script you run directly on a server, or via Docker if you are on Windows or do not want to install dependencies locally.
How do I run it?Run it in bash via the convenient interactive menu, or use the advanced mode with command-line flags for things like IPv4/IPv6-only checks, a specific network interface, or a proxy server.
Do I need to install anything first?The script checks your OS and installs its own dependencies (it will ask before doing so), or you can pass a flag to auto-install or skip the OS/dependency check entirely.
Does it detect everything reliably on every platform?Windows is only supported through Docker, not natively, and the project's changelog shows a long history of bug fixes for edge cases like gateway ports blocking mail checks or inaccurate Netflix/TikTok region detection.
Can it run without internet access?No, it needs internet access to query external risk databases (Maxmind, AbuseIPDB, IP2Location, etc.) and streaming/mail services.
Which streaming and AI services can it check for unlock status?TikTok, Disney+, Netflix, YouTube, Amazon Prime Video, Reddit, and ChatGPT, each with unlock-type detection.
Which mail providers does it test connectivity for?Gmail, Outlook, Yahoo, Apple, QQ, Mail.ru, AOL, GMX, Mail.com, 163, Sohu, and Sina.
Can I get the output in JSON instead of a visual report?Yes, a flag outputs the result as JSON, and another option lets you save the report as ANSI, JSON, or plain text to a file.
Which risk databases does it combine for the risk score?It merges data from IPinfo, ipregistry, ipapi, AbuseIPDB, IP2Location, IPQS, DB-IP, and Scamalytics, plus a 400+ source IP blacklist check.
Creator
xykt
Size
9 MB
Stars
10.8K
Updated
CommitSep 30
Age
2y
Commits · 90 Days