首次启动
镜像跑起来后，浏览器打开服务器 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这种 URL
推荐 ONVIF 接入
ONVIF 自动拿 PTZ 能力、对讲端口、子码流地址，省去你查厂商手册。凭证加密落库。
5. 看到画面就成功了
添加完跳到 Live 页面，应该 3–8 秒看到画面。优先用低延迟通道（< 500ms），如果不通自动切换到稳定通道（2–4s）。
卡在缓冲圈
看不到画面通常是：RTSP URL 不对（密码错 / 路径错）、防火墙挡了 23515 UDP 端口、相机用了私有协议（如 Tapo）。详见 排错。
6. 启用录像（可选）
默认录像是开着的，按时间分段写到 data 目录下。如果要关或只录某些时段，到 摄像头详情 → 录像设置 调。