# Dépannage Redis (port / auth / READONLY) > **En incident :** procédure pas à pas → **[REDIS-RUNBOOK.md](./REDIS-RUNBOOK.md)**. ## Sécurité (état attendu) Redis Prediqo est **durci** dans `docker-compose.yml` : | Mesure | Détail | |--------|--------| | Pas de port hôte | Aucun `ports:` sur le service `redis` — accessible uniquement via `prediqo-net` | | Mot de passe | `requirepass` = `REDIS_PASSWORD` (obligatoire dans `.env`) | | URL app | Conteneurs : `redis://:${REDIS_PASSWORD}@redis:6379` | | Commandes dangereuses | `FLUSHALL`, `FLUSHDB`, `CONFIG`, `KEYS`, `DEBUG`, `REPLICAOF`, `SLAVEOF` désactivées | Sans `REDIS_PASSWORD` dans `.env`, `docker compose` refuse de démarrer. **Ne jamais** republier `6379:6379` sur un VPS public. C’est la cause typique d’un Redis forcé en esclave (`READONLY You can't write against a read only replica`). --- ## Symptômes : conflit de port (legacy) Si une ancienne version du compose publiait encore 6379, lors de `npm run phase-b:up` : ```text Error response from daemon: failed to set up container networking: ... endpoint crypto_wallet_redis ... failed to bind host port 0.0.0.0:6379/tcp: address already in use ``` Avec le compose actuel (sans `ports:`), ce conflit **ne devrait plus** se produire pour Prediqo. Si 6379 est encore ouvert sur l’hôte, c’est un **autre** Redis (système ou autre projet) — à arrêter, pas à réutiliser. Sur l’app (Candle Predict / Support) si Redis est down : - `Stream isn't writeable and enableOfflineQueue options is false` - `Connection is closed` --- ## Symptômes : READONLY / réplica ```text READONLY You can't write against a read only replica ``` Souvent après exposition publique de 6379 : un bot a envoyé `SLAVEOF` / `REPLICAOF` vers une IP distante. ### Diagnostic ```bash docker exec crypto_wallet_redis redis-cli -a "$REDIS_PASSWORD" --no-auth-warning INFO replication # role:master → OK # role:slave → compromis / mauvais état ``` ### Remise en master (compose durci) Avec `REPLICAOF` désactivé, le plus sûr est de **recréer** Redis (le cache se reconstruit ; Postgres reste la source de vérité) : ```bash cd /path/to/games_app # Assurez-vous que .env contient REDIS_PASSWORD (fort, alphanumérique) docker compose stop redis docker compose rm -f redis # Optionnel si l’état volume est douteux après attaque : # docker volume rm games_app_redis_data # adapter le nom: docker volume ls | grep redis docker compose up -d redis docker exec crypto_wallet_redis redis-cli -a "$REDIS_PASSWORD" --no-auth-warning INFO replication # puis redémarrer API / workers / WS docker compose up -d backend backend-ws backend-worker-bets backend-worker-engine ``` Vérifier qu’**aucun** process n’écoute 6379 sur l’hôte : ```bash sudo ss -tlnp | grep 6379 || echo "OK: 6379 non publié" ``` --- ## Diagnostic général ```bash sudo ss -tlnp | grep 6379 docker ps -a --filter name=redis sudo npm run phase-b:status # ou docker compose ps ``` | Observation | Interprétation | |-------------|----------------| | Conteneur `crypto_wallet_redis` Exit | Mot de passe manquant, healthcheck, ou volume | | `ss` montre 6379 sur l’hôte | Fuite / autre Redis — **fermer** | | `role:slave` | Voir section READONLY ci-dessus | | App : Stream isn't writeable | Redis down ou mauvais `REDIS_URL` / mot de passe | Ping interne : ```bash docker exec crypto_wallet_redis redis-cli -a "$REDIS_PASSWORD" --no-auth-warning ping # PONG ``` --- ## Déploiement VPS (checklist sécurité) 1. Copier / générer `REDIS_PASSWORD` dans le `.env` du VPS (même valeur que celle utilisée par compose). 2. Déployer le `docker-compose.yml` **sans** mapping de port Redis. 3. `docker compose up -d` (ou `npm run phase-b:up` / `phase-b:up:https`). 4. Confirmer : pas de 6379 public + `INFO replication` → `role:master`. 5. Firewall : n’ouvrir que 9080/9443 (ou 80/443), **jamais** 6379. --- ## Prévention - Redis **uniquement** sur le réseau Docker interne. - Mot de passe long (ex. 64 hex) ; ne pas committer `.env`. - Ne pas installer Redis système sur le même VPS « pour debug » en écoute `0.0.0.0:6379`. - Après incident slave : recréer le service (+ volume si besoin), puis vérifier `role:master`. ## Références code - Client Redis : `backend/src/realtime/redis/client.ts` (`enableOfflineQueue: false`) - Compose : service `redis` + `REDIS_URL` dans `x-backend-common` - Stack : `docs/DEPLOY-VPS.md` (`phase-b:up`, `phase-b:status`, `phase-b:logs`)