Frigate中文文档

主题

2025-08-27
1324
5.1m

常见问题解答 ​

Python致命错误: Bus error ​

此错误是由于共享内存(shm-size)设置过小导致的。请根据此指南调整shm-size大小。

如何在录像中添加音频？ ​

默认情况下，Frigate会移除录像中的音频以减少因无效数据导致失败的概率。如需保留音频，需要设置支持音频的FFmpeg预设：

yaml
ffmpeg:
  output_args:
    record: preset-record-generic-audio-aac

如何在实时监控中获取音频？ ​

仅当配置了go2rtc时才支持实时监控音频，详见实时监控文档。

无法在Web界面查看录像 ​

请确保摄像头发送的是h264编码视频，或进行转码。

可在Chrome浏览器打开chrome://media-internals/页面尝试播放，该页面会显示播放失败的具体原因。

摄像头子码流质量不佳怎么办？ ​

Frigate通常推荐使用可配置子码流的摄像头。若子码流分辨率不合适，可对主码流进行缩放处理。

高效缩放需要满足以下条件：

  1. 需配备GPU或核显进行缩放处理
  2. 需使用硬件加速的ffmpeg预设
  3. 在配置中设置detect -> width和detect -> height为期望的检测分辨率

正确配置后，GPU将负责解码和缩放，CPU占用仅小幅增加但效果更佳。

MJPEG流或快照显示异常绿色画面 ​

这通常表示摄像头配置的分辨率(width/height)不正确。请使用VLC等播放器确认实际分辨率，并检查宽高值是否颠倒。

分辨率不匹配

日志中出现"[mov,mp4,m4a,3gp,3g2,mj2 @ 0x5639eeb6e140] moov atom not found" ​

某些情况下出现此日志信息是正常的。Frigate会在存储前检查录像文件完整性，偶尔这些缓存文件会无效并自动清理。

日志中重复出现"On connect called" ​

若日志频繁出现"On connect called"信息，请检查是否有多个Frigate实例。当多个容器使用相同client_id连接MQTT时会出现此情况。

错误：Database Is Locked ​

SQLite在网络共享存储上运行不佳。若/media目录映射到网络共享，请按照此指南将数据库移至内部存储。

无法发布到MQTT：客户端未连接 ​

在Docker中使用MQTT时，请使用MQTT服务器的实际IP地址，而非localhost、127.0.0.1或mosquitto.ix-mosquitto.svc.cluster.local。

因为Frigate容器不在host网络模式下运行，localhost指向的是容器自身而非宿主机网络。

如何判断摄像头是否离线 ​

可通过MQTT或/api/stats接口检测，离线摄像头的camera_fps会显示为0。

此外，当摄像头离线时，Home Assistant会将其标记为不可用状态。

如何不通过Web界面查看Frigate日志？ ​

Frigate既会内部管理日志，也会直接输出到Docker标准输出。通过CLI查看日志的步骤如下：

  1. 在运行Frigate容器的主机上打开终端
  2. 执行以下命令：
    docker logs -f frigate
    注意：若容器名称不是"frigate"，请替换为实际名称。"-f"参数表示实时跟踪日志更新，按Ctrl+C可退出。

更多日志查看选项可参考Docker官方文档。

另外，创建容器时可绑定主机目录到/dev/shm/logs，既持久化日志又便于使用日志分析工具：

docker run -d \
  --name frigate \
  --restart=unless-stopped \
  --mount type=tmpfs,target=/tmp/cache,tmpfs-size=1000000000 \
  --device /dev/bus/usb:/dev/bus/usb \
  --device /dev/dri/renderD128 \
  --shm-size=64m \
  -v /path/to/your/storage:/media/frigate \
  -v /path/to/your/config:/config \
  -v /etc/localtime:/etc/localtime:ro \
  -v /path/to/local/log/dir:/dev/shm/logs \
  -e FRIGATE_RTSP_PASSWORD='password' \
  -p 5000:5000 \
  -p 8554:8554 \
  -p 8555:8555/tcp \
  -p 8555:8555/udp \
  ghcr.io/blakeblackshear/frigate:stable

RTSP流在VLC中正常播放，但在Frigate配置中使用相同URL却失败，这是bug吗？ ​

不是。Frigate使用TCP协议连接RTSP流，而VLC会根据网络条件自动切换UDP/TCP协议。VLC能播放而Frigate失败，很可能是因为VLC选择了UDP协议。

TCP能确保数据包有序到达，这对视频录制、解码和流处理至关重要，因此Frigate强制使用TCP连接。UDP速度更快但可靠性较低，VLC的要求与Frigate不同。

如需使用UDP协议，可通过ffmpeg输入参数或preset-rtsp-udp预设配置，详见ffmpeg预设文档。

默认登录密码是什么？/我忘记登录后台密码了怎么办？ ​

在首次安装Frigate的时候，会在日志里生成账号密码，请打开容器日志进行查看。

如果已经重启导致日志丢失的话，可使用5000端口进行访问，5000端口没有鉴权。然后可以在端口下进入设置中修改密码。

警告

请不要将5000端口直接映射到公网，这将会有严重的隐私泄露隐患！如果可以，建议在不需要的时候关闭5000端口的映射。 如果你的系统已经占用了5000端口（例如群晖的管理页面），你可以将容器的5000端口映射至其他任意空闲端口。

最近更新