پیش از شروع
مهاجرت، پنل قدیمی را از راه API خودش میخواند، همانطور که صفحهی وب خودش میخواند. نه خروجی گرفتن از دیتابیس لازم است و نه کپی دستی، و پنل قدیمی تا وقتی همهچیز را بررسی میکنید روشن میماند.
چه چیزهایی لازم است
- پنل و صفحهی اشتراک Umiji که با راهنمای راهاندازی نصب شده باشند. لازم نیست چیز دیگری در آن بسازید.
- آدرس پنل قدیمی و نام کاربری و رمز مدیرش. برای رمناویو بهجایش یک توکن API، و برای هیدیفای لینک مدیری که به شما داده است.
- سرور Umiji بتواند آن آدرس را باز کند. اگر پنل قدیمی فقط به بعضی IPها اجازه میدهد، IP سرور Umiji را هم اضافه کنید.
چه چیزهایی منتقل میشود
همهی کاربران، با رمزها و UUIDها، ترافیک مصرفشده و محدودیت، دورهی ریست ترافیک، تاریخ انقضا، وضعیت، یادداشت، آیدی تلگرام و ایمیلشان. کلیدهای کاربران همان میماند، پس اتصالشان عوض نمیشود.
| از | اینباندها | گروهها | هاستها | لینکهای قدیمی |
|---|---|---|---|---|
| مرزبان | بله | بله | بله | با کلید مخفی |
| پاسارگارد | بله | بله | بله | با کلید مخفی |
| مرزنشین | بله | بله | بله | بله |
| 3x-ui | بله | بله | بله | بله |
| رمناویو | بله | بله | بله | بله |
| هیدیفای | نه، چرا؟ | نه | نه | بله |
اینباندها در یک پروفایل کانفیگ به نام پنل قدیمی قرار میگیرند. گروهها (مجموعهی اینباندهای مرزبان، گروههای پاسارگارد، سرویسهای مرزنشین) به اسکواد داخلی تبدیل میشوند، پس هر کاربر به همان چیزهایی دسترسی دارد که قبلاً داشت.
چه چیزهایی منتقل نمیشود: مدیرها و نمایندههای پنل قدیمی، و سرورهایش. کاربرانی که مدیر
دیگری ساخته بود، در یادداشتشان Owner: name میگیرند تا پیدایشان کنید. اینباندهای VMess
و SOCKS جا میمانند، چون Umiji آنها را اجرا نمیکند؛ کاربرانشان پروتکلهای دیگرشان را نگه میدارند.
کپی کردن کلید مخفی
مرزبان و پاسارگارد هر لینک اشتراک را با یک کلید مخفی امضا میکنند که در دیتابیسشان نگه میدارند. 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; را در خود دیتابیس اجرا کنید. جوابش یک خط بلند از حروف و عدد است.
کلید مخفی را به کسی ندهید. هر کس آن را داشته باشد، برای هر کاربری لینکی میسازد که کار میکند.
اجرای مهاجرت
سؤالهای اسکریپت انگلیسیاند. هر قدم میگوید کدام را انتخاب کنید.
-
با root وارد سرور Umiji شوید و این را اجرا کنید:
همیشه تازهترین نسخه را اجرا میکند و برای دفعههای بعد، Migrate را هم به منویbash <(curl -fsSL https://raw.githubusercontent.com/therewasluna/umiji/main/install.sh) migrateumijiاضافه میکند. - پنل قدیمی را انتخاب کنید و آدرسش را بچسبانید، مثل
https://old.example.com:8000. برای 3x-ui مسیر مخفیاش را هم بنویسید. - نام کاربری و رمز مدیرش را بنویسید. رمز هنگام تایپ دیده نمیشود و جایی ذخیره نمیشود.
- پنل قدیمی را میخواند و نشان میدهد چه چیزهایی میسازد. هنوز چیزی عوض نشده است. خطهای Worth knowing را بخوانید: میگویند چه چیزی در Umiji فرق دارد و برای چند کاربر.
- 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 بدهید. اجرای دوباره کاربرانی را که از قبل اینجا هستند رد میکند، پس تمدید، شارژ ترافیک یا غیرفعال کردنی که بعد از آن در پنل قدیمی انجام شود منتقل نمیشود.
کار کردن لینکهای قدیمی
هر کاربر شناسهی لینک قدیمیاش را نگه میدارد و صفحهی اشتراک قالب لینکهای پنل قدیمی را یاد میگیرد، پس لینک قدیمی همان کاربر را اینجا باز میکند. همهی قالبها و نوع برنامهها کار میکنند: ساده، sing-box، Clash و بقیه. فقط دامنهی لینکهای قدیمی باید به صفحهی اشتراک Umiji برسد:
- لینکها دامنهای روی پورت 443 یا 80 دارند. مهاجرت پیشنهاد میدهد آن را از همین سرور جواب بدهد. بله را بزنید و هر وقت جابهجا شدید، رکورد A آن دامنه را روی این سرور بگذارید.
-
پورت دیگری، مثل
:8000یا:2096. مهاجرت یک خط برای اضافه کردن به Caddy چاپ میکند. آن پورت را در فایروال هم باز کنید. - لینکها IP سرور قدیمی را دارند. فقط همان سرور میتواند جوابشان را بدهد، پس صفحهی اشتراک Umiji را آنجا نصب کنید، یا لینک جدید کاربران را برایشان بفرستید.
لینک جدید مثل همیشه در صفحهی کاربر در پنل است. وقتی برنامهی کاربر یک بار از لینک قدیمی بهروز شد، با هر کدام از دو لینک کار میکند.
آوردن سرورها
کلیدهای کاربران منتقل شدهاند، ولی ترافیکشان هنوز از سرورهای پنل قدیمی میگذرد. هر سرور را هر وقت آماده بودید بیاورید. کاربرانش یک قطعی کوتاه میبینند و بعد روی Umiji هستند.
- نود پنل قدیمی را روی آن سرور خاموش کنید تا پورتهایش آزاد شوند. در 3x-ui و هیدیفای، این خود پنل قدیمی است.
- در Umiji، نودها را باز کنید و سرور را با نصب خودکار (IP سرور و رمز SSH) اضافه کنید، مثل راهنمای راهاندازی. پروفایلی را انتخاب کنید که مهاجرت ساخت.
- ببینید نود آنلاین شده باشد، بعد امتحان کنید که یک کاربر وصل میشود.
وقتی همهی سرورها آمدند و دامنهی قدیمی به اینجا اشاره کرد، میتوانید پنل قدیمی را خاموش کنید. سرورش را چند روزی نگه دارید، شاید لازم شد چیزی از آن بخوانید.
نکتههای هر پنل
- مرزبان، پاسارگارد
- شمارش روزهای کاربرانی که منتظر اولین استفادهاند (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 باز کنید و پیشنمایشی را که چاپ کرد بگذارید.