---
title: "入门 | Kilobat 文档"
url: "https://kilobat.app/zh-hans/docs/getting-started"
description: "安装 Kilobat 应用和免费的 CLI，设置 shell 补全，试试最初几条命令。"
---

# 入门

安装 Kilobat 应用和免费的 CLI，设置 shell 补全，试试最初几条命令。

## 安装

CLI 免费且开源。用 Homebrew 安装：

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

这会安装 `kilobat` 以及它的简短别名 `kb`。下面的所有示例两者都能用。

也可以下载 Mac 应用，它在 `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 雷达和附近的网络、“为什么连不上？”以及保持唤醒。按应用统计的流量、规则和网络过滤器、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     # 按应用显示实时流量；q 退出，s 排序，f 筛选，/ 搜索
kilobat diagnose           # 导致连接变慢的原因
kilobat speedtest          # 负载下的速度和延迟
kilobat profile travel     # 切换到“出行”配置
kilobat block com.example.App
```

运行 `kilobat <command> --help` 查看任意命令的帮助。

## Mac 应用

1. 下载磁盘映像，把 Kilobat 拖到“应用程序”文件夹，然后从那里打开。
2. 实时流量、Wi-Fi 选择器、速度测试、发现 Wi-Fi 登录页面、保持唤醒和“为什么连不上？”都是免费的，整个 CLI 也免费。Pro 在应用中增加规则和询问、预算、Wi-Fi 健康、连接地图、雷达和历史记录。要解锁 Pro，可以开始 7 天试用，或把许可证粘贴到设置中。
3. 在设置中选择菜单栏项目。按住 Command 键拖移菜单栏项目，即可移动它的位置。

系统询问时请允许定位访问，这样 Kilobat 才能显示 Wi-Fi 名称并扫描附近网络。你的位置不会被发送到任何地方。