--- canonical: https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/ language: pt generated: 2026-10-21T13:33:42.126Z --- [Início](https://koalavps.com/pt/) / [Explorar](https://koalavps.com/pt/resources/) / As notas de campo do KoalaVPS As notas de campo do KoalaVPS # Fluxos de trabalho que sobrevivem ao próximo reinício. Um editor de automação auto-alojado pode ligar contas poderosas. Trate a sua base de dados e chave de cifra como infraestrutura crítica. [Encontre o seu VPS](https://koalavps.com/pt/vps/) ## NESTE DOCUMENTO [Proteja o editor](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-1)[Manter a chave da credencial](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-2)[Escale o caminho de execução deliberadamente](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-3)[Retenha apenas dados de execução úteis](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-4)[Trate a chave de encriptação como parte da base de dados](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-5)[Dê aos webhooks o endereço público deles](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-6)[Defina a carga de trabalho e as integrações permitidas](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-7)[Defina a origem pública do webhook para a versão instalada](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-8)[Teste um fluxo de trabalho inofensivo antes de conceder acesso de escrita](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-9)[Escale apenas após observar o gargalo de execução](https://koalavps.com/pt/guides-self-host-n8n-on-a-vps/#section-10)[Base de conhecimento](https://koalavps.com/pt/resources/) ## 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](https://docs.n8n.io/deploy/host-n8n/configure-n8n/basic-configuration/configuration-examples/set-a-custom-encryption-key.md) ## 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=1 ``` Documentação oficial: [n8n atrás de um proxy reverso](https://docs.n8n.io/deploy/host-n8n/configure-n8n/basic-configuration/configuration-examples/configure-webhook-urls-with-reverse-proxy.md) ## 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](https://docs.n8n.io/hosting/installation/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=1 ``` Documentação oficial: [n8n definições de proxy reverso do webhook](https://docs.n8n.io/hosting/configuration/configuration-examples/webhook-url/) ## 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](https://docs.n8n.io/hosting/configuration/configuration-examples/encryption-key/) ## 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](https://docs.n8n.io/hosting/scaling/queue-mode/) · [Definições de eliminação de execuções](https://docs.n8n.io/hosting/configuration/environment-variables/executions/) CONTINUE A EXPLORAR ## Continuar a ler. [Guias ### Automação com um botão de parada claro. Um bom sistema de automação tem uma tarefa restrita, estado visível e uma resposta previsível à incerteza.…](https://koalavps.com/pt/automation-safety/)[Produtos ### Um habitat confiável para seus agentes. Execute agendadores, workers de navegador, filas e processos de automação em infraestrutura que controla. Mantenha cada agente den…](https://koalavps.com/pt/agentic-vps/)[Guias ### Um backup importa quando restaura. Projete um backup em torno dos dados que você não pode recriar e do tempo que seu serviço pode se dar ao luxo de perder. Um upload…](https://koalavps.com/pt/backups/) CONFIGURE SUA INFRAESTRUTURA ## Assuma o controle. Implemente nos seus termos. Sem documentação de identidade. Acesso total de administrador. Faturação nativa em cripto. [Selecione uma configuração](https://koalavps.com/pt/vps/)