2026-10-22 02:27:18 +02:00
2026-10-22 02:27:01 +02:00
2026-10-22 02:27:01 +02:00
2026-10-22 02:27:18 +02:00
2026-10-22 02:27:01 +02:00
2026-10-22 02:27:01 +02:00
2026-10-22 02:27:01 +02:00
2026-10-22 02:27:01 +02:00

cam : webcam, son bidirectionnel et enceinte Bluetooth via Cloudflare

Page web https://kaisa.esiah.dev/mic : video + son de la webcam du serveur, et micro du navigateur vers une enceinte Bluetooth branchee sur le serveur. Aucun port ouvert sur le routeur ni sur le serveur : tout passe par le tunnel Cloudflare.

Architecture

Navigateur --HTTPS--> Cloudflare (Access + Tunnel) --> cloudflared (app-tunnel) | reseau docker shared-network /mic* --> mic-bridge:8090 (page + WebSocket micro -> paplay -> Pulse -> Bluetooth) reste --> go2rtc:1984 (video MSE + son camera)

  • go2rtc : lit la webcam (/dev/video0 + carte son ALSA webcam) via ffmpeg (H.264 baseline + AAC) et la diffuse en MSE par HTTP/WebSocket.
  • mic-bridge : sert la page /mic, recoit l'audio du navigateur en WebSocket (PCM 16 bits mono) et le joue sur l'enceinte via PulseAudio/PipeWire. Son entrypoint reconnecte l'enceinte et remet son volume toutes les 15 s.
  • Limite : ce n'est pas du WebRTC (Cloudflare ne transporte pas l'UDP). Latence du micro ~200 a 500 ms, mode ON/OFF et non duplex natif.

Arborescence

/srv/apps/cam docker-compose.yml services go2rtc + mic-bridge go2rtc.yaml flux webcam (gain camera : volume=XXdB) Makefile commandes de gestion mic-bridge/ Dockerfile, server.js, index.html, entrypoint.sh scripts/cam-watch.* surveillance webcam (cron)

Prerequis

  • Debian avec Docker + Compose, make, PipeWire (pipewire-pulse), BlueZ.
  • Reseau docker externe shared-network (partage avec le conteneur app-tunnel).
  • Utilisateur esiahdmin (UID 1001) : le socket Pulse est dans /run/user/1001.
  • Enceinte Bluetooth appairee (69:B2:C0:04:A4:80).

Installation

cd /srv/apps/cam
make host-setup      # une seule fois : linger, pipewire au boot, trust BT, micro webcam
make up
make cron-install    # surveillance webcam
make status

Configuration Cloudflare (dashboard, une seule fois)

  1. Tunnel (Networks > Tunnels > Public Hostname), dans cet ordre :
    • kaisa.esiah.dev + chemin mic* -> HTTP mic-bridge:8090
    • kaisa.esiah.dev + chemin vide -> HTTP go2rtc:1984
  2. Access (Access > Applications) : une seule application sur kaisa.esiah.dev avec deux destinations : sans chemin, et mic*. Politique Allow limitee a votre email (One-time PIN si le fournisseur d'identite pose probleme).
  3. Page d'accueil (Rules > Redirect Rules) : http.host eq "kaisa.esiah.dev" et http.request.uri.path eq "/" -> redirection statique 302 vers https://kaisa.esiah.dev/mic.

Ne jamais supprimer la destination sans chemin dans Access : l'API go2rtc, camera comprise, deviendrait publique.

Utilisation

  • Ouvrir https://kaisa.esiah.dev (ou l'icone ajoutee a l'ecran d'accueil du telephone).
  • Cliquer sur la video pour activer le son de la camera.
  • Bouton Micro ON/OFF : active le micro du navigateur. Le son de la camera est coupe chez vous pendant que le micro est ON (evite l'echo).
  • Curseur Gain : volume de votre voix dans l'enceinte (0.2 a 5, defaut 1).
  • Le WebSocket se reconnecte seul ; l'ecran reste allume via Wake Lock si le navigateur le permet.

Commandes (make help)

Commande Effet
make up / down / restart Demarrer, arreter, redemarrer
make rebuild / update Reconstruire sans cache / mettre a jour les images
make status Diagnostic : webcam, carte son, conteneurs, Bluetooth, flux
make logs / logs-cam / logs-mic Logs en continu
make bt Reconnecter l'enceinte
make audio-fix Relancer pipewire + enceinte
make usb-reset Reset du controleur USB (coupe aussi le Bluetooth)
make speaker Bruit de test dans l'enceinte
make level Niveau du son camera (viser -25 a -30 dB)
make gain-cam GAIN=15 Gain du son camera (dB)
make sink-volume SINKVOL=60% Volume de l'enceinte
make cron-install / cron-remove / cron-log Surveillance webcam

Variables surchargeables : BT_MAC, USER_ID, PCI_USB, GAIN, SINKVOL.

Reglages

  • Son camera trop faible/fort : make gain-cam GAIN=... (12 par defaut, plage utile 8 a 20).
  • Echo : eloigner l'enceinte de la webcam, baisser make sink-volume SINKVOL=50%.
  • Voix trop faible dans l'enceinte : curseur Gain de la page, puis volume de l'enceinte.

Depannage

Symptome Cause probable Action
Pas d'image, ERR [exec] timeout Webcam absente make status; si /dev/video* absent : debrancher 30 s, rebrancher a l'arriere de la carte mere, make restart
dmesg : error -110 / -62 sur usb 1-3 Alimentation/cable/port USB Cable court, port direct, hub alimente, autre port ; sinon webcam defectueuse
Image OK, pas de son camera Son coupe par le navigateur ou gain trop bas Cliquer sur la video ; make level
Micro : WebSocket refuse (302) Access ne couvre pas /mic/ws Verifier les deux destinations de l'application Access
Micro OK mais silence Enceinte deconnectee make bt ou make audio-fix ; make speaker pour tester
404 sur /stream.html Regle tunnel manquante ou mal ordonnee mic* d'abord, la regle sans chemin en dernier
Boucle de 3 boutons dans la page /stream.html route vers mic-bridge Meme cause que ci-dessus
Plus de son apres redemarrage pipewire Sink Bluetooth perdu make audio-fix
Firefox : micro silencieux AudioContext a 16 kHz refuse Deja gere : la page utilise la frequence native du navigateur

Journal de la surveillance : make cron-log (/var/log/cam-watch.log).

Securite

  • Aucun port publie : tout est joignable uniquement via le reseau docker et le tunnel.
  • Cloudflare Access est la seule barriere d'authentification : ne jamais la desactiver.
  • go2rtc tourne en privileged avec /dev monte pour survivre aux reenumerations USB. Si la webcam devient stable, remplacer par devices: [/dev/video0, /dev/snd] + group_add: [video, audio].
  • Le conteneur mic-bridge monte /run/user/1001 et le bus D-Bus pour piloter Bluetooth/Pulse.

Sauvegarde et restauration

Tout est dans /srv/apps/cam (pas de volume de donnees). Sauvegarder ce dossier (par exemple dans le depot git) et rejouer :

make host-setup && make up && make cron-install
S
Description
No description provided
Readme
1.7 MiB
Languages
TypeScript 88.7%
CSS 4.1%
Makefile 2.9%
Shell 1.7%
Dockerfile 1.5%
Other 1.1%