---
title: "入門 | Kilobat 說明文件"
url: "https://kilobat.app/zh-hant/docs/getting-started"
description: "安裝 Kilobat App 和免費的 CLI，設定 shell 自動完成，試試最初幾個指令。"
---

# 入門

安裝 Kilobat App 和免費的 CLI，設定 shell 自動完成，試試最初幾個指令。

## 安裝

CLI 免費且開放原始碼。用 Homebrew 安裝：

```
brew install seifip/kilobat/kilobat
```

這會安裝 `kilobat` 和簡短的別名 `kb`。下面每個範例兩個都能用。

或者下載 Mac App，它也在 `Kilobat.app/Contents/Helpers/kilobat` 附有 CLI。

[下載 Mac 版 ↓](https://kilobat.app/downloads/Kilobat-1.31.1.dmg?via=site) [下載免費 CLI ↓](https://kilobat.app/downloads/kilobat-cli-1.31.1-universal.tar.gz)

### Mac App Store 上的 Kilobat Lite

Kilobat Lite 是即將在 Mac App Store 推出的免費版本。它在 Apple 的 App 沙盒中執行，保留在沙盒裡能正常運作的功能：健康檢查、速度測試、Wi-Fi 雷達和附近的網路、「為什麼連不上？」以及保持喚醒。各 App 的流量、規則和網路過濾器、DNS 變更、闔上螢幕輔助程式和 CLI 需要沙盒不允許的權限，所以只有本網站提供的 Kilobat App 才有。兩者可以同時安裝。

為你的 shell 開啟 Tab 自動補齊：

```
# zsh
echo 'source <(kilobat completion zsh)' >> ~/.zshrc
# fish
kilobat completion fish > ~/.config/fish/completions/kilobat.fish
```

## 快速入門

單獨執行 `kilobat` 會打開互動式選單：用方向鍵或 j/k 移動，Enter 打開，按數字直接跳到該項，q 結束。

```
kilobat status --watch     # 按 App 顯示即時流量；q 結束、s 排序、f 篩選、/ 搜尋
kilobat diagnose           # 導致連線變慢的原因
kilobat speedtest          # 負載下的速度和延遲
kilobat profile travel     # 切換至「旅行」設定檔
kilobat block com.example.App
```

執行 `kilobat <command> --help` 取得任何指令的說明。

## Mac App

1. 下載磁碟映像檔，把 Kilobat 拖進「應用程式」，然後從那裡打開。
2. 即時流量、Wi-Fi 選擇器、速度測試、偵測 Wi-Fi 登入頁面、保持喚醒和「為什麼連不上？」都免費，整個 CLI 也是。Pro 在 App 中加入規則與「詢問」、預算、Wi-Fi 健康狀態、連線地圖、雷達和歷史記錄。要解鎖 Pro，請開始 7 天免費試用，或把授權碼貼到「設定」中。
3. 在「設定」中選擇要顯示的選單列項目。按住 Command 鍵並拖移選單列項目，可以移動它的位置。

被詢問時請允許取用定位，Kilobat 才能顯示 Wi-Fi 名稱並掃描附近的網路。你的位置不會傳送到任何地方。