实用技巧

找出某个网站或 API 连不上的原因

当互联网正常、只有某个地址连不上时，Kilobat 会逐层检查，指出是哪一层失败了，以及下一步该怎么做。

App 和 CLI 中免费核查日期：2026年10月29日

在 App 中

  1. 打开仪表盘，点按“健康”标签页。

  2. 找到“为什么连不上？”。

  3. 把连不上的确切地址粘贴到输入框中，例如 github.com 或完整的 URL。

  4. 如果是某个 App 出了问题，就选择该 App。Kilobat 还会检查它自己的代理和打开的连接。

  5. 点按“检查”。查看失败的那一层和下一步。

使用 CLI

  1. 检查一个主机。

    kilobat why api.example.com

    输出每一层的结果（ok、warning、failed 或 skipped），然后是结论和下一步。有一层失败时，命令以 1 退出。

  2. 检查某个 App 使用的确切 URL。输出会隐藏查询参数的值。

    kilobat why https://example.com/file.zip --app com.example.App

  3. 通过 App 在自身设置中配置的代理地址进行测试。

    kilobat why https://huggingface.co --proxy http://127.0.0.1:7890

  4. 代码在容器、虚拟机或远程机器上运行时，告诉 Kilobat。

    kilobat why db.internal --context container

  5. 把 App 失败的时间与检查时间一并记录。

    kilobat why api.example.com --failed-at 14:05

通过 MCP

用 claude mcp add kilobat -- kilobat mcp 连接一次 MCP 服务器。其他客户端参阅文档。之后智能体就可以调用这些工具。会更改设置的工具会提示智能体先征求你的同意。

工具与参数作用
diagnose_connection
{"target": "https://api.example.com/v1/models", "app": "process:node"}
返回 verdict、next 和 steps，每项都带有 layer、status 和 detail。

须知

  • 检查在 Kilobat 内部运行，而不是通过 curl。严格的 Kilobat 配置无法阻止检查本身。
  • 它会分别测试 IPv4 和 IPv6。IPv6 路径故障会得到单独的结论。
  • 检查通过，表示此刻这个请求可以从这台 Mac 经由该路径正常工作。它看不到已经在进行中的传输。

常见问题

--context provider 有什么作用？

当托管服务从它自己的服务器发出请求时使用它。像 localhost 这样的私有地址在你的 Mac 上可以访问，但那些服务器无法访问。

参考资料

参考资料核查于 2026年10月29日。man 手册页为 macOS 自带版本；在“终端”中用 man <name> 打开。