前言

平时排查网络问题，我经常要在几个工具之间来回切换：先查当前 IP，再检查网站是否经过代理，接着看 AI 平台有没有故障。如果同一网络下只有某个浏览器不能用，还得继续检查扩展、权限和浏览器环境。

这些检测单独做都不复杂，麻烦的是结果分散，放在一起又容易混淆。比如 IP 查询显示的是某次请求的出口，全球 Ping 测的是远程机器到目标的路径，它们回答的其实是不同的问题。

于是我把日常用到的检测整理成了 One IP。这篇也是网站的使用说明：先从一次基本检查开始，再结合具体场景，说明各个工具的用法和结果含义。没有网络基础也可以跟着操作，遇到术语时看对应解释即可。终端与 API 放在后面，只使用网页可以跳过。

• 在线使用：ip.huzhihui.com
• 开源代码：GitHub / one-ip
• 接口说明：API 使用
• 问题反馈：[email protected]

本文按 2026 年 9 月整理的开源项目页面说明。“分流出口”已合并到“网站连通与出口”，旧入口会跳转。文中截图来自此前版本，用于认识页面布局；按钮位置与功能名称以当前页面为准。

如何使用这份文档

第一次使用，可以从“快速开始”往下读。已经有具体问题时，直接找到对应章节，按操作步骤完成检测，再对照结果说明。前半部分介绍网页工具，后半部分整理常见问题、API 和数据说明。

快速开始：完成一次基本检查

打开网站，找到需要的工具

用电脑或手机浏览器打开 One IP。电脑端通过页面导航切换功能，手机端通过底部导航进入对应分类，再选择分类里的工具。

网站主要分成五个入口：

截图已经遮盖 IP、位置和运营商信息。截图里的延迟、颜色和状态是当时的结果，不是你打开网站后应该得到的“标准答案”。

先看出口，再看网站响应

进入概览后，检测结果会逐步出现。先等待当前区域完成加载，向下滚动查看其他区域。部分网站检测会在对应内容进入可见区域后开始，刚打开页面时看到等待状态，不一定是卡住了。

第一次只需要关注两件事：

1. 有没有查到公网出口 IP。 有结果就先记住地址及其来源，不用急着理解所有字段。
2. 常用网站有没有返回响应。 多个目标都失败，与只有一个目标失败，后续排查方向不同。

没有代理、只是想了解自己的网络，到这里已经完成了基础检查。如果还想知道某个网站为什么不能用，再进入后面的对应章节。

修改前后各测一次

有了第一轮结果，接下来就可以做对比了。这里我更建议保留修改前的结果，再调整一个条件重新检测。这样至少能知道，这次变化与哪一步操作有关。

例如想检查代理是否生效，可以先记录当前结果，接着只打开代理，再刷新页面观察。不要同时换 Wi-Fi、换浏览器、换节点，否则结果虽然变了，却不知道是哪一步起了作用。

可以简单记录：

检测时间：使用设备和浏览器：当前网络：家里 Wi-Fi / 公司网络 / 手机流量代理状态：关闭 / 开启，当前节点或策略检测目标：修改前的出口和结果：本次只修改了什么：修改后的出口和结果：

这个记录留给自己排查即可。公开发截图或求助时，再遮盖 IP、指纹标识和具体位置信息。

使用前，先认识几个常见概念

接下来会用到 IP、分流、延迟等概念。我们先把它们放在一起说明，后面再结合实际结果来看。不需要记住缩写，阅读某个功能时回来查就可以。

另外，“查询一个 IP”和“使用这个 IP 上网”是两回事。你在输入框查询 1.1.1.1，只是查看这个地址的信息，不会把自己的出口改成它。

公网出口：确认请求从哪里出去

入口：概览。

先来看最常用的出口查询。我们打开网页时，目标服务会收到一次连接，而公网出口 IP 就是它看到的来源地址。这个地址可能属于家庭宽带，也可能属于请求经过的代理服务器。

基本用法

