Umiji

کاربرانتان را از پنل دیگری بیاورید.

با یک گزینه در منو، همه‌ی کاربران مرزبان، پاسارگارد، مرزنشین، 3x-ui، رمناویو یا هیدیفای با ترافیک، محدودیت و تاریخ انقضایشان منتقل می‌شوند. برنامه‌هایشان هم از همان لینک‌های قدیمی به‌روز می‌شوند.

  • 6 پنل
  • حدود 10 دقیقه
  • پنل قدیمی دست نمی‌خورد
01
پنج دقیقه

پیش از شروع

مهاجرت، پنل قدیمی را از راه API خودش می‌خواند، همان‌طور که صفحه‌ی وب خودش می‌خواند. نه خروجی گرفتن از دیتابیس لازم است و نه کپی دستی، و پنل قدیمی تا وقتی همه‌چیز را بررسی می‌کنید روشن می‌ماند.

چه چیزهایی لازم است

  • پنل و صفحه‌ی اشتراک Umiji که با راهنمای راه‌اندازی نصب شده باشند. لازم نیست چیز دیگری در آن بسازید.
  • آدرس پنل قدیمی و نام کاربری و رمز مدیرش. برای رمناویو به‌جایش یک توکن API، و برای هیدیفای لینک مدیری که به شما داده است.
  • سرور Umiji بتواند آن آدرس را باز کند. اگر پنل قدیمی فقط به بعضی IPها اجازه می‌دهد، IP سرور Umiji را هم اضافه کنید.

چه چیزهایی منتقل می‌شود

همه‌ی کاربران، با رمزها و UUIDها، ترافیک مصرف‌شده و محدودیت، دوره‌ی ریست ترافیک، تاریخ انقضا، وضعیت، یادداشت، آیدی تلگرام و ایمیلشان. کلیدهای کاربران همان می‌ماند، پس اتصالشان عوض نمی‌شود.

ازاینباندهاگروه‌هاهاست‌هالینک‌های قدیمی
مرزبانبلهبلهبلهبا کلید مخفی
پاسارگاردبلهبلهبلهبا کلید مخفی
مرزنشینبلهبلهبلهبله
3x-uiبلهبلهبلهبله
رمناویوبلهبلهبلهبله
هیدیفاینه، چرا؟نهنهبله

اینباندها در یک پروفایل کانفیگ به نام پنل قدیمی قرار می‌گیرند. گروه‌ها (مجموعه‌ی اینباندهای مرزبان، گروه‌های پاسارگارد، سرویس‌های مرزنشین) به اسکواد داخلی تبدیل می‌شوند، پس هر کاربر به همان چیزهایی دسترسی دارد که قبلاً داشت.

چه چیزهایی منتقل نمی‌شود: مدیرها و نماینده‌های پنل قدیمی، و سرورهایش. کاربرانی که مدیر دیگری ساخته بود، در یادداشتشان Owner: name می‌گیرند تا پیدایشان کنید. اینباندهای VMess و SOCKS جا می‌مانند، چون Umiji آن‌ها را اجرا نمی‌کند؛ کاربرانشان پروتکل‌های دیگرشان را نگه می‌دارند.

02
روی سرور قدیمی · فقط مرزبان و پاسارگارد

کپی کردن کلید مخفی

مرزبان و پاسارگارد هر لینک اشتراک را با یک کلید مخفی امضا می‌کنند که در دیتابیسشان نگه می‌دارند. API آن‌ها این کلید را نشان نمی‌دهد، پس این تنها چیزی است که دستی کپی می‌کنید. با آن، برنامه‌ها از لینک‌های قدیمی به‌روز می‌شوند. بدون آن، بقیه‌ی چیزها باز هم منتقل می‌شوند، ولی باید لینک جدید هر کاربر را برایش بفرستید.

وارد سرور قدیمی شوید و کلید را چاپ کنید:

cd /opt/marzban && docker compose exec -T marzban python3 -c "import sqlite3;print(sqlite3.connect('/var/lib/marzban/db.sqlite3').execute('select secret_key from jwt').fetchone()[0])"
cd /opt/pasarguard && docker compose exec -T pasarguard python3 -c "import sqlite3;print(sqlite3.connect('/var/lib/pasarguard/db.sqlite3').execute('select secret_key from jwt').fetchone()[0])"

این برای دیتابیس پیش‌فرض، یعنی SQLite است. با MySQL، MariaDB یا PostgreSQL، دستور SELECT secret_key FROM jwt; را در خود دیتابیس اجرا کنید. جوابش یک خط بلند از حروف و عدد است.

کلید مخفی را به کسی ندهید. هر کس آن را داشته باشد، برای هر کاربری لینکی می‌سازد که کار می‌کند.

03
روی سرور Umiji

اجرای مهاجرت

