عیب‌یابی

بیشتر مشکلات در یک فرمان پیدا می‌شوند. اول آن را با root اجرا کنید:

row-template verify

هر خطی که چاپ می‌کند در بررسی نصب و هر پیام خطا در مرجع خطاها توضیح داده شده است. این صفحه به‌جای آن، از چیزی که می‌بینید شروع می‌کند.

امتناع‌ها عمدی‌اند

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

مشترکان هنوز صفحهٔ داخلی پنل را می‌بینند

تنظیم را بررسی کنید. در Panel Settings → Subscription، مقدار Sub Theme Directory باید دقیقاً /etc/3x-ui/sub_templates/row-template باشد — بدون اسلش یا فاصلهٔ انتهایی.
پس از تغییر آن پنل را ری‌استارت کنید، از خود پنل یا با systemctl restart x-ui.
لینک را در مرورگر باز کنید. اپ‌های VPN قرار است همچنان محتوای معمولی اشتراک را بگیرند.
row-template verify را اجرا کنید. خطوط Panel subThemeDir points at Row-Template و Live render check: a browser receives Row-Template آن را از سمت سرور تأیید می‌کنند.

row-template verify را اجرا کنید. خط PasarGuard selects the Row-Template page, and the placed page is current فایل‌ها و .env را تأیید می‌کند.
پنل را ری‌استارت کنید اگر verify می‌گوید PasarGuardِ در حال اجرا هنوز از صفحه استفاده نمی‌کند: pasarguard restart. PasarGuard فایل .env را فقط هنگام شروع می‌خواند.
خطوط خودتان در .env را بررسی کنید. خط SUBSCRIPTION_PAGE_TEMPLATEی از خودتان که پایین‌تر از بلوک Row-Template باشد اعمال می‌شود، چون آخرین مقداردهی ملاک است.
آنچه همچنان اولویت دارد را بررسی کنید. ادمینی که تمپلیت اشتراک خودش را دارد آن را برای کاربرانش نگه می‌دارد، و تنظیم disable subscription template باعث می‌شود پنل به‌جای هر صفحه‌ای، اشتراک خام را به مرورگرها بفرستد. verify هر دو را گزارش می‌دهد.

row-template verify را اجرا کنید. خط Rebecca selects the Row-Template page, and the placed page is current فایل‌ها و تنظیمات را تأیید می‌کند.
داشبورد را بررسی کنید. در Settings → Subscription → Templates، مقدار Subscription page template باید row-template/index.html باشد و Custom templates directory باید پوشه‌ای باشد که row-template/ را دارد (به‌طور پیش‌فرض /var/lib/rebecca/templates). با MySQL/MariaDB این مرحله همیشه دستی است.
تنظیمات اختصاصی ادمین‌ها را بررسی کنید. ادمینی که تنظیمات تمپلیت اشتراک خودش را دارد آن را برای کاربرانش نگه می‌دارد؛ verify می‌گوید چند ادمین چنین‌اند.

اگر verify موفق است اما مرورگر شما هنوز صفحهٔ قدیمی را نشان می‌دهد، ممکن است چیزی بین شما و پنل — یک CDN یا پراکسی کش‌کننده — نسخهٔ ذخیره‌شده‌ای را ارائه کند.

نصب‌کننده Rebecca را رد می‌کند

panel rebecca: this is Rebecca 0.0.x, the Python edition … — ایمیج rebeccapanel/rebecca در Docker Hub هنوز نسخهٔ پایتونی 0.0.x است که نمی‌تواند صفحهٔ Rebecca در Row-Template را رندر کند؛ با آن، Rebecca تنظیم را می‌پذیرفت و بی‌صدا همان صفحهٔ خودش را ارائه می‌داد. نصب‌کننده پیش از هر تغییری آن را رد می‌کند. Rebecca نسخهٔ 1.x، یعنی نسخهٔ Go، را با نصب‌کنندهٔ باینری Rebecca (rebecca-binary.sh) نصب کنید — نصبی که Row-Template روی آن آزموده شده — و نصب‌کننده را دوباره اجرا کنید.

نصب‌کننده می‌گوید بیش از یک پنل نصب است

more than one panel is installed here (…); choose one with RT_PANEL=3xui|pasarguard|rebecca. — سرور چند پنل پشتیبانی‌شده دارد و نصب اسکریپتی نمی‌تواند بپرسد به کدام سرویس بدهد. نصب‌کننده را با RT_PANEL برابر همان پنل دوباره اجرا کنید، یا آن را در ترمینال اجرا کنید و پنل را از فهرست انتخاب کنید. هر نصب به یک پنل سرویس می‌دهد.