1. 打开概览，等待 IP 相关区域返回结果。
2. 查看结果来自哪个探测来源，再看它返回的地址。
3. 记录地址、国家或地区、运营商等信息。
4. 如果要比较网络变化，只切换一个条件，例如从 Wi-Fi 切到手机流量，再刷新检测。

为什么会看到不止一个 IP

前面查到地址后，可能会发现几个来源给出的结果并不相同。来看看一个简单的过程：浏览器分别访问网站 A 和网站 B，A 告诉我们它看到的来源地址，B 也返回自己的观察结果。假如 A 直连、B 经过代理，两边返回不同地址就符合这条请求路径。

常见情况包括：

• 网站 A 直连，网站 B 经过代理，两者看到不同出口。
• IPv4 经过代理，IPv6 走另一条路径，两种地址的网络归属不同。
• 浏览器扩展只代理网页流量，其他类型的连接没有经过同样的路径。

也就是说，出口要和目标一起看。排查某个网站时，我们关心的是访问它的请求走哪条路径，而不是先从所有结果里选出一个地址，再要求其他结果与它一致。

常见结果怎么处理

网站连通与出口：检查响应和分流

入口：网络检测 → 网站连通与出口。

知道公网出口的含义后，接下来把范围缩小到具体网站。这个页面把两类结果放在一起：连通检测观察请求是否有响应，出口检测观察可读取的来源地址。

比如，我们希望某个目标经过代理。它能打开，只能说明这次访问可用；还要对照出口，才能进一步判断路径是否符合设置。

先检查网站是否响应

1. 打开页面，找到要观察的网站分组。
2. 滚动到对应区域，等待测试记录逐步填充。
3. 查看每个目标的延迟和测试记录。
4. 若要复测，使用对应分组的“重新测试”，保持网络设置不变，比较两次结果。

当前网站连通表格会展示一组多次测试记录。等待中的记录与失败记录不同：等待表示还没有完成，失败表示那一次没有成功取得探测结果。先等这一轮结束，再判断是否持续失败。

延迟先比较同一个目标在同样条件下的变化。例如同一浏览器访问同一目标，多轮结果经常在几十毫秒与几秒之间跳动，就值得继续检查网络波动。不要直接拿两个网站的数值给整条线路排名，它们的资源、距离和响应策略都可能不同。

再确认出口是否符合你的配置

假设你的目标是“国内网站直连，AI 网站经过代理”，可以照着做：

1. 在当前配置下，记录可读取出口的目标及其地址。
2. 到代理软件中确认当前使用的模式和规则。
3. 只调整你想检查的那一条规则或对应策略。
4. 返回 One IP 重新检测，必要时刷新页面。
5. 对比目标出口有没有按预期变化，再实际打开目标网站确认。

下面是说明判断方法的假设示例，不是实测数据：

如果预期只有一个目标变化，结果所有目标都变了，先检查是否切到了全局代理。如果目标始终没变，检查域名是否匹配了预期规则，以及浏览器是否实际使用了该代理。One IP 负责展示检测结果，不会替你修改代理设置。

“暂不可用”是否意味着网站打不开

不一定。检测请求与完整网页访问不是完全相同的操作。浏览器安全限制、防护页面、扩展拦截或目标不提供可读取信息，都可能影响检测。

这里的“跨域限制”可以简单理解为：浏览器允许打开一个网站，不代表允许另一个网页读取它的响应内容。

遇到这种结果，下一步是直接打开目标网站测试。若目标可以正常使用，只是 One IP 读不到出口，就把这一项理解为缺少检测数据，不用为了让它变绿反复修改网络。

IP 检测：查看地址归属与信誉

入口：网络检测 → IP 检测。

基本用法：查询当前出口或指定地址

1. 找到 IP 搜索框；若当前页面收起了搜索，先展开搜索。
2. 输入一个 IPv4 或 IPv6 地址。例如 1.1.1.1 可以用来练习输入格式。
3. 提交查询，等待详情返回。
4. 先核对结果中的地址，再查看归属、网络分类和信誉信息。
5. 已经查过的地址可以从“最近查询”中选择；需要最新结果时重新发起查询。

