IP质量体检脚本（IPQuality）：全方位IP检测工具

一、工具简介

二、核心优势对比

1. 与同类 IP 检测工具横向对比

2. 核心亮点

• 数据源全面性：风险信息整合 IPinfo、IPQS、Scamalytics 等 8 + 数据库，结果比单一数据源更精准；
• 场景化适配：针对跨境常用的 TikTok/Netflix/Disney+ 等流媒体解锁类型、Gmail/QQ 邮箱等邮局连通性专项检测，贴合实际使用需求；
• 轻量化 & 易操作：无需复杂配置，一行命令即可运行，内置依赖自动检测 / 安装逻辑，新手友好；
• 多终端适配：输出结果针对 PC、移动端终端做单屏优化，排版清晰便于截图分享；
• 开源合规：基于 AGPLv3 协议开源，支持自由修改、分发，商用无限制（需遵守开源协议）。

三、安装与使用教程

前置说明

1. 环境准备：Bash 版本升级（可选）

# 下载并运行升级脚本 
curl -Ls https://raw.githubusercontent.com/xykt/IPQuality/main/ref/upgrade_bash.sh | bash
# 验证升级结果  bash --version | head -n 1

• Linux 发行版：自动识别 Ubuntu/Debian/CentOS/Arch/Alpine 等，通过系统包管理器升级；
• macOS：自动检测 Homebrew，未安装则先部署 Homebrew 再升级 Bash；
• Termux：适配移动端 Linux 环境，通过 pkg 包管理器升级。

2. 安装 / 运行方式（多方案适配不同场景）

方式 1：便捷模式（交互界面，推荐新手）

Bash 直运行（Linux/macOS 原生环境）

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

Docker 运行（跨平台，免环境依赖）

• Linux/macOS

docker run --rm --net=host -it xykt/check -I && docker rmi xykt/check > /dev/null 2>&1

• Windows（CMD 命令行）

docker run --rm --net=host -it xykt/check -I & docker rmi xykt/check > NUL 2>&1

方式 2：手动下载脚本（自定义修改 / 离线运行）

# 克隆仓库 git clone https://github.com/xykt/IPQuality.git cd IPQuality
# 添加执行权限 chmod +x ip.sh
#（可选）离线环境手动安装依赖
## Debian/Ubuntu
sudo apt update && sudo apt install -y curl jq dnsutils whois
## CentOS/RHEL
sudo dnf install -y curl jq bind-utils whois
## macOS（Homebrew）brew install curl jq bind whois
## Alpine
sudo apk add curl jq bind-tools whois
# 运行脚本
./ip.sh

3. 常用命令示例（覆盖 90% 使用场景）

使用界面截图

4. 常见安装问题排查

四、高级使用场景

1. 批量 IP 检测（结合 JSON 输出）

# 新建 IP 列表文件
echo -e "8.8.8.8\n2001:4860:4860::8888\n1.1.1.1" > ip_list.txt
# 循环检测并导出 JSON 结果
for ip in $(cat ip_list.txt);
do bash <(curl -Ls https://IP.Check.Place) -j --ip $ip > ${ip}_result.json done

2. 结合代理池批量检测节点质量

# 代理列表文件（proxy_list.txt）格式：socks5://ip:port 或 http://user:pass@ip:port
for proxy in $(cat proxy_list.txt);
 do echo "===== 检测代理：$proxy ====="
 bash <(curl -Ls https://IP.Check.Place) -x $proxy -f
done

五、开源协议与合规说明

1. 自由使用：允许免费复制、修改、分发脚本，个人 / 商业场景均可使用；
2. 开源义务：修改脚本后分发时，需开源修改后的完整源码；
3. 网络服务要求：若将修改后的脚本部署为在线检测服务（如网页版 IP 检测），需向用户提供源码访问方式；
4. 免责声明：脚本无官方质保，使用风险由用户自行承担，详细条款可参考仓库 LICENSE 文件（https://github.com/xykt/IPQuality/blob/main/LICENSE）。

六、贡献与支持

• 提交问题 / 需求：可在仓库 Issues 板块（https://github.com/xykt/IPQuality/issues）反馈；
• 代码贡献：欢迎提交 PR 完善功能，需遵循 AGPLv3 协议；
• 赞助支持：项目维护者接受 GitHub Sponsors 赞助（https://github.com/sponsors/xykt）。