排錯
遇到問題先按本章對照症狀自查。如果都沒命中，到末尾的 "求助渠道" 聯絡我們。
1. 看不到畫面（Live 一直緩衝）
| 可能原因 | 怎麼驗證 | 解決 |
|---|---|---|
| RTSP URL 不對 | 用 VLC 試同樣的 URL | 改 URL 重新儲存；ONVIF 自動發現抓錯位址時改用手動 RTSP |
| 憑證錯誤 | 網頁後台顯示驗證失敗 | 回 攝影機詳情 改密碼；ONVIF 密碼 ≠ RTSP 密碼 |
| 低延遲通道被擋 | DevTools → Network 看連線錯誤 | 防火牆開 UDP 23515；無法開的話會自動切到穩定通道（延遲 2–4s） |
| 攝影機走私有協議（Tapo / 小米） | 查攝影機品牌是否不在 攝影機 清單裡 | 走 go2rtc 橋接 |
| 串流媒體閘道沒啟動 | docker logs yunkan 看啟動錯誤 | 多半是連接埠被佔用；試著重啟容器 |
2. 看回放黑畫面 / 進度條不動
- 錄影沒開：攝影機詳情 → 錄影設定 → 開啟
- 磁碟滿：
df -h看 data 所在分割區，刪舊錄影或縮短保留天數 - 錄影段壞了：找到對應的
data/recordings/<id>/<date>/<HH-MM-SS>.mp4用 VLC 試播；壞掉的段最多遺失 5 分鐘 - 時間不對：伺服器時區和攝影機時區不同步，回放時間軸會錯 8 小時；用
timedatectl檢查
3. AI 偵測不運作
| 症狀 | 原因 | 解決 |
|---|---|---|
| 事件頁一直是空的 | 全域偵測開關關了 | 設定 → 偵測 → 啟用 |
| 某台攝影機不偵測 | 該攝影機有 "偵測失敗" 狀態 | 攝影機詳情 → "清除偵測錯誤" |
| GPU 使用率 0 | 映像檔變體不對（cpu 映像檔跑 GPU 卡） | 拉取對應變體的映像檔後重啟 |
| 人臉總是 "陌生人" | 庫裡沒上傳過這個人 / 閾值太嚴格 | 新增人臉 / 降低人臉相似度閾值 |
| 跌倒誤報多 | 下墜速度閾值太低 | 把跌倒下墜速度閾值調高一點 |
4. 容器一直重啟
用 docker logs --tail 200 yunkan 看最後輸出。常見錯誤：
- 設定缺失：處於精靈模式但健康檢查失敗 → 瀏覽器走完 /setup 精靈即可
- 連接埠被佔用：
ss -tnlp | grep 23406，把佔用的服務關掉或換連接埠 - 硬體檔案沒掛載：bind-mount 沒帶
/etc/machine-id，授權校驗崩潰；按 安裝 加上 - 架構不支援:雲瞰 只發布 x86_64 與 RK3588(arm64)映像檔,其它 ARM 機器無法運作(
uname -m應輸出x86_64;輸出aarch64的只有 RK3588 板可用,見 RK3588 部署)
5. 上傳 115 失敗
- 登入資訊過期（30 天左右）：設定 → 115 → 重新掃碼登入
- VIP 到期：超大檔案需要 115 VIP 的秒傳通道；非 VIP 走限速通道
- 目標資料夾被刪：到 115 重建資料夾後回 雲瞰 重選
- 網路不穩：上傳任務自帶重試，看
docker logs yunkan看具體錯誤
6. 自動化不觸發
- 勿擾時段：設定 → 通知 → 勿擾時段，看是不是剛好處於這段時間
- 冷卻時間：30 秒內重複事件會被吞掉，調低冷卻時間或換不同事件類型
- 條件不符：規則裡加了 "辨識到的人 = 張三" 但實際辨識成 "陌生人"，規則不會觸發；放寬條件
- MQTT 沒連上：設定 → 整合 → MQTT 看連線狀態，檢查位址 / 憑證
7. 升級後精靈又出現 / 資料不見了
升級後跳到 /setup 幾乎一定是 data 目錄沒有正確掛載——容器看不到上次寫入的設定檔就以為是新安裝。檢查：
bash
docker inspect yunkan | grep -A 2 Mounts
# 應該看到 Source: /home/.../data, Destination: /app/data
# 如果路徑變了 / 沒掛，docker rm 容器，重新 docker run 時掛對切勿在精靈裡再走一遍
直接走 setup 會寫一個新的空資料庫，原資料庫雖然還在但被停用。先停容器、把掛載修好、重啟，就能直接進入正常模式。
8. 忘記密碼，登不進去
先看是哪一種情況：
| 情況 | 怎麼辦 |
|---|---|
| 還記得原密碼，只是想換一個 | 登入後進「設定 → 使用者管理」修改 |
| 家人的帳號忘了密碼 | 請管理員進「設定 → 使用者管理」，替這個帳號重設 |
| 管理員自己忘了，誰都進不去 | 用下面的指令重設 |
雲瞰裝在你自己家裡，沒有「找回密碼」信件這條路。管理員忘了密碼時，在裝雲瞰的那台機器上執行下面的指令即可——能操作這台機器的人，本來就擁有最高權限。
bash
# 先看看系統裡有哪些帳號
docker exec -it yunkan skyview-reset-password --list
# 重設指定帳號的密碼，依提示輸入兩次（輸入時螢幕上不顯示字元）
docker exec -it yunkan skyview-reset-password --user admin指令的提示是英文
New password (not shown) 是輸入新密碼，Type it again 是再輸入一次。密碼要求和網頁裡一樣：至少 8 位，同時包含英文字母和數字。如果這個帳號先前被停用過，只重設密碼還是登不進去。指令末尾加上 --activate，可以在重設的同時重新啟用：
bash
docker exec -it yunkan skyview-reset-password --user admin --activate容器名稱不叫 yunkan 怎麼辦
指令裡的
yunkan 是一鍵腳本安裝時的預設容器名稱。用 NAS 應用中心或 Home Assistant 附加元件安裝的，名稱可能不一樣，先用 docker ps 查一下，把指令裡的 yunkan 換成實際名稱。重設密碼不會把人踢下線
已經登入的手機和網頁，在原有登入有效期內仍然可以繼續使用。如果是擔心帳號被別人拿到了，請到「設定 → 使用者管理」把那個帳號停用或刪除。
9. 看日誌的方法
bash
# 單映像檔部署：所有功能日誌混在一起
docker logs --tail 500 -f yunkan
# 想只看偵測相關：
docker logs yunkan 2>&1 | grep -i detection
# 多容器部署：每個元件獨立
docker compose logs -f api detection求助渠道
- 後台工單：客戶中心 → 我的訂單 → 提工單，附上
docker logs --tail 200 yunkan的輸出，跟進最快 - 電子郵件：support@yun-kan.com（24 小時內回覆）
- 微信群組：購買後客戶中心的 "我的訂單" 頁面有入群二維碼（僅付費使用者）
這篇文件有幫助嗎？