只填地址，不填网页链接。例如输入 1.1.1.1，不要输入 https://1.1.1.1/path。查询网站的注册信息请使用后面的 WHOIS 工具。

从地址归属到网络分类

首先看 IP 是否正确，再看 国家或地区、ISP、ASN，最后看分类和信誉。

地图只是帮助理解数据库给出的归属位置，不是手机定位。国家、城市、注册机构和实际使用地点也不总是一一对应。多个来源不一致时，先保留差异，不要直接挑一个喜欢的结果当结论。

住宅、移动网络、数据中心等标签描述的是数据源对地址的分类；VPN、代理、Tor 等标签也是线索。一个地址被标记为数据中心，并不表示它已经出故障；没有代理标签，也不保证目标平台一定把它看作普通家庭网络。

信誉分怎么看

IP 健康度接口的分数范围是 0–100，越高表示上游数据源给出的信誉评价越好。项目将有效分数整理成以下状态：

例如显示 80 分，只能说明本次数据源评价落在 good 区间，不表示网速是 80，也不表示有 80% 的概率通过某个平台验证。信誉分不等于 ChatGPT、Claude 或其他服务的官方风控结果。

普通使用者可以把它作为补充信息：先确认目标能否使用，再结合分类和信誉排查，没必要为了一个分数不断更换出口。

全球 Ping：从不同地区检测同一个目标

入口：网络检测 → 全球 Ping。

测量的是哪一段网络

前面的检测主要围绕当前浏览器。如果想知道同一个目标从其他地区访问起来怎么样，就需要换一个观察位置。

Ping 的基本思路是发出探测消息，再统计回应所需的时间。One IP 使用 Globalping 的远程探针完成这一步，探针就是部署在不同地方、负责执行测量的机器。

所以，你坐在上海，选了东京探针，测量的也是“东京探针到目标”的路径，而不是“你的电脑到目标”的路径。

基本用法：选择目标与探测地区

1. 在输入框填写目标 IP 或域名，例如 1.1.1.1 或 example.com。
2. 第一次先使用全球检测或一个区域，不必直接选择所有城市。
3. 想比较特定位置时，打开“自定义地区”，搜索国家或城市，选择后使用所选地区。
4. 点击“开始”，等待不同节点分批返回。
5. 查看结果中的地区、延迟和丢包信息；不需要继续时可以“停止检测”，保留已经返回的结果。

只输入 IP 或域名，不需要附带网页路径。优选模式适合先做大致比较，完整覆盖会使用更多探测地区和额度，确有需要时再选择。

结果怎么看

• 延迟：这条探针到目标路径上的往返耗时，先比较同一目标的不同探针。
• 丢包：发出的探测中，有多少没有收到回应。少量测试里的偶发丢包要复测，不能只看一次就确定长期不稳定。
• 超时或没有数值：可能是网络问题，也可能是目标不响应这种探测。
• 部分测量未完成：先查看已经返回的节点，不要把所有未返回节点都当成目标故障。

有些目标会限制 ICMP，也就是 Ping 常用的探测方式。这时网页可能仍然可以打开。因此，全球 Ping 适合补充“不同地区的访问差异”，判断当前浏览器是否好用，仍要回到网站连通和实际访问。

DNS、CDN 与域名信息查询

网络排查还会遇到几类看起来相近的信息：域名由谁解析、请求到了哪个节点、资源登记在谁名下。它们对应不同环节，我们按用途分别来看。

DNS 出口：谁在帮你解析域名

入口：DNS 出口。

我们输入 ip.huzhihui.com 时，浏览器需要先获得连接目标所用的地址。DNS 负责帮助完成这一步，可以把它理解为根据名称查地址的过程。

因此，网站访问不符合预期时，除了查看网页出口，也可以检查解析请求体现出的路径。

打开页面后，等待检测返回，观察解析出口及其网络归属。要比较配置，可以先记录结果，再只更改安全 DNS 或代理的解析设置，然后重新检测。

如果 DNS 出口与网页出口属于不同地区，先检查浏览器是否启用了独立的安全 DNS、代理是否使用远程解析。它们经过不同服务时，结果可能不同，不能只凭地区不一致就确定“泄漏”。