نصب‌کننده می‌گوید هیچ پنل پشتیبانی‌شده‌ای پیدا نشد

no supported panel was detected on this host: … — نصب‌کننده نه 3X-UI، نه PasarGuard و نه Rebecca را پیدا کرد. یک پنل فقط وقتی نصب‌شده به حساب می‌آید که دو نشانهٔ مستقل از آن با هم بخوانند (پیش‌نیازها را ببینید)؛ اگر خطی در بالا می‌گوید پنلی نیمه‌نصب است، نصب همان پنل را کامل یا تعمیر کنید. Row-Template باید روی همان سروری نصب شود که پنل روی آن است. برای 3X-UI، نصب‌کننده دنبال /usr/local/x-ui/x-ui، /usr/local/bin/x-ui، فرمان x-ui در PATH یا سرویس systemd با نام x-ui.service می‌گردد؛ 3X-UIی که داخل کانتینر یا با نام دیگری نصب شده پیدا نمی‌شود.

فعال‌سازی شکست خورد و بازگردانده شد

در PasarGuard و Rebecca فعال‌سازی یک تراکنش است: اگر مرحله‌ای شکست بخورد، تنظیمات پنل از عکس فوری‌ای که درست پیش از آن گرفته شده بازگردانده می‌شوند و این را می‌بینید: … was restored exactly to its state before the attempt. خود Row-Template نصب باقی می‌ماند. علت را در خط panel pasarguard: یا panel rebecca: بالای آن بخوانید — اغلب پنلی که ری‌استارت نشد، یا CUSTOM_TEMPLATES_DIRECTORYی بیرون از پوشه‌ای که کانتینر به اشتراک می‌گذارد — آن را برطرف کنید، سپس row-template را اجرا کنید و 5 — Activate / Re-apply theme را انتخاب کنید.

اپ‌های VPN به‌جای پیکربندی، HTML دریافت می‌کنند

verify گزارش می‌دهد VPN-client check: HTML was returned instead of subscription content. پنل از روی درخواست تصمیم می‌گیرد چه چیزی بفرستد، پس چیزی جلوی آن درخواست را تغییر می‌دهد — معمولاً پراکسی یا CDNی که هدرهای User-Agent یا Accept را بازنویسی یا حذف می‌کند. اجازه دهید این درخواست‌ها بدون تغییر به پنل برسند.

صفحه نمایش داده می‌شود اما ارقام هرگز به‌روز نمی‌شوند

صفحه برای به‌روزرسانی، ارقام را از پنل شما می‌پرسد: در 3X-UI نشانی خودش را با ?format=info، و در PasarGuard و Rebecca نشانی /<token>/info پنل را (1.4.0؛ در 1.3.x این دو پنل اصلاً به‌روز نمی‌شدند). اگر یک reverse proxy رشتهٔ پرس‌وجو را حذف کند یا آن نشانی را به پنل نرساند، صفحه ارقامی را که با آن‌ها ارائه شده نگه می‌دارد و پانویسش می‌گوید Live updates stopped. یا Live updates are not available on this panel (در صفحهٔ فارسی: «به‌روزرسانی زنده متوقف شد.» یا «به‌روزرسانی زنده در این پنل در دسترس نیست»). این نشانی را هم مثل خود نشانی اشتراک به پنل برسانید. پاسخی که صفحه نشناسد عمداً به‌روزرسانی را متوقف می‌کند؛ بارگذاری دوبارهٔ صفحه آن را دوباره شروع می‌کند.

فعال‌سازی خودکار در دسترس نیست

3X-UI: Automatic activation is unavailable here (sqlite3 is not installed). یا sqlite3 را نصب کنید و از گزینهٔ 5 — Activate / Re-apply theme در منوی مدیریت استفاده کنید، یا Sub Theme Directory را دستی در پنل تنظیم کنید. هر دو به یک اندازه خوب‌اند. اگر sqlite3 نصب است اما پایگاه‌داده پیدا نمی‌شود — مثلاً چون جای غیرمعمولی است — به Row-Template بگویید کجاست:
```
XUI_DB_FOLDER=/opt/x-ui/db row-template
```
Rebecca: Automatic activation is unavailable here; the page will be placed for you to select. Rebecca از MySQL/MariaDB استفاده می‌کند یا sqlite3 نصب نیست. دو مقداری را که چاپ می‌کند در Settings → Subscription → Templates وارد کنید. فعال‌سازی را ببینید.

پایگاه‌دادهٔ 3X-UI رد شد

