---
title: "找出某个网站或 API 连不上的原因 · Kilobat 实用技巧"
url: "https://kilobat.app/zh-hans/guides/recipes/why-cant-it-connect"
description: "从 Mac 上逐层检查某个网站、API 或主机：网络、VPN 和代理、DNS、Kilobat 的规则、IPv4 和 IPv6、TLS 以及服务器的响应。"
---

实用技巧

# 找出某个网站或 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 服务器。其他客户端参阅[文档](https://kilobat.app/zh-hans/docs#agents)。之后智能体就可以调用这些工具。会更改设置的工具会提示智能体先征求你的同意。

| 工具与参数 | 作用 |
|---|---|
| `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 上可以访问，但那些服务器无法访问。

## 参考资料

- [Kilobat 文档：连不上时](https://kilobat.app/zh-hans/docs#why)
- [Kilobat 技能：mac-network-troubleshooting](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-network-troubleshooting)
- [Kilobat llms.txt：CLI 和 MCP 参考](https://kilobat.app/llms.txt)

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

## 相关指南

- [网站在手机上能打开，在 Mac 上却打不开](https://kilobat.app/zh-hans/guides/site-works-on-phone-not-mac): 网站在手机上能打开、在 Mac 上却打不开时，问题通常出在 Mac 上。
- [Mac 上代理设置导致 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps): 代理设置会让流量经由另一台服务器转发。
- [Mac 上的 IPv6 问题](https://kilobat.app/zh-hans/guides/ipv6-problems-mac): 大多数网络会同时为 Mac 分配 IPv4 和 IPv6 地址。
- [容器无法访问 Mac 上的 localhost](https://kilobat.app/zh-hans/guides/localhost-from-container): 每个容器都有自己的网络栈。