4.4 KiB
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 falseConnection 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é)
- Copier / générer
REDIS_PASSWORDdans le.envdu VPS (même valeur que celle utilisée par compose). - Déployer le
docker-compose.ymlsans mapping de port Redis. docker compose up -d(ounpm run phase-b:up/phase-b:up:https).- Confirmer : pas de 6379 public +
INFO replication→role:master. - 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_URLdansx-backend-common - Stack :
docs/DEPLOY-VPS.md(phase-b:up,phase-b:status,phase-b:logs)