文档目录
故障排查
先确认问题发生在哪一步：Rerinku View 服务 → 摄像头接入 → 实时画面 → 录像 → AI 或远程访问。先在局域网用一台摄像头复现，再比较其他设备或外网访问的表现。
控制台打不开或服务启动失败
- 在 Rerinku View 主机上请求
curl http://127.0.0.1:8080/healthz。改过监听地址或端口时，用实际值。正常返回200和{"status":"ok"}；它只检查服务与数据库，不代表摄像头正常。 - 本机也连不上时，查看启动日志。检查端口是否占用、配置中是否有不认识的键，以及运行用户能否写配置、数据和组件目录。用
RERINKU_CONFIG指定的文件必须已经存在。 - 本机能访问、另一台机器不能时，检查监听地址是否只设为
127.0.0.1，以及主机防火墙、容器网络。另一台机器要用主机的局域网 IP，不能用localhost。
配置优先级是环境变量 > 文件 > 默认值；路径按工作目录解析。详见配置参考。
找不到或加不上摄像头
| 症状 | 先检查 | 处理后怎样确认 |
|---|---|---|
| ONVIF 发现列表为空 | 同网段、摄像头的 ONVIF 开关、组播和 UDP 3702；Docker Desktop 的网络限制 | 用手动添加填 IP，验证能否连接 |
| 添加时账号密码错误 | 摄像头的账号、密码和 ONVIF 权限；不是 Cloud 账号 | 重新添加通过连接验证 |
| RTSP 地址被拒绝 | 地址里是否包含账号密码 | 把凭据移到单独字段后添加 |
| 国标没有通道 | SIP 注册参数、密码、5060 端口是否被占用，设置页是否显示监听运行 | 注册后从发现列表添加各个通道 |
| USB 不出现或提示占用 | Linux、输出格式、video 组、容器设备映射；是否有别的程序正在使用 |
释放占用后再查看；只有 YUYV/NV12 输出的设备不支持 |
各协议的完整步骤见接入摄像头。
实时画面不出来
- 先看播放器提示。 密码错误、码流不存在和编码不受支持需要处理对应设置。H.265 播放失败时，先切到 H.264 码流，详见码流与编码。
- 比较局域网与外网。 控制台和实时媒体使用不同连接；能打开网页只说明 HTTP 可达。局域网能播、外网不行时，检查 WebRTC 的 ICE、UDP 或 TURN 路径，见配置参考和远程访问。
- 只播放一路再观察。 打开播放器的调试 HUD，查看帧率、码率和丢包；MJPEG 转码和 AI 解码会消耗资源。恢复后确认画面持续更新，再增加分屏。
网络断线时播放器会自动重连；可手动点「立即重试」。重连规则见实时查看。
没有录像或回放为空
- 确认这台设备开启了连续录像；实时画面正常不等于正在录像。
- 在回放页选对设备、码流和日期。日历按浏览器时区显示，文件目录按 UTC 分日，不要仅凭目录日期判断缺失。
- 检查磁盘空闲、容量与保留天数，以及数据目录写入权限。日志出现
recordings paused to protect storage表示因空间不足暂停，恢复空间后会自动继续。 - 只有事件、没有视频时，检查该时间是否有录像，以及设备是否支持事件录像。SDK 设备和 Rerinku Cam 需要开启连续录像。
设置和清理策略见录像与回放。远端存储不是即时写入：本机文件封口后才上传。
AI 不能开启或资源占用高
先检查 AI 支持的平台、模型下载状态和摄像头的物体检测开关。需要人脸识别时，还要开启「人」类别并准备人脸库。
在 设置 → 智能检测 查看性能，在 设置 → 视频解码 查看每路是否使用硬件解码。GPU 解码与 GPU 推理分别支持，不能根据其中一个推断另一个。先减少检测路数或使用较低分辨率的检测码流，再比较负载。模型、帧率和各平台的加速方式见 AI 识别。
快速连接或手机通知异常
- 先确认局域网内能打开 Rerinku View。Cloud 撤销的节点需要在 Rerinku View「断开并移除」后重新连接。
- 手机在外面连不上时，检查 App 保存的地址。配对二维码不包含快速连接地址，App 也不会自动在局域网地址与公网地址间切换。
- 设了访问密码后无法新绑定手机，是当前 App 的已知限制；已经绑定的手机仍可用。
- 收不到通知时，在 设置 → 通知 → 手机推送 发送测试，检查手机系统通知权限、设备和类别筛选，以及 Rerinku View 的出站网络。文字能到但图片没有时，还要确认手机能访问 Rerinku View。
详见远程访问与手机 App及事件与通知。
保留哪些诊断信息
记录 Rerinku View 版本、操作系统和架构、原生或 Docker 安装方式、摄像头协议和编码、发生时间及使用的时区、局域网与外网是否都能复现，以及出错前后的日志和播放器提示。
使用本文安装服务名时，Linux 可用 journalctl -u rerinku-view -n 100 --no-pager；Docker Compose 可用 docker compose logs --tail=100。手动运行时保存终端输出。更多日志说明见备份与监控。分享前移除摄像头密码、令牌、二维码、节点公网地址和人脸照片等私人信息。