这个页面显示的是检测过程观察到的解析出口，不一定就是你在系统网络设置里手动填写的 DNS 地址。存在中转解析时，两者可能不同。

CDN 节点：这次请求碰到了哪个边缘节点

入口：CDN 节点。

CDN 可以理解为分布在不同地方的服务节点。网站使用它来提供内容或转发请求，访问同一服务时，不同网络可能连接到不同节点。

1. 打开页面，查看对应厂商的检测结果。
2. 展开被省略的节点或响应信息，阅读可获得的详情。
3. 如需比较线路，记录当前结果，再切换一个网络条件后复测。

节点标识和缓存字段来自服务愿意公开的信息，某些字段可能没有返回。它们适合帮助理解当前请求路径，不直接等于网站源服务器的位置，也不能单凭某个节点代号判断线路优劣。

WHOIS：查域名、IP 或 ASN 的注册资料

入口：WHOIS。

WHOIS 页面通过 RDAP 读取注册资料，可以理解为查询网络资源的登记信息。

1. 输入域名、IP 地址或 AS 号，例如 example.com、1.1.1.1、AS13335。
2. 提交查询，等待结果返回。
3. 查看登记机构、资源范围、相关日期、状态和实体信息，具体字段取决于查询对象。
4. 有疑问时再查看原始响应，不需要一开始就读原始数据。

查询域名时不必加 https:// 或文章路径。域名到期时间是注册层面的信息，不是网站停机时间；登记机构也不一定是网站实际运营者。资料被隐私保护或数据源没有公开时，部分内容为空很正常。

子域名查询：查公开证书里出现过的名称

入口：子域名查询。

以 example.com 为例，www.example.com、api.example.com 都是它下面的子域名。这个工具查询证书透明度日志，也就是公开证书留下的记录。

1. 输入要查询的域名，例如 example.com。
2. 发起查询，等待证书日志返回。
3. 查看结果列表，数量多时翻页，可以复制单条或“复制全部”。

结果表示名称曾经出现在相关证书记录中，不保证现在还在使用，也不保证能打开。没有发现记录，同样不代表这个域名没有子域名。

AI 检测：从网络响应到实际使用

入口：AI 检测。

基本用法

先选定一个正在出问题的平台，完成下面这一轮检查。不要同时调整多个平台的设置，否则很难比较结果。

1. 打开 AI 检测，找到你正在使用的平台，例如 ChatGPT、Claude 或 Gemini。
2. 等待资源探测返回，查看目标域名、延迟及可获得的出口信息。
3. 进入对应平台详情，查看更具体的检测与快捷入口。
4. 到“服务状态”核对是否有相关故障。
5. 最后实际打开该平台，尝试你原本失败的操作，例如登录或发送一条消息。

不是所有平台都能返回可读取的出口。没有出口数据时，不要拿别的平台或旁边的对照地址替代。对照结果只说明那一次对照请求的路径。

三种常见情况

有延迟数值，但无法聊天。 说明某个被测资源有响应，不代表登录、验证码、订阅、额度或模型请求都能成功。继续看目标页面的实际报错，并核对官方服务状态。

One IP 探测失败，但目标网站能用。 可能是被测资源、跨域规则或浏览器拦截影响了检测。以实际使用情况为补充，不必为了一项探测修改原本可用的配置。

多个 AI 目标和其他网站一起失败。 先回到基础网络与代理检查。如果普通网页也打不开，应先恢复网络，再排查单个平台。

各平台的网页、API 和不同产品可能是不同服务。尤其是状态链接指向 API 产品时，要看清楚它对应的范围，不能把 API 正常直接理解成聊天网页一定正常。

浏览器检测：环境、指纹与权限

前面几组工具主要检查请求路径和服务响应。接下来再看浏览器本身。

一个常见场景是：同一台电脑、同一条网络，换个浏览器就能正常使用。这时网络未必是主要原因，我们可以从环境信息开始，再根据现象检查指纹、扩展和权限。如果所有设备都无法联网，仍应先回到网络检测。

环境信息：看看浏览器对外提供了什么

