Restaurer depuis une sauvegarde
Deux façons de récupérer vos utilisateurs : la restauration en un clic depuis le tableau de bord, qui les réimporte de manière idempotente, ou une restauration manuelle dans un Marzban vierge, puisque le fichier est au format utilisateur natif de Marzban.
Une sauvegarde ne vaut que ce que vaut sa restauration. Il existe deux façons de récupérer vos utilisateurs — la plus simple depuis le tableau de bord, et une manuelle pour les cas avancés (ou si un jour vous quittez CreateYourVPN).
Option 1. Restaurer depuis le tableau de bord
La voie la plus simple. Sur la page Utilisateurs ou la page Sauvegardes, un bouton « Restaurer depuis une sauvegarde » est disponible.
Cliquez sur « Restaurer depuis une sauvegarde » et choisissez la sauvegarde souhaitée (depuis votre stockage Google Drive / S3).
Confirmez la restauration. CreateYourVPN déchiffre la sauvegarde pour vous — il n'y a aucune phrase secrète à saisir.
CreateYourVPN réimporte les utilisateurs sur la configuration actuelle du cluster.
L'import est idempotent, on peut donc l'exécuter plusieurs fois sans risque :
- les utilisateurs existants sont mis à jour pour correspondre à la sauvegarde,
- les utilisateurs manquants sont recréés avec leur UUID d'origine, afin que leurs anciennes configurations clientes continuent de fonctionner,
- les abonnements sont préservés lorsque vous restaurez sur le même cluster.
La restauration depuis le tableau de bord déchiffre la sauvegarde pour vous automatiquement. (L'export en clair « Télécharger » distinct n'est pas chiffré — gardez ce fichier confidentiel.)
Option 2. Restaurer dans un Marzban vierge
La sauvegarde téléchargée n'est rien d'autre que le format utilisateur natif de Marzban — la même structure que celle attendue par l'API de Marzban — avec un champ _cyv supplémentaire qu'un Marzban ordinaire ignore tout simplement. Cela signifie que vous pouvez recréer vos comptes sur n'importe quel Marzban, même un qui n'a jamais vu CreateYourVPN.
Utilisez l'export en clair « Télécharger » de la page Sauvegardes comme fichier source. (Les sauvegardes chiffrées présentes dans votre stockage cloud ne peuvent être restaurées que via le tableau de bord — elles ne sont pas déchiffrables à la main.)
Parcourez le tableau users du fichier et envoyez chaque entrée au panneau cible :
POST /api/userChaque objet utilisateur est déjà au format de Marzban, il passe donc tel quel. L'UUID de proxy sous proxies.vless.id est transporté dans la charge utile, si bien que les comptes recréés conservent le même UUID — les applications clientes existantes n'en ont pas besoin d'un nouveau.
Une réserve en toute honnêteté. Recréer les comptes ne représente que la moitié du chemin. Pour que la configuration cliente existante d'un utilisateur reste connectée, le panneau cible doit disposer des mêmes inbounds, réglages Xray et host que l'original. Si la cible est configurée différemment, les comptes sont bien créés, mais chaque client doit récupérer à nouveau son abonnement pour obtenir les nouveaux détails de connexion. Restaurer sur le même cluster (option 1) évite entièrement ce souci.