# OAK4 高级

## 通过 SSH 或 ADB 连接相机

#### SSH

### 通过以太网连接

### 启用 SSH

默认情况下，运行 OS 1.18 及更新版本的设备上，通过密码进行 SSH 访问是禁用的。有两种启用方式：

 * 使用 [Luxonis Hub](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-getting-started.md) 或
   [本地设置](#Local%20Setup) 设置相机时，可使用给定密码启用 SSH 访问，
 * 在主机上执行 oakctl device unlock，此时设备需在同一网络中（[下载并安装 oakctl](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)）。

### 使用方式

要通过 SSH 访问设备，您需要知道其 IP 地址。您可以通过将设备连接到网络并检查路由器的 DHCP 租约，或使用 nmap 等网络扫描工具或某些 IP 扫描应用来找到它。或者，您也可以运行 oakctl list 来查找本地网络中的 OAK 设备。

```bash
# SSH 连接到设备
$ ssh root@IP_ADDRESS
```

要传输文件到设备，可以使用 scp：

```bash
$ scp folder/file.txt root@IP_ADDRESS:/data/
# 或传输文件夹
$ scp -r folder/ root@IP_ADDRESS:/data/
```

#### ADB

### 通过 USB 连接（仅限 ADB 调试连接）

### 供电：

OAK4 最高可消耗 25W（峰值），因此直接连接到计算机 USB 端口可能导致崩溃且不受支持。由于高功耗需求，我们的 [Y-Adapter](https://docs.luxonis.com/hardware/products/Y-adapter.md)
也不兼容。我们建议通过 PoE+（802.3at，30W）供电器/交换机供电。

### 通信：

通过 USB-C 连接到计算机时，OAK4 会被识别为 USB 设备，并可通过 ADB（[Android Debug Bridge](https://developer.android.com/tools/adb)）访问。这对调试和开发目的很有用，但
不允许运行 depthAI 和 oakctl 脚本。

> **需要 USB 网络而非仅 ADB 访问？**
> 如果您希望主机计算机通过 USB 与 OAK4 共享其互联网连接，请参阅
> [`oakctl usbd`](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)
> 。

> **ADB 连接提示**
> 如果相机通过
> **USB 集线器**
> 或
> **低质量 USB 线缆**
> 连接，ADB 可能间歇性失败。使用
> **高质量的 USB-C 线缆**
> 并将相机
> **直接插入计算机**
> （中间无集线器）以获得最可靠的性能。

### 准备工作

在主机上安装 [oakctl 工具](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)，因为它包含了您所需的 adb 命令。

### 使用方式

要通过 ADB 访问设备，您需要从主机运行以下命令：

```bash
$ oakctl adb devices
```

如果设备已列出，您可以使用以下命令在设备上打开 shell：

```bash
$ oakctl adb shell
```

要传输文件到设备，可以使用 oakctl adb push：

```bash
$ oakctl adb root
$ oakctl adb push folder/file.txt /data/
# 或传输文件夹
$ oakctl adb push folder/ /data/
```

## 设置静态 IP

> 在 OS
> **1.20.5**
> 版本上设置静态 IP 将无法生效，因为该版本存在故障。如果您正在使用此版本，我们强烈建议在尝试配置静态 IP 之前
> [升级到更新的 OS](https://docs.luxonis.com/software-v3/sw-stack/luxonis-os.md)
> 。

当相机必须保持一个其他系统可以可靠引用的恒定、可预测地址时，静态 IP 很有帮助。此配置假定您已经与相机建立了活动连接。

> **无 DHCP**
> 如果没有可用的 DHCP 服务器，请参考
> [**故障排除中的无 DHCP 部分**](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-getting-started.md)
> 。

您可以通过以下方式手动设置静态 IP：

 * 在使用 [Luxonis Hub](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-getting-started.md) 或
   [本地设置](#Local%20Setup) 设置相机时的高级设置中。
 * 通过连接到相机（通过 [ADB/SSH](#Connect%20to%20the%20camera%20through%20SSH%20or%20ADB)）并使用 agentconfd configure 工具：

```bash
agentconfd configure --help
Usage: agentconfd configure [OPTIONS] [NETWORK_CONFIG]
Arguments:
  [NETWORK_CONFIG]  Either "dhcp" or "ipv4,ipv4_mask,ipv4_gateway"
```

因此，您可以设置静态 IP 地址，或恢复为 DHCP：

```bash
# ADB/SSH 进入设备后，在设备上设置静态 IP：
agentconfd configure 192.168.10.15,255.255.255.0,192.168.10.1
# 恢复为 DHCP：
agentconfd configure dhcp
```

## 配置 DNS

使用 DHCP 时，您仍可以覆盖设备使用的 DNS 服务器。这在封闭网络、DHCP 服务器不提供 DNS，或需要将设备指向特定解析器时很有用。

首先连接到相机（通过 SSH 或 ADB），然后运行：

```bash
# ADB/SSH 进入设备后，在设备上运行：
agentconfd configure dhcp --dns 10.12.102.2
```

如果名称解析仍然失败，尝试一个已知的公共解析器（仅在您的网络策略允许的情况下）：

```bash
agentconfd configure dhcp --dns 8.8.8.8
```

示例会话：

```bash
~ # agentconfd configure dhcp --dns 10.12.102.2
[2026-02-06T13:49:15Z INFO  agentconfd] Success!
~ # ping google.com
ping: bad address 'google.com'
~ # agentconfd configure dhcp --dns 8.8.8.8
[2026-02-06T13:49:30Z INFO  agentconfd] Success!
~ # ping google.com
PING google.com (142.250.203.142): 56 data bytes
64 bytes from 142.250.203.142: seq=0 ttl=251 time=11.978 ms
64 bytes from 142.250.203.142: seq=1 ttl=251 time=14.046 ms
```

如果通过主机名 ping 失败，但通过 IP ping 成功，则说明 DNS 配置错误。请调整 DNS 服务器或确认您的网络允许出站 DNS。

## 本地设置

本节介绍使用 oakctl 设置 OAK 设备的高级路径，包括无法访问互联网的情况。当您需要完全本地控制设置过程时，可以使用此方法——例如：

 * 在不连接到 Luxonis Hub 的情况下设置相机。
 * 为开发或调试启用 SSH 访问。
 * 在本地重置设备密码。
 * 配置高级网络设置，例如在 DHCP 不可用时分配静态 IP。

在以下场景中使用本地设置：当网络限制或工作流要求阻止使用标准云设置时，或任何需要本地控制的环境。

### 1. 给设备通电

连接 PoE/ETH 线缆给设备通电。

### 2. 验证 oakctl 版本

确保您安装了 oakctl 版本 0.16.2 或更高版本，执行 oakctl version。如有必要，使用 oakctl self-update 更新。

### 3. 将设备置于设置模式

确保设备已准备好进行设置（相机上的状态灯闪烁蓝色），将其置于设置模式：

```bash
oakctl start-setup
```

### 4. 设置您的设备

#### 使用 setup.luxonis.com

如果您想要一个简单、有引导的本地设置体验，请使用此选项。基于 Web 的向导会自动为您的部署生成配置值。前往 [setup.luxonis.com](https://setup.luxonis.com)，选择 本地设置 (Setup
Locally)，然后按照屏幕上的说明配置您的相机。

#### 使用命令行

如果您没有互联网访问权限和/或想使用命令行设置相机，此选项很有用。设置密码并启用 ssh 的最小命令：

```bash
oakctl setup -p <INSERT_PASSWORD_HERE> --dont-check-internet
```

请务必在命令中将 <INSERT_PASSWORD_HERE> 替换为您首选的密码。要查看其他选项，请执行 oakctl setup --help。

> 如果多个设备连接到同一网络，
> `oakctl`
> 可能会提示您选择要配置的设备。

> **需要 WiFi 连接？**
> 请参阅
> [OAK4 WiFi](https://docs.luxonis.com/hardware/platform/deploy/oak4-wifi.md)
> 了解支持的 USB-C WiFi 适配器和设置说明。

## 常见问题

USB 和 PoE 能否同时使用？

可以，如果您的目标是：

 * 通过 USB 供电，并使用非 PoE 线缆进行通信。
 * 通过 PoE 供电，并使用 USB 进行 ADB 通信。

### 需要帮助？

请前往 [OAKChina 官网](https://www.oakchina.cn/) 获取技术支持或解答您的任何疑问。