Instala-se a Evolution API num VPS com Docker Compose: um ficheiro descreve os serviços (a API, a base de dados e, em muitos guias, o Redis), um segundo ficheiro guarda as definições e um comando levanta tudo. O que este artigo não faz é copiar o ficheiro compose, porque ele muda com as versões. O ficheiro certo está na documentação oficial do projecto, e é de lá que o deve tirar.
Antes de começar
| Precisa de |
Porquê |
| Um VPS com acesso root |
A Evolution API não corre em hospedagem partilhada, que não tem Docker. Veja os primeiros passos com o VPS. |
| Um sistema com boa documentação |
O Ubuntu 22.04 LTS é o mais documentado. Veja qual o sistema a escolher. |
| Docker e Docker Compose |
Se ainda não os tem, comece por instalar o Docker e o Docker Compose. |
| Um domínio ou subdomínio |
Para pôr HTTPS à frente da API. Pode ser feito depois, mas não deixe a API aberta entretanto. |
Passo a passo
| 1 |
Ligue-se ao VPS por SSH e crie uma pasta só para este projecto, por exemplo evolution. Tudo o que se segue fica lá dentro, o que facilita as cópias de segurança.
|
|
| 2 |
Obtenha o ficheiro compose na documentação oficial da Evolution API, e o ficheiro de definições de exemplo que o acompanha. Confirme que o exemplo corresponde à versão da imagem que vai usar.
|
|
| 3 |
Gere a chave da API. A chave AUTHENTICATION_API_KEY protege todos os pedidos. Gere-a aleatória, por exemplo com openssl rand -hex 32, e escreva-a no ficheiro de definições. Nunca a publique.
|
|
| 4 |
Escolha a base de dados. PostgreSQL ou MySQL, segundo a documentação. Ponha uma palavra-passe forte e diferente da chave da API. Se o ficheiro de exemplo inclui o Redis, deixe-o.
|
|
| 5 |
Confirme os volumes. O compose tem de guardar as instâncias e a base de dados em volumes. Sem isso, um reinício apaga as sessões e tem de ler os códigos QR todos outra vez.
|
|
| 6 |
Levante os serviços com docker compose up -d, na pasta do projecto.
|
|
| 7 |
Veja se arrancaram. docker compose ps mostra os serviços e docker compose logs -f segue os registos. Procure erros de ligação à base de dados ou de definições em falta.
|
|
|
Não deixe a API exposta sem protecção. Enquanto não tiver HTTPS nem firewall, a única barreira é a chave. O Docker publica as portas mexendo ele próprio nas regras de rede, e por isso uma firewall comum pode não as esconder. Leia proteger a Evolution API.
|
Quando algo corre mal
| Sintoma |
Onde olhar |
| O serviço da API reinicia sem parar |
Os registos: base de dados inacessível, definição em falta ou palavra-passe diferente entre os ficheiros. |
| A base de dados não arranca |
Espaço em disco e permissões do volume. Veja Docker a encher o disco. |
| Não chega à API de fora |
A porta e a firewall. Veja portas e firewall num VPS. |
| Perde tudo ao reiniciar |
Falta o volume persistente. Corrija o compose antes de ligar qualquer número. |
Não use docker compose down -v para «limpar». A opção -v apaga os volumes, e com eles a base de dados e as sessões. Para parar os serviços sem perder dados basta docker compose down.
|
PRODUTO RECOMENDADO Servidor VPS com acesso root Recursos só seus, o sistema que escolher, reinstalação quando quiser. desde $8.40/mês (plano de 3 anos, com cupão) Ver planos |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
