Skip to content

stormzhang/ipcheck

Repository files navigation

ipcheck

网络环境诊断工具,一键检测 IP、DNS、代理、IP 风控、时区一致性与 Claude 端点,确保 AI 工具流畅运行、规避封号。

English

screenshot

为什么需要这个工具

想让 Claude Code、OpenAI API、Cursor 等 AI 工具流畅稳定运行,网络环境配置至关重要。以下问题可能影响使用体验:

  • IPv6 泄露真实地址 — 代理通常只处理 IPv4,IPv6 会暴露你的实际位置
  • DNS 泄露 — 使用国内 DNS 会暴露真实地理位置
  • IP 风险过高 — 机房 IP 或被滥用的 IP 可能影响连接质量
  • 时区不一致 — 本地时区配置与 IP 所在地不匹配
  • Claude 端点走了中转 — 第三方中转站可能泄露数据,甚至触发封号

ipcheck 一键检测这些问题,确保你的 AI 工具流畅稳定运行,尤其 Claude 启动之前先检测下,原因你懂得,规避封号。

功能

检测项 说明
本机真实 IP / IPv6 经国内直连回显拿到真实公网 IP(即使开着 VPN/TUN 也能露出真实 ISP 出口),并确认 IPv6 是否已禁用
本地 DNS 识别 DNS 来源(国内 / 国外),标注已知 DNS 服务商
出口 IP 信息 出口(代理后)IP、国家 / 地区、城市、运营商、IP 归属、时区
代理检测 环境变量代理、系统代理、TUN/VPN 的开关状态
IP 类型与风险 机房 / 住宅识别、proxycheck.io 风险评分、StopForumSpam 滥用记录、是否被标记为代理
时区一致性 系统时区与 CLI 时区(全 IANA),分别按 CC CLI(认 $TZ)和桌面版(走系统时区)比对出口 IP 时区
Claude 端点检测 识别 Claude Code 端点是官方直连 / 国产大模型 / 第三方中转;中转会提示数据泄露与封号风险,并比对已知端点黑名单
综合结论 汇总各项风险,一句话判定当前环境 Claude 使用为高 / 中 / 低风险

安装

pip install ai-ipcheck

升级到最新版:

pip install --upgrade ai-ipcheck

使用

ipcheck

环境要求

  • Python 3.10+
  • 支持 macOS / Linux / Windows

结果说明

本机真实 IP & DNS — 本机真实 IP 经国内直连回显获取,即使开着 VPN/TUN 也能露出真实 ISP 出口,用于确认真实身份是否泄露。IPv6 建议禁用,大部分代理不处理 IPv6 流量,开启后可能同时暴露两个不同地区的 IP。若检测到国内 DNS,需要在代理软件中调整 DNS 设置。

出口 IP 信息 — 显示经过代理后的出口 IP、所在国家/地区、运营商、IP 归属和时区。这些信息直接影响 AI 服务对你请求来源的判断。

代理检测ipcheck 会展示环境变量代理、系统代理和 TUN/VPN 的开关状态。系统代理只代表系统配置状态,不等于所有 CLI 流量都会继承;Codex、Claude Code 等带沙箱或独立网络栈的工具,可能需要显式设置 HTTP_PROXY / HTTPS_PROXY,或者开启 TUN 模式兜底。

IP 风险评估 — 检测 IP 是住宅还是机房类型。机房 IP 不一定有问题,但会进一步查询风险评分和滥用记录。如果风险评分偏高,建议更换节点。

时区一致性 — 分两条比对:CC CLI 比对 CLI 时区(认 $TZ)与出口 IP 时区,桌面版 比对系统时区(不认 $TZ)与出口 IP 时区。Claude Code CLI 认 $TZ,可在 shell 或 ~/.claude/settings.jsonenv 里把 TZ 设为与出口 IP 匹配的 IANA 时区(如 America/Los_Angeles);Claude 桌面版走系统时区,需改系统设置。

Claude 端点检测 — 读取 Claude Code 的 ANTHROPIC_BASE_URL,判断是官方直连、国产大模型(不经 Anthropic,无封号风险),还是第三方中转(提示「疑似中转,注意数据泄露风险」),并比对已知端点黑名单,命中会拉高综合风险。

综合结论 — 报告末尾单独成块,汇总各项给出一句话定论:当前环境 Claude 使用为「低 / 中 / 高风险」。建议启动 Claude 前先看这一行。

License

MIT © 2026 stormzhang

About

网络环境诊断工具,一键检测 IP/DNS/代理/风控/时区,确保 AI 工具流畅运行

Resources

License

Stars

173 stars

Watchers

2 watching

Forks

Packages

 
 
 

Contributors

Languages