# Luxonis Hub 概述

Luxonis Hub 是面向 OAK 的控制平面，用于连接设备、管理应用、打开远程操作员会话、收集快照，并将这些工作流集成到您自己的软件中。请使用此页面了解核心操作模型，然后再进入设置、车队运营、应用管理或面向客户的集成部分。

## 为何重要

Hub 旨在消除围绕实际 OAK 部署的共享基础设施工作。您无需从头构建自己的设备管理、远程访问和应用操作层，而是可以使用 Hub 来操作设备、运行应用、收集数据，并将这些工作流连接到您自己的后端和产品中。

> **当前可用性**
> 基于清单的部署、广泛的 Webhook 集成以及自托管 OTA 管理目前尚未普遍可用。

## 心智模型

将 Luxonis Hub 视为四个相互连接的层次：

 * 设备提供物理运行时环境。
 * OAK Agent将受支持的设备连接到 Hub，并管理本地应用/运行时桥接。
 * OAK Apps承载应用逻辑、配置和可选的前端。
 * 您的产品和后端可以将 Hub API 和流式传输原语集成到面向客户的工作流中。

## 实际核心能力

 * 设备管理：跟踪设备状态、连接性、软件版本和远程可操作性详情。
 * 应用生命周期：在受管理设备上安装、更新、停止和检查 OAK Apps。
 * 远程操作：在无法本地访问时使用 Web 终端、实时日志和远程可视化。
 * 数据收集：捕获快照及相关输出，以支持调试和模型改进。
 * 客户集成：将 Hub 连接到您自己的后端、前端和运营系统。
 * AI 与模型：在 Hub 中管理模型并将其转换为在 Luxonis 硬件上部署。

## 核心概念

### 设备

设备是 OAK Agent 运行的物理环境。

实际上，通常是以下之一：

 * 已安装 Agent 的 Series 4 相机。
 * 受支持的 Linux 主机（例如 NUC 或 Jetson），已安装 Agent 并连接了受支持的 OAK 设备。

设备会出现在 Hub UI 中，您可以在其中检查状态、查看软件版本、部署应用，并打开远程会话进行调试或操作。

### OAK Agent

OAK Agent 是设备与 Luxonis Hub 之间的运行时桥接。它负责设备发现、应用部署、远程会话连接、日志传输和数据上传。

 * 在 Series 4 设备上，Agent 是受支持的 Hub 管理路径的一部分。
 * 在自托管 Linux 部署中，Agent 将主机和连接的硬件连接到 Hub。

对于自托管部署，主机操作系统仍由客户管理。Hub 预期的管理边界是 oak-agent 和应用层，而非完整的主机生命周期管理。

### OAK App

OAK App 是您通过 Hub 部署和操作的容器化单元。它将您的运行时逻辑、配置和可选的静态前端打包成一个可部署的产物，用于受支持的设备。

 * 它通过 [oakapp.toml](https://docs.luxonis.com/software-v3/oak-apps/configuration.md) 进行配置。
 * 它可以暴露静态前端，或回退到 Hub 的默认可视化路径。
 * 它可以发出日志、流式传输输出并生成快照或其他收集的产物。

### 构建并运行 OAK App

了解如何使用当前软件栈创建、配置和部署 OAK App。

[构建并运行 OAK App](https://docs.luxonis.com/software-v3/oak-apps.md)

### 应用示例

浏览常见 OAK 工作流的示例仓库和参考实现。

[应用示例](https://github.com/luxonis/oak-examples)

### oakctl

oakctl 是用于 OAK App 开发和附近设备操作的主要本地 CLI。您可以使用它来构建应用、运行本地迭代、在开发过程中检查设备，并将应用产物发布到 Hub。

[了解有关 oakctl 的更多信息](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)

## 集成与管理边界

对于面向客户的产品，默认的集成模型是：

 * 客户用户 -> 客户前端 -> 客户后端 -> Hub API 和流式传输原语

这意味着：

 * 客户认证由客户自己负责
 * Hub API 密钥仅保留在您的后端
 * 您的前端仅接收会话或可视化所需的派生负载

当您围绕 Luxonis 硬件构建自己的门户或运营后端，而不仅仅是依赖 Hub UI 时，这一点尤其有用。

## 相关指南

### 连接设备

启动 OAK4 采用和受支持的自托管连接流程的设置路径。

[连接设备](https://docs.luxonis.com/cloud/hub/connect-oak.md)

### 管理设备

检查设备状态、远程访问工作流以及受支持设备的 OTA 行为。

[管理设备](https://docs.luxonis.com/cloud/features/device-management.md)

### 管理应用

在连接的设备上安装、运行、检查和故障排除 OAK Apps。

[管理应用](https://docs.luxonis.com/cloud/features/application-management.md)

### 集成架构

查看推荐的客户自有前端/后端模式，用于 Hub 集成。

[集成架构](https://docs.luxonis.com/cloud/api/guides/integration-architecture.md)