zhihui-hu/one-ip

选用指南

AI 根据 README 整理 · 2026/10/14 17:11:00

使用方式

通过网页在线体验或部署到 Cloudflare Workers 后使用，也提供终端 API 接口。

查看 README 依据

<img src="https://img.shields.io/badge/Leaflet-199900?logo=leaflet&amp;logoColor=white" alt="Leaflet" /> <img src="https://img.shields.io/badge/pnpm-10-F69220?logo=pnpm&amp;logoColor=white" alt="pnpm 10" /> <img src="https://img.shields.io/badge/Prettier-F7B93E?logo=prettier&amp;logoColor=black" alt="Prettier" /> </p> IP 查询、网络诊断、浏览器检测与 AI 服务状态工具箱。 **中文** · [English](README.en.md) [在线体验](https://ip.huzhihui.com/) · [GitHub](https://github.com/zhihui-hu/one-ip) 点击下方按钮，一键部署到 Cloudflare。

WebMCP 仍处于实验阶段。本地可在 Chrome 开启 `chrome://flags/#enable-webmcp-testing` 后检查 `await document.modelContext.getTools()`；线上 Chrome 访问需要参与 [WebMCP Origin Trial](https://developer.chrome.com/docs/ai/webmcp/) 或等待浏览器正式支持。本站没有内置试验令牌。工具只在当前页面同源暴露，不向跨源 iframe 授权。查询结果可能包含第三方数据；浏览器指纹、出口 IP 和 WebRTC 结果可能涉及隐私，调用前应由用户决定是否交给代理处理。 ## 终端与 API 部署此版本后，可通过 `GET /api/ip/health` 查询 IP 健康度，无需 API Key。 ```bash # 当前请求的公网出口 IP，终端文本 curl -fsS 'https://ip.huzhihui.com/api/ip/health?format=text' # 默认返回 JSON，便于脚本处理 curl -fsS 'https://ip.huzhihui.com/api/ip/health' # 指定公网 IPv4 或 IPv6

部署要求

部署需要 Cloudflare Workers 环境，构建使用 Node.js 24 和 pnpm 10.32.1；基础功能无需环境变量或 API Key。

查看 README 依据

[](https://deploy.workers.cloudflare.com/?url=https%3A%2F%2Fgithub.com%2Fzhihui-hu%2Fone-ip) ## Cloudflare 部署教程 1. [Fork 本项目](https://github.com/zhihui-hu/one-ip/fork)到你的 GitHub 账号。 2. 登录 [Cloudflare 控制台](https://dash.cloudflare.com/)，进入 **Workers & Pages**，创建 Worker，选择导入 Git 仓库。 3. 连接 GitHub，选择你的 `one-ip` Fork，生产分支填 `main`。 4. 构建命令填 `pnpm build`，部署命令填 `pnpm deploy`。使用 Node.js 24 和 pnpm 10.32.1，根目录保持默认。 5. 点击部署，完成后打开 `workers.dev` 地址。自定义域名在 Worker 设置中绑定。

项目使用 **Cloudflare Workers + Static Assets**，`/api/*` 接口需要 Worker。基础功能无需应用环境变量或 API Key。Turnstile 和 reCAPTCHA 的配置见“验证体验”。 国内网络访问地图时，建议在 Worker → Settings → Variables and Secrets 配置 `TIANDITU_TOKEN`（也可以用 `pnpm exec wrangler secret put TIANDITU_TOKEN`）。配置后地图优先使用天地图，失败时回退到 OpenStreetMap；未配置时保持 OpenStreetMap。 Workers Builds 会在 `main` 收到提交时构建和部署。上方按钮使用原项目地址；需要保留 Fork 关系和更新工作流时，请按教程导入你的 Fork。 ## 功能 | 模块 | 支持的功能 |

已知限制

第三方服务的限流和跨域限制会影响查询结果；IP 类型和信誉分仅供参考，不代表 AI 平台的官方判断。

查看 README 依据

| 使用体验 | 中英文、深浅主题、移动端布局与底部抽屉、查询历史、二维码分享与复制链接 | | 可选验证体验 | Cloudflare Turnstile、Google reCAPTCHA v3；入口需要配置和域名匹配 | 第三方服务的限流和跨域限制会影响查询结果。HTTP 耗时与 ICMP Ping 的测量方式不同。IP 类型和信誉分供参考，不代表 AI 平台的官方判断。 ### WebMCP 支持浏览器原生 WebMCP：在提供 `document.modelContext` 的浏览器中，页面会注册结构化工具，覆盖 IP / WHOIS / 子域名查询、网络与 AI 检测、服务状态及浏览器诊断。`one_ip_catalog` 可列出支持的站点、平台和页面；`one_ip_open_page` 可导航到需要用户操作的权限与人机校验页面。工具使用现有数据源和请求限制，支持取消；不支持 WebMCP 的浏览器仍可正常使用网页。