入口：环境信息。

进入页面后，查看系统、浏览器、语言、时区、屏幕和硬件相关信息。文字放不下时打开详情阅读。

第一次只需要核对：系统是否符合实际、语言和时区是否符合自己的设置、屏幕信息是否与当前窗口环境相符。浏览器可能为保护隐私而减少或修改可读取信息，因此它不是完整的电脑硬件检测报告。

例如人在中国使用海外代理，IP 显示海外、时区仍是中国，并不矛盾：前者描述网络出口，后者来自设备环境，不需要为了让它们相同而随意修改系统。

指纹检测：比较浏览器环境有没有变化

入口：指纹检测。

这里先解释一下“指纹”。浏览器会提供语言、屏幕、字体及绘图能力等信息，指纹算法将一组特征整理成结果，再生成摘要编号，也就是页面里的指纹 ID。

我们使用它，主要是为了比较环境变化。比如调整一个扩展前后，哪些组成项目发生了变化，结果 ID 是否也随之改变。

1. 进入页面，等待首次检测完成。
2. 记录所选算法及结果 ID，查看组成项目。
3. 保持同一个浏览器、同一种算法，重新检测一次，观察结果是否变化。
4. 若要排查扩展影响，每次只调整一个扩展，再对比相同算法下的结果与项目详情。

不同算法的编号本来就不应直接比较。浏览器升级、字体、隐私模式或设置变化，也可能改变结果。编号相同不证明是同一个人，编号变化也不意味着账号一定会被平台限制。

当前页面还提供 JA3/JA4 Fingerprint 选项。这类信息描述连接建立时的 TLS 特征，与网页通过 JavaScript 采集的环境指纹不同。TLS 可以简单理解为 HTTPS 建立加密连接的过程。普通用户不需要据此做设置；显示“平台未提供”时，只表示当前没有得到对应字段。

环境一致性：寻找值得核对的差异

入口：环境一致性。

页面会自动开始本地深度检测，等待完成后先看整体结果，再打开具体模块详情。需要复测时使用重新检测；离开页面会清理当前检测。

一致性检查是在比较不同接口返回的信息是否存在需要注意的差异。请按下面的方式读结果：

例如，启用了防指纹保护的浏览器可能有意改变某些信息。看到信号后，先判断是否与你自己的设置有关，不需要把所有隐私保护关闭来追求一个“全绿”结果。

深度检测基于项目中的 CreepJS 模块，本地实现的范围与官方完整站点不同，也不包含官方联网评分和 Worker 检测。多个模块可能指向同一个原因，不能把报告条数直接当成独立故障数量。

自动化特征：查看线索，不直接判断真人或机器人

入口：自动化特征。

打开页面查看项目详情，关注到底是哪一个可观察信号触发了提示。它不是账号风控测试，也不能覆盖所有自动化工具。

如果没有使用自动化工具却看到提示，可以在相同网络下，用另一个正常浏览器作对照，再逐项排查扩展或环境设置。这里先关注提示对应的具体项目，再判断它是否与当前使用问题有关。

权限与隐私：检查摄像头、麦克风、定位和 WebRTC

入口：权限与隐私。

例如，视频通话页面打不开摄像头，就可以从这里检查权限。页面显示的状态可能是已允许、已拒绝、需要询问，或者浏览器无法提供状态。

需要注意的是，网站权限和系统权限是两层设置。浏览器允许某个网站使用摄像头后，操作系统仍可能阻止浏览器访问设备，所以还要结合实际测试。

需要测试摄像头、麦克风或定位时，点击对应功能，再阅读浏览器弹出的权限提示。只测试当前需要的项目即可；不使用这些功能，不必授权。当前媒体权限测试在获取媒体流后会关闭，不进行音视频录制。

如果曾经点过拒绝，浏览器可能不会再次弹窗。可以打开地址栏旁的站点权限设置，检查对应权限；必要时再检查操作系统的隐私权限，然后重新测试。

