معرفی

3X-UI، PasarGuard و Rebecca هر کدام می‌توانند به‌جای صفحهٔ داخلی خودشان، یک صفحهٔ سفارشی به مشترکان نشان دهند. Row-Template همان صفحه است. مشترک لینک اشتراکش را در مرورگر باز می‌کند و پلن، ترافیک، تاریخ انقضا و راه‌های یک‌لمسی افزودن اشتراک به اپی را که استفاده می‌کند می‌بیند.

هر طرح به‌صورت یک فایل HTML مستقل عرضه می‌شود — همهٔ استایل‌ها، اسکریپت‌ها، فونت‌ها و سازندهٔ QR داخل همان فایل‌اند — و برای موتور قالب هر پنل جداگانه ساخته می‌شود. یک فرمان پنل شما را تشخیص می‌دهد، صفحه را کنار آن نصب می‌کند، پنل را به آن متصل می‌کند و ابزار مدیریتی row-template را برای برندینگ، به‌روزرسانی و بازگردانی در اختیارتان می‌گذارد.

این مستندات مربوط به Row-Template نسخهٔ 1.4.0 است

پنل‌های پشتیبانی‌شده: 3X-UI (MHSanaei) نسخهٔ 3.6.0 یا جدیدتر، PasarGuard نسخهٔ 5.x و Rebecca نسخهٔ 1.x — یعنی نسخهٔ Go با نصب باینری Rebecca. ایمیج Docker مربوط به Rebecca هنوز نسخهٔ پایتونی 0.0.x است که نمی‌تواند این صفحه را رندر کند؛ نصب‌کننده آن را رد می‌کند و چیزی را تغییر نمی‌دهد. فرمان‌ها و پیام‌های این سایت از نصب‌کنندهٔ نسخهٔ 1.4.0 گرفته شده‌اند. سازگاری ←

چطور کار می‌کند

نصب‌کننده یک نسخه را دانلود می‌کند، چک‌سام SHA-256 آن را بررسی می‌کند (هیچ راهی برای رد شدن از این بررسی نیست) و تشخیص می‌دهد سرور کدام پنل را اجرا می‌کند. روی سروری با بیش از یک پنل می‌پرسد — یا در اسکریپت، RT_PANEL را می‌خواند.
در پوشهٔ مخصوص خودش نصب می‌شود — /etc/3x-ui/sub_templates/row-template در 3X-UI و /etc/row-template در PasarGuard و Rebecca — سپس صفحه را از روی طرحی که انتخاب کرده‌اید و برندینگ شما می‌سازد، اعتبارسنجی می‌کند و به‌صورت اتمی سر جایش می‌گذارد.
پنل را با کمترین تغییر ممکن به صفحه متصل می‌کند:
- 3X-UI: یک تنظیم پنل، یعنی پوشهٔ پوستهٔ اشتراک (subThemeDir).
- PasarGuard: صفحه در پوشهٔ تمپلیت‌های PasarGuard قرار می‌گیرد و یک بلوک نشان‌دار که آن را انتخاب می‌کند به انتهای /opt/pasarguard/.env اضافه می‌شود.
- Rebecca: صفحه در پوشهٔ تمپلیت‌های Rebecca قرار می‌گیرد و دو فیلد از تنظیمات اشتراکش آن را انتخاب می‌کنند.
در PasarGuard و Rebecca این کار یک تراکنش است: اول از تنظیمات پنل عکس فوری گرفته می‌شود و اگر هر مرحله شکست بخورد، دقیقاً بازگردانده می‌شوند.
پنل هنگام ارائهٔ صفحه، اطلاعات هر مشترک را در آن قرار می‌دهد. صفحه سپس وضعیت را با پرسیدن از پنل خود شما به‌روز نگه می‌دارد، روی هر سه پنل. اپ‌های VPN که همان لینک را دریافت می‌کنند همچنان محتوای معمولی اشتراک را می‌گیرند.

/etc/3x-ui/sub_templates/row-template/ (3X-UI)

/etc/row-template/ (PasarGuard, Rebecca)

├── sub.html # the generated page (3X-UI serves it from here;

│ # PasarGuard and Rebecca get a copy in their templates directory)

├── config.env # your branding and selected design (data, never executed)

├── VERSION

├── PANEL # the panel this installation serves

├── dist/

│ ├── template.html # the selected design, pristine

│ └── templates/<id>/ # every design in the release, each with its checksum

├── lib/ # the management library and the transaction engine

├── panels/ # one adapter per panel

├── backups/ # snapshots used by rollback

└── backups.v2/ # PasarGuard and Rebecca: the panel's settings before activation

چرا Row-Template

حریم خصوصی از پایه

صفحه هیچ درخواستی به سرویس‌های دیگر نمی‌فرستد: نه CDN، نه سرویس بیرونی QR یا موقعیت‌یابی، نه آمارگیری. وضعیت زنده در 3X-UI از پنل خود شما می‌آید.

واقعاً بدون برند

نام سرویس شما، لینک پشتیبانی شما، لوگوی شما. هیچ چیزی در صفحه نام Row-Template را نشان نمی‌دهد.

هفده طرح

امکانات، زبان‌ها و بررسی‌های ایمنی یکسان روی همهٔ پنل‌های پشتیبانی‌شده — فقط چیدمان و ظاهر عوض می‌شود. طرح پیش‌فرض Row است.

مدیریت امن

نسخه‌های با چک‌سام بررسی‌شده، فعال‌سازی اتمی و تراکنشی، بازگردانی خودکار هنگام خطا و بازگردانی نسخه با یک فرمان.

چه کارهایی نمی‌کند

هرگز پنل شما را دست‌کاری نمی‌کند. در 3X-UI یک تنظیم، یعنی subThemeDir را تغییر می‌دهد؛ در PasarGuard یک بلوک نشان‌دار به .env اضافه می‌کند؛ در Rebecca دو فیلد از تنظیمات اشتراکش را تنظیم می‌کند. حذف Row-Template هر کدام را برمی‌گرداند.
هرگز به اینباندها، کلاینت‌ها، کاربران، نودها، هاست‌ها، گواهی‌ها یا سایر تنظیمات پنل دست نمی‌زند.
چیز دیگری روی سرور نصب نمی‌کند: نه Node.js، نه Python، نه پایگاه‌داده. از ابزارهایی استفاده می‌کند که لینوکس از قبل دارد، و اگر sqlite3 نصب باشد از آن هم.

قدم بعدی

شروع سریع

نصب، فعال‌سازی و بررسی در سه مرحله.

تمپلیت‌ها

پیش‌نمایش زندهٔ هر هفده طرح.

سازگاری

سه پنل، آنچه روی هر کدام تغییر می‌کند، و محدودیت‌های نسخهٔ 1.4.0.

مرجع خطاها

همهٔ پیام‌هایی که نصب‌کننده ممکن است چاپ کند، معنی آن‌ها و راه حل.