概览硬件软件云平台
平台

本页目录

  • 通过 SSH 或 ADB 连接相机
  • 设置静态 IP
  • 配置 DNS
  • 本地设置
  • 1. 给设备通电
  • 2. 验证 oakctl 版本
  • 3. 将设备置于设置模式
  • 4. 设置您的设备
  • 常见问题

OAK4 高级

通过 SSH 或 ADB 连接相机

SSH

通过以太网连接

启用 SSH

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

使用方式

要通过 SSH 访问设备，您需要知道其 IP 地址。您可以通过将设备连接到网络并检查路由器的 DHCP 租约，或使用 nmap 等网络扫描工具或某些 IP 扫描应用来找到它。或者，您也可以运行 oakctl list 来查找本地网络中的 OAK 设备。
Command Line
1# SSH 连接到设备
2$ ssh root@IP_ADDRESS
要传输文件到设备，可以使用 scp：
Command Line
1$ scp folder/file.txt root@IP_ADDRESS:/data/
2# 或传输文件夹
3$ scp -r folder/ root@IP_ADDRESS:/data/

ADB

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

供电：

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

通信：

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

准备工作

在主机上安装 oakctl 工具，因为它包含了您所需的 adb 命令。

使用方式

要通过 ADB 访问设备，您需要从主机运行以下命令：
Command Line
1$ oakctl adb devices
如果设备已列出，您可以使用以下命令在设备上打开 shell：
Command Line
1$ oakctl adb shell
要传输文件到设备，可以使用 oakctl adb push：
Command Line
1$ oakctl adb root
2$ oakctl adb push folder/file.txt /data/
3# 或传输文件夹
4$ oakctl adb push folder/ /data/

设置静态 IP

当相机必须保持一个其他系统可以可靠引用的恒定、可预测地址时，静态 IP 很有帮助。此配置假定您已经与相机建立了活动连接。您可以通过以下方式手动设置静态 IP：
  • 在使用 Luxonis Hub 或 本地设置 设置相机时的高级设置中。
  • 通过连接到相机（通过 ADB/SSH）并使用 agentconfd configure 工具：
Command Line
1agentconfd configure --help
2Usage: agentconfd configure [OPTIONS] [NETWORK_CONFIG]
3Arguments:
4  [NETWORK_CONFIG]  Either "dhcp" or "ipv4,ipv4_mask,ipv4_gateway"
因此，您可以设置静态 IP 地址，或恢复为 DHCP：
Command Line
1# ADB/SSH 进入设备后，在设备上设置静态 IP：
2agentconfd configure 192.168.10.15,255.255.255.0,192.168.10.1
3# 恢复为 DHCP：
4agentconfd configure dhcp

配置 DNS

使用 DHCP 时，您仍可以覆盖设备使用的 DNS 服务器。这在封闭网络、DHCP 服务器不提供 DNS，或需要将设备指向特定解析器时很有用。首先连接到相机（通过 SSH 或 ADB），然后运行：
Command Line
1# ADB/SSH 进入设备后，在设备上运行：
2agentconfd configure dhcp --dns 10.12.102.2
如果名称解析仍然失败，尝试一个已知的公共解析器（仅在您的网络策略允许的情况下）：
Command Line
1agentconfd configure dhcp --dns 8.8.8.8
示例会话：
Command Line
1~ # agentconfd configure dhcp --dns 10.12.102.2
2[2026-02-06T13:49:15Z INFO  agentconfd] Success!
3~ # ping google.com
4ping: bad address 'google.com'
5~ # agentconfd configure dhcp --dns 8.8.8.8
6[2026-02-06T13:49:30Z INFO  agentconfd] Success!
7~ # ping google.com
8PING google.com (142.250.203.142): 56 data bytes
964 bytes from 142.250.203.142: seq=0 ttl=251 time=11.978 ms
1064 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. 将设备置于设置模式

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

4. 设置您的设备

使用 setup.luxonis.com

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

使用命令行

如果您没有互联网访问权限和/或想使用命令行设置相机，此选项很有用。设置密码并启用 ssh 的最小命令：
Command Line
1oakctl setup -p <INSERT_PASSWORD_HERE> --dont-check-internet
请务必在命令中将 <INSERT_PASSWORD_HERE> 替换为您首选的密码。要查看其他选项，请执行 oakctl setup --help。

常见问题

USB 和 PoE 能否同时使用？可以，如果您的目标是：
  • 通过 USB 供电，并使用非 PoE 线缆进行通信。
  • 通过 PoE 供电，并使用 USB 进行 ADB 通信。

需要帮助？

请前往 OAKChina 官网 获取技术支持或解答您的任何疑问。