Files
MyIP/README_ZH.md
T

13 KiB
Raw Blame History

🧰 MyIP - 更好的 IP 工具箱

Note

这是由社区维护的翻译版本;英文版 README 为唯一权威来源,本页面内容可能滞后于英文版。

IPCheck.ing Banner

jason5ng32%2FMyIP | Trendshift

Mentioned in Awesome Self Hosted

GitHub Repo stars GitHub forks Docker Pulls

Website PWA

CodeQL Docker Build and Push CI

English | 简体中文 | 繁體中文 | Русский | Français | Português (BR) | Shqip | ไทย | हिन्दी

一个开源的一站式 IP 工具箱:多来源 IP 查询、连通性测试、WebRTC 与 DNS 泄露检测、网速测试、MTR、封锁检测、Whois 等等 —— 一条 Docker 命令即可自行部署。

👉 在这里体验:https://ipcheck.ing

欢迎收藏在线版本,也可以自行部署。

Deploy with Docker

👀 主要功能

🪪 你的 IP 与身份

  • 🛜 IP 卡片:从多个相互独立的来源并列检测你的 IPv4 和 IPv6 —— 国家、地区、城市、ASN、组织,以及该 IP 所在地的时区。
  • 🔍 IP 查询:查询任意一个你感兴趣的 IP 地址的同样详细的信息。
  • 🧾 IP 历史记录:在本地记录你使用过的 IP,可按类型和国家筛选 —— 数据只存在你的浏览器里。
  • 🖥️ 浏览器指纹:用多种方式计算你的浏览器指纹,并展示是什么让你变得可被识别。

🕵️ 泄露与隐私

  • 🚥 WebRTC 检测:揭示 WebRTC 连接过程中暴露的 IP 地址 —— 包括你的浏览器是否开启了隐私强化。
  • 🛑 DNS 泄露测试:展示是哪些 DNS 出口在解析你的请求,以便评估使用 VPN 或代理时 DNS 泄露的风险。
  • 🛡️ 广告与跟踪屏蔽检测:检查你的广告拦截器、浏览器、DNS 过滤、VPN 或路由器实际拦住了什么——涵盖广告网络、统计分析、社交平台跟踪、错误监控、设备厂商遥测、跟踪脚本与元素隐藏。
  • 📋 安全检查清单:一份覆盖 12 个领域、共 258 项的个人网络安全检查清单,进度保存在你的浏览器里。

📡 网络测试

  • 🚦 网络连通性:检测最多 60 个你自选网站的可达性,多轮测试取最低延迟 —— 还提供精选导入列表,从国家套装到 AI、社交、流媒体、游戏、开发者等应有尽有。并根据检测结果,提示你当前能否访问全球互联网。
  • 🚀 网速测试:基于边缘网络测量你的下载、上传速度与延迟。
  • ⏱️ 全球延迟测试:从遍布全球的探针 ping 你的目标 —— 可从所有可用的 Globalping 探针中按大洲分组选择国家。
  • 🚉 MTR 测试:从分布在全球的探针发起 MTR,查看数据包实际经过的路由。
  • 🚧 封锁测试:展示一个网站在全球哪些地方被封锁 —— 以及是通过什么手段封锁的。
  • 🚏 分流测试:验证你的代理软件的规则配置是否按你的预期工作。

🔦 查询与基础设施

  • 📟 DNS 解析:同时通过多个解析器解析一个域名,并按国家分组 —— 轻松发现劫持或污染。
  • 📓 Whois 查询:对域名、IP 地址和 AS 号进行 Whois 查询。
  • 🗄️ MAC 地址查询:识别一个物理地址背后的厂商与详细信息。
  • 🧮 IP 计算器:对任意 IP、前缀、范围或列表做子网计算、进制转换与 IPv6 接口解读,全部本地完成。
  • 🛰️ ASN 信息与上游拓扑:在每张 IP 卡片里直接展示 AS 详情、该 IP 前缀的历史宣告记录,以及其 ASN 到 Tier 1 骨干网的上游路径。
  • 🛂 ASN 档案:任意 AS 的完整档案 —— 注册信息与原始 Whois 记录、全球排名与规模、流量构成与连接质量、IPv4 地址分布在哪些国家、全部宣告前缀及其 RPKI 状态、上游 / 对等 / 客户网络,以及它接入的互联网交换中心和数据中心。
  • 📶 服务可用性:知名服务的实时可用状态 —— Claude、OpenAI、GitHub、Cloudflare 等 —— 数据来自它们的官方状态页,并附最近的事故。

✨ 平台能力

  • 📤 诊断报告分享:把你的测试结果生成一份诊断报告 —— 可选自动过期的只读链接、适合喂给 AI 的 Markdown,或 JSON。
  • ⌨️ 命令行 API:在终端里用一条 curl 命令获取你的 IP。
  • 🌍 地球在线:一个实时播报全球断网事件的面板。
  • 🌗 暗黑模式:自动跟随系统,也可以手动切换。
  • 📲 PWA:可以安装为手机应用,也可以安装为桌面上的 Chrome 应用。
  • ⚡ 快捷键:每个功能都有对应的快捷键 —— 按 ? 查看列表。
  • 🔤 多语言:界面内置 6 种语言,添加你的语言只需一个语言包。

📕 如何使用

使用 Docker

一条命令即可运行:

docker run -d -p 18966:18966 --name myip --restart always jason5ng32/myip:latest

