تغییرات

فهرست کامل تغییرات، شامل تغییرات داخلی و توسعه، در فایل CHANGELOG.md مخزن آمده است.

1.4.0

آخرین نسخه منتشرشده در ۲۸ سپتامبر ۲۰۲۶. پرچم همهٔ کشورها روی همهٔ پلتفرم‌ها؛ در PasarGuard، برنامه‌ها و لینک اطلاعیه‌ای که از قبل در پنل تنظیم کرده‌اید؛ ارقام زنده در PasarGuard و Rebecca؛ و پیشنهاد نام و لینک پشتیبانی پنل هنگام نصب. Row همچنان طرح پیش‌فرض است و برای نصب موجود جز آنچه پایین آمده چیزی تغییر نمی‌کند.

اضافه شد

• پرچم همهٔ کشورها، روی همهٔ پلتفرم‌ها. صفحه فونت پرچم خودش (پرچم‌های Twemoji) را همراه دارد که فقط برای نشان پرچم به کار می‌رود، پس هر ۲۵۸ پرچم همه جا یکسان دیده می‌شوند — از جمله در مرورگرهای مبتنی بر Chromium روی ویندوز، که پرچمی ندارند و دو حرف مثل DE نشان می‌دادند. هم ایموجی پرچم را پوشش می‌دهد و هم کد کشور را (🇹🇷 Istanbul، TR | Ankara، GB-LON-1)؛ UK پرچم بریتانیا را نشان می‌دهد و XK (کوزوو) هم شناخته می‌شود. جزئیات ←
• PasarGuard: برنامه‌های خودتان. وقتی در Settings → Subscription → Applications برنامه‌هایی فهرست کنید، کارت Connect به‌جای اپ‌های داخلی خودش همان‌ها را نشان می‌دهد: برای هر پلتفرمی که پوشش می‌دهید یک زبانه، اول برنامهٔ پیشنهادی شما، توضیحات شما به زبان مشترک، و یک لینک دانلود. Import از لینکی استفاده می‌کند که PasarGuard برای مشترک ساخته است؛ آیکون‌ها بارگذاری نمی‌شوند. جزئیات ←
• PasarGuard: لینک خود اطلاعیه. اطلاعیه‌ای که در پنل برایش نشانی تنظیم شده، زیر متنش یک باز کردن لینک می‌گیرد.
• ارقام زنده در PasarGuard و Rebecca. مصرف، انقضا و وضعیت آنلاین تا وقتی صفحه باز است به‌روز می‌شوند، روی همهٔ پنل‌ها. جزئیات ←
• پیشنهاد نام و لینک پشتیبانی پنل هنگام نصب. در PasarGuard و Rebecca، نصب تازه عنوان اشتراک و لینک پشتیبانی‌ای را که از قبل در پنل تنظیم شده نشان می‌دهد و می‌پرسد Use them for this page?؛ RT_PANEL_BRANDING=1 آن‌ها را در اسکریپت برمی‌دارد، و منوی مدیریت روی نصب موجود پیشنهادشان می‌دهد. پیش‌فرض‌های خود پنل‌ها هرگز پیشنهاد نمی‌شوند. جزئیات ←

اصلاح شد

• لینک پشتیبانی پیش‌فرض پنل دیگر جای لینک شما را نمی‌گیرد. لینک پشتیبانی Rebecca به‌طور پیش‌فرض https://t.me/ خالی است و لینک پشتیبانی پنل بر لینکی که در Row-Template تنظیم شده مقدم است؛ پس در Rebecca با تنظیمات پیش‌فرض، Contact support صفحه به صفحهٔ اول تلگرام می‌رفت. این پیش‌فرض خالی حالا «بدون لینک» حساب می‌شود، هم در Rebecca و هم در PasarGuard.
• بازگردانی پس از به‌روزرسانی طرح شما را حفظ می‌کند. بازگردانی به پشتیبانی که به‌روزرسان قدیمی‌تر گرفته بود، به‌جای طرحی که داشتید Row را بازمی‌گرداند؛ حالا طرحی را بازمی‌گرداند که تنظیمات ذخیره‌شدهٔ آن پشتیبان انتخاب کرده بود.

تغییر کرد

• صفحه بزرگ‌تر شده، اما به همان زودیِ قبل نمایش داده می‌شود. هر طرح ۸۱ کیلوبایت بزرگ‌تر شده که بیشترش فونت پرچم است؛ سقف اندازهٔ صفحه ۲۸۰ KiB است. فونت بعد از محتوای صفحه قرار گرفته، پس نخستین نمایش منتظرش نمی‌ماند — روی یک گوشی کُند با اتصال 3G اندازه‌گیری شد: صفحه به همان زودیِ 1.3.1 ظاهر می‌شود و روی همان اتصال حدود ۰٫۴ ثانیه دیرتر بارگذاری‌اش تمام می‌شود. زمان اجرای اسکریپت تغییری نکرده است.
• زبانه‌ها به خط بعد می‌روند. وقتی فهرست PasarGuard بیش از چهار پلتفرم داشته باشد، نوار زبانه‌ها در همهٔ طرح‌ها به خط دوم می‌رود.
• پیام رد نسخهٔ Docker مربوط به Rebecca حالا به نصب‌کنندهٔ باینری Rebecca (rebecca-binary.sh) اشاره می‌کند.

