Proteja o editor
Coloque o editor atrás de HTTPS e de autenticação suportada. Restrinja o acesso administrativo e evite o registo público quando desnecessário. As rotas de webhook exigem as suas próprias decisões de exposição e autenticação.
Manter a chave da credencial
Faça cópia de segurança da chave de encriptação configurada com proteção adequada. Restaurar uma base de dados sem a chave correta pode deixar as credenciais guardadas inutilizáveis. Mantenha a chave fora de capturas de ecrã, repositórios e registos não filtrados.
Escale o caminho de execução deliberadamente
Para uma configuração movimentada, reveja a base de dados, a fila e o modelo de trabalhadores suportados. O Redis e trabalhadores separados acrescentam os seus próprios requisitos de acesso e persistência. Limite as tarefas simultâneas para que um pico não possa esgotar o VPS ou um orçamento API externo.
Retenha apenas dados de execução úteis
Os fluxos de trabalho podem lidar com tokens, registos pessoais e documentos. Defina a eliminação do histórico de execução, oculte valores sensíveis e defina novas tentativas com cuidado. Um webhook duplicado não deve provocar um segundo pagamento ou mensagem indesejado.
Trate a chave de encriptação como parte da base de dados
As credenciais guardadas dependem da chave de encriptação do n8n. Preserve o diretório de estado que contém uma chave gerada automaticamente ou defina N8N_ENCRYPTION_KEY a partir de um armazenamento de segredos privado. Todos os workers de fila precisam da mesma chave que o processo principal. Teste a restauração com uma credencial descartável; uma base de dados restaurada por si só pode parecer saudável enquanto as suas credenciais permanecem ilegíveis.
- Mantenha a chave fora do diretório público e do repositório
- Faça cópias de segurança da base de dados de forma consistente
- Utilize PostgreSQL suportado para a implementação de produção pretendida
Documentação oficial: configuração da chave de encriptação n8n
Dê aos webhooks o endereço público deles
Um reverse proxy como o Caddy pode terminar HTTPS enquanto o n8n escuta internamente. A documentação atual utiliza N8N_WEBHOOK_URL para a origem do webhook externo e substitui o nome mais antigo WEBHOOK_URL a partir da versão 2.35.0. Defina a contagem de saltos de proxy confiáveis para o caminho real; um único proxy utiliza N8N_PROXY_HOPS=1. Preserve o host, o protocolo e as informações do cliente encaminhados. Teste um webhook a partir do exterior do servidor e verifique o seu URL de produção.
- Defina o fuso horário do fluxo de trabalho deliberadamente
- Elimine o histórico de execução que contém entradas sensíveis
- Use workers de fila e Redis apenas com os controlos de acesso privado necessários
# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1Documentação oficial: n8n atrás de um proxy reverso
Defina a carga de trabalho e as integrações permitidas
Liste os gatilhos, contas externas, volume de execução esperado e o gasto máximo ou efeito colateral que cada fluxo de trabalho pode criar. Verifique a licença do n8n para o uso real, especialmente se oferecê-lo como serviço a terceiros. Um pequeno fluxo de trabalho agendado e um processador de webhook público têm necessidades de recursos diferentes. Comece com uma versão suportada, estado persistente privado, um nome TLS e um banco de dados adequado à implantação; evite expor portas de banco de dados com o editor.
- Utilize credenciais restritas separadas para cada integração.
- Defina o fuso horário pretendido do fluxo de trabalho e a retenção do histórico de execução.
- Mantenha os fluxos de trabalho exportados livres de segredos reais incorporados.
Documentação oficial: n8n Implantação Docker
Defina a origem pública do webhook para a versão instalada
Um reverse proxy como o Caddy acede ao n8n internamente enquanto os serviços externos chamam a sua origem de webhook HTTPS. Utilize a variável de webhook URL documentada para a versão instalada; a documentação atual designa N8N_WEBHOOK_URL, enquanto versões mais antigas utilizavam WEBHOOK_URL. Defina a contagem real de saltos de proxy em vez de confiar em cabeçalhos encaminhados arbitrários. Mantenha a política de acesso ao editor separada da autenticação do webhook e verifique se o callback de produção não contém um host ou porta internos.
# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1Documentação oficial: n8n definições de proxy reverso do webhook
Teste um fluxo de trabalho inofensivo antes de conceder acesso de escrita
Comece com um pedido só de leitura ou um registo de teste descartável. Teste o webhook de produção a partir do exterior do VPS, a rejeição de autenticação e uma nova tentativa deliberada. Um pedido repetido não deve criar acidentalmente uma segunda ação com consequências. Verifique os registos de execução à procura de entradas expostas e, em seguida, aplique uma política de retenção. Se um webhook só funcionar no modo de teste do editor, verifique se o fluxo de trabalho está publicado/ativo e se as rotas de produção e de teste chegam ao processo correto.
- Use uma credencial de integração descartável para testar uma restauração.
- Mantenha uma cópia encriptada independente de N8N_ENCRYPTION_KEY ou do estado da chave gerada.
- Não envie senhas de exemplo ou tokens API para saídas de depuração retidas.
Documentação oficial: chave de encriptação n8n
Escale apenas após observar o gargalo de execução
O modo de fila adiciona Redis, workers e uma base de dados partilhada; o processo principal recebe os gatilhos enquanto os workers executam as execuções. Cada worker deve utilizar a mesma chave de encriptação de credenciais. Siga os requisitos atuais de armazenamento de dados binários antes de mover um fluxo de trabalho com ficheiros para o modo de fila. Limite a concorrência e os orçamentos de API do upstream, e monitore a idade da fila e as falhas. Faça backup da base de dados, do estado e da chave em conjunto; reiniciar um contentor não é um plano de recuperação para credenciais guardadas ilegíveis.
Documentação oficial: modo de fila do n8n · Definições de eliminação de execuções