远程访问免费下载
安装
本页内容
  1. Windows 和 macOS
  2. 预装镜像 (Raspberry Pi)
  3. Home Assistant 加载项
  4. Docker
  5. 直接安装 (.deb)

安装

Grablo Spot 可在 Windows、macOS 以及 Raspberry Pi、Jetson、Radxa 等多种 Linux 设备上运行。所有安装文件都可在下载页面获取。

平台操作系统架构
WindowsWindows 10 1903 或更高版本x64
macOSmacOS 14.4 (Sonoma) 或更高版本Apple 芯片、Intel
LinuxRaspberry Pi OS、基于 Ubuntu/Debian 的 LinuxARM64、x64

支持的单板计算机包括 Raspberry Pi 3/4/5 和 Zero 2 W、NVIDIA Jetson（Nano、Orin Nano、AGX Orin）以及 Radxa Rock（5A、5B、5C、Zero 3W）。

Windows 和 macOS

从下载页面下载安装程序（Windows：.exe，macOS：.pkg），运行后按照说明操作。安装完成后，Grablo 会自动启动。

预装镜像 (Raspberry Pi)

将预装 Grablo 的 Raspberry Pi OS 镜像写入 SD 卡。Grablo 会在开机时作为系统服务自动启动，因此这是初次使用者最简单的方式。提供带桌面的完整镜像和仅含命令行的精简 (Lite) 镜像。

下载的镜像文件 (.img.xz) 也可以用 balenaEtcher 等通用镜像写入工具写入，但建议使用 Raspberry Pi Imager，因为它可以在写入 SD 卡的同时设置 Wi-Fi 和用户账户。以下步骤和界面以 Raspberry Pi Imager 1.9 为准。在操作系统选择中选择使用自定义镜像，然后选择镜像文件。

Raspberry Pi Imager 操作系统列表中的“使用自定义镜像”项
在 Raspberry Pi Imager 的操作系统列表中选择使用自定义镜像。

在存储设备中选择要写入的 SD 卡，然后点击下一步。随后会弹出对话框，询问是否应用自定义系统配置。

在此对话框中选择编辑设置，即可预先配置主机名、用户账户、Wi-Fi 和区域设置。如果不接显示器且不使用有线网络，请务必配置 Wi-Fi。如果未编辑设置，Raspberry Pi OS 的默认登录信息为 grablo / grablo。

Raspberry Pi Imager 的“自定义系统配置”对话框
“自定义系统配置”对话框。使用编辑设置可预先配置 Wi-Fi 和账户。
Raspberry Pi Imager“自定义系统配置”窗口的“通用”标签页，包含主机名、用户名和密码以及无线局域网字段
设置窗口的通用标签页。输入主机名、用户名和密码、无线局域网 (Wi-Fi) 以及区域设置。

在服务标签页中启用 SSH 后，无需显示器即可通过网络访问设备。完成后点击保存，返回“自定义系统配置”对话框，然后点击确认。随后会提示 SD 卡上的现有数据将被清除，确认后即开始写入。

写入完成后，将 SD 卡插入 Raspberry Pi 并接通电源。每次开机时，Grablo 都会作为系统服务自动启动，无需登录。

Home Assistant 加载项

在 Home Assistant OS 或 Supervised 上，以加载项形式安装 Grablo。加载项会自动连接到 Home Assistant，无需手动配置硬件。

  1. 在 Home Assistant 中打开 Settings > Apps > App store，然后将 https://github.com/grablo/grablo-spot-hass-addons 添加到右上角菜单的Repositories中。点击下方按钮可直接打开仓库对话框。
  2. 在商店中找到 Grablo Spot，然后点击Install。
  3. 安装完成后，点击Start。

将仓库添加到我的 Home Assistant

加载项运行后，在同一网络中的浏览器里打开 http://<Home Assistant IP address>:8127 即可进入本地界面。首次打开时所需的设置码会在加载项首次启动时显示在加载项的Log标签页中。详情请参阅打开本地界面。

Docker

在迷你主机、NAS 等 Docker 主机上，以容器形式安装 Grablo。如果使用 Home Assistant OS 或 Supervised，建议改用上述加载项。 

git clone https://github.com/grablo/grablo-docker.git
cd grablo-docker
docker compose -f docker-compose.spot.yml up -d

容器运行后，在同一网络中的浏览器里打开 http://<Docker host IP address>:8127 即可进入本地界面。运行 docker exec grablo cat /etc/grablo/local/setup_code.txt 可查看首次打开时所需的设置码。

设备身份和数据保存在命名卷中，因此更新或重新创建容器后，它仍是同一台设备。容器不会自动更新；要应用新版本，请先运行 docker compose -f docker-compose.spot.yml pull，再运行 docker compose -f docker-compose.spot.yml up -d。详情请参阅安装指南。

直接安装 (.deb)

熟悉 Linux 的用户可以下载适合所用架构 (ARM64/x64) 的 .deb 软件包直接安装。在桌面环境中，从文件管理器打开 .deb 文件即可安装；在命令行中，将软件包复制到设备后运行 sudo apt install -y ./grablo-spot*.deb。安装后，Grablo 会作为系统服务运行，并在开机时自动启动，无需登录。