或者点击本页顶部的「Deploy with Docker」按钮。

在 Node 环境部署

确保你已经安装了 Node.js,然后克隆代码:

git clone https://github.com/jason5ng32/MyIP.git

安装与构建。本项目使用 pnpm —— 如果你还没有,请先安装(npm 随 Node 一起提供,这条命令一定能用):

npm install -g pnpm
pnpm install && pnpm run build

运行:

pnpm start

程序会运行在 18966 端口。

⚙️ 配置

Important

MaxMind GeoLite2 凭证是必需的。 它为 IP 地理位置与 ASN 查询提供数据 —— 不配置时,MaxMind 数据源会返回 503。凭证是免费的:→ MaxMind Setup

Warning

在真实域名上部署时,ALLOWED_DOMAINS 是必需的。 它是后端 API 的主机名白名单 —— 不配置时,来自非 localhost 域名的每个请求都会收到 403。→ Reverse Proxy & Domains

docker run -d -p 18966:18966 \
  -e MAXMIND_ACCOUNT_ID="YOUR_ACCOUNT_ID" \
  -e MAXMIND_LICENSE_KEY="YOUR_LICENSE_KEY" \
  -e DATASET_AUTO_UPDATE="true" \
  -e ALLOWED_DOMAINS="your-domain.com" \
  --name myip --restart always \
  jason5ng32/myip:latest

其余全部是可选配置 —— 第三方 API Key、安全与限流、日志、Sentry、curl API 域名等,详见环境变量参考。

📖 官方文档

完整指南在 MyIP 文档中心:docs.ipcheck.ing

  • 开发者指南 —— 部署、配置、架构说明与参与贡献
  • 知识库 —— 每个工具的使用说明、网络问题排查步骤、网络概念科普

🤝 参与贡献

欢迎参与贡献!我们维护着一批对新手友好的任务,每条都写明了具体文件路径、验收标准,并有测试引导你完成一次绿色构建:

  • 🏷️ Good first issues —— 添加你所在国家的 DNS 解析服务、添加精选网站列表、把 README 翻译成你的语言、润色翻译等
  • 🌐 TRANSLATING.md —— 把 UI 带到你的语言:一个语言包加上一行注册表,而且部分翻译也是欢迎的首次 PR
  • 📄 CONTRIBUTING.md —— 环境搭建、开发约定与 PR 流程(请将 PR 提交到 dev 分支)

👩🏻‍💻 高级用法

同时查询真实 IP 与代理 IP 的代理规则

如果你在通过代理上网,可以考虑在你的代理配置里增加下面的规则(请根据你使用的客户端进行修改)。这样就可以同时查询你的真实 IP 和使用代理时的 IP:

# IP Testing
IP-CIDR,1.0.0.2/32,Proxy,no-resolve
IP-CIDR6,2606:4700:4700::1111/128,Proxy,no-resolve
DOMAIN,4.ipcheck.ing,DIRECT
DOMAIN,6.ipcheck.ing,DIRECT
# Rule Testing
DOMAIN,ptest-1.ipcheck.ing,Proxy1
DOMAIN,ptest-2.ipcheck.ing,Proxy2
DOMAIN,ptest-3.ipcheck.ing,Proxy3
DOMAIN,ptest-4.ipcheck.ing,Proxy4
DOMAIN,ptest-5.ipcheck.ing,Proxy5
DOMAIN,ptest-6.ipcheck.ing,Proxy6
DOMAIN,ptest-7.ipcheck.ing,Proxy7
DOMAIN,ptest-8.ipcheck.ing,Proxy8
DOMAIN,ptest-9.ipcheck.ing,Proxy9
DOMAIN,ptest-10.ipcheck.ing,Proxy10
DOMAIN,ptest-11.ipcheck.ing,Proxy11
DOMAIN,ptest-12.ipcheck.ing,Proxy12

💖 赞助商与支持者

作为一个开源项目,我非常感谢以下赞助者对我的支持:

赞助商

RapidProxy
↳ RapidProxy — 全球住宅代理服务,覆盖 9000 万+ 住宅 IP,支持智能轮换、稳定会话和精准地理定位,适用于代理测试、浏览器自动化及数据采集等场景。低至 $0.55/GB,使用 RAPID10 享 9 折优惠。

SwiftProxy
↳ SwiftProxy — 提供高质量动态和静态住宅代理,拥有 9000 万+住宅 IP,覆盖全球 220+ 个地区,支持 HTTP(S)、SOCKS5 协议及动态轮换和粘性会话。动态住宅代理低至 $0.7/GB,使用优惠码 PROXY90 再享九折优惠。

Proxy-Seller
↳ Proxy-Seller — 提供私有住宅、移动(4G/5G/LTE)、静态 ISP 以及数据中心 IPv4/IPv6 代理,支持 HTTP(S) 与 SOCKS5 协议,拥有 4700 万+ 住宅 IP,覆盖全球 220+ 地区,可精准定位国家、城市及运营商,具备 99.7% 可用性与 24/7 技术支持。MyIP 用户使用优惠码 CHECKINGIP15 可享 15% 折扣。

V.PS
↳ V.PS — 高性能 KVM VPS,覆盖全球多个地区。日本与新加坡线路更有三网优化,提供极高速网络连接。支持 IPv4 与 IPv6。


支持者

Cloudflare Project Alexandria

1Password

Greptile

Sentry

GitBook

有意赞助 MyIP?成为赞助者

📄 开源协议

MIT © Jason Ng