# 首次启动

镜像跑起来后，浏览器打开服务器 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）。详见 [排错](/docs/troubleshooting)。

## 6. 启用录像（可选）

默认录像是开着的，按时间分段写到 data 目录下。如果要关或只录某些时段，到 摄像头详情 → 录像设置 调。

## 下一步看哪里

- 想加更多摄像头 → [摄像头接入](/docs/cameras)
- 想看回放 → 直接到网页后台的 "回放" 页用时间轴拖
- 想开 AI 检测（运动 / 人脸 / 车牌） → [AI 检测](/docs/detection)
- 出问题了 → [排错](/docs/troubleshooting)

---

来源:https://yun-kan.com/ja/docs/quickstart