مرجع
سازگاری
پنلها، سیستمعاملها، مرورگرها و اپهایی که Row-Template نسخهٔ 1.4.0 پشتیبانی میکند، آنچه روی هر پنل تغییر میدهد، و محدودیتهای نسخهٔ 1.4.0.
پنلها
| پنل | وضعیت | نسخهها |
|---|---|---|
| 3X-UI (MHSanaei) | پشتیبانیشده از 1.0.0 | 3.6.0 یا جدیدتر |
| PasarGuard | پشتیبانیشده از 1.3.0 | 5.x — نصب رسمی Docker، یا نصب از سورس (pasarguard.service) |
| Rebecca | پشتیبانیشده از 1.3.0 | 1.x، یعنی نسخهٔ Go — نصب باینری Rebecca (rebecca-binary.sh که بهصورت rebecca.service اجرا میشود) |
ایمیج Docker مربوط به Rebecca (rebeccapanel/rebecca) |
پشتیبانی نمیشود | 0.0.x، یعنی نسخهٔ پایتونی. نصبکننده آن را تشخیص میدهد و پیش از هر تغییری رد میکند. بهجای آن از Rebecca نسخهٔ 1.x با نصبکنندهٔ باینریاش (rebecca-binary.sh) استفاده کنید. |
پشتیبانیشده یعنی همهٔ قابلیتها روی آن پنل موجودند — تشخیص، نصب، فعالسازی، بررسی، پشتیبانگیری، بازگردانی و حذف — و هر کدام در مجموعهٔ آزمونهای Row-Template آزموده میشود، و صفحههای هر پنل با موتور قالب واقعی همان پنل رندر میشوند. نسخهٔ 1.4.0 پیش از انتشار روی پنلهای واقعی هم آزموده شد — 3X-UI 3.8.5، PasarGuard 5.4.1 و Rebecca 1.x — از جمله بهروزرسانی از نسخهٔ منتشرشدهٔ 1.3.1 و بازگردانی به آن.
| 3X-UI | PasarGuard | Rebecca | |
|---|---|---|---|
| موتور قالب | html/template زبان Go |
Jinja2 | pongo2 (به سبک Django، در Go) |
| پوشهٔ نصب | /etc/3x-ui/sub_templates/row-template |
/etc/row-template |
/etc/row-template |
| آنچه فعالسازی تغییر میدهد | subThemeDir |
یک بلوک نشاندار در /opt/pasarguard/.env |
دو فیلد از جدیدترین ردیف تنظیمات اشتراک |
| نیاز فعالسازی خودکار | sqlite3 و پایگاهدادهٔ پنل |
هیچ چیز اضافه | پایگاهدادهٔ پیشفرض SQLite و sqlite3 |
| ریاستارت هنگام فعالسازی | بله، کوتاه | یک بار، فقط اگر در حال اجرا باشد | هرگز |
| بهروزرسانی زندهٔ وضعیت | بله | بله، از 1.4.0 | بله، از 1.4.0 |
| فهرست برنامههای خود پنل | — | بله، از 1.4.0 | — |
| پیشنهاد نام و لینک پشتیبانی هنگام نصب | — | بله، از 1.4.0 (SQLite) | بله، از 1.4.0 (SQLite) |
نصبکننده تشخیص میدهد کدام پنل روی سرور است. یک پنل فقط وقتی نصبشده به حساب میآید که دو نشانهٔ مستقل از آن با هم بخوانند (پیکربندیاش، فایل compose یا سرویسش، فرمانش، پوشهٔ دادهاش)؛ پنلی که فقط بخشی از آن وجود دارد، بهجای حدس زدن، رد میشود. روی سروری با بیش از یک پنل پشتیبانیشده، نصب تعاملی میپرسد به کدام سرویس بدهد و نصب تازهٔ اسکریپتی باید RT_PANEL=3xui|pasarguard|rebecca را تنظیم کند — بدون آن، نصبکننده پیش از هر تغییری متوقف میشود. هر نصب به یک پنل سرویس میدهد؛ اجرای دوباره و بهروزرسانی آن را حفظ میکنند.
چرا هر طرح سه بار ساخته میشود: این سه پنل موتور قالب مشترکی ندارند و صفحهای که برای یکی نوشته شده در دیگری معتبر نیست. لایهٔ ظاهری CSS ساده و همه جا یکسان است؛ برای PasarGuard و Rebecca هر طرح در یک مقدمهٔ کوچک قرار میگیرد که دادههای خود پنل را به صفحه نگاشت میکند، داخل یک بلوک autoescape صریح، تا هر مقداری روی هر پنلی escape شود.
محدودیتهای نسخهٔ 1.4.0
- ایمیج Docker مربوط به Rebecca رد میشود (0.0.x، نسخهٔ پایتونی)، همانطور که بالا آمد.
- Rebecca با MySQL/MariaDB — یا بدون
sqlite3— به انتخاب دستی صفحه در Settings → Subscription → Templates نیاز دارد؛ خود صفحه همچنان گذاشته میشود. 3X-UI بدونsqlite3هم به همین شکل به تنظیم دستی Sub Theme Directory نیاز دارد. - تنظیمات پنل که همچنان اولویت دارند: تمپلیت اشتراک اختصاصی یک ادمین در PasarGuard و Rebecca، و تنظیم disable subscription template در PasarGuard. در اختیار خودتاناند؛
row-template verifyآنها را گزارش میدهد. - عنوان صفحهٔ PasarGuard (
subTitle) و تمپلیتهای Clash ساخته نمیشوند — فقط صفحهٔ اشتراک ساخته میشود. - افزودن یکلمسی در PasarGuard هیچ اپ sing-box یا Clash را از فهرست داخلی پیشنهاد نمیدهد (این نشانیها به صفحه داده نمیشوند) — برای پیشنهاد هر اپی، برنامههای خودتان را در پنل فهرست کنید؛ در Rebecca اپهای Clash از اشتراک Clash Meta آن استفاده میکنند و sing-box پیشنهاد نمیشود.
- آیکون برنامههای PasarGuard نمایش داده نمیشوند: صفحه هیچ چیزی را از سایت دیگری بارگذاری نمیکند.
- نام و لینک پشتیبانیای که هنگام نصب پیشنهاد میشوند فقط از پایگاهدادهٔ SQLite خوانده میشوند.
- اشتراکهای on hold فعال نشان داده میشوند. در PasarGuard که مدت انتظار را به صفحه میگوید، تاریخ انقضا نشان میدهد که با اولین اتصال شروع میشود؛ در Rebecca که این را نمیگوید، تاریخ انقضا بهجای حدس زدن، نامعلوم نشان داده میشود.
- یک پنل برای هر سرور. هر نصب به پنلی سرویس میدهد که برای آن نصب شده؛ سرویس دادن به پنل دیگر یعنی اول
row-template uninstall. - بازگردانی صفحه و نسخهٔ ثبتشدهٔ Row-Template را بازمیگرداند، نه خود منوی مدیریت
row-templateرا و هرگز پنل را؛ فقط دو پشتیبان جدیدتر نگه داشته میشوند. پشتیبانگیری و بازگردانی را ببینید.
سرور
| سیستمعامل | لینوکس. پیشنهادی: Ubuntu 24.04 LTS (x86_64). |
| پوسته و ابزارها | bash، coreutils، tar، sha256sum یا shasum، curl، awk، sed، od، base64؛ flock (از util-linux) برای PasarGuard و Rebecca |
| اختیاری | sqlite3 (فعالسازی خودکار در 3X-UI و Rebecca، و بررسیهای بیشتر)، systemd (ریاستارت سرویس 3X-UI پیرامون فعالسازی) |
| Runtime | هیچ — نه Node.js، نه Python، نه پایگاهداده |
مشترکان
| مرورگرها | مرورگرهای فعلی دسکتاپ و موبایل. |
| زبانها | انگلیسی، فارسی، عربی، روسی، چینی ساده — با چیدمان راستبهچپ برای فارسی و عربی. |
| پوستهها | System، Light، Dark. |
| افزودن یکلمسی | v2rayNG، Happ و sing-box در Android؛ Streisand، V2Box و Shadowrocket در iOS؛ Clash Verge Rev، Mihomo Party و v2rayN (کپی) در Windows؛ Clash Verge Rev، Streisand و V2Box در macOS — هر کدام جایی که پنل نشانی لازم را به صفحه بدهد. |
| پروتکلهای برچسبخورده | VLESS، VMess، Trojan، Shadowsocks، Hysteria/Hysteria2، WireGuard، AmneziaWG، Telegram MTProto. |
نسخهها
| Row-Template | پنلها | توضیح |
|---|---|---|
| 1.4.0 | 3X-UI ≥ 3.6.0، PasarGuard 5.x، Rebecca 1.x | پرچم همهٔ کشورها روی همهٔ پلتفرمها؛ برنامههای خود PasarGuard؛ وضعیت زنده در PasarGuard و Rebecca؛ پیشنهاد نام و لینک پشتیبانی پنل هنگام نصب. از 1.3.x: یک بار بهروزرسانی. |
| 1.3.1 | 3X-UI ≥ 3.6.0، PasarGuard 5.x، Rebecca 1.x | نامگذاری صفحههای PasarGuard و Rebecca با نام مشترک؛ پرچم از روی کدهای ISO. |
| 1.3.0 | 3X-UI ≥ 3.6.0، PasarGuard 5.x، Rebecca 1.x | پشتیبانی از PasarGuard و Rebecca؛ Meter و Notebook — هفده طرح. از 1.1.0 یا 1.2.0: یک بار بهروزرسانی. |
| 1.2.0 | 3X-UI ≥ 3.6.0 | پانزده طرح. |
| 1.1.0 | 3X-UI ≥ 3.6.0 | Configuration Explorer. |
| 1.0.0 | 3X-UI ≥ 3.6.0 | نخستین نسخهٔ پایدار. |
نسخهٔ عمومی 1.2.1 وجود نداشت؛ اصلاحات آن در 1.3.0 گنجانده شدهاند.