How do I get an HLS stream from an IP camera?

说明与用途

开发者通过使用ffmpeg将RTSP转码为HLS，并使用供应商提供的HLS句柄，为本地和远程用户安全地公开IP摄像头的实时流。

问题

Developers need to expose live camera feeds to web clients using HLS while respecting security, latency, and control requirements.

结果

The approach enables secure, low‑latency HLS delivery for both LAN and off‑site viewers, with clear separation of concerns, robust error handling, and telemetry for monitoring.

工作流

• 1. Store camera RTSP URL in a secret store on the server.
• 2. For on‑premise cameras, run ffmpeg to transcode RTSP to HLS, outputting .m3u8 and segments to a secure directory.
• 3. Serve HLS over HTTPS with an expiring path; set segment duration and list size as knobs.
• 4. For off‑site viewers, bind camera to database, authorize user, and request a vendor live handle via POST /sites/.../cameras/.../live.
• 5. Return JSON with handle and expiry; client destroys player on route change.
• 6. In the React app, fetch the live handle, handle HTTP errors (403 DENIED, 409 OFFLINE, other MEDIA), and initialize the player.
• 7. Log telemetry (cameraId, actorId, sourceKind, code, firstFrameMs) without persisting RTSP URLs or vendor secrets.
• 8. Implement tests to ensure no RTSP leakage, correct RBAC, handle refresh after revocation, and proper error states.
• 9. Monitor packager health (TCP reachability, process status, playlist mtime) and vendor API health (bind, mint, revoke).

证据

I do not ask an IP camera for HLS. I ask it for RTSP, or I ask a vendor live API that already packaged the camera into HTTP.

来源

ffmpeg -rtsp_transport tcp -i "$CAMERA_RTSP" -c:v copy -c:a aac -f hls -hls_time 2 -hls_list_size 6 /var/origin/live/cam.m3u8

来源

POST /sites/site_12/cameras/cam_4/live Cookie: session=... 201 { "handle": "ply_…", "expiresAt": "…" } 403 { "code": "DENIED" } 409 { "code": "OFFLINE" }

来源