mirror of
https://github.com/EvolutionAPI/evolution-api.git
synced 2026-03-21 20:18:40 -06:00
docs: adiciona documentação do deploy Multi-Device fix
This commit is contained in:
GABRIEL-PI
@@ -0,0 +1,282 @@
|
||||
# 🚀 Evolution API - Multi-Device Fix
|
||||
|
||||
## 📋 Resumo da Alteração
|
||||
|
||||
**Problema:** A Evolution API estava caindo/desconectando quando o WhatsApp Android estava ativo, porque se identificava como "WebClient" (WhatsApp Web), ocupando o slot de sessão web.
|
||||
|
||||
**Solução:** Remover a identificação de browser para usar o modo Multi-Device nativo do Baileys 7.x, que não conflita com outras sessões.
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Alteração no Código
|
||||
|
||||
### Arquivo: `src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts`
|
||||
|
||||
**ANTES (WebClient - CAI):**
|
||||
```typescript
|
||||
const session = this.configService.get<ConfigSessionPhone>('CONFIG_SESSION_PHONE');
|
||||
|
||||
let browserOptions = {};
|
||||
|
||||
if (number || this.phoneNumber) {
|
||||
this.phoneNumber = number;
|
||||
this.logger.info(`Phone number: ${number}`);
|
||||
} else {
|
||||
const browser: WABrowserDescription = [session.CLIENT, session.NAME, release()];
|
||||
browserOptions = { browser };
|
||||
this.logger.info(`Browser: ${browser}`);
|
||||
}
|
||||
|
||||
// ... no socketConfig:
|
||||
...browserOptions,
|
||||
```
|
||||
|
||||
**DEPOIS (Multi-Device nativo - NÃO CAI):**
|
||||
```typescript
|
||||
if (number || this.phoneNumber) {
|
||||
this.phoneNumber = number;
|
||||
this.logger.info(`Phone number: ${number}`);
|
||||
}
|
||||
|
||||
// Multi-Device mode: não definimos browser para evitar ser tratado como WebClient
|
||||
// Isso faz o Baileys usar o modo MD nativo, que não conflita com outras sessões
|
||||
this.logger.info('Using Multi-Device native mode (no browser identification)');
|
||||
|
||||
// ... no socketConfig:
|
||||
// Removido browserOptions para usar Multi-Device nativo (não WebClient)
|
||||
```
|
||||
|
||||
### Imports removidos:
|
||||
- `ConfigSessionPhone` do `@config/env.config`
|
||||
- `WABrowserDescription` do `baileys`
|
||||
- `release` do `os`
|
||||
|
||||
---
|
||||
|
||||
## 📦 Repositório Fork
|
||||
|
||||
**URL:** https://github.com/joinads/evolution-api
|
||||
|
||||
**Commit:** `5dbf3e93` - "fix: usar Multi-Device nativo para evitar desconexões"
|
||||
|
||||
---
|
||||
|
||||
## 🐳 Deploy na VPS com Docker Compose
|
||||
|
||||
### Pré-requisitos
|
||||
- Docker e Docker Compose instalados
|
||||
- Acesso SSH à VPS
|
||||
- Volumes existentes com dados (PostgreSQL, Redis, Instances)
|
||||
|
||||
### Volumes Utilizados (externos)
|
||||
```
|
||||
evolution-clean_evolution_instances # Dados das instâncias WhatsApp
|
||||
evolution-clean_evolution_redis # Cache Redis
|
||||
evolution-clean_postgres_data # Banco de dados PostgreSQL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Comandos de Deploy
|
||||
|
||||
### 1. Clone o repositório
|
||||
```bash
|
||||
cd ~
|
||||
git clone https://github.com/joinads/evolution-api.git evolution-api-custom
|
||||
cd evolution-api-custom
|
||||
```
|
||||
|
||||
### 2. Copie o .env existente
|
||||
```bash
|
||||
cp ~/evolution-clean/.env .
|
||||
```
|
||||
|
||||
### 3. Crie o docker-compose.prod.yaml
|
||||
```bash
|
||||
cat > docker-compose.prod.yaml << 'EOF'
|
||||
services:
|
||||
api:
|
||||
container_name: evolution_api
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
image: evolution-api:v2.3.4-multidevice
|
||||
restart: always
|
||||
depends_on:
|
||||
- redis
|
||||
- postgres
|
||||
ports:
|
||||
- 8080:8080
|
||||
volumes:
|
||||
- evolution-clean_evolution_instances:/evolution/instances
|
||||
networks:
|
||||
- evolution-net
|
||||
env_file:
|
||||
- .env
|
||||
expose:
|
||||
- 8080
|
||||
|
||||
redis:
|
||||
image: redis:latest
|
||||
networks:
|
||||
- evolution-net
|
||||
container_name: redis
|
||||
command: >
|
||||
redis-server --port 6379 --appendonly yes
|
||||
volumes:
|
||||
- evolution-clean_evolution_redis:/data
|
||||
ports:
|
||||
- 6379:6379
|
||||
|
||||
postgres:
|
||||
container_name: postgres
|
||||
image: postgres:15
|
||||
networks:
|
||||
- evolution-net
|
||||
command: ["postgres", "-c", "max_connections=1000", "-c", "listen_addresses=*"]
|
||||
restart: always
|
||||
ports:
|
||||
- 5432:5432
|
||||
environment:
|
||||
- POSTGRES_USER=caio
|
||||
- POSTGRES_PASSWORD=caio123
|
||||
- POSTGRES_DB=evolution
|
||||
- POSTGRES_HOST_AUTH_METHOD=trust
|
||||
volumes:
|
||||
- evolution-clean_postgres_data:/var/lib/postgresql/data
|
||||
expose:
|
||||
- 5432
|
||||
|
||||
volumes:
|
||||
evolution-clean_evolution_instances:
|
||||
external: true
|
||||
evolution-clean_evolution_redis:
|
||||
external: true
|
||||
evolution-clean_postgres_data:
|
||||
external: true
|
||||
|
||||
networks:
|
||||
evolution-net:
|
||||
name: evolution-net
|
||||
driver: bridge
|
||||
EOF
|
||||
```
|
||||
|
||||
### 4. Pare a Evolution antiga (se estiver rodando)
|
||||
```bash
|
||||
cd ~/evolution-clean
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
### 5. Build da nova imagem
|
||||
```bash
|
||||
cd ~/evolution-api-custom
|
||||
docker-compose -f docker-compose.prod.yaml build --no-cache
|
||||
```
|
||||
|
||||
### 6. Suba os containers
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yaml up -d
|
||||
```
|
||||
|
||||
### 7. Verifique os logs
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yaml logs -f api
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Comandos Úteis
|
||||
|
||||
### Ver status dos containers
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yaml ps
|
||||
```
|
||||
|
||||
### Reiniciar a API
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yaml restart api
|
||||
```
|
||||
|
||||
### Ver logs em tempo real
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yaml logs -f api
|
||||
```
|
||||
|
||||
### Parar todos os containers
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yaml down
|
||||
```
|
||||
|
||||
### Rebuild após alterações no código
|
||||
```bash
|
||||
git pull origin main
|
||||
docker-compose -f docker-compose.prod.yaml build --no-cache
|
||||
docker-compose -f docker-compose.prod.yaml up -d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Verificar se o Fix está Funcionando
|
||||
|
||||
Nos logs da API, você deve ver:
|
||||
```
|
||||
Using Multi-Device native mode (no browser identification)
|
||||
```
|
||||
|
||||
**NÃO deve mais aparecer:**
|
||||
```
|
||||
Browser: ['Evolution API', 'Chrome', ...]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Notas Importantes
|
||||
|
||||
1. **Instâncias existentes:** Continuam funcionando normalmente. As credenciais salvas não dependem do parâmetro `browser`.
|
||||
|
||||
2. **Novas conexões:** Usarão o modo Multi-Device nativo automaticamente.
|
||||
|
||||
3. **Se uma sessão expirar:** Ao reconectar via QR Code, já usará o novo modo.
|
||||
|
||||
4. **Volumes externos:** O docker-compose usa `external: true` para apontar para os volumes existentes, preservando todos os dados.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Comparação: Antes vs Depois
|
||||
|
||||
| Aspecto | Antes (v2.3.4 oficial) | Depois (com fix) |
|
||||
|---------|------------------------|------------------|
|
||||
| Identificação | `['Evolution API', 'Chrome', OS]` | Nenhuma (MD nativo) |
|
||||
| Tipo de sessão | WebClient | Multi-Device |
|
||||
| Aparece como | "WhatsApp Web" | Dispositivo vinculado |
|
||||
| Conflita com Android | ✅ SIM | ❌ NÃO |
|
||||
| Cai quando Android ativo | ✅ SIM | ❌ NÃO |
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Rollback (Voltar para versão oficial)
|
||||
|
||||
Se precisar voltar para a versão oficial:
|
||||
|
||||
```bash
|
||||
cd ~/evolution-api-custom
|
||||
docker-compose -f docker-compose.prod.yaml down
|
||||
|
||||
cd ~/evolution-clean
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📅 Data da Alteração
|
||||
**04 de Dezembro de 2025**
|
||||
|
||||
## 👤 Autor
|
||||
Alteração realizada com auxílio de IA (Claude/Cursor)
|
||||
|
||||
## 🔗 Links
|
||||
- Fork: https://github.com/joinads/evolution-api
|
||||
- Original: https://github.com/EvolutionAPI/evolution-api
|
||||
- Baileys: https://github.com/WhiskeySockets/Baileys
|
||||
|
||||
Reference in New Issue
Block a user