Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Proxy e rede de saída

8 variáveis das versões 1.123.92, 2.45.7 e 3.0.1

Proxy das requisições que os Nodes fazem para fora, a lista de exceções e o User-Agent enviado. A lista sai do código de cada versão e das páginas de variáveis da documentação oficial, conferidos em 3 de novembro de 2026. Toda variável aceita o sufixo _FILE para ler o valor de um arquivo, útil para senhas e chaves em secrets do Docker.

  • URL do proxy usado tanto para requisições HTTP quanto HTTPS feitas pelos Nodes. O n8n só usa este valor quando HTTP_PROXY ou HTTPS_PROXY não estão definidas.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • URL do proxy usado nas requisições HTTPS feitas pelos Nodes. Com o valor definido, todo o tráfego criptografado de saída passa pelo proxy.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • URL do proxy usado nas requisições HTTP sem criptografia feitas pelos Nodes.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Faz as requisições de saída do n8n enviarem um User-Agent completo, no formato Mozilla/5.0 (compatible; n8n/<versão>; +https://n8n.io/), aceito por firewalls de aplicação mais rígidos. Com false, o n8n mantém o User-Agent simples n8n. O código prevê true como padrão em uma próxima versão principal.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • User-Agent personalizado das requisições de saída quando N8N_ENFORCE_GLOBAL_USER_AGENT está ligada. Útil para não revelar a versão do n8n a servidores externos. Vazio, vale o formato completo com a versão.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo máximo em milissegundos sem receber nenhum trecho do corpo de uma resposta HTTP. O prazo reinicia a cada trecho recebido, então um download lento que continua avançando não é interrompido.

    Tipo
    Number
    Padrão
    300000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_OUTBOUND_PROXY_MODE
    • Defasada
    • Fora da documentação

    Define quais processos do n8n usam as variáveis de proxy para o tráfego de saída padrão do Node.js. Com all, valem para o processo principal, os workers, os processadores de webhook e os comandos da CLI.

    Na 2.x e na 3.x, a variável existe só por compatibilidade e será removida. O n8n pede para retirá-la e listar em NO_PROXY os endereços internos acessados sem proxy. Enquanto isso, main-only mantém o comportamento antigo, com proxy só no processo principal.

    Tipo
    Enum
    Padrão
    all
    Versões
    1.x não aceita2.x aceita3.x aceita
    Valores
    • all
    • main-only
  • Hosts ou URLs, separados por vírgula, que o n8n acessa direto, sem passar pelo proxy definido em HTTP_PROXY, HTTPS_PROXY ou ALL_PROXY.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita