video-surveillance-app/deploy/Caddyfile.snippet
Adam Belkacemi d70892dce0 Flux video temps reel : l'iPhone pousse, MediaMTX restitue
L'iPhone n'est joignable depuis nulle part - CGNAT operateur en 4G, NAT
de la box sur le WiFi du studio, UPnP indisponible. Le serveur RTSP de
l'application camera est donc inutilisable de l'exterieur. Seule une
connexion sortante traverse les deux NAT : c'est le telephone qui pousse.

- MediaMTX en conteneur : SRT/RTMP en entree, WebRTC (WHEP) et HLS en
  sortie. La video ne traverse jamais la JVM - 800 kbps continus dans
  Spring Boot couteraient un thread par spectateur sans rien apporter.
- SRT privilegie sur RTMP : RTMP est du TCP, un paquet perdu sur un lien
  mobile bloque tout le flux. SRT retransmet selectivement en UDP.
- Lecture publique (choix assume), publication authentifiee : sans ca
  n'importe qui pousserait sa propre video sur le flux "biblio".
- Console : client WHEP maison avec repli HLS automatique, et mise en
  pause quand l'onglet passe en arriere-plan.

Correction d'un bug trouve en deployant : le @ExceptionHandler(Exception)
avalait les exceptions que Spring sait deja traduire, si bien que toute
URL inconnue renvoyait 500 au lieu de 404 - ce qui noyait les vraies
pannes au milieu des 500 provoques par les crawlers. Test de regression
ajoute.

35 tests au vert.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-12 18:08:34 +02:00

73 lines
3.1 KiB
Text

# ---------------------------------------------------------------------------
# Bloc a ajouter a /opt/edge/Caddyfile sur le serveur Hetzner.
#
# Pourquoi Caddy et pas Nginx + Certbot : le serveur heberge deja cinq autres
# domaines derriere un Caddy qui detient les ports 80 et 443. Y demarrer un
# second frontal aurait mis les deux en conflit sur les memes ports et coupe
# les services existants. Caddy obtient et renouvelle les certificats
# Let's Encrypt tout seul - il n'y a pas de Certbot a installer.
#
# Les deux orthographes sont servies : "seurveillance" est le sous-domaine
# effectivement cree, "surveillance" couvre la faute de frappe dans les deux
# sens. Caddy demande un certificat pour chaque nom qui resout vers ce serveur.
#
# Trois destinations derriere un seul domaine :
# /webrtc/* -> MediaMTX, signalisation WebRTC (flux video temps reel)
# /hls/* -> MediaMTX, repli HLS
# le reste -> l'application Spring Boot (console, API, websocket STOMP)
#
# Le proxy WebSocket n'a rien a declarer : Caddy propage l'upgrade nativement.
# ---------------------------------------------------------------------------
video-seurveillance.belkacemi.me, video-surveillance.belkacemi.me {
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
Referrer-Policy "strict-origin-when-cross-origin"
-Server
}
# L'actuator n'a aucune raison d'etre public : health et metriques
# renseignent un attaquant sur les versions et l'etat interne.
@actuator path /actuator/*
respond @actuator 404
# --- Flux video : WebRTC (latence < 1 s) --------------------------------
# flush_interval -1 desactive la bufferisation de la reponse. Sans ca, la
# negociation WHEP et les segments basse latence seraient retenus par le
# proxy le temps de remplir un tampon - ce qui annule tout l'interet.
handle_path /webrtc/* {
reverse_proxy iot-alarm-mediamtx:8889 {
flush_interval -1
}
}
# --- Flux video : HLS (repli, ~6 s) -------------------------------------
# Pas de compression ici : les segments video sont deja compresses, gziper
# par-dessus ne gagne rien et consomme du CPU sur un serveur a 2 vCPU.
handle_path /hls/* {
reverse_proxy iot-alarm-mediamtx:8888 {
flush_interval -1
# MediaMTX repond d'abord une redirection vers un chemin ABSOLU
# (/biblio/index.m3u8?cookieCheck=1), qui ignore le prefixe /hls
# retire par handle_path. Sans cette reecriture, le navigateur
# suit la redirection vers l'application Spring Boot au lieu du
# serveur media - et recoit du JSON la ou il attend une playlist.
header_down Location "^/(.*)$" "/hls/${1}"
}
}
# --- Application Spring Boot (console, API, WebSocket STOMP) ------------
handle {
encode gzip zstd
reverse_proxy iot-alarm-app:8080
}
log {
output file /var/log/caddy/iot-alarm.log
format json
}
}