games_app/docs/TROUBLESHOOTING-REDIS-PORT.md
2026-10-26 11:57:27 +02:00

4.4 KiB
Raw Blame History

Dépannage Redis (port / auth / READONLY)

En incident : procédure pas à pas → 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 :

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

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

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é) :

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 :

sudo ss -tlnp | grep 6379 || echo "OK: 6379 non publié"

Diagnostic général

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 :

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)