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

130 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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`)