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.7K ·GitHub
IPQuality
这是什么？IPQuality 是一个检查服务器或 VPS 的 IP 质量的 shell 脚本：地理位置、风险评分、黑名单状态、流媒体解锁状态和邮箱服务商连通性，全部汇总在一份报告里。
它是独立脚本，还是需要框架？它是一个独立的 bash 脚本，可以直接在服务器上运行；如果你在 Windows 上或不想在本地装依赖，也可以通过 Docker 运行。
怎么运行它？在 bash 里通过便捷的交互式菜单运行，或用带命令行标志的高级模式，比如仅检测 IPv4/IPv6、指定某块网卡，或走代理服务器。
需要先安装什么吗？脚本会检查你的操作系统并自行安装依赖（安装前会先询问），你也可以传一个标志让它自动安装，或干脆跳过系统/依赖检查。
它在每个平台上都能可靠地检测出所有项目吗？Windows 只能通过 Docker 支持，没有原生支持；项目更新日志里有大量针对边缘情况的修复记录，比如网关端口挡住邮件检测、Netflix/TikTok 区域检测不准等。
它能在没有网络的情况下运行吗？不能，它需要联网查询外部风险数据库（Maxmind、AbuseIPDB、IP2Location 等）以及流媒体/邮件服务。
它能检测哪些流媒体和 AI 服务的解锁状态？TikTok、Disney+、Netflix、YouTube、Amazon Prime Video、Reddit 和 ChatGPT，每项都带解锁类型检测。
它测试哪些邮箱服务商的连通性？Gmail、Outlook、Yahoo、Apple、QQ、Mail.ru、AOL、GMX、Mail.com、163、搜狐和新浪。
能让结果输出成 JSON，而不是可视化报告吗？可以，一个标志能把结果以 JSON 输出，另一个选项可以把报告以 ANSI、JSON 或纯文本保存到文件。
风险评分综合了哪些风险数据库？它合并了 IPinfo、ipregistry、ipapi、AbuseIPDB、IP2Location、IPQS、DB-IP 和 Scamalytics 的数据，外加 400 多个来源的 IP 黑名单检查。
What are similar projects?vps-security-enhancement-scripts, clashctl, shadowsocks-c, brook, wireguard-install, trojan, sing-box, smartdns
Which topics is it in?network-security, vpn, sysadmin, shell, proxy, china, monitoring, networking, command-line-tool, privacy, security, terminal
Creator
xykt
Size
9 MB
Stars
10.7K
Updated
CommitSep 30
Age
2y
Commits · 90 Days