常見問題

支援哪些硬體?

x86_64 全功能支援;ARM 平台目前只支援瑞芯微 RK3588 板(Orange Pi 5 / Radxa Rock 5 等,用板載 NPU 加速,見 RK3588 部署)。樹莓派 / Apple Silicon Mac / 非 RK3588 的 ARM 架構 NAS(綠聯 ARM 型號、極空間 Z2/Z4 等大部分家用型號)暫不支援,請勿嘗試。

推薦起步硬體:N100 / N305 mini-PC(約人民幣 1000 元、折合約 US$140)跑全功能 AI(移動 + 人臉 + 物體)1–3 路夠用;要更多路、或加跌倒 / 車牌辨識,建議上 i5 / i7 + 內顯,再多就上 NVIDIA 獨顯。x86 架構的 NAS(如 Synology XS 系列、TerraMaster D 系列、綠聯部分 x86 型號)也可以裝;想要低功耗小盒子可以選 RK3588 板。下單前先在目標機器執行 uname -m,輸出 x86_64 才能裝,輸出 aarch64 的只有 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 單路只能給少數用戶端訂閱。即時畫面 + 偵測 + 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 目前只認使用者名稱密碼，遇到開了兩步驟驗證的帳號會登入失敗——最省事的辦法是給它們單獨建一個不開兩步驟驗證、按唯讀授權的帳號，見〈登入兩步驟驗證〉最後一節。