محدودیت‌های شناخته‌شده

آیکون برنامه‌های PasarGuard نمایش داده نمی‌شوند؛ نام و لینک پشتیبانی فقط از پایگاه‌دادهٔ SQLite پیشنهاد می‌شوند؛ عنوان صفحهٔ PasarGuard و تمپلیت‌های Clash ساخته نمی‌شوند؛ Rebecca با MySQL/MariaDB به انتخاب دستی صفحه نیاز دارد. همهٔ محدودیت‌ها ←

ارتقا

• از 1.3.x، 1.2.0 یا 1.1.0، روی هر پنلی: یک بار row-template update را اجرا کنید. جزئیات ←
• بازگردانی، صفحه و نسخهٔ ثبت‌شده را بازمی‌گرداند، نه خود منوی مدیریت را، و فقط دو پشتیبان جدیدتر نگه داشته می‌شوند. جزئیات ←

1.3.1

منتشرشده در ۲۷ سپتامبر ۲۰۲۶. یک نسخهٔ اصلاحی: همهٔ اصلاحات پس از 1.3.0، در قالب یک به‌روزرسانی کوچک. برای نصب موجود 3X-UI چیزی تغییر نمی‌کند.

اصلاح شد

• صفحه‌های PasarGuard و Rebecca با نام مشترک نام‌گذاری می‌شوند. پیش‌تر عنوانشان «Subscription» بود. در PasarGuard اگر ادمین عنوان پروفایل خودش را تنظیم کرده باشد، همان نام صفحه می‌شود — عنوانی که هنوز یک جای‌نگهدار مخصوص هر مشترک مثل {USERNAME} دارد کنار گذاشته می‌شود — وگرنه نام کاربری مشترک؛ در Rebecca، نام کاربری.
• پرچم از روی کد کشور. نام نودی که یک کد دوحرفی کشور دارد (TR | Istanbul، RU-01، GB-LON-1)، مثل ایموجی پرچم، پرچم همان کشور را نشان می‌دهد. کد فقط وقتی حساب می‌شود که با حروف بزرگ و جدا آمده باشد و نام یک کشور واقعی باشد؛ نام کشورها و شهرها خوانده نمی‌شوند.

ارتقا

• row-template update، روی هر پنلی.

1.3.0

منتشرشده در ۲۶ سپتامبر ۲۰۲۶. Row-Template حالا علاوه بر 3X-UI روی PasarGuard و Rebecca هم نصب می‌شود و دو طرح تازه دارد. برای نصب موجود 3X-UI جز آنچه پایین آمده چیزی تغییر نمی‌کند و Row همچنان طرح پیش‌فرض است. همهٔ اصلاحاتی هم که برای 1.2.1 آماده شده بود — نسخه‌ای که جداگانه منتشر نشد — در همین نسخه گنجانده شده است.

اضافه شد

• پشتیبانی از PasarGuard (نسخهٔ 5.x، نصب رسمی Docker یا نصب از سورس): تشخیص، نصب، فعال‌سازی، بررسی، پشتیبان‌گیری، بازگردانی و حذف. صفحه در پوشهٔ تمپلیت‌های PasarGuard قرار می‌گیرد و با یک بلوک نشان‌دار در انتهای /opt/pasarguard/.env انتخاب می‌شود؛ پنلِ در حال اجرا یک بار ری‌استارت می‌شود، هیچ‌کدام از خطوط خودتان ویرایش نمی‌شود و حذف، .env را دقیقاً به بایت‌های قبلی‌اش برمی‌گرداند. فعال‌سازی ←
• پشتیبانی از Rebecca (نسخهٔ 1.x، یعنی نسخهٔ Go با نصب باینری Rebecca) با همان عملیات. صفحه در پوشهٔ تمپلیت‌های Rebecca قرار می‌گیرد و در تنظیمات اشتراکش انتخاب می‌شود که Rebecca در هر درخواست می‌خواند — چیزی ری‌استارت نمی‌شود. با پایگاه‌دادهٔ پیش‌فرض SQLite و sqlite3 خودکار است؛ با MySQL/MariaDB دو مقدار را در داشبورد وارد می‌کنید. فعال‌سازی ←
• تشخیص و انتخاب پنل. نصب‌کننده پنل روی سرور را پیدا می‌کند؛ یک پنل فقط وقتی حساب می‌شود که دو نشانهٔ مستقل با هم بخوانند. روی سروری با بیش از یک پنل می‌پرسد، یا در اسکریپت RT_PANEL را می‌خواند.
• فعال‌سازی تراکنشی در PasarGuard و Rebecca: از تنظیمات پنل عکس فوری گرفته می‌شود، تغییر اعمال و بررسی می‌شود، و اگر هر مرحله شکست بخورد دقیقاً بازگردانده می‌شود.
• دو طرح تازه، Meter و Notebook — در مجموع هفده طرح، روی همهٔ پنل‌ها. ببینیدشان ←
• همهٔ طرح‌ها برای همهٔ پنل‌ها: هر نسخه برای هر طرح یک نسخهٔ PasarGuard و یک نسخهٔ Rebecca دارد که مثل صفحه‌های 3X-UI با چک‌سام بررسی می‌شوند.