WebRTC 是浏览器实时音视频通信使用的技术之一。它的连接路径可能与普通网页请求不同。查看检测地址时，将它与 HTTP 出口对照：结果不同，说明值得核对网络配置，但还要区分公网地址、内网地址以及浏览器隐藏地址后的表现，不能看到任何差异就直接断定泄漏。

人机校验：体验本站的一次验证

入口：人机校验，该入口需要服务端配置满足条件才会显示。

进入后等待自动验证，查看 Turnstile 状态及 reCAPTCHA v3 结果。失败或等待超时后可按页面提示重试；不要连续高频刷新。

reCAPTCHA v3 返回 0–1 范围的分数，本站当前通过阈值为 0.50。它与 IP 健康度的 0–100 分完全不同。这里通过了，仅表示本站这一次验证达到本站条件，不保证在其他网站也会通过。

看不到入口、提示未配置或平台不可用时，可能是站点配置或服务商限制，不需要因此修改自己的 IP。

服务状态：核对厂商的故障与维护

入口：服务状态。

1. 找到出问题的平台或服务。
2. 查看当前状态、更新时间，以及是否有故障或维护事件。
3. 打开事件详情，确认影响的是哪个产品、组件或地区。
4. 如有官方事件链接，继续阅读厂商说明与处理进度。

“降级”通常表示服务仍可能运行，但速度或部分功能受影响；“故障”表示有功能不可用；“维护”表示正在进行计划内操作。仍要以对应事件描述为准。

如果事件明确影响你正在使用的功能，而且时间也对应，就可以先等待恢复，避免反复调整本地配置。若厂商显示正常，但只有自己失败，则继续检查网络、浏览器和账号。

官方状态也可能晚于实际故障更新。“没有公告”和“所有用户一定正常”不是一回事；One IP 没读到状态时，也不能替厂商判定正常。

常见问题与排查思路

开了代理，为什么 IP 还是没变

1. 确认代理软件已经连接，并记下当前模式。
2. 到“网站连通与出口”看具体目标，而不是只看概览中的一个来源。
3. 如果规则规定这个目标直连，出口不变可能符合预期。
4. 如果规定经过代理，检查该域名的规则命中与浏览器代理设置。
5. 只修改相关配置，再刷新复测，最后直接访问目标验证。

普通网页正常，AI 平台不能用

1. 到 AI 检测查看该目标的响应情况。
2. 核对可读取的出口是否符合预期。
3. 到服务状态查看对应产品的事件。
4. 直接打开目标平台，记录是登录失败、验证码失败、额度不足，还是发送消息失败。
5. 如果同一网络下另一个浏览器可用，再查原浏览器的扩展、权限和环境。

这几种报错属于不同环节，求助时保留原始错误文字，比只说“不能用”更容易定位。

浏览器和终端查到的 IP 不一样

先看浏览器是不是用了代理扩展，再看终端是否配置了代理。浏览器扩展通常不意味着所有程序都经过同一出口。用同一网络路径比较之后，再判断是否异常。

浏览器检测出现多项异常

先打开具体详情，区分“发现差异”和“检测失败”。然后保持网络不变，用另一个正常浏览器对照。若只有一个浏览器出现问题，再逐项检查扩展及隐私设置，不必一次重置全部配置。

检测长时间等待或大量失败

1. 先打开其他常用网站，确认设备能够正常上网。
2. 等当前检测结束，不要同时开很多标签页反复测试。
3. 若页面提示请求过多，暂停一段时间再试。
4. 只切换 Wi-Fi 或手机流量其中一个条件，判断是否与当前网络有关。
5. 若其他网页正常、One IP 仍持续异常，记录时间、页面地址和错误信息后反馈。

换了节点，页面仍显示旧结果

先确认当前展示的是查询历史还是刚刚请求的结果。最近查询可能保留此前成功查询的数据，需要重新提交来更新。再确认当前检测已完成，必要时刷新页面。对比时记录检测时间，避免把旧结果和新结果混在一起。

进阶使用：通过 API 查询 IP 健康度

前面的操作都在网页里完成。如果希望在终端快速查看出口，或者把结果交给脚本处理，可以使用 IP 健康度 API。API 是供程序调用的接口，我们先用一条命令读取它，再看参数和返回字段。只使用网页的朋友可以跳过这一节。

