6.2 KiB
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 ALSAwebcam) 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 conteneurapp-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)
- Tunnel (Networks > Tunnels > Public Hostname), dans cet ordre :
kaisa.esiah.dev+ cheminmic*->HTTPmic-bridge:8090kaisa.esiah.dev+ chemin vide ->HTTPgo2rtc:1984
- Access (Access > Applications) : une seule application sur
kaisa.esiah.devavec deux destinations : sans chemin, etmic*. Politique Allow limitee a votre email (One-time PIN si le fournisseur d'identite pose probleme). - Page d'accueil (Rules > Redirect Rules) :
http.host eq "kaisa.esiah.dev"ethttp.request.uri.path eq "/"-> redirection statique 302 vershttps://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
privilegedavec/devmonte pour survivre aux reenumerations USB. Si la webcam devient stable, remplacer pardevices: [/dev/video0, /dev/snd]+group_add: [video, audio]. - Le conteneur mic-bridge monte
/run/user/1001et 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