panel database is not an SQLite database: … (not falling back to another database; …). اولین فایل پایگاه‌داده‌ای که Row-Template پیدا کرد فایل SQLite معتبری نیست و Row-Template فایل دیگری را حدس نمی‌زند. با XUI_DB_FOLDER پوشهٔ درست را نشانش دهید، یا اگر مطمئنید آن فایل قدیمی استفاده نمی‌شود، حذفش کنید. تا آن زمان دستی فعال کنید.

سرور به GitHub دسترسی ندارد

cannot fetch manifest.txt from the release source. یا could not obtain a verified release. از روی سرور curl -I https://github.com را بررسی کنید. اگر GitHub مسدود است، از پوشهٔ محلی نصب یا به‌روزرسانی کنید.

پس از به‌روزرسانی از 1.1.0 طرح‌ها وجود ندارند

پس از row-template update از 1.1.0، دفعهٔ بعد که row-template را باز می‌کنید یا row-template config یا row-template verify را با root اجرا می‌کنید، نسخهٔ جدید پیش از هر کاری بقیهٔ همان نسخه — همهٔ طرح‌ها — را دانلود می‌کند. اگر منو می‌گوید No templates are installed, and they could not be restored automatically، آن دانلود شکست خورده و پیام بالای آن علتش را می‌گوید: مطمئن شوید سرور به منبع نسخه دسترسی دارد و منو را دوباره باز کنید، یا row-template update را اجرا کنید. چرا ←

تغییر برندینگ نمایش داده نمی‌شود

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

لوگو رد می‌شود

unsupported image: only PNG, JPEG or WebP by content — محتوای فایل فرمت دیگری است؛ تغییر نام فایده ندارد. آن را تبدیل کنید، مثلاً با ImageMagick: convert logo.svg -resize 256x256 logo.png.
logo too large: … bytes (max 262144) — فایل بیش از ۲۵۶ کیلوبایت است. اندازه‌اش را کوچک کنید یا به WebP ذخیره‌اش کنید.
logo path is a symlink; refusing to read it — مسیر خود فایل واقعی را بدهید.

پرچم‌ها در ویندوز دوحرفی نمایش داده می‌شوند

به 1.4.0 به‌روزرسانی کنید: از آن پس صفحه فونت پرچم خودش را همراه دارد و پرچم هر کشوری در ویندوز هم نمایش داده می‌شود. در 1.3.x، مرورگرهای مبتنی بر Chromium روی ویندوز برای همهٔ کشورها به‌جز شش کشور کدی مثل DE نشان می‌دادند، چون ویندوز خودش پرچمی ندارد.

اگر برچسب فقط یک حرف دارد، مونوگرام است: نام نود نه ایموجی پرچم دارد و نه کد دوحرفی کشوری که جدا آمده باشد (TR | Istanbul، DE-FRA-2)، یا آن کد مال هیچ کشوری نیست. نام کشورها و شهرها خوانده نمی‌شوند؛ پرچم یا کد را در نام نود در پنل خود بگذارید.

`row-template: command not found`

فرمان در /usr/local/bin/row-template است. اگر /usr/local/bin در PATH شما نیست، آن را با مسیر کاملش صدا بزنید. اگر فایل وجود ندارد، نصب‌کننده را دوباره اجرا کنید: نصب را در همان جا تعمیر می‌کند و پیکربندی شما را نگه می‌دارد.

منوی مدیریت می‌گوید «Installation damaged»

فایل‌هایی وجود ندارند یا صفحهٔ زنده در اعتبارسنجی رد شده است. 3 — Verify را اجرا کنید تا ببینید کدام، سپس با اجرای دوبارهٔ نصب‌کننده یا row-template update تعمیرش کنید.

درخواست کمک

در github.com/iitzSeriZdev/Row-Template/issues یک issue باز کنید و این‌ها را بیاورید:

خروجی row-template version و row-template verify؛
پنل شما و نسخهٔ آن؛
سیستم‌عامل، نسخه و معماری پردازنده؛
چه کردید، چه انتظار داشتید و چه اتفاقی افتاد.

هرگز اطلاعات محرمانه نگذارید

لینک‌های اشتراک، مقادیر subId، UUID کلاینت‌ها، نام کاربری یا رمز پنل، کوکی‌ها، توکن‌ها، webBasePath پنل، محتوای .env، نشانی پایگاه‌داده، کلیدهای TLS یا نشانی واقعی سرورها را نگذارید. verify و version هرگز هیچ‌کدام از این‌ها را چاپ نمی‌کنند، اما لاگ‌های دیگر ممکن است — آن‌ها را پاک کنید.