Configurer le Failover avec 3CX

Introduction

La fonction de failover dans 3CX vous permet de créer une réplique en standby de votre PBX. Dans le cas d’une panne du PBX, votre réplique s'active, minimisant le temps d’arrêt et la perte de données. Une clé de licence édition IA est nécessaire.

Comment ça marche

3CX utilise une approche active - passive un utilisant une réplication de la configuration intégrée avec une compensation maximum de 24h. L’hôte actif traite les appels et les informations de présence, tandis que l’hôte passif surveille l’hôte actif. En cas de panne de l’hôte actif (indépendante d’une panne de l’application, de l’OS ou du matériel), l’hôte passif stoppe son rôle de surveillance et prend le relais en tant qu’hôte actif. La configuration de l’hôte passif détermine dans quel état l’hôte actif est déclaré en panne afin d’initialiser le passage en failover.

Prérequis

Avant de configurer ou d‘activer le failover 3CX sur vos 2 serveurs, les installations 3CX doivent répondre à ces conditions.

1. Deux (2) PBX 3CX chacun avec sa propre IP publique, installés avec des paramètres identiques, incluant FQDN, certificat SSL, ports SIP, Tunnel et serveur web, et système d’exploitation.
2. Quand vous configurez 3CX après installation, vous devez sélectionner le FQDN 3CX. Vous pouvez utiliser un FQDN personnalisé mais la configuration est plus complexe et vous devez modifier le modèle de script vous-même et assurer le support.
3. Le champ “Interface sélectionnée” doit être défini avec le FQDN (pas l’IP) dans l’onglet “Extension” > “Configuration des téléphones” > section “Téléphone IP”.
4. Le Split DNS est nécessaire comme pour toutes les installations 3CX.

Étape 1 : Configurer le serveur actif

1. Allez sur “Sauvegarde” > “Emplacement” et sélectionnez Stockage Google comme emplacement, ou spécifiez d’autres options de sauvegardes, ex. SMB ou SFTP. Pour cet exemple, les sauvegardes sont stockées dans le dossier “3CX_PBX_Backups” sur un bucket de stockage Google.
2. Cliquez sur “Planifier la sauvegarde”, sélectionnez les options de sauvegarde à inclure, définissez l’horaire de la sauvegarde et cliquez sur “OK” pour sauvegarder votre configuration. Nous recommandons une sauvegarde quotidienne hors des heures de bureau, p.ex, un démarrage de la sauvegarde à 1h du matin l’upload de “3CXScheduledBackup.zip” (dernier nom de fichier de sauvegarde) sur le stockage Google.
3. Maintenant, cliquez sur le bouton “Failover”, activez la coche “Activer le failover” et sélectionnez “Actif”. Appuyez sur OK pour sauvegarder.

Étape 2 : Configurer le serveur passif (#2)

1. Passez sur votre serveur passif et cliquez sur le bouton Sauvegarde > “Failover”, activez la coche “Activer le Failover” et sélectionnez “Passif”.
2. Entrez l’adresse IP du serveur actif (#1), ex.
   1.1.1.1
3. Sélectionnez quand effectuer un failover e quels services vous voulez surveiller : serveur SIP, serveur Web ou serveur Tunnel.
4. Sélectionnez l'intervalle pour que le contrôle se fasse, (par défaut 30 secondes) et configurez si le failover doit s’effectuer su un ou tous les tests échouent.
5. Spécifiez l’emplacement de vos scripts de failover. Vous pouvez trouver les scripts Windows ici. Les scripts Linux sont trouvables ici.
6. Définissez une heure pour l’application de la restauration.
7. Appuyez sur “OK” pour sauvegarder la configuration et commencer la surveillance. Quand le serveur actif (#1) s’arrête, le passif détecte la panne et prend le relais. Avec la sauvegarde déjà restaurée, l’action du failover permet aux serveurs DNS 3CX de mettre à jour le FQDN sur l’adresse IP du nouveau serveur actif (#2). Il est important que le serveur actif précédent (#1) soit éteint pour éviter tout conflit avec le serveur qui vient de prendre le relais.

Remarques importantes

• Les passerelles dans un scénario de failover sont uniquement supportées en local avec votre système PBX, c.à.d. accessibles via LAN.
• Pour les scénarios où les serveurs Actif/Primaire et Passif/Failover sont derrières des adresses IP publiques différentes, quand vous terminez l’installation du serveur passif et déployez les options d’installation, votre FQDN public sera réécrit avec l’IP publique du serveur failover. Pour ré-écrire votre FQDN externe pour qu’il corresponde à nouveau à l’IP publique du serveur actif, vous devez redémarrer le service du système.
• Si vous configurez votre failover sur Microsoft Windows, les droits appropriés doivent être assignés à ce service exécutant les scripts, en étant le Gestionnaire de Notifications d’événements 3CX. Le niveau de compte minimum auquel le service peut être assigné doit avoir des droits administratifs locaux comme utilisateur du “Système local” et, si exécution du
  dnscmd
  , également des privilèges d’administrateur de gestion du DNS. Pour cette raison, il est recommandé de créer un utilisateur Active Directory dédié avec les droit administratifs adéquats et un mot de passe qui n’expire pas.
• Pour le failover utilisé avec un FQDN personnalisé et des scénarios LAN-to-LAN ou Cloud-to-Cloud, pour mettre à jour votre DNS et FQDN lors d’un failover, vous devez utiliser un script avancé et des services tels que Active Directory  pour exécuter des scripts shell avec privilèges administrateur.

Voir aussi

• Configurer le stockage Google Cloud pour 3CX
• Scripts de failover PBX Linux

Dernière mise à jour

La dernière mise à jour de ce document a été effectuée le 28 avril 2026.        

https://www.3cx.fr/docs/failover/