---
title: "找出某個網站或 API 為什麼連不上 · Kilobat 實用技巧"
url: "https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect.html"
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-hant/docs.html#agents)。之後 AI 代理程式就能呼叫這些工具。會更改設定的工具會告訴 AI 代理程式先詢問你。

| 工具與參數 | 作用 |
|---|---|
| `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-hant/docs.html#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-hant/guides/site-works-on-phone-not-mac.html): 網站在手機上能開、在 Mac 上卻打不開時，問題通常出在 Mac 上。
- [代理伺服器設定讓 Mac 上的 App 無法連線](https://kilobat.app/zh-hant/guides/proxy-settings-breaking-apps.html): 代理伺服器設定會讓流量經由另一台伺服器傳送。
- [Mac 上的 IPv6 問題](https://kilobat.app/zh-hant/guides/ipv6-problems-mac.html): 大多數網路都會同時提供 IPv4 和 IPv6 位址給 Mac。
- [容器無法連到 Mac 上的 localhost](https://kilobat.app/zh-hant/guides/localhost-from-container.html): 每個容器都有自己的網路堆疊。