Files
Kai-Sa-Cam/README.md
T
2026-10-22 02:27:01 +02:00

129 lines
6.2 KiB
Markdown

# 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
```bash
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 :
```bash
make host-setup && make up && make cron-install
```