백업에서 복원하기
사용자를 되살리는 두 가지 방법: 멱등하게 다시 가져오는 원클릭 대시보드 복원, 또는 파일이 네이티브 Marzban 사용자 형식이라 비어 있는 Marzban으로 수동 복원하는 방법.
백업은 복원이 되어야 비로소 가치가 있습니다. 사용자를 되살리는 방법은 두 가지입니다. 대시보드 안에서 간편하게 하는 방법과, 고급 상황(또는 언젠가 CreateYourVPN에서 옮겨 갈 때)을 위한 수동 방법입니다.
방법 1. 대시보드에서 복원하기
가장 간단한 방법입니다. 사용자 페이지나 백업 페이지에 "백업에서 복원" 버튼이 있습니다.
**"백업에서 복원"**을 클릭하고 원하는 백업을 고르세요(본인의 Google Drive / S3 저장소에서).
복원을 확인하세요. CreateYourVPN이 백업을 대신 복호화하므로 입력할 암호구가 없습니다.
CreateYourVPN이 클러스터의 현재 설정에 맞춰 사용자를 다시 가져옵니다.
가져오기는 멱등하므로 여러 번 실행해도 안전합니다.
- 기존 사용자는 백업에 맞춰 업데이트되고,
- 누락된 사용자는 원래 UUID로 다시 생성되어 기존 클라이언트 설정이 계속 작동하며,
- 같은 클러스터로 복원하면 구독이 그대로 유지됩니다.
대시보드 내 복원은 백업을 자동으로 복호화해 줍니다. (별도의 평문 "다운로드" 내보내기는 암호화되지 않으니, 그 파일은 비공개로 잘 보관하세요.)
방법 2. 비어 있는 Marzban으로 복원하기
내려받은 백업은 그저 네이티브 Marzban 사용자 형식 — Marzban 자체 API가 기대하는 것과 같은 구조 — 이며, 일반 Marzban이 그냥 무시하는 _cyv 필드 하나만 추가되어 있습니다. 덕분에 CreateYourVPN을 한 번도 접한 적 없는 것을 포함해 어떤 Marzban에서도 계정을 다시 만들 수 있습니다.
백업 페이지의 평문 "다운로드" 내보내기를 원본 파일로 사용하세요. (클라우드 저장소에 있는 암호화된 백업은 대시보드를 통해서만 복원할 수 있으며, 수작업으로는 복호화할 수 없습니다.)
파일의 users 배열을 순회하며 각 항목을 대상 패널로 보내세요.
POST /api/user각 사용자 객체는 이미 Marzban 형식이라 그대로 전달됩니다. proxies.vless.id 아래의 프록시 UUID가 페이로드에 담겨 있어, 다시 생성된 계정은 같은 UUID를 유지합니다. 기존 클라이언트 앱은 새 UUID가 필요 없습니다.
솔직한 유의사항. 계정을 다시 만드는 것은 절반에 불과합니다. 사용자의 기존 클라이언트 설정이 계속 연결되려면 대상 패널이 원본과 같은 인바운드, Xray 설정, 호스트를 갖추고 있어야 합니다. 대상이 다르게 구성되어 있으면 계정은 올바르게 생성되지만, 각 클라이언트가 새 연결 정보를 받으려면 구독을 다시 가져와야 합니다. 같은 클러스터로 복원하면(방법 1) 이 문제를 완전히 피할 수 있습니다.