اصلاح شد

• بازگردانی به پشتیبانی که زیر 1.1.0 گرفته شده کار می‌کند. پشتیبانی که طرحش را نام می‌برد با همان طرح بازگردانده می‌شود؛ پشتیبانی که صفحه‌اش هیچ‌کدام از طرح‌های این نسخه نیست با Row بازگردانده می‌شود، و پس از آن verify، تعویض طرح و به‌روزرسانی همچنان کار می‌کنند.
• یک بار row-template update برای رفتن از 1.1.0 کافی است: منوی مدیریت، config یا verify نصب را از همان نسخه کامل می‌کنند. طرح‌های جابه‌جاشده برگردانده می‌شوند و verify طرح‌های ناموجود و خراب را نام می‌برد.
• بازگردانی‌ای که در همان ثانیهٔ تغییر قبلی انجام شود حالا همان تغییر را برمی‌گرداند؛ بررسی زنده پس از config، update و rollback در 3X-UI اجرا می‌شود؛ تغییر صفحه‌ای که به PasarGuard یا Rebecca نرسد چیزی را تغییر نمی‌دهد؛ و صفحهٔ معتبر روی سرور پرمشغله هرگز رد نمی‌شود.

امنیت

• هر صفحهٔ PasarGuard و Rebecca بدنه‌اش را در یک بلوک autoescape صریح قرار می‌دهد، پس هر مقداری روی هر پنلی escape می‌شود و برندینگ هرگز نمی‌تواند تگ قالب باز کند.
• فایل .env پنل PasarGuard و تنظیمات پایگاه‌دادهٔ Rebecca فقط برای کلیدهایی که نصب‌کننده لازم دارد خوانده می‌شوند، هرگز چاپ نمی‌شوند و هرگز در پشتیبان کپی نمی‌شوند.
• پشتیبان‌ها پنل خود را ثبت می‌کنند و هرگز روی پنل دیگری بازگردانده نمی‌شوند.

تغییر کرد

• row-template version پنلی را که به آن سرویس می‌دهد نشان می‌دهد.
• row-template uninstall هر پنل را به صفحه‌ای که پیش از Row-Template داشت برمی‌گرداند و صفحه‌ای را که بعداً انتخاب کرده‌اید دست نمی‌زند.
• نصب تازهٔ اسکریپتی روی سروری که بیش از یک پنل پشتیبانی‌شده دارد به RT_PANEL نیاز دارد. به‌جای حدس زدن، پیش از هر تغییری متوقف می‌شود.

محدودیت‌های شناخته‌شده

به‌روزرسانی زنده فقط در 3X-UI است؛ ایمیج Docker مربوط به Rebecca (0.0.x) رد می‌شود؛ Rebecca با MySQL/MariaDB به انتخاب دستی صفحه نیاز دارد؛ عنوان صفحهٔ PasarGuard و تمپلیت‌های Clash ساخته نمی‌شوند. همهٔ محدودیت‌ها ←

ارتقا

• از 1.2.0 یا 1.1.0 در 3X-UI: یک بار row-template update را اجرا کنید. جزئیات ←
• در PasarGuard یا Rebecca: نصب‌کننده را اجرا کنید — نسخه‌های قبلی روی این پنل‌ها نصب نمی‌شدند.
• بازگردانی صفحه و نسخهٔ ثبت‌شده را بازمی‌گرداند، نه خود منوی مدیریت را، و فقط دو پشتیبان جدیدتر نگه داشته می‌شوند. جزئیات ←

1.2.0

منتشرشده در ۲۴ سپتامبر ۲۰۲۶. Row-Template به مجموعه‌ای از طرح‌ها تبدیل می‌شود. Row همچنان طرح پیش‌فرض است و 3X-UI نسخهٔ 3.6.0 یا جدیدتر همچنان تنها پنل پشتیبانی‌شده.

