130 lines
4.4 KiB
Markdown
130 lines
4.4 KiB
Markdown
# 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`)
|