Com certeza! Analisei o README
e preparei uma versão em português, simplificada e direta, mantendo a estrutura e a clareza técnica.
Este repositório contém a configuração para implantar o n8n
utilizando Docker Compose, com armazenamento persistente para os dados do n8n
e do PostgreSQL. Também inclui o Qdrant
como banco de dados vetorial.
Esta configuração é destinada exclusivamente para ambientes de teste e desenvolvimento. Não é recomendada para produção pelos seguintes motivos:
Segurança Inadequada:
- As credenciais de autenticação (
N8N_BASIC_AUTH_USER
eN8N_BASIC_AUTH_PASSWORD
) são armazenadas em texto plano no arquivo.env
.- A configuração padrão não utiliza certificados de segurança (HTTPS).
Escalabilidade Limitada:
- A arquitetura é de nó único, sem balanceamento de carga ou redundância.
Sem Backup e Monitoramento:
- Não há mecanismos configurados para backups regulares dos workflows, logs ou do banco de dados.
- Ferramentas de logs e monitoramento para produção não estão inclusas.
Persistência de Dados Local:
- A persistência dos dados depende de diretórios locais (
n8n_data
epgdata
), que não são adequados para um ambiente de produção robusto.
Garanta que os seguintes softwares estejam instalados em seu sistema:
Você pode configurar o projeto com o script automatizado ou manualmente.
-
Siga as Instruções: O script irá:
- Instalar o Git (se necessário).
- Clonar este repositório para um diretório chamado
n8n-docker
. - Criar os diretórios
n8n_data
epgdata
. - Definir as permissões corretas para esses diretórios.
- Copiar o arquivo
.env
de exemplo e solicitar que você o edite.
-
Inicie os Serviços: Após configurar o arquivo
.env
, inicie os serviços com:docker compose up -d
- Acesse o
n8n
em http://localhost:5678.
- Acesse o
Siga estes passos para uma configuração manual.
git clone https://github.com/butdiditwork/n8n-docker.git
cd n8n-docker
Crie os diretórios para o armazenamento persistente:
mkdir n8n_data pgdata
Ajuste o proprietário dos diretórios para o usuário node
(ID 1000), que é o usuário padrão dentro do contêiner do n8n
:
chown -R 1000:1000 ./n8n_data ./pgdata
Copie o arquivo de exemplo .env.example
para .env
e edite-o. Você pode usar seu editor de preferência, como o nvim
.
cp .env.example .env
nano .env # ou nvim .env
- Configure as seguintes variáveis no arquivo
.env
:
# Configuração do n8n
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=password
N8N_HOST=localhost
N8N_PORT=5678
WEBHOOK_URL=http://localhost:5678
N8N_DIAGNOSTICS_ENABLED=false
N8N_SECURE_COOKIE=false
# Configuração do PostgreSQL
POSTGRES_USER=n8n
POSTGRES_PASSWORD=n8n
POSTGRES_DB=n8n
# Configuração do Qdrant
QDRANT_PORT=6333
QDRANT_GRPC_PORT=6334
Execute o comando para iniciar todos os serviços em segundo plano:
docker compose up -d
- Acesse o
n8n
em http://localhost:5678.
-
n8n:
- O serviço principal de automação de workflows.
- Os dados persistentes são salvos em
./n8n_data
.
-
PostgreSQL:
- O banco de dados para o
n8n
. - Os dados persistentes são salvos em
./pgdata
.
- O banco de dados para o
-
Qdrant:
- Banco de dados vetorial para armazenar e consultar embeddings.
- Portas expostas:
- API REST:
${QDRANT_PORT}:6333
- API gRPC:
${QDRANT_GRPC_PORT}:6334
- API REST:
Para iniciar e acompanhar os logs (útil na primeira vez):
docker compose up
Para iniciar em segundo plano (detached mode):
docker compose up -d
docker compose restart
Para parar os contêineres e remover os volumes de dados associados (cuidado, isso apaga os dados):
docker compose down -v
Para apenas parar os contêineres sem remover os dados:
docker compose down
Caso encontre erros de permissão nos volumes, re-aplique os comandos:
mkdir -p ./n8n_data ./pgdata
chown -R 1000:1000 ./n8n_data ./pgdata
Para depurar problemas, verifique os logs dos contêineres em tempo real:
docker compose logs -f