# 故障排除

> **弃用通知**
> 本页面描述的功能已在 Luxonis Hub 中被移除或替换。功能可能有限，仅适用于 Hub Original 客户。请参考最新指南来配置设备、管理设备群组和部署应用程序。

## Agent 状态

如果设备无法连接到云端，您可以检查 Agent 的状态。通过 SSH 连接到设备，然后运行：

```bash
hubctl status
```

您将收到关于 Agent 是否运行、是否连接到云端以及设备在云端的直接链接的信息。输出应类似如下：

```bash
$ hubctl status
╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║ Luxonis Hub Agent (24.55.1308 | linux/arm64 | DepthAI 2.21.2) ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

Web UI                   https://localhost:9010
DepthAI                  2.21.2

已连接到云端？     是 (https://hub.luxonis.com)
团队                     Luxonis
待处理的检测结果       0

云端机器人链接
https://hub.luxonis.com/robots/00000000-0000-0000-0000-000000000000
```

有关如何使用 CLI 的更多信息，请访问其 [文档页面](https://docs.luxonis.com/cloud/advanced/legacy/hub-agent/cli.md)。

## Agent 日志

Agent 日志可通过 SSH 访问，或者如果已连接到 Hub，也可通过设备详情页面上的“Web 终端”访问。有关如何通过 SSH 处理日志的信息，请运行：

```bash
hubctl help logs
```

## 应用程序日志

启动应用程序后，日志可在应用程序详情中的“日志”选项卡中查看。如有需要，您可以从此处复制文本格式的日志。

## 支持文件

如需向 Luxonis 上传支持文件，请使用：

```bash
hubctl upload-support
```

支持文件已加密。如需分析，请从命令输出中复制哈希值并提供给 Luxonis 支持团队。

## 常见问题

### 无法安装应用程序 - 没有这样的主机

应用程序无法安装的一个常见原因是 DNS 解析问题。Agent 安装所在的主机系统使用的 DNS 服务器可能无法解析安装所需的 GitHub 仓库的正确 IP 地址。在这种情况下，您可能会在错误日志中看到类似 no such host 的消息：

```bash
time="2024-05-30T10:23:50+08:00" level=warning msg="Failed to decode the keys [\"storage.imagestore\"] from \"/home/robothub/storage.conf\""
2Error: initializing source docker://ghcr.io/luxonis/robothub-app-v2:2024.117.2129-rvc2-regular: Get "https://ghcr.io/token?scope=repository%3Aluxonis%2Frobothub-app-v2%3Apull&service=ghcr.io": dial tcp: lookup ghcr.io on 192.168.0.1:53: no such host
```

最佳解决方案是使用公共 DNS 服务。配置 DNS 设置有两种选择：

本地设置

第一种可能是在本地机器上设置 DNS 解析器。在基于 Debian 的系统上，您可以修改 /etc/systemd/resolved.conf 文件来更改 DNS 和 FallbackDNS 键值。这也可以通过系统的图形界面完成，无需手动更新配置文件。

> 这会导致本地网络地址无法解析。请谨慎使用。

路由器设置

另一种选择是更改路由器上的 DNS 设置。这可以确保所有连接到网络的设备使用相同的 DNS 设置，从而保持一致性并简化管理。为此，您需要访问路由器的管理界面。

推荐的公共 DNS 服务

我们推荐使用 Google Public DNS 或 Cloudflare 的 1.1.1.1。您可以在此处找到逐步说明：

 * [Google Public DNS](https://developers.google.com/speed/public-dns/docs/using#linux)
 * [1.1.1.1](https://one.one.one.one/dns)