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 — shell-скрипт, который проверяет качество IP-адреса сервера или VPS: геолокация, оценка риска, присутствие в чёрных списках, статус разблокировки стримингов и связность с почтовыми провайдерами — всё в одном отчёте.
Это самостоятельный скрипт или ему нужен фреймворк?Это самостоятельный bash-скрипт, который запускается прямо на сервере или через Docker — если вы на Windows или не хотите ставить зависимости локально.
Как его запустить?Запустите его в bash через удобное интерактивное меню или используйте продвинутый режим с флагами командной строки — например, для проверок только IPv4/IPv6, конкретного сетевого интерфейса или прокси-сервера.
Нужно ли что-то предварительно установить?Скрипт проверяет вашу ОС и сам устанавливает свои зависимости (предварительно спросив), либо можно передать флаг, чтобы установить всё автоматически или вовсе пропустить проверку ОС/зависимостей.
Всё ли он надёжно определяет на каждой платформе?Windows поддерживается только через Docker, не нативно, а в changelog проекта длинная история исправлений краевых случаев — вроде блокировки почтовых проверок портами шлюза или неточного определения региона Netflix/TikTok.
Может ли он работать без доступа в интернет?Нет, ему нужен интернет для запросов к внешним базам риска (Maxmind, AbuseIPDB, IP2Location и т. д.) и стриминговым/почтовым сервисам.
Какие стриминговые и ИИ-сервисы он может проверять на разблокировку?TikTok, Disney+, Netflix, YouTube, Amazon Prime Video, Reddit и ChatGPT, с определением типа разблокировки для каждого.
Связность с какими почтовыми провайдерами он проверяет?Gmail, Outlook, Yahoo, Apple, QQ, Mail.ru, AOL, GMX, Mail.com, 163, Sohu и Sina.
Можно получить вывод в JSON вместо визуального отчёта?Да, один флаг выводит результат в JSON, а другая опция позволяет сохранить отчёт в файл в формате ANSI, JSON или простого текста.
Какие базы риска он объединяет для оценки риска?Он смешивает данные из IPinfo, ipregistry, ipapi, AbuseIPDB, IP2Location, IPQS, DB-IP и Scamalytics, плюс проверку IP по чёрным спискам из 400+ источников.
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