Pular para o conteúdo principal

Instalação Local via npm

instalao-local via npm

A instalação local via npm é ideal para desenvolvimento, testes rápidos e experimentação offline. É a forma mais simples de começar com o n8n.

📦 Instalação via NPM​

Instalação Global​

npm install -g n8n

Instalação Local (Desenvolvimento)​

# Clonar repositório
git clone https://github.com/n8n-io/n8n.git
cd n8n

# Instalar dependências
npm install

# Executar em modo desenvolvimento
npm run dev

Exemplo de Node Customizado​

import { IExecuteFunctions } from 'n8n-core';
import { INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';

export class MyNode implements INodeType {
  description: INodeTypeDescription = {
    displayName: 'Meu Node',
    name: 'myNode',
    icon: 'file:myNode.svg',
    group: ['transform'],
    version: 1,
    description: 'Descrição do meu node customizado',
    defaults: {
      name: 'Meu Node',
    },
    inputs: ['main'],
    outputs: ['main'],
    properties: [
      {
        displayName: 'Operação',
        name: 'operation',
        type: 'string',
        default: 'process',
        description: 'Operação a ser executada',
      },
    ],
  };

  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
    const items = this.getInputData();
    const returnData: INodeExecutionData[] = [];

    for (let i = 0; i < items.length; i++) {
      const operation = this.getNodeParameter('operation', i) as string;
      / Sua lógica aqui
      const processedData = {
        ...items[i].json,
        processed: true,
        operation,
      };
      returnData.push({
        json: processedData,
      });
    }

    return [returnData];
  }
}


---
<IonicIcon name="bug-outline" style={{fontSize: '24px', color: '#ea4b71'}} />
**Debug e Troubleshooting**

### Logs Detalhados

```bash
# Executar com logs detalhados
DEBUG=* n8n start

# Executar com mais memória
NODE_OPTIONS="--max-old-space-size=4096" n8n start

Problemas de Rede​

# Verificar conectividade
curl -I http://localhost:5678

# Verificar portas em uso
netstat -tulpn | grep 5678

# Verificar logs do n8n
n8n start --verbose

Configuração Avançada

Variáveis de Ambiente​

# Configurações básicas
export N8N_HOST=localhost
export N8N_PORT=5678
export N8N_PROTOCOL=http

# Configurações de banco
export DB_TYPE=sqlite
export DB_SQLITE_DATABASE=n8n.db

# Configurações de segurança
export N8N_ENCRYPTION_KEY=sua_chave_32_caracteres
export N8N_BASIC_AUTH_ACTIVE=true
export N8N_BASIC_AUTH_USER=admin
export N8N_BASIC_AUTH_PASSWORD=SUA_SENHA_SEGURA_AQUI

Executar com Configurações​

# Executar com variáveis de ambiente
N8N_HOST=localhost \
N8N_PORT=5678 \
N8N_PROTOCOL=http \
n8n start

# Executar em modo produção
NODE_ENV=production n8n start

# Executar com configuração personalizada
n8n start --config /path/to/config.json