常见问题

Q: 支持哪些硬件？

x86_64 全功能支持。ARM64 上:瑞芯微 RK3588 板(Orange Pi 5 / Radxa Rock 5 等)用板载 NPU 加速,见 RK3588 部署;Mac(Apple Silicon 与 Intel)用一键脚本在虚拟机里运行,见 macOS 部署;其它 ARM64 设备(树莓派 5、ARM 服务器、ARM 架构的 NAS)可以运行纯 CPU 版本,AI 检测速度取决于 CPU,性能较弱的设备建议只给少数机位开检测。32 位 ARM 系统不支持。 推荐起步硬件：N100 / N305 mini-PC（约 1000 元）跑全功能 AI（移动 + 人脸 + 物体）1–3 路够用；要更多路、或加跌倒 / 车牌识别，建议上 i5 / i7 + 核显，再多就上 NVIDIA 独显。x86 架构的 NAS（如 Synology XS 系列、TerraMaster D 系列、绿联部分 x86 型号）也可以装；想要低功耗小盒子可以选 RK3588 板。下单前先在目标机器执行 uname -m：输出 x86_64 或 aarch64 都能装；要用 NPU 加速的 ARM 设备只认 RK3588。

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 全功能支持。ARM64 上:瑞芯微 RK3588 板(Orange Pi 5 / Radxa Rock 5 等)用板载 NPU 加速,见 RK3588 部署;Mac(Apple Silicon 与 Intel)用一键脚本在虚拟机里运行,见 macOS 部署;其它 ARM64 设备(树莓派 5、ARM 服务器、ARM 架构的 NAS)可以运行纯 CPU 版本,AI 检测速度取决于 CPU,性能较弱的设备建议只给少数机位开检测。32 位 ARM 系统不支持。

推荐起步硬件：N100 / N305 mini-PC（约 1000 元）跑全功能 AI（移动 + 人脸 + 物体）1–3 路够用；要更多路、或加跌倒 / 车牌识别，建议上 i5 / i7 + 核显，再多就上 NVIDIA 独显。x86 架构的 NAS（如 Synology XS 系列、TerraMaster D 系列、绿联部分 x86 型号）也可以装；想要低功耗小盒子可以选 RK3588 板。下单前先在目标机器执行 uname -m：输出 x86_64 或 aarch64 都能装；要用 NPU 加速的 ARM 设备只认 RK3588。

需要公网 IP 吗？

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

一台机器最多接几路？

瓶颈在 AI 检测，不在视频转发。检测开得越全（人脸 / 跌倒 / 车牌 / 手势 / 哭声）越吃算力。下面是全功能、1080p、5fps 下的保守估计；把不重点的相机关掉检测（仅录像）能省算力给重点机位：

N100 / N150 集显：1–3 路全功能（N150 起支持跌倒检测）
i5 / i7 + Iris Xe 核显：2–4 路（含车牌识别）
RTX 2060 / 3060 等独显：8 路左右起步，具体看显存和开了哪些识别器
只录不检测：受磁盘 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。

登录页没有单点登录按钮 / 通行密钥按钮？

两个按钮的出现条件不一样。「使用 XX 登录」要管理员先在平台配置 → 单点登录里配好并打开总开关，少填一项或者开关没开都不会显示，见〈单点登录〉。「使用通行密钥登录」则要求你通过 HTTPS 域名访问云瞰——用 IP 地址或明文 http 打开时，浏览器不允许创建这类钥匙，按钮和添加入口都不会出现，配域名和证书见〈外网访问〉。

开了二次验证之后，电视大屏 / Home Assistant 登不上了？

新版 Home Assistant 集成不受影响：它把你带到云瞰自己的登录页，验证码输在那里，之后拿的是一枚专用令牌，见〈Home Assistant 集成〉。连在电视上的大屏界面和旧版手机 App 目前只认用户名密码，遇到开了二次验证的账号会登录失败——最省事的办法是给它们单独建一个不开二次验证、按只读授权的账号，见〈登录二次验证〉最后一节。

这篇文档有帮助吗？