# 自托管 oak-agent

oak-agent 服务可以在 amd64 和 arm64 架构的 Linux 机器上进行自托管。 自托管的 oak-agent 要求主机上安装有 Docker 和 systemd。

## 安装

通过运行以下命令安装最新的稳定版本：

```bash
curl -fsSL https://oakagent-releases.luxonis.com/self-hosted/stable/install-oak-agent.sh | sudo bash -s -- -y --password linux123
```

## 使用

通过运行 oakctl device list 查找安装了 oak-agent 的主机：

```sh
oakctl device list
+---+------------------+--------------------------------+----------------------------------------+------------------------+---------------+-------------------+
| # | Serial Number    | Device                         | Connection                             | OS                     | Agent Version | Setup             |
+=============================================================================================================================================================+
| 1 | 0e40028535f13370 | Raspberry Pi 5 Model B Rev 1.1 | 10.12.11.231, 10.12.102.35, 172.17.0.1 | Ubuntu 24.04.4 LTS     | 0.21.0        | Setup (unadopted) |
+---+------------------+--------------------------------+----------------------------------------+------------------------+---------------+-------------------+
```

使用 systemd 管理服务：

#### 启用 oak-agent

```sh
sudo systemctl enable oak-agent
```

#### 禁用 oak-agent

```sh
sudo systemctl disable oak-agent
```

## 在没有 OAK 设备的情况下构建 OAK 应用

自托管的 oak-agent 可用于在没有 OAK4 设备的情况下构建 OAK 应用。这对于 CI 环境或在独立的 Linux 主机上准备 .oakapp 包非常有用。

如果之后想要将构建的应用安装到 OAK4 设备上，则自托管代理必须运行在 arm64 架构的 Linux 机器上。

### 示例：在自托管 oak-agent 上构建 UVC C++ 示例并安装到 OAK4 设备

本示例使用 Raspberry Pi 5 作为自托管 oak-agent 主机，以 OAK4 设备作为部署目标。

#### 在 Raspberry Pi 5 上安装自托管代理

使用上述的[安装命令](#Installation)。

#### 列出可用设备并将 oakctl 连接到自托管代理

```sh
oakctl device list
+---+------------------+--------------------------------+----------------------------------------+------------------------+---------------+-------------------+
| # | Serial Number    | Device                         | Connection                             | OS                     | Agent Version | Setup             |
+=============================================================================================================================================================+
| 1 | 0e40028535f13370 | Raspberry Pi 5 Model B Rev 1.1 | 10.12.11.231, 10.12.102.35, 172.17.0.1 | Ubuntu 24.04.4 LTS     | 0.21.0        | Setup (unadopted) |
+---+------------------+--------------------------------+----------------------------------------+------------------------+---------------+-------------------+
| 2 | 2795412959       | Luxonis, Inc. OAK4-D R9        | 10.12.102.126, 172.23.136.130          | Luxonis OS RVC4 1.32.1 | 0.20.0        | Setup (unadopted) |
+---+------------------+--------------------------------+----------------------------------------+------------------------+---------------+-------------------+
oakctl device connection set 1 # Connect to the first device
```

#### 克隆 oak-examples 仓库

该仓库包含 UVC C++ 示例。

```sh
git clone --depth 1 --branch main https://github.com/luxonis/oak-examples
cd oak-examples
git submodule update --init --recursive
```

#### 构建 UVC 应用

```sh
cd cpp/uvc
oakctl app build .
```

#### 将构建的 OAK 应用安装到 OAK4 设备

```sh
oakctl app install *.oakapp -d 2
```

-d 2 参数从上述列表中选择 OAK4 设备。

#### 检查 UVC 应用是否正在运行

```sh
oakctl app list -d 2
+---+--------+---------------------------------+---------+--------------+
| E | App Id | Identifier                      | Status  | Frontend URL |
+=======================================================================+
| * | d4ed4  | com.example.streaming.uvc:3.0.0 | running |              |
+---+--------+---------------------------------+---------+--------------+
```