Community Nodes não verificados e a mudança da v3

O n8n 3.0 altera o padrão de N8N_UNVERIFIED_PACKAGES_ENABLED de true para false. Sem uma configuração explícita, a instância atualizada não instala pacotes não verificados do npm. Os pacotes desse tipo já instalados também não carregam.

A alteração afeta workflows que dependem desses componentes. Ter o pacote registrado na instância não confirma que o Node estará disponível depois da atualização. Você precisa revisar tanto as dependências dos workflows quanto as variáveis aplicadas ao serviço.

Três configurações diferentes

A configuração geral prevalece sobre as duas específicas. Com N8N_COMMUNITY_PACKAGES_ENABLED=false, habilitar apenas os não verificados não torna esses componentes disponíveis.

Manter um pacote não verificado

Para continuar usando esse tipo de pacote, declare as duas configurações no serviço do n8n. Na stack de estudos com Docker Compose e Traefik, acrescente ao .env:

1
# Community nodes, inclusive os não verificados
2
N8N_COMMUNITY_PACKAGES_ENABLED=true
3
N8N_UNVERIFIED_PACKAGES_ENABLED=true

Depois, inclua as duas variáveis no environment do serviço n8n do compose.yaml:

1
      - N8N_COMMUNITY_PACKAGES_ENABLED=${N8N_COMMUNITY_PACKAGES_ENABLED}
2
      - N8N_UNVERIFIED_PACKAGES_ENABLED=${N8N_UNVERIFIED_PACKAGES_ENABLED}

Aplique com docker compose up -d e confira, na instância de estudos com a versão de destino, se os nodes carregam.

Habilitar a variável autoriza a instalação e o uso de código não verificado. A documentação alerta que community Nodes podem acessar a máquina do n8n e as informações dos workflows. Revise a origem e a versão de cada pacote que pretende manter.

Confira os workflows dependentes

Relacione os pacotes instalados aos workflows que os utilizam. Para cada dependência, escolha entre manter o pacote com configuração explícita ou adaptar o workflow a um componente verificado disponível.

Na instância de teste com a versão de destino, abra os workflows e execute as ações que dependem desses Nodes. Confira a saída e os erros de carregamento. Registre o pacote, a versão e o resultado de cada teste antes de atualizar a instância principal.