اضافه شد

• پانزده طرح — Row، Editorial، Canvas، Prism، Terminal، Pulse، Brutal، Arcade، Sketch، Signature، Saffron، Pulse Nova، Prism Nova، Terminal Nova و Arcade Nova — همه ساخته‌شده از یک اجرای مشترک و ترجمه‌های یکسان. ببینیدشان ←
• انتخاب طرح: انتخابگر طرح در نصب‌های تازهٔ تعاملی، RT_TEMPLATE برای نصب‌های بدون پرسش و Reconfigure branding → Template در منوی مدیریت. به‌روزرسانی‌ها انتخاب را حفظ می‌کنند.
• طرح‌های دارای چک‌سام: هر طرح با SHA-256 مخصوص خودش عرضه می‌شود و verify همه را بررسی می‌کند و تأیید می‌کند که صفحهٔ زنده همان طرح انتخاب‌شده است.
• پرچم‌های نقاشی‌شده برای آلمان، فرانسه، هلند، ژاپن، سوئد و ایالات متحده، تا در ویندوز هم نمایش داده شوند.
• پوسته‌های صفحه برای PasarGuard و Rebecca در پوشهٔ shells/، که 1.2.0 هنوز نصبشان نمی‌کرد — پشتیبانی از هر دو پنل در 1.3.0 آمد.

تغییر کرد

• تشخیص پایگاه‌دادهٔ پنل سخت‌گیرانه شد: اولین فایل پایگاه‌دادهٔ پیداشده فقط وقتی استفاده می‌شود که پایگاه‌دادهٔ SQLite واقعی باشد؛ در غیر این صورت به‌جای امتحان بی‌صدای فایل دیگر، رد می‌شود.
• به‌روزرسانی زنده فقط دادهٔ خودش را می‌پذیرد: پاسخ غیرمنتظره به‌روزرسانی را متوقف می‌کند و ارقامی را که سرور فرستاده بود نگه می‌دارد.
• نسخه حالا فایل‌های همراه نصب‌کننده (lib/transaction.sh، panels/) را هم دارد و نصب و به‌روزرسانی، نسخه‌ای را که آن‌ها را نداشته باشد رد می‌کنند.

ارتقا

در 1.2.0، اولین row-template update از 1.1.0 — که به‌روزرسان خود 1.1.0 انجامش می‌داد — فقط Row را نصب می‌کرد و به‌روزرسانی دوم همهٔ طرح‌ها و بقیهٔ فایل‌ها را. به‌روزرسانی از 1.1.0 مستقیم به 1.3.0 با یک بار انجام می‌شود. جزئیات ←

در 1.2.0، بازگردانی به پشتیبانی که 1.1.0 گرفته بود رد می‌شد؛ 1.3.0 آن را بازمی‌گرداند. جزئیات ←

1.1.0

منتشرشده در ۳۰ اوت ۲۰۲۶. صفحه به مرکز اتصال و پیکربندی تبدیل می‌شود.

• Configuration Explorer: هر سرور در یک ردیف جداگانه، با پرچم یا مونوگرام، نام، برچسب پروتکل و دکمه‌های View (QR محلی و کپی) و Copy. جست‌وجو برای فهرست‌های طولانی؛ ادغام موارد تکراری؛ جداسازی لینک‌های نادرست.
• برچسب پروتکل برای VLESS، VMess، Trojan، Shadowsocks، Hysteria/Hysteria2، WireGuard، AmneziaWG و Telegram MTProto.
• نشان کشور فقط از روی کد کشور معتبر در برچسب خود پیکربندی — هرگز حدس زده‌شده از روی میزبان یا IP.
• لینک‌ها تا View پوشیده می‌مانند، هرگز ثبت نمی‌شوند و کدهای QR محلی ساخته می‌شوند.
• به‌روزرسانی از 1.0.0 برندینگ را حفظ می‌کند و برای بازگردانی پشتیبان نگه می‌دارد.

1.0.0

منتشرشده در ۳۰ اوت ۲۰۲۶. اولین نسخهٔ پایدار.

• یک صفحهٔ اشتراک مستقل برای 3X-UI — یک فایل HTML که همه چیز داخل آن است، بدون درخواست بیرونی.
• برندینگ بدون برند: نام سرویس، لینک پشتیبانی و لوگو، ذخیره‌شده به‌صورت داده و جاسازی‌شده به‌صورت امن.
• پنج زبان با پشتیبانی راست‌به‌چپ.
• نصب‌کنندهٔ یک‌خطی با بررسی اجباری SHA-256، استخراج امن و فعال‌سازی اتمی.
• ابزار مدیریتی row-template: config، update، rollback، verify، version، uninstall و help.
• پشتیبان‌گیری و بازگردانی با حفظ برندینگ.