Como Alterar a Porta do n8n e Configurá-lo como Serviço no Debian

O n8n é uma poderosa ferramenta de automação de fluxo de trabalho, mas para personalizar sua configuração, pode ser necessário alterar a porta em que o serviço é executado ou configurá-lo para iniciar automaticamente com o sistema. Neste tutorial, vamos aprender como:

1. Alterar a Porta do n8n
2. Configurar o n8n para Iniciar Automaticamente no Boot (Debian & Semelhantes)

1. Alterando a Porta do n8n

Por padrão, o n8n escuta na porta 5678, mas você pode alterá-la facilmente, seja por linha de comando ou por configuração permanente.

Alteração por Linha de Comando

Para iniciar o n8n em uma porta diferente, use o seguinte comando:

N8N_PORT=5678 n8n

No exemplo acima, a porta foi alterada para 5678. Substitua por qualquer outra porta de sua preferência.

Alteração Permanente

Caso deseje que a alteração da porta seja permanente, você pode configurar o n8n usando um arquivo .env. Para isso:

1. Navegue até o diretório onde o n8n está instalado ou onde você deseja rodá-lo.
2. Crie ou edite um arquivo .env e adicione a seguinte linha: N8N_PORT=5678
3. Agora, toda vez que o n8n for iniciado, ele usará a nova porta configurada.

2. Configurando o n8n como Serviço no Debian

Para garantir que o n8n inicie automaticamente sempre que o Debian for iniciado, você pode configurá-lo como um serviço usando o systemd. Isso vai permitir que o n8n seja gerenciado como um serviço do sistema, facilitando o controle e o reinício automático.

Passo a Passo para Criar o Serviço

Entendido! Aqui está a versão corrigida, sem o uso de sublistas, com os itens dispostos um abaixo do outro para garantir que o formato seja correto no seu blog:

1. Alterando a Porta do n8n

Por padrão, o n8n escuta na porta 5678, mas você pode alterá-la facilmente, seja por linha de comando ou por configuração permanente.

Alteração por Linha de Comando

Para iniciar o n8n em uma porta diferente, use o seguinte comando:

N8N_PORT=5678 n8n

No exemplo acima, a porta foi alterada para 5678. Substitua por qualquer outra porta de sua preferência.

Alteração Permanente

Caso deseje que a alteração da porta seja permanente, você pode configurar o n8n usando um arquivo .env. Para isso, siga as etapas abaixo:

1. Navegue até o diretório onde o n8n está instalado ou onde você deseja rodá-lo.
2. Crie ou edite um arquivo .env e adicione a seguinte linha:

N8N_PORT=5678

Agora, toda vez que o n8n for iniciado, ele usará a nova porta configurada.

---

2. Configurando o n8n como Serviço no Debian

Para garantir que o n8n inicie automaticamente sempre que o Debian for iniciado, você pode configurá-lo como um serviço usando o systemd. Isso vai permitir que o n8n seja gerenciado como um serviço do sistema, facilitando o controle e o reinício automático.

Passo a Passo para Criar o Serviço

Crie o arquivo de serviço do systemd:

No terminal, execute o comando abaixo para criar o arquivo de unidade do systemd:

sudo nano /etc/systemd/system/n8n.service

Adicione o conteúdo abaixo ao arquivo:

[Unit]
Description=n8n Workflow Automation Tool
After=network.target

[Service]
ExecStart=/usr/local/bin/n8n
Restart=always
User=n8n
Environment=NODE_ENV=production
Environment=N8N_PORT=5678
Environment=N8N_LOG_LEVEL=info
WorkingDirectory=/home/n8n
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=n8n

[Install]
WantedBy=multi-user.target

Lembre-se de substituir o caminho de ExecStart com o local correto onde o n8n está instalado no seu sistema. O diretório de trabalho pode ser ajustado conforme sua preferência.

Crie o usuário do sistema para isolar o serviço:

Se ainda não tiver, crie um usuário dedicado ao n8n:

sudo adduser --system --group --home /home/n8n n8n

Ajuste as permissões de diretório:

Certifique-se de que o diretório de trabalho tenha as permissões adequadas para o usuário do n8n:

sudo mkdir /home/n8n/.n8n
sudo chown -R n8n:n8n /home/n8n/.n8n

Recarregue as unidades do systemd:

Para aplicar as mudanças, recarregue o systemd:

sudo systemctl daemon-reload

Habilite e Inicie o Serviço:

Agora, você pode habilitar o serviço para iniciar automaticamente no boot:

sudo systemctl enable n8n

E inicie o serviço imediatamente:

sudo systemctl start n8n

Verifique se o serviço está funcionando corretamente:

Para verificar o status do serviço, execute:

sudo systemctl status n8n

---

Conclusão

Com esses passos, você conseguiu alterar a porta do n8n e configurá-lo para iniciar automaticamente com o Debian. Usar o systemd para gerenciar o n8n como um serviço garante que o processo seja controlado de forma eficiente, com reinício automático em caso de falhas, além de facilitar a manutenção do serviço.