實用技巧

找出某個網站或 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 伺服器一次即可。其他用戶端請參閱說明文件。之後 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 可以連上，但那些伺服器連不到。

資料來源

資料來源檢查日期：2026年10月29日。man 頁面為 macOS 內建版本；在終端機中用 man <name> 開啟。