commit 831e4b0ae0458e2784d9dc3ad555a0980b2455e0 Author: Esiah Date: Thu Oct 22 02:27:01 2026 +0200 cam: go2rtc + mic-bridge diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..dc49e67 --- /dev/null +++ b/Makefile @@ -0,0 +1,110 @@ +.RECIPEPREFIX = > +.DEFAULT_GOAL := help + +BT_MAC ?= 69:B2:C0:04:A4:80 +USER_ID ?= 1001 +PCI_USB ?= 0000:00:14.0 +GAIN ?= 12 +SINKVOL ?= 70% +ENVU = XDG_RUNTIME_DIR=/run/user/$(USER_ID) DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(USER_ID)/bus + +.PHONY: help up down restart build rebuild ps logs logs-cam logs-mic status \ + bt audio-fix usb-reset speaker level gain-cam sink-volume \ + host-setup cron-install cron-remove cron-log update + +help: ## Liste des commandes +> @grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN{FS=":.*?## "}{printf " %-14s %s\n",$$1,$$2}' + +up: ## Demarrer (build si besoin) +> docker compose up -d --build + +down: ## Arreter et supprimer les conteneurs +> docker compose down + +restart: ## Redemarrer go2rtc et mic-bridge +> docker compose restart go2rtc mic-bridge + +build: ## Reconstruire l'image mic-bridge +> docker compose build mic-bridge + +rebuild: ## Reconstruire sans cache et relancer +> docker compose build --no-cache mic-bridge +> docker compose up -d + +ps: ## Etat des conteneurs +> docker compose ps + +logs: ## Logs des deux services (suivi) +> docker compose logs -f --tail 50 + +logs-cam: ## Logs go2rtc (suivi) +> docker compose logs -f --tail 50 go2rtc + +logs-mic: ## Logs mic-bridge / Bluetooth (suivi) +> docker compose logs -f --tail 50 mic-bridge + +status: ## Diagnostic complet (webcam, son, Bluetooth, flux) +> @echo "== Webcam (hote)" +> @ls /dev/video* 2>/dev/null || echo "ABSENTE : probleme USB, voir README" +> @grep -A1 webcam /proc/asound/cards || echo "carte son webcam ABSENTE" +> @echo "== Conteneurs" +> @docker compose ps +> @echo "== Bluetooth" +> @bluetoothctl info $(BT_MAC) | grep -E "Name|Connected" || true +> @echo "== Flux go2rtc" +> @docker exec mic-bridge node -e "fetch('http://go2rtc:1984/api/streams').then(r=>r.text()).then(t=>console.log(t.slice(0,300)))" || true + +bt: ## Reconnecter l'enceinte Bluetooth +> $(ENVU) bluetoothctl connect $(BT_MAC) +> docker compose restart mic-bridge + +audio-fix: ## Relancer pipewire, reconnecter l'enceinte +> $(ENVU) systemctl --user restart pipewire pipewire-pulse wireplumber +> sleep 3 +> $(ENVU) bluetoothctl connect $(BT_MAC) +> docker compose restart mic-bridge + +usb-reset: ## Reset du controleur USB (coupe aussi le Bluetooth) +> echo $(PCI_USB) | sudo tee /sys/bus/pci/drivers/xhci_hcd/unbind +> sleep 3 +> echo $(PCI_USB) | sudo tee /sys/bus/pci/drivers/xhci_hcd/bind +> sleep 8 +> ls -l /dev/video* || echo "webcam toujours absente : debrancher/rebrancher" +> $(MAKE) restart + +speaker: ## Bruit de test dans l'enceinte +> docker exec mic-bridge sh -c 'head -c 32000 /dev/urandom | paplay --raw --rate=16000 --format=s16le --channels=1' + +level: ## Niveau du son camera (viser -25 a -30 dB) +> docker exec go2rtc ffmpeg -hide_banner -i rtsp://127.0.0.1:8554/webcam -t 5 -vn -af volumedetect -f null - 2>&1 | grep -E "mean_volume|max_volume" + +gain-cam: ## Gain camera : make gain-cam GAIN=15 +> sed -i -E 's/volume=[0-9.]+dB/volume=$(GAIN)dB/' go2rtc.yaml +> docker compose restart go2rtc + +sink-volume: ## Volume enceinte : make sink-volume SINKVOL=60% +> sed -i -E 's/SINK_VOLUME: "[^"]*"/SINK_VOLUME: "$(SINKVOL)"/' docker-compose.yml +> docker compose up -d mic-bridge + +host-setup: ## A faire une fois : linger, pipewire, trust BT, volume micro +> sudo loginctl enable-linger $$USER +> $(ENVU) systemctl --user enable --now pipewire pipewire-pulse wireplumber +> bluetoothctl trust $(BT_MAC) +> sudo amixer -c 0 sset Mic 100% cap unmute +> sudo alsactl store + +cron-install: ## Installer la surveillance webcam (cron, chaque minute) +> sudo install -m 755 scripts/cam-watch.sh /usr/local/bin/cam-watch +> sudo install -m 644 scripts/cam-watch.cron /etc/cron.d/cam-watch +> @echo "Installe. Log : /var/log/cam-watch.log" + +cron-remove: ## Desinstaller la surveillance +> sudo rm -f /etc/cron.d/cam-watch /usr/local/bin/cam-watch + +cron-log: ## Voir le journal de la surveillance +> @tail -n 30 /var/log/cam-watch.log 2>/dev/null || echo "(vide)" + +update: ## Mettre a jour l'image go2rtc et reconstruire mic-bridge +> docker compose pull go2rtc +> docker compose build --pull mic-bridge +> docker compose up -d diff --git a/README.md b/README.md new file mode 100644 index 0000000..e75191d --- /dev/null +++ b/README.md @@ -0,0 +1,128 @@ +# 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 +``` diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..8b93b78 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,29 @@ +name: cam + +services: + go2rtc: + image: alexxit/go2rtc + container_name: go2rtc + restart: unless-stopped + privileged: true # survit aux ré-énumérations USB (video0/video1) + volumes: + - /dev:/dev + - ./go2rtc.yaml:/config/go2rtc.yaml:ro + networks: [shared-network] + + mic-bridge: + build: ./mic-bridge + container_name: mic-bridge + restart: unless-stopped + environment: + BT_MAC: "69:B2:C0:04:A4:80" + PULSE_SERVER: "unix:/run/user/1001/pulse/native" + SINK_VOLUME: "70%" + volumes: + - /run/user/1001:/run/user/1001 + - /var/run/dbus:/var/run/dbus + networks: [shared-network] + +networks: + shared-network: + external: true diff --git a/go2rtc.yaml b/go2rtc.yaml new file mode 100644 index 0000000..21448b0 --- /dev/null +++ b/go2rtc.yaml @@ -0,0 +1,10 @@ +log: + level: debug + exec: debug + +api: + listen: ":1984" + +streams: + webcam: + - "exec:ffmpeg -hide_banner -loglevel warning -f v4l2 -video_size 640x480 -framerate 15 -i /dev/video0 -thread_queue_size 512 -f alsa -ac 1 -ar 16000 -i hw:CARD=webcam,DEV=0 -c:v libx264 -preset ultrafast -tune zerolatency -profile:v baseline -pix_fmt yuv420p -g 30 -c:a aac -b:a 64k -af aresample=async=1,highpass=f=80,volume=20dB,alimiter=limit=0.95 -f rtsp {output}" diff --git a/mic-bridge/Dockerfile b/mic-bridge/Dockerfile new file mode 100644 index 0000000..d59870d --- /dev/null +++ b/mic-bridge/Dockerfile @@ -0,0 +1,9 @@ +FROM node:22-slim +RUN apt-get update && apt-get install -y --no-install-recommends \ + pulseaudio-utils bluez ca-certificates \ + && rm -rf /var/lib/apt/lists/* +WORKDIR /app +RUN npm i ws +COPY server.js index.html entrypoint.sh ./ +RUN chmod +x entrypoint.sh +CMD ["./entrypoint.sh"] diff --git a/mic-bridge/entrypoint.sh b/mic-bridge/entrypoint.sh new file mode 100644 index 0000000..77569e3 --- /dev/null +++ b/mic-bridge/entrypoint.sh @@ -0,0 +1,21 @@ +#!/bin/bash +# Boucle de maintien : Bluetooth + volume de l'enceinte +( + while true; do + if ! bluetoothctl info "$BT_MAC" 2>/dev/null | grep -q "Connected: yes"; then + echo "[bt] connexion à $BT_MAC" + bluetoothctl connect "$BT_MAC" >/dev/null 2>&1 + sleep 5 + fi + if bluetoothctl info "$BT_MAC" 2>/dev/null | grep -q "Connected: yes"; then + SINK=$(pactl list short sinks 2>/dev/null | grep -i bluez | awk '{print $2}' | head -1) + if [ -n "$SINK" ]; then + pactl set-default-sink "$SINK" 2>/dev/null + pactl set-sink-volume "$SINK" "${SINK_VOLUME:-100%}" 2>/dev/null + pactl set-sink-mute "$SINK" 0 2>/dev/null + fi + fi + sleep 15 + done +) & +exec node server.js diff --git a/mic-bridge/index.html b/mic-bridge/index.html new file mode 100644 index 0000000..32fea5a --- /dev/null +++ b/mic-bridge/index.html @@ -0,0 +1,59 @@ + + + +Cam + + +
+ micro éteint + +
+ + diff --git a/mic-bridge/server.js b/mic-bridge/server.js new file mode 100644 index 0000000..4af8c47 --- /dev/null +++ b/mic-bridge/server.js @@ -0,0 +1,36 @@ +const http = require('http'), fs = require('fs'), { spawn } = require('child_process'); +const { WebSocketServer } = require('ws'); +const page = fs.readFileSync('index.html'); +const srv = http.createServer((q, r) => { + if (q.url.split('?')[0] !== '/mic') { r.statusCode = 404; return r.end(); } + r.setHeader('content-type', 'text/html'); + r.end(page); +}); +const wss = new WebSocketServer({ server: srv, path: '/mic/ws' }); +let active = null; +wss.on('connection', ws => { + if (active) { try { active.ws.close(); } catch (e) {} try { active.p && active.p.stdin.end(); } catch (e) {} } + const me = { ws, p: null }; + active = me; + ws.isAlive = true; + ws.on('pong', () => { ws.isAlive = true; }); + ws.on('message', (d, bin) => { + if (!bin) { + if (me.p) return; + let rate = 48000; + try { rate = parseInt(JSON.parse(d.toString()).rate) || 48000; } catch (e) {} + me.p = spawn('paplay', ['--raw', '--rate=' + rate, '--format=s16le', '--channels=1', '--latency-msec=150']); + me.p.on('error', e => console.log('paplay error', e.message)); + me.p.stdin.on('error', () => {}); + console.log('mic start', rate); + return; + } + if (me.p) me.p.stdin.write(d); + }); + ws.on('close', () => { if (me.p) me.p.stdin.end(); if (active === me) active = null; console.log('mic stop'); }); +}); +setInterval(() => wss.clients.forEach(ws => { + if (!ws.isAlive) return ws.terminate(); + ws.isAlive = false; ws.ping(); +}), 20000); +srv.listen(8090); diff --git a/scripts/cam-watch.cron b/scripts/cam-watch.cron new file mode 100644 index 0000000..aaa2fb2 --- /dev/null +++ b/scripts/cam-watch.cron @@ -0,0 +1,2 @@ +PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin +* * * * * root /usr/local/bin/cam-watch diff --git a/scripts/cam-watch.sh b/scripts/cam-watch.sh new file mode 100755 index 0000000..0bea39b --- /dev/null +++ b/scripts/cam-watch.sh @@ -0,0 +1,34 @@ +#!/bin/bash +LOG=/var/log/cam-watch.log +STAMP=/run/cam-watch.last +STATE=/run/cam-watch.state +COOLDOWN=120 +now=$(date +%s) +last=$(cat "$STAMP" 2>/dev/null || echo 0) +[ $((now - last)) -lt $COOLDOWN ] && exit 0 + +recreate() { + echo "$(date '+%F %T') $1 : recreation go2rtc" >> "$LOG" + (cd /srv/apps/cam && docker compose up -d --force-recreate go2rtc >/dev/null 2>&1) + echo "$now" > "$STAMP" +} + +prev=$(cat "$STATE" 2>/dev/null || echo ok) + +# Webcam reellement presente ? (lsusb plus fiable que /dev/video0 qui peut etre perime) +if lsusb | grep -q '1d5b:0104'; then + if [ "$prev" = "absent" ]; then + echo "$(date '+%F %T') webcam revenue" >> "$LOG" + echo "ok" > "$STATE" + sleep 5 + recreate "retour webcam" + exit 0 + fi + echo "ok" > "$STATE" + if [ "$(docker inspect -f '{{.State.Running}}' go2rtc 2>/dev/null)" != "true" ]; then + recreate "go2rtc arrete" + fi +else + [ "$prev" != "absent" ] && echo "$(date '+%F %T') webcam ABSENTE (probleme USB)" >> "$LOG" + echo "absent" > "$STATE" +fi