バックアップから復元
ユーザーを取り戻す2つの方法: ワンクリックのダッシュボード復元で冪等に再インポートするか、素のMarzbanへ手動で復元します。ファイルはMarzbanネイティブのユーザー形式です。
バックアップの価値は、復元できてこそのものです。ユーザーを取り戻す方法は2つあります。ダッシュボード内で行う手軽な方法と、上級者向け(またはCreateYourVPNから移行する場合)の手動の方法です。
方法1. ダッシュボードで復元する
最もシンプルな方法です。ユーザーページまたはバックアップページに**「バックアップから復元」**ボタンがあります。
**「バックアップから復元」**をクリックし、復元したいバックアップを(Google Drive/S3ストレージから)選びます。
復元を確定します。CreateYourVPNがバックアップを自動で復号します — パスフレーズを入力する必要はありません。
CreateYourVPNがクラスターの現在の構成にユーザーを再インポートします。
このインポートは冪等なので、複数回実行しても安全です。
- 既存のユーザーはバックアップに合わせて更新され、
- 存在しないユーザーは元のUUIDで再作成されるため、古いクライアント設定がそのまま機能し続け、
- 同じクラスターに復元した場合はサブスクリプションが保持されます。
ダッシュボード内の復元では、バックアップの復号が自動で行われます。(別途用意されているプレーンテキストの**「ダウンロード」**エクスポートは暗号化されていません。そのファイルは非公開に保ってください。)
方法2. 素のMarzbanへ復元する
ダウンロードしたバックアップは、単なるMarzbanネイティブのユーザー形式です。Marzban自身のAPIが期待するものと同じ形で、素のMarzbanが単に無視する_cyvフィールドが1つ余分に付いているだけです。つまり、どのMarzbanでも、CreateYourVPNを一度も使ったことのないものであっても、アカウントを再作成できます。
バックアップページのプレーンテキストの**「ダウンロード」**エクスポートをソースファイルとして使用します。(クラウドストレージ内の暗号化されたバックアップはダッシュボードからのみ復元でき、手作業では復号できません。)
ファイル内の**users**配列をループし、各エントリを対象のパネルに送信します。
POST /api/user各ユーザーオブジェクトはすでにMarzbanの形式になっているため、そのまま通ります。プロキシUUIDは**proxies.vless.idとしてペイロードに含まれるので、再作成されたアカウントは同じUUID**を保ちます。既存のクライアントアプリに新しいものは必要ありません。
正直な注意点。 アカウントの再作成は話の半分にすぎません。ユーザーの既存のクライアント設定が接続を維持するには、対象のパネルが元と同じインバウンド、Xray設定、ホストを持っている必要があります。対象が別の設定になっている場合、アカウントは正しく作成されますが、各クライアントは新しい接続情報を取得するためにサブスクリプションを再取得しなければなりません。同じクラスター(方法1)に復元すれば、これを完全に回避できます。