ipcheck

KO | EN

gitlite — search

#python #hacktoberfest #react #typescript #golang #deep-learning #docker #java #windows #awesome #kubernetes #vue #pytorch #security

(★ 197)

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

ipcheck 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ipcheck

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

[English](./README_EN.md)

![screenshot](https://raw.githubusercontent.com/stormzhang/ipcheck/main/screenshot.png)

## 为什么需要这个工具

想让 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 使用为高 / 中 / 低风险 |

## 安装

```bash
pip install ai-ipcheck
```

升级到最新版：

```bash
pip install --upgrade ai-ipcheck
```

## 使用

```bash
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.json` 的 `env` 里把 `TZ` 设为与出口 IP 匹配的 IANA 时区（如 `America/Los_Angeles`）；Claude 桌面版走系统时区，需改系统设置。

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

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

## License

ipcheck

ipcheck 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ipcheck

ipcheck 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README