Se você utiliza o n8n para gerenciar o seu ecossistema de AutoBlog, já sabe que a performance é o que separa um projeto amador de um negócio lucrativo e escalável. A chegada da versão 2.0 do n8n marcou um antes e depois na ferramenta, trazendo o esperado suporte ao modo SQLite WAL (Write-Ahead Logging), que garante uma velocidade de processamento absurdamente superior.
No entanto, migrar de uma versão legada (como a v1.123.6) para a v2.1.4 ou superior dentro do Easypanel não é apenas clicar em um botão de “update”. Se você fizer isso, corre o risco de corromper seu banco de dados, perder suas credenciais de API ou ver seus formulários pararem de funcionar.
Neste guia, vou te ensinar o passo a passo seguro para realizar essa transição, garantindo que suas automações continuem rodando como um relógio suíço.
Dica Visual: Para quem prefere acompanhar o processo em tempo real, preparei um tutorial em vídeo detalhando cada comando e clique na interface do Easypanel. Assista ACIMA!
Por que a Versão 2 do n8n é Obrigatória?
Antes de partirmos para a prática, é importante entender o “porquê”. A versão 2.0 removeu drivers antigos e pesados, otimizando o motor de execução. A maior mudança está no gerenciamento do banco de dados SQLite. Agora, em vez de um único arquivo .sqlite, você verá arquivos auxiliares como -wal e -shm.
Isso resolve um problema crônico de “Database Locked” que muitos alunos enfrentavam ao rodar múltiplos fluxos simultâneos na VPS. Se você quer escalar seu AutoBlog, a v2 não é uma opção, é uma necessidade.
Você pode gostar também:
Requisitos Básicos para a Migração
Para que este tutorial funcione, você deve atender aos seguintes pré-requisitos:
- Acesso Root via SSH à sua VPS (recomendamos a Hostinger pela estabilidade).
- Easypanel Instalado e atualizado.
- Instância Antiga (v1) Ativa: Não apague nada ainda! Precisamos extrair dados dela.
- Espaço em Disco: Certifique-se de que tem pelo menos o dobro do espaço que seu banco de dados ocupa hoje.
Passo 1: Instalando o Novo n8n no Easypanel
O segredo de uma migração de sucesso é o isolamento. Nunca tente atualizar a versão v1 diretamente na mesma instância. Criaremos um ambiente novo e limpo.
- Acesse seu Easypanel.
- Crie um novo projeto (ex: n8nv2).
- Dentro desse projeto, adicione um novo serviço de aplicação utilizando o template oficial do n8n.
- Certifique-se de selecionar a tag latest (v2.x).
- Ponto Crítico: Após a criação, acesse o painel da nova aplicação e clique em STOP. O container deve estar desligado para recebermos os dados externos.
Passo 2: Resgatando a “Chave Mestra” de Criptografia
Um dos erros mais comuns dos iniciantes é mover o banco de dados e perceber que todas as credenciais (WordPress, OpenAI, Google) estão pedindo senha novamente. Isso acontece porque o n8n usa uma Encryption Key única para embaralhar seus dados.
Se a chave da v2 for diferente da v1, o banco de dados ficará ilegível para as credenciais.
Como localizar a chave original:
No terminal da sua VPS, execute o comando para ler o arquivo de configuração do seu n8n antigo (geralmente no projeto geral):
cat /etc/easypanel/projects/geral/n8n/volumes/data/config
Procure pela linha que contém “encryptionKey“: “SEU_CODIGO_AQUI“. Copie exatamente o código que está entre as aspas.
🛡️ Aviso de Segurança: Esta chave é o coração do seu n8n. Se alguém tiver acesso a ela e ao seu banco de dados, poderá ver todas as suas senhas de API. Nunca a exiba em vídeos ou capturas de tela sem borrão.
Passo 3: O Desafio dos Bancos de Dados Gigantes (2.5GB+)
Se você está rodando o AutoBlog há algum tempo, seu arquivo database.sqlite provavelmente está enorme. No caso que analisamos, ele chegou a 2.53 GB. Tentar baixar esse arquivo direto pelo navegador via Filebrowser pode causar timeouts e corromper o arquivo.
Solução: Compactação via SSH
Antes de mover ou baixar, vamos comprimir o arquivo para economizar tempo e garantir a integridade.
1. Acesse a pasta do banco antigo:
cd /etc/easypanel/projects/geral/n8n/volumes/data
2. Execute a compactação:
tar -czvf backup_v1_total.tar.gz database.sqlite
3. Download Seguro: Agora, use o Filebrowser para baixar o arquivo .tar.gz. Ele estará muito menor e servirá como seu backup físico no PC caso algo dê errado no processo.
Passo 4: Migrando os Dados e Ajustando Permissões
Com o backup feito, vamos levar o banco de dados para a nova casa (n8nv2).
1. Limpando a nova instalação:
Precisamos remover o banco de dados vazio que o n8n v2 criou ao ser instalado.
rm -rf /etc/easypanel/projects/n8nv2/n8nv2/volumes/data/database.sqlite*
2. Copiando o banco original:
cp -p /etc/easypanel/projects/geral/n8n/volumes/data/database.sqlite /etc/easypanel/projects/n8nv2/n8nv2/volumes/data/
3. O Pulo do Gato: Permissões de Usuário
O n8n roda dentro de um container Docker sob o usuário node (ID 1000). Se você copiar o arquivo como root, o n8n não conseguirá escrever no banco, resultando no erro “SQLITE_CORRUPT“ ou “Permission Denied“.
Corrija as permissões com este comando:
chown -R 1000:1000 /etc/easypanel/projects/n8nv2/n8nv2/volumes/data/
Passo 5: Configuração das Variáveis de Ambiente
Agora, voltamos para a interface do Easypanel. No projeto n8nv2, acesse a aba Environment (Ambiente) e adicione as seguintes variáveis:
- N8N_ENCRYPTION_KEY: Cole aqui a chave que você resgatou no Passo 2
- WEBHOOK_URL: https://n8n.seudominio.com (seu dominio com protocolo http/https)
- N8N_HOST: n8n.seudominio.com (seu dominio SEM protocolo http/https)
- GENERIC_TIMEZONE: America/Sao_Paulo (se for o caso)
- N8N_RUNNERS_ENABLED: false (Recomendado para migrações iniciais para manter a estabilidade sem precisar de containers extras)
- EXECUTIONS_DATA_MAX_AGE: 168 (Isso define que logs com mais de 7 dias serão apagados, evitando que seu banco chegue a 2.5 GB novamente)
O meu ficou assim:
N8N_ENCRYPTION_KEY=djfafel38ac24ffd343f
WEBHOOK_URL=https://n8n.seudominio.com
N8N_HOST=n8n.seudominio.com
GENERIC_TIMEZONE=America/Sao_Paulo
N8N_RUNNERS_ENABLED=false
EXECUTIONS_DATA_MAX_AGE=168
Passo 6: O Problema do “Basic Auth” nos Formulários
Muitos usuários relatam que, após migrar para a v2.0, os n8n Forms param de funcionar, dando erro ao enviar os dados.
A Causa: Na versão 2.0, a segurança foi reforçada. Se você ativar a autenticação Basic Auth globalmente nas configurações do Workflow, o n8n bloqueará qualquer tentativa de envio de formulário público, pois o navegador não consegue enviar as credenciais de admin no clique do botão “enviar”.
A Solução: Para fluxos que contenham formulários, desative o Basic Auth nas configurações de autenticação do próprio Workflow. Se precisar de segurança, valide os dados internamente no fluxo com um nó IF.
Checklist de Sucesso Pós-Migração
Após clicar em START no novo projeto, verifique os seguintes pontos:
- [ ] Arquivos WAL: Acesse a pasta /data e veja se os arquivos database.sqlite-wal e database.sqlite-shm foram criados. Se sim, o modo de alta performance está ativo.
- [ ] Credenciais: Abra um fluxo do WordPress e veja se o nó consegue se conectar sem erros de autenticação.
- [ ] Webhooks: Entre nos seus fluxos mais importantes, desative-os e ative-os novamente. Isso garante que o n8n v2 registrou corretamente a URL no novo container.
Conclusão
Migrar para o n8n v2 no Easypanel é o passo definitivo para profissionalizar suas automações. Ao separar o banco de dados, garantir a chave de criptografia correta e ajustar as permissões do Docker, você elimina 99% dos problemas que travam o crescimento de um AutoBlog.
Lembre-se: o backup que você baixou via Filebrowser é sua apólice de seguro. Com ele em mãos, você tem total liberdade para testar as novas funcionalidades da versão 2.0.
Gostou deste guia técnico? Se você quer aprender a criar fluxos ainda mais avançados e automatizar seu site WordPress de forma profissional, não deixe de conferir os outros artigos aqui no blog!