第一步：打开终端，先看文字结果

macOS 可以打开“终端”；Windows 可以打开 PowerShell。系统提供 curl 时，可以直接执行以下命令。旧版 Windows PowerShell 建议把 curl 写成 curl.exe，避免调用到同名别名。

curl -sS 'https://ip.huzhihui.com/api/ip/health?format=text'

复制整行，粘贴后按回车。curl 用来发送请求，-sS 隐藏进度条但保留请求错误，format=text 表示希望得到便于阅读的文字。

无需提供 API Key，也就是无需填写接口密钥。不要在命令里加入账号密码。若提示找不到命令，可以继续使用网页，不影响其他功能。

第二步：理解它查的是谁

没有填写 ip 参数时，接口查的是 这次终端请求的公网出口，不是自动读取浏览器里的结果。

想查询指定地址，可以这样写：

curl -sS 'https://ip.huzhihui.com/api/ip/health?ip=1.1.1.1&format=text'

这里 ? 后面是参数，& 用来连接多个参数。把 1.1.1.1 换成你要查询的公网地址即可。IPv6 也可以：

curl -sS 'https://ip.huzhihui.com/api/ip/health?ip=2606:4700:4700::1111&format=text'

不要填写 192.168.x.x 这类内网地址。自部署的本地开发环境无法直接识别真实访客出口，需要明确指定公网 ip。

第三步：程序需要时再使用 JSON

不写 format=text，默认返回 JSON，也就是按字段名称组织的数据：

curl -sS 'https://ip.huzhihui.com/api/ip/health?ip=1.1.1.1'

主要字段如下：

分类字段中的 true 是肯定标记，false 是否定标记，null 是没有有效数据。不要把 null 转换成 false 或 0，否则会把未知误判为明确结论。

已经安装 jq 的用户，可以提取部分字段：

curl -fsS 'https://ip.huzhihui.com/api/ip/health?ip=1.1.1.1' \  | jq '{ip, score, status, country, isp, asn, flags}'

这条命令用于脚本处理，额外使用了 -f，HTTP 错误时会以失败状态退出。若想阅读服务端返回的错误正文，可以去掉 -f。

接口报错时怎么处理

错误正文使用 {"error":"…"} 形式，即使请求文字格式也可能看到 JSON 错误。不要把所有非正常返回都当成网络不通，先读错误说明。

查询记录、数据与问题反馈

IP、WHOIS 等查询工具会在当前浏览器保存最近成功查询的记录，方便再次查看。主题、语言和部分显示偏好也会保存在本地。需要清除时，可以通过浏览器的站点数据管理删除本站数据；清除后这些历史和偏好会一起重置。

“保存在浏览器里”不等于检测过程完全离线。查询 IP 时，目标地址可能发送给对应数据源；检测网站连通时，目标服务会看到这次连接；全球 Ping 使用远程测量服务；地图和人机校验也可能加载第三方资源。

清除本地站点数据不会删除第三方服务或托管平台已有的记录。查询地址也可能出现在浏览器历史中。具体说明可以查看隐私政策和使用条款。

反馈问题时，建议提供下面这些信息：

出问题的页面：检测时间及所在时区：设备、系统和浏览器版本：使用 Wi-Fi 还是手机流量，是否经过代理：做了哪些操作：预期看到什么：实际看到什么，完整错误文字是什么：换网络或换浏览器后的结果：

截图前遮盖公网 IP、精确位置和指纹标识。不要附带账号密码、Cookie 或接口密钥。若问题只出现在某个第三方网站，也一并说明直接打开该网站的结果。

结语

到这里，One IP 的主要功能就介绍完了。实际使用时，先选一个具体问题，再找到对应工具做检查：出口不符合预期，就看分流；某个平台不可用，就对照连通结果和官方事件；浏览器之间表现不同，再检查环境与权限。

这篇也作为网站的使用说明保留。后续页面或字段调整时，会继续在对应章节补充。排查过程中记下修改前后的结果，最后回到目标网站验证，就能把工具里的信息用到实际问题上。