سؤال‌های اسکریپت انگلیسی‌اند. هر قدم می‌گوید کدام را انتخاب کنید.

  1. با root وارد سرور Umiji شوید و این را اجرا کنید:
    bash <(curl -fsSL https://raw.githubusercontent.com/therewasluna/umiji/main/install.sh) migrate
    همیشه تازه‌ترین نسخه را اجرا می‌کند و برای دفعه‌های بعد، Migrate را هم به منوی umiji اضافه می‌کند.
  2. پنل قدیمی را انتخاب کنید و آدرسش را بچسبانید، مثل https://old.example.com:8000. برای 3x-ui مسیر مخفی‌اش را هم بنویسید.
  3. نام کاربری و رمز مدیرش را بنویسید. رمز هنگام تایپ دیده نمی‌شود و جایی ذخیره نمی‌شود.
  4. پنل قدیمی را می‌خواند و نشان می‌دهد چه چیزهایی می‌سازد. هنوز چیزی عوض نشده است. خط‌های Worth knowing را بخوانید: می‌گویند چه چیزی در Umiji فرق دارد و برای چند کاربر.
  5. Enter را بزنید تا منتقل شوند. اول از دیتابیس بکاپ می‌گیرد، پنل و صفحه‌ی اشتراک را به‌روز می‌کند، بعد کاربران را شش‌تا شش‌تا منتقل می‌کند.
  Which panel are the users on?
    1  Marzban
    4  3x-ui            2.x or 3.x
  …
  3x-ui at old.example.com
    Users        412 to move
                 398 active, 9 limited, 5 expired
    Profiles     3x-ui (3 inbounds)
    Squads       3x-ui, 3x-ui 2
    Hosts        3

  Move them now? [Y/n]
  [1/7] ✓ Database backed up 2s
  [5/7] ✓ Users moved 41s
  [6/7] ✓ Sub page knows the old links 9s

دوباره اجرا کردنش بی‌خطر است. کاربرانی که از قبل اینجا هستند رد می‌شوند، پس بعد از خطا، کاری را که می‌گوید انجام دهید و دوباره اجرا کنید. کاربرانی هم که از آن موقع به پنل قدیمی اضافه شده‌اند می‌آیند. برای برگرداندن همه‌چیز، بکاپی را که گرفت برگردانید: umiji و بعد Restore.

بعد از مهاجرت، تغییرها را فقط در Umiji بدهید. اجرای دوباره کاربرانی را که از قبل اینجا هستند رد می‌کند، پس تمدید، شارژ ترافیک یا غیرفعال کردنی که بعد از آن در پنل قدیمی انجام شود منتقل نمی‌شود.

05
هر سرور قدیمی

آوردن سرورها

کلیدهای کاربران منتقل شده‌اند، ولی ترافیکشان هنوز از سرورهای پنل قدیمی می‌گذرد. هر سرور را هر وقت آماده بودید بیاورید. کاربرانش یک قطعی کوتاه می‌بینند و بعد روی Umiji هستند.

  1. نود پنل قدیمی را روی آن سرور خاموش کنید تا پورت‌هایش آزاد شوند. در 3x-ui و هیدیفای، این خود پنل قدیمی است.
  2. در Umiji، نودها را باز کنید و سرور را با نصب خودکار (IP سرور و رمز SSH) اضافه کنید، مثل راهنمای راه‌اندازی. پروفایلی را انتخاب کنید که مهاجرت ساخت.
  3. ببینید نود آنلاین شده باشد، بعد امتحان کنید که یک کاربر وصل می‌شود.

وقتی همه‌ی سرورها آمدند و دامنه‌ی قدیمی به اینجا اشاره کرد، می‌توانید پنل قدیمی را خاموش کنید. سرورش را چند روزی نگه دارید، شاید لازم شد چیزی از آن بخوانید.

✓

نکته‌های هر پنل

مرزبان، پاسارگارد
شمارش روزهای کاربرانی که منتظر اولین استفاده‌اند (on hold) از روز مهاجرت شروع می‌شود: Umiji چنین وضعیتی ندارد. ریست سالانه‌ی ترافیک حذف می‌شود. مدیرهای نماینده به فروشنده تبدیل نمی‌شوند.
مرزنشین
اینباندها از کانفیگ Xray هر نود خوانده می‌شوند و سرویس‌ها اسکواد می‌شوند. کاربری که منتظر اولین استفاده است، از روز مهاجرت شمارش می‌شود.
3x-ui
کلاینتی که با یک شناسه‌ی اشتراک در چند اینباند است، یک کاربر با همه‌ی آن اینباندها می‌شود. تمدید خودکار و ریست ساعتی ترافیک در Umiji معادلی ندارند و حذف می‌شوند، و پیش‌نمایش می‌گوید برای چند کاربر. نسخه‌ی 2.x و 3.x هر دو کار می‌کنند.
رمناویو
توکن را در رمناویو از Remnawave Settings و بعد API Tokens بسازید. پروفایل‌ها، اسکوادها و هاست‌ها یک‌به‌یک کپی می‌شوند. اسکوادهای خارجی کپی نمی‌شوند، پس کاربرانشان تنظیمات پیش‌فرض اشتراک را می‌گیرند.
هیدیفای
API هیدیفای اینباندهایش را نمی‌دهد، پس اول در Umiji یک پروفایل کانفیگ و یک اسکواد داخلی مثل آن‌ها بسازید. مهاجرت نام اسکواد را می‌پرسد و همه‌ی کاربران را در آن می‌گذارد. VLESS همان UUID قدیمی را نگه می‌دارد. Trojan و Shadowsocks رمز تازه می‌گیرند، چون رمزهای هیدیفای از حدی که Umiji می‌پذیرد بلندترند؛ لینک کاربر رمزهای تازه را می‌آورد.

با مرزبان، پاسارگارد، مرزنشین و رمناویو (نسخه‌های نوامبر 2026)، 3x-ui نسخه‌ی 2.6 و 3.11، و هیدیفای 14.2 آزمایش شده است. چیزی درست منتقل نشد؟ مشکلات رایج را ببینید، یا در GitHub یک issue باز کنید و پیش‌نمایشی را که چاپ کرد بگذارید.