n8n

n8n est une plateforme libre d’automatisation de flux de travail qui permet de connecter des applications, des API et des services au moyen d’un éditeur visuel à base de noeuds. Elle prend en charge des centaines d’intégrations et peut exécuter de la logique JavaScript personnalisée dans les flux de travail.

Logiciels inclus

Composant	Version
n8n	2.29.8
Docker	Dernière stable
Docker Compose	Dernière stable
Ubuntu	24.04 LTS

Variables d’environnement

Vous pouvez définir cette valeur lors du déploiement de n8n depuis la marketplace.

Variable	Description
`N8N_HOST`	Hôte ou domaine public pour n8n

Bien démarrer

1. Connectez-vous à votre VM

ssh ubuntu@<your-vm-ip>

2. Attendez la configuration au premier démarrage

Au premier démarrage, un script de configuration s’exécute automatiquement. Il:

génère une clé de chiffrement aléatoire pour protéger les identifiants stockés dans n8n;
écrit la configuration d’environnement dans /opt/n8n/.env;
démarre n8n avec Docker Compose.

Cela prend moins de 60 secondes. Suivez la progression:

journalctl -u n8n-first-boot.service -f

3. Accédez à l’interface n8n

Ouvrez un navigateur et accédez à:

http://<your-vm-ip>:5678

Lors de la première visite, n8n vous demandera de créer un compte propriétaire avec l’adresse courriel et le mot de passe de votre choix. Ce compte est stocké localement sur la VM.

Facultatif : définir une URL de webhook personnalisée

Si n8n doit être accessible par un nom de domaine, fournissez l’URL au déploiement avec les userdata cloud-init. Les webhooks pourront ainsi utiliser votre domaine plutôt que l’adresse IP de la VM.

Ajoutez ceci aux userdata de votre VM au moment du déploiement:

#cloud-config
write_files:
  - path: /run/n8n-webhook-url
    content: 'https://n8n.example.com'
    permissions: '0600'
    owner: root:root

Si aucune URL n’est fournie, n8n utilise http://<vm-ip>:5678 par défaut.

Gérer n8n

n8n s’exécute comme un service Docker Compose dans /opt/n8n.

# Vérifier l'état
cd /opt/n8n && docker compose ps

# Redémarrer
cd /opt/n8n && docker compose restart

# Consulter les journaux
cd /opt/n8n && docker compose logs -f

# Arrêter
cd /opt/n8n && docker compose down

# Démarrer
cd /opt/n8n && docker compose up -d

Les données de flux de travail sont conservées dans /opt/n8n/data.

Configuration d’environnement: /opt/n8n/.env

Sécurité

Le port 5678 est accessible sur l’interface réseau de la VM. UFW est activé et n’autorise que SSH (port 22) par défaut.

Pour autoriser l’accès depuis un navigateur à partir d’une adresse IP précise:

sudo ufw allow from <trusted-ip> to any port 5678

Pour accéder à l’interface sans ouvrir le pare-feu, utilisez un tunnel SSH:

# Exécutez ceci sur votre poste local
ssh -L 5678:localhost:5678 ubuntu@<your-vm-ip>

# Ouvrez ensuite dans le navigateur
http://localhost:5678

Pour un usage en production, placez n8n derrière un proxy inverse avec HTTPS et un nom de domaine, puis définissez N8N_SECURE_COOKIE=true dans /opt/n8n/.env.

n8n