首次啟動
映像檔跑起來後，瀏覽器打開伺服器 IP 的 23406 連接埠，會自動跳到 /setup 精靈。整套首啟流程通常 5 分鐘內完成。
1. 選資料庫類型
精靈第一步要選 SQLite 還是 MySQL/MariaDB：
| 選項 | 適合 | 說明 |
|---|---|---|
| SQLite（預設建議） | 家庭單機部署 | 資料庫就是一個檔案，零設定零維運 |
| MySQL/MariaDB | 多機 / 大規模 / 已有 MySQL | 需要自己部署或選「內建 MariaDB」讓映像檔啟動一份 |
選 SQLite 不丟臉
SQLite 在 200 路以下攝影機、單伺服器部署完全夠用。效能瓶頸基本上永遠是磁碟 IO（錄影）和 GPU（偵測），不是資料庫。
2. 建立管理員帳號
使用者名稱 + 密碼（≥ 8 位，含字母和數字）。這個帳號是網頁後台的最高權限，能刪攝影機、改全域設定，建議給一個高強度密碼。
忘記管理員密碼怎麼辦
目前沒有內建 CLI 重設工具。臨時解決：進資料庫（SQLite 用
sqlite3 data/skyview.db、MySQL 用 mysql -u skyview -p）執行 DELETE FROM users; 清空使用者資料表，瀏覽器重新整理會重新跳到 Setup 精靈讓你建立首位管理員，攝影機、人臉庫、自動化規則等其他資料都不受影響。所以記好密碼，或者用密碼管理器存一份。3. 設定完成，進入網頁後台
精靈寫完設定後會自動重啟服務並跳到登入頁。用剛才建立的帳號登入，進入後台首頁。
4. 新增第一台攝影機
左側導覽 → 攝影機 → 新增。支援兩種接入：
- ONVIF 自動探索（建議）：攝影機和伺服器在同一區域網路時點「掃描」，幾秒鐘列出所有 ONVIF 裝置
- 手動 RTSP：貼上
rtsp://使用者名稱:密碼@攝影機IP:554/stream1這種網址
建議 ONVIF 接入
ONVIF 自動拿 PTZ 能力、對講連接埠、子碼流位址，省去你查廠商手冊。憑證加密落庫。
5. 看到畫面就成功了
新增完跳到 Live 頁面，應該 3–8 秒看到畫面。優先用低延遲通道（< 500ms），如果不通自動切換到穩定通道（2–4s）。
卡在緩衝圈
看不到畫面通常是：RTSP URL 不對（密碼錯 / 路徑錯）、防火牆擋了 23515 UDP 連接埠、攝影機用了私有協定（如 Tapo）。詳見 疑難排解。
6. 啟用錄影（可選）
預設錄影是開著的，按時間分段寫到 data 目錄下。如果要關或只錄某些時段，到 攝影機詳情 → 錄影設定 調。
下一步看哪裡
這篇文件有幫助嗎？