OAK4 高级设置
最后更新
通过 SSH 或 ADB 连接到相机
SSH
通过 PoE+ 或 USB 连接
Command Line
1oakctl usbd enable # 在主机 PC 上运行在相机上启用 SSH
- 使用 Luxonis Hub 或 本地 设置相机,可以使用给定密码启用 SSH 访问,
- 在主机计算机上执行
oakctl device unlock,同时设备连接在同一网络上(下载并安装 oakctl)。
用法
oakctl list 来查找本地网络中的 OAK 设备。或者,您也可以检查路由器上的 DHCP 租约,或使用 nmap 等网络扫描工具或某些 IP 扫描应用程序。Command Line
1$ oakctl list # 查找本地网络中 OAK 设备的 IP
2$ ssh root@IP_ADDRESS # SSH 连接到设备scp:Command Line
1$ scp folder/file.txt root@IP_ADDRESS:/data/
2# 或者一个文件夹
3$ scp -r folder/ root@IP_ADDRESS:/data/设置静态 IP
在 OS 版本 1.20.5 上设置静态 IP 将不起作用,因为该版本存在故障。如果您正在使用此版本,我们强烈建议您在尝试配置静态 IP 之前 升级到较新的 OS。
无 DHCP
如果没有 DHCP 服务器可用,请参阅 故障排除中的无 DHCP 部分。
- 使用 Luxonis Hub 或 本地 设置相机时的高级设置。
- 通过连接到相机(ADB/SSH)并使用
agentconfd configure工具:
Command Line
1agentconfd configure --help
2用法:agentconfd configure [选项] [NETWORK_CONFIG]
3
4参数:
5 [NETWORK_CONFIG] “dhcp”或“ipv4,ipv4_mask,ipv4_gateway”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
Command Line
1# 首先通过 ADB/SSH 连接到设备,然后在设备上运行:
2agentconfd configure dhcp --dns 10.12.102.2Command Line
1agentconfd configure dhcp --dns 8.8.8.8Command Line
1~ # agentconfd configure dhcp --dns 10.12.102.2
2[2026-02-06T13:49:15Z INFO agentconfd] 成功!
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] 成功!
7~ # ping google.com
8PING google.com (142.250.203.142): 56 数据字节
9来自 142.250.203.142 的 64 字节:seq=0 ttl=251 time=11.978 ms
10来自 142.250.203.142 的 64 字节:seq=1 ttl=251 time=14.046 msping 失败但通过 IP ping 成功,则 DNS 配置错误。调整 DNS 服务器或验证您的网络是否允许出站 DNS。本地设置
- 在不连接到 Luxonis Hub 的情况下设置相机。
- 启用 SSH 访问以进行开发或调试。
- 本地重置设备密码。
- 配置高级网络设置,例如在 DHCP 不可用时分配静态 IP。
为设备供电
连接 PoE/ETH 电缆为设备供电。
验证 oakctl 版本
通过执行
oakctl version 确保您已安装 0.16.2 或更高版本的 oakctl。如有必要,请使用 oakctl self-update 进行更新。将设备置于设置模式
通过将设备置于设置模式,确保设备已准备好进行设置(相机上的状态灯闪烁蓝色):
Command Line
1oakctl start-setup设置您的设备
使用 setup.luxonis.com
Setup Locally,然后按照屏幕上的说明配置您的相机。使用命令行
Command Line
1oakctl setup -p <在此处插入密码> --dont-check-internet<在此处插入密码> 替换为您首选的密码。要查看其他选项,请执行 oakctl setup --help。如果多个设备连接到同一网络,
oakctl 可能会提示您选择要配置的设备。需要 WiFi 连接?
请参阅 OAK4 WiFi 以获取支持的 USB-C WiFi 加密狗和设置说明。
恢复出厂设置
恢复出厂设置警告
这将把设备恢复到出厂设置,删除所有配置和数据。请务必在继续之前备份所有重要数据。
按住重置按钮
按住重置按钮10 秒。大约 5 秒后,前置 LED 闪烁橙色。继续按住;大约 10 秒后,LED 闪烁红色,然后熄灭,表示已开始恢复出厂设置。
松开重置按钮
LED 熄灭后松开按钮,等待设备重新启动(这可能需要几秒钟)。
常见问题
- 通过 USB 供电并使用非 PoE 电缆进行通信。
- 通过 PoE 供电并使用 USB 进行 ADB 通信
需要帮助?
请访问讨论论坛以获取技术支持或您可能有的任何其他问题。
