常见问题

Q: 支持哪些硬件？

现阶段只支持 x86_64 架构。树莓派 / 香橙派 / Apple Silicon Mac / ARM 架构 NAS（绿联 DXP、极空间 Z2/Z4 等大部分家用型号）暂不支持，请勿尝试。 推荐起步硬件：N100 / N305 mini-PC（约 1000 元）即可跑全功能 AI 8–12 路。x86 架构的 NAS（如 Synology XS 系列、TerraMaster D 系列、绿联部分 x86 型号）也可以装。下单前先在目标机器执行 uname -m，输出 x86_64 才能装。

Q: 一台机器最多接几路？

瓶颈在 AI 检测，不在视频转发。粗略指标： - N100 / 11 代 i3 + 集显加速：8–12 路 1080p 5fps 全功能 - RTX 3060 + 显卡加速：20–32 路 - 只录不检测：100+ 路（瓶颈在磁盘 IO，看你 HDD 能写多少 MB/s）

Q: 能纯局域网用吗？

可以。授权激活时一次性需要联网，之后服务器可以彻底断网——心跳失败不影响功能（详见 授权）。事件推送、TTS 喊话、Home Assistant 桥接、录像回放都不需要公网。

Q: 支持海康 / 大华吗？

全系支持。海康 / 大华 / 宇视 / TP-Link Vigi / 华为好望 这些专业 IPC 都是标准 ONVIF，扫描即出。详见 摄像头接入。

Q: 支持 4K 录像吗？

支持。云瞰 直接转发 H.264 / H.265，4K 流量大但 CPU 消耗几乎为 0。AI 检测自动用子码流（416x416）所以不影响。注意 4K 一路一天约 42GB，规划好磁盘。

Q: 出商业 SaaS 版本吗？

短期不会。云瞰 定位 "自托管" —— 数据完全在用户自己的服务器，不上传任何画面到我方。这是隐私承诺也是和大厂 IPC App 的核心差异。

Q: 数据会不会被上传到云端？

不会。云瞰 是纯自托管：所有视频、人脸、事件数据都只存在你自己的服务器上，我们的服务器不存任何画面。除了授权激活时的指纹校验心跳（仅一串硬件 hash），客户端不向我方发任何业务数据。可以在路由器层面观察出口流量验证。

下面是产品高频问题。购买 / 退款相关请看价格页 FAQ。

支持哪些硬件？

现阶段只支持 x86_64 架构。树莓派 / 香橙派 / Apple Silicon Mac / ARM 架构 NAS（绿联 DXP、极空间 Z2/Z4 等大部分家用型号）暂不支持，请勿尝试。

推荐起步硬件：N100 / N305 mini-PC（约 1000 元）即可跑全功能 AI 8–12 路。x86 架构的 NAS（如 Synology XS 系列、TerraMaster D 系列、绿联部分 x86 型号）也可以装。下单前先在目标机器执行 uname -m，输出 x86_64 才能装。

需要公网 IP 吗？

不需要。在家局域网或 NAS 上跑，远程访问推荐 Tailscale / Wireguard 走 VPN，零运维零暴露。需要给家人外面看就走反代 + 强密码 + HTTPS。

一台机器最多接几路？

瓶颈在 AI 检测，不在视频转发。粗略指标：

N100 / 11 代 i3 + 集显加速：8–12 路 1080p 5fps 全功能
RTX 3060 + 显卡加速：20–32 路
只录不检测：100+ 路（瓶颈在磁盘 IO，看你 HDD 能写多少 MB/s）

能纯局域网用吗？

可以。授权激活时一次性需要联网，之后服务器可以彻底断网——心跳失败不影响功能（详见授权）。事件推送、TTS 喊话、Home Assistant 桥接、录像回放都不需要公网。

为什么不让 App 直接连相机？

RTSP 单路只能少数客户端订阅。Live + 检测 + App 直连就 3 路了，廉价 ONVIF 相机会撑爆。云瞰中转后一路相机连接分发给 N 个客户端，同时把 RTSP 转成浏览器和 App 能直接播的格式，并完成录像分段——自己实现等于重写一台 NVR。

支持海康 / 大华吗？

全系支持。海康 / 大华 / 宇视 / TP-Link Vigi / 华为好望这些专业 IPC 都是标准 ONVIF，扫描即出。详见摄像头接入。

支持 4K 录像吗？

支持。云瞰直接转发 H.264 / H.265，4K 流量大但 CPU 消耗几乎为 0。AI 检测自动用子码流（416x416）所以不影响。注意 4K 一路一天约 42GB，规划好磁盘。

能跨设备同步人脸库 / 配置吗？

目前不行（单实例部署）。多机部署需要共享数据库 + 共享 NFS 录像目录，文档里没写但可行。后续会做 "配置导出 / 导入" 一键迁移。

出商业 SaaS 版本吗？

短期不会。云瞰定位 "自托管" —— 数据完全在用户自己的服务器，不上传任何画面到我方。这是隐私承诺也是和大厂 IPC App 的核心差异。

数据会不会被上传到云端？

不会。云瞰是纯自托管：所有视频、人脸、事件数据都只存在你自己的服务器上，我们的服务器不存任何画面。除了授权激活时的指纹校验心跳（仅一串硬件 hash），客户端不向我方发任何业务数据。可以在路由器层面观察出口流量验证。

支持双向对讲吗?

支持。基于 ONVIF backchannel,Android / iOS 都是按住讲(Hold-to-Talk),带 backchannel 的摄像头即可用。自动化还能用文字转语音(TTS)主动喊话,例如有人逗留时自动播放提示。

怎么接 Tapo / 小米 / Wyze 这类摄像头?

云瞰原生只接 RTSP 与 ONVIF 两类。Tapo / 小米 / Wyze / 萤石等私有协议设备,先用 go2rtc 桥接成标准 RTSP,再当普通 RTSP 源添加即可。

自然语言搜录像需要联网或 API key 吗?

不需要。语义搜索由本地 VLM(视觉语言模型)完成,中英双向、完全离线,不调用任何外部 LLM,也不需要 OpenAI / Gemini 之类的 API key。

能装在 NAS 上吗(群晖 / Unraid / 飞牛 / TrueNAS)?

能。云瞰是单 Docker 镜像,支持群晖(Container Manager)、Unraid、飞牛、UGOS、TrueNAS SCALE、Proxmox VE LXC,以及 Home Assistant OS 加载项。各平台步骤见安装文档。

录像存在哪?可以传到网盘吗?

录像默认存服务器本地。可选上传后端:115 网盘(扫码登录 + 秒传)或本地归档目录,由独立的上传进程异步推送,不占用实时链路。

和 Home Assistant 怎么集成?

通过 MQTT discovery 自动把摄像头与检测事件暴露给 Home Assistant,可在 HA 里做联动;反向也能由云瞰的自动化引擎触发 TTS 喊话等动作。详见自动化文档。

支持 Apple 家庭(HomeKit)吗?

目前不集成 HomeKit。云瞰以官方 iOS / Android App 和 Web 控制台作为主要客户端,直播走 WebRTC,握手超时自动降级 HLS。