راهنما و عیب‌یابی

مرجع خطاها

همهٔ خطاها و هشدارهایی که نصب‌کننده و فرمان row-template نسخهٔ 1.4.0 ممکن است چاپ کنند — روی 3X-UI، PasarGuard و Rebecca — ترجمهٔ کامل، معنی، علت و راه حل هر کدام.

این صفحه همهٔ پیام‌هایی را فهرست می‌کند که نصب‌کننده و فرمان row-template به‌عنوان خطا یا هشدار چاپ می‌کنند — از جمله آداپتورهای پنل و موتور تراکنش فعال‌سازی — مستقیماً از کد منبع نسخهٔ 1.4.0. متن پیام‌ها همان‌طور که در ترمینال می‌بینید به انگلیسی آمده و ترجمهٔ فارسی هر کدام زیر آن است. بخشی از پیام را (به انگلیسی یا فارسی) در کادر جست‌وجو وارد کنید تا پیدایش کنید؛ نام‌ها، مسیرها و عددهایی که در هر اجرا فرق می‌کنند به‌صورت مورب نمایش داده شده‌اند.

پیام‌ها در ترمینال این‌طور دیده می‌شوند:

پیشوند چاپ‌شده توسط معنی
install: راه‌انداز، یعنی install.sh، پیش از بارگذاری کتابخانه دانلود یا بررسی آن متوقف شد. چیزی نصب نشده است.
FAIL کتابخانهٔ مدیریتی عملیاتی متوقف شد، یا verify یک مشکل جدی پیدا کرد.
warn کتابخانهٔ مدیریتی ارزش توجه دارد؛ عملیات ادامه پیدا کرد.
row-template: راه‌انداز فرمان فرمان نتوانست کتابخانه‌اش را بارگذاری کند.

پیام‌های آداپتور پنل پس از برچسب FAIL یا warn نام پنل را دارند — panel pasarguard: یا panel rebecca: — و پیام‌های موتور فعال‌سازی با transaction: شروع می‌شوند. پیام‌هایی که نام پنل، مسیر یا نسخه‌ای را می‌آورند، آن را مورب نشان می‌دهند: روی سرور شما مقدار واقعی چاپ می‌شود، مثل PasarGuard یا پوشهٔ نصب (/etc/3x-ui/sub_templates/row-template در 3X-UI و /etc/row-template در PasarGuard و Rebecca).

امتناع‌ها بررسی ایمنی‌اند

بسیاری از این پیام‌ها یعنی Row-Template عمداً از انجام کاری ناامن خودداری کرده است. علتی را که پیام نام می‌برد برطرف کنید — هرگز سعی نکنید آن را دور بزنید. وقتی عملیاتی متوقف می‌شود، صفحه‌ای که مشترکان می‌بینند همان‌طور که بود می‌ماند، مگر اینکه پیام چیز دیگری بگوید.

432 پیام

سرور و پنل

install:FAIL

the installer must run as root (e.g. sudo bash install.sh).this operation must run as root (e.g. sudo row-template ...)

ترجمه: نصب‌کننده باید با کاربر root اجرا شود (مثلاً sudo bash install.sh). / این عملیات باید با root اجرا شود (مثلاً sudo row-template ...)

معنی

نصب و هر فرمانی که چیزی را در سیستم تغییر می‌دهد (config، update، rollback، uninstall و منوی مدیریت) به دسترسی root نیاز دارد. هیچ تغییری اعمال نشده است.

راه حل

  1. با sudo -i یک پوستهٔ root باز کنید و فرمان را دوباره اجرا کنید.
  2. برای نصب یک‌خطی از sudo bash <(curl …) استفاده نکنید؛ sudo توصیف‌گر فایلی را که <(…) می‌سازد می‌بندد. اول root شوید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template uninstallمنوی مدیریت
install:

required tool not found: ‹ابزار›

ترجمه: ابزار لازم پیدا نشد: ‹ابزار›

معنی

نصب‌کننده برای بررسی و باز کردن نسخه به tar و sha256sum (یا shasum) نیاز دارد و یکی از آن‌ها نصب نیست. چیزی دانلود یا تغییر داده نشده است.

راه حل

  1. ابزار ناموجود را نصب کنید — در Debian و Ubuntu: apt-get install -y tar coreutils؛ در خانوادهٔ RHEL: dnf install -y tar coreutils.
  2. نصب‌کننده را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

no sha256 tool (sha256sum or shasum) found

ترجمه: هیچ ابزار sha256 (یعنی sha256sum یا shasum) پیدا نشد

معنی

Row-Template هر فایلی را که نصب می‌کند با SHA-256 بررسی می‌کند و ابزاری برای محاسبهٔ آن پیدا نکرد. عملیات پیش از هر تغییری متوقف شد.

راه حل

بستهٔ coreutils را (که sha256sum را دارد) نصب کنید و فرمان را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
FAIL

no 3x-ui installation was detected on this host.

ترجمه: هیچ نصبی از 3x-ui روی این سرور پیدا نشد.

معنی

Row-Template قرار بود به 3X-UI سرویس بدهد — چون RT_PANEL=3xui تنظیم شده یا چون نصب روی این سرور به 3X-UI سرویس می‌دهد — اما نه فایل اجرایی 3X-UI را پیدا کرد (/usr/local/x-ui/x-ui، /usr/local/bin/x-ui یا x-ui در PATH) و نه سرویس systemd با نام x-ui.service را. هیچ تغییری اعمال نشده است.

راه حل

  1. نصب‌کننده را روی همان سروری اجرا کنید که پنل 3X-UI روی آن است.
  2. از نصب بودن پنل مطمئن شوید: ls -l /usr/local/x-ui/x-ui و systemctl status x-ui.
  3. پنلی که داخل کانتینر یا با نام دیگری نصب شده باشد پشتیبانی نمی‌شود.
  4. اگر این سرور PasarGuard یا Rebecca را اجرا می‌کند، RT_PANEL=3xui را تنظیم نکنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

cannot determine the 3x-ui version; refusing to proceed

ترجمه: نسخهٔ 3x-ui مشخص نشد؛ ادامه نمی‌دهم

معنی

3X-UI پیدا شد، اما نسخهٔ آن از خروجی x-ui -v خوانده نشد. Row-Template روی پنلی که نسخه‌اش را نمی‌تواند تأیید کند نصب نمی‌شود. هیچ تغییری اعمال نشده است.

راه حل

  1. فرمان /usr/local/x-ui/x-ui -v را اجرا کنید و ببینید نسخه‌ای مثل 3.7.0 چاپ می‌کند یا نه.
  2. اگر خطا داد، اول 3X-UI را تعمیر یا دوباره نصب کنید و بعد نصب‌کننده را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

3x-ui ‹نسخه› is below the required minimum 3.6.0; not installing3x-ui ‹نسخه› is below the minimum 3.6.0.

ترجمه: نسخهٔ ‹نسخه› از 3x-ui پایین‌تر از حداقل لازم یعنی 3.6.0 است؛ نصب انجام نمی‌شود / نسخهٔ ‹نسخه› از 3x-ui پایین‌تر از حداقل 3.6.0 است.

معنی

Row-Template روی 3X-UI به نسخهٔ 3.6.0 یا جدیدتر نیاز دارد و پنل شما قدیمی‌تر است. نصب‌کننده بدون هیچ تغییری متوقف می‌شود و verify آن را خطای جدی گزارش می‌کند.

راه حل

3X-UI را به نسخهٔ 3.6.0 یا جدیدتر به‌روز کنید و نصب‌کننده (یا row-template verify) را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template verify
warn

XUI_DB_FOLDER database is not an SQLite database: ‹مسیر› (not falling back to another database)

ترجمه: پایگاه‌دادهٔ XUI_DB_FOLDER یک پایگاه‌دادهٔ SQLite نیست: ‹مسیر› (به پایگاه‌دادهٔ دیگری مراجعه نمی‌شود)

معنی

پوشه‌ای که XUI_DB_FOLDER نشان می‌دهد فایل x-ui.db معتبری از نوع SQLite ندارد. Row-Template آن را رد می‌کند و عمداً سراغ مسیر دیگری نمی‌رود، چون ممکن است متعلق به نصب دیگری باشد. در این حالت تنظیم پنل فقط به‌صورت دستی ممکن است.

راه حل

  1. مطمئن شوید این پوشه همان پوشه‌ای است که پنل استفاده می‌کند و x-ui.db داخل آن پایگاه‌دادهٔ فعال است.
  2. مقدار XUI_DB_FOLDER را اصلاح یا حذف کنید و فرمان را دوباره اجرا کنید.
  3. یا Sub Theme Directory را خودتان در پنل تنظیم کنید — فعال‌سازی را ببینید.
کجا دیده می‌شود:نصب‌کنندهrow-template verifyrow-template uninstallمنوی مدیریت
warn

panel database is not an SQLite database: ‹مسیر› (not falling back to another database; set XUI_DB_FOLDER to the panel's database folder)

ترجمه: پایگاه‌دادهٔ پنل از نوع SQLite نیست: ‹مسیر› (به پایگاه‌دادهٔ دیگری مراجعه نمی‌شود؛ XUI_DB_FOLDER را روی پوشهٔ پایگاه‌دادهٔ پنل تنظیم کنید)

معنی

اولین پایگاه‌دادهٔ پنل که در مسیرهای پیش‌فرض پیدا شد (به ترتیب /etc/x-ui/x-ui.db، /usr/local/x-ui/x-ui.db و /etc/3x-ui/x-ui.db) فایل SQLite معتبری نیست. این فایل رد می‌شود و عمداً مسیر بعدی امتحان نمی‌شود. تا این مشکل حل نشود، فعال‌سازی خودکار و بررسی‌های subThemeDir در دسترس نیستند.

راه حل

  1. پایگاه‌داده‌ای را که پنل واقعاً استفاده می‌کند پیدا کنید و فرمان را با XUI_DB_FOLDER=/path/to/its/folder اجرا کنید.
  2. اگر فایل نام‌برده باقی‌ماندهٔ قدیمی است، جابه‌جایش کنید — فقط وقتی مطمئن هستید پنل از آن استفاده نمی‌کند.
  3. یا Sub Theme Directory را دستی در پنل تنظیم کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template verifyrow-template uninstallمنوی مدیریت

انتخاب پنل

FAIL

no supported panel was detected on this host: no 3x-ui installation, and no PasarGuard or Rebecca installation.

ترجمه: هیچ پنل پشتیبانی‌شده‌ای روی این سرور پیدا نشد: نه نصبی از 3x-ui و نه نصبی از PasarGuard یا Rebecca.

معنی

نصب‌کننده هر سه پنل پشتیبانی‌شده را جست‌وجو کرد و هیچ‌کدام را پیدا نکرد. یک پنل فقط وقتی نصب‌شده به حساب می‌آید که دو نشانهٔ مستقل از آن با هم بخوانند — مثلاً پیکربندی و سرویسش، یا فایل compose و پوشهٔ داده‌اش. هیچ تغییری اعمال نشده است.

راه حل

  1. نصب‌کننده را روی سروری که پنل شما روی آن است و با root اجرا کنید.
  2. اول پنل را با نصب‌کنندهٔ رسمی خودش نصب کنید. Rebecca باید نسخهٔ 1.x با نصب باینری باشد.
  3. اگر خطی در بالا می‌گوید پنلی *نیمه‌نصب* به نظر می‌رسد، نصب آن پنل را کامل یا تعمیر کنید و نصب‌کننده را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کننده
warn

‹پنل› looks partly installed (only one of its files was found); it is not treated as present.

ترجمه: ‹پنل› نیمه‌نصب به نظر می‌رسد (فقط یکی از فایل‌هایش پیدا شد)؛ موجود به حساب نمی‌آید.

معنی

فقط یک نشانه از این پنل پیدا شد — مثلاً فایل پیکربندی بدون سرویس، یا پوشهٔ داده بدون فایل compose. Row-Template هرگز دربارهٔ پنل نیمه‌نصب حدس نمی‌زند، پس آن را موجود حساب نمی‌کند. این پیام به‌تنهایی فقط هشدار است؛ خط بعد می‌گوید آیا به‌جای آن پنل دیگری پیدا شد یا نه.

راه حل

  1. اگر این پنل باید نصب باشد، نصبش را با نصب‌کنندهٔ رسمی خودش کامل یا تعمیر کنید و نصب‌کننده را دوباره اجرا کنید.
  2. اگر باقی‌ماندهٔ پنلی است که حذف کرده‌اید، می‌توانید این هشدار را نادیده بگیرید.
کجا دیده می‌شود:نصب‌کننده
FAIL

more than one panel is installed here (‹پنل‌ها›); choose one with RT_PANEL=3xui|pasarguard|rebecca.

ترجمه: بیش از یک پنل اینجا نصب است (‹پنل‌ها›)؛ یکی را با RT_PANEL=3xui|pasarguard|rebecca انتخاب کنید.

معنی

بیش از یک پنل پشتیبانی‌شده روی این سرور نصب است و نصب‌کننده بدون ترمینال اجرا شده، پس نمی‌تواند بپرسد به کدام سرویس بدهد. نصب تازهٔ اسکریپتی روی چنین سروری باید پنل را نام ببرد. هیچ تغییری اعمال نشده است.

راه حل

  1. نصب‌کننده را دوباره با RT_PANEL اجرا کنید و پنلی را که Row-Template باید به آن سرویس بدهد نام ببرید، مثلاً RT_PANEL=pasarguard.
  2. یا آن را در ترمینال اجرا کنید و پنل را از فهرست انتخاب کنید. متغیرهای محیطی را ببینید.
کجا دیده می‌شود:نصب‌کننده
FAIL

RT_PANEL='‹مقدار›' is not a panel Row-Template supports (3xui, pasarguard, rebecca).RT_PANEL=‹مقدار›, but ‹پنل› was not detected on this host.

ترجمه: RT_PANEL='‹مقدار›' پنلی نیست که Row-Template پشتیبانی کند (3xui، pasarguard، rebecca). / RT_PANEL=‹مقدار›، اما ‹پنل› روی این سرور پیدا نشد.

معنی

RT_PANEL پنلی را نام می‌برد که نصب برای آن انجام می‌شود. مقدارش باید دقیقاً 3xui، pasarguard یا rebecca باشد و آن پنل باید روی همین سرور نصب باشد. هیچ تغییری اعمال نشده است.

راه حل

  1. مقدار را اصلاح کنید — با حروف کوچک و بدون فاصله — یا روی سروری که فقط یک پنل دارد آن را حذف کنید.
  2. اگر پنل نصب است اما پیدا نمی‌شود، بررسی کنید با نصب‌کنندهٔ رسمی خودش نصب شده باشد (برای Rebecca: نصب باینری نسخهٔ 1.x).
کجا دیده می‌شود:نصب‌کننده
FAIL

no panel was chosen; nothing was changed.

ترجمه: هیچ پنلی انتخاب نشد؛ هیچ تغییری اعمال نشد.

معنی

انتخابگر پنل بدون انتخاب رها شد (مثلاً با 0 یا با پایان ورودی). هیچ تغییری اعمال نشده است.

راه حل

نصب‌کننده را دوباره اجرا کنید و پنلی را که Row-Template باید به آن سرویس بدهد انتخاب کنید.

کجا دیده می‌شود:نصب‌کننده
FAIL

Row-Template is installed for ‹پنل› at ‹پوشهٔ نصب›; uninstall it before installing for ‹پنل›.

ترجمه: Row-Template برای ‹پنل› در ‹پوشهٔ نصب› نصب شده است؛ پیش از نصب برای ‹پنل›، آن را حذف کنید.

معنی

هر نصب فقط به یک پنل سرویس می‌دهد. Row-Template روی این سرور برای پنل اول نصب شده و RT_PANEL پنل دیگری را خواسته است. اجرای دوباره یا به‌روزرسانی همیشه پنلی را که نصب برای آن انجام شده حفظ می‌کند. هیچ تغییری اعمال نشده است.

راه حل

  1. برای ادامهٔ سرویس به پنل فعلی، نصب‌کننده (یا row-template update) را بدون RT_PANEL اجرا کنید.
  2. برای سرویس دادن به پنل دیگر، اول row-template uninstall را اجرا کنید — پنل فعلی را به صفحهٔ خودش برمی‌گرداند — و بعد دوباره با RT_PANEL نصب کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

Row-Template is installed twice (‹مسیر› and ‹مسیر›); remove one with 'row-template uninstall' before continuing.

ترجمه: Row-Template دو بار نصب شده است (‹مسیر› و ‹مسیر›)؛ پیش از ادامه، یکی را با row-template uninstall حذف کنید.

معنی

هر دو پوشهٔ نصب وجود دارند — /etc/3x-ui/sub_templates/row-template (3X-UI) و /etc/row-template (PasarGuard و Rebecca) — و هر کدام فایل VERSION دارند. انتخاب اینکه کدام مدیریت شود حدس خواهد بود، پس تا یکی حذف نشود کاری انجام نمی‌شود.

راه حل

  1. تصمیم بگیرید کدام نصب را نگه می‌دارید. با row-template version ببینید فرمان الان کدام پنل را مدیریت می‌کند.
  2. دیگری را حذف کنید: برای نصبی که فرمان مدیریت می‌کند row-template uninstall را اجرا کنید، یا اگر دیگری باقی‌ماندهٔ قدیمی است، پس از اطمینان از اینکه پنلش دیگر از آن استفاده نمی‌کند، پوشه‌اش را دستی جابه‌جا کنید.
کجا دیده می‌شود:نصب‌کننده
warn

the panel record ‹مسیر› is not a panel this release knows; treating the install as 3X-UI.

ترجمه: رکورد پنل در ‹مسیر› پنلی نیست که این نسخه بشناسد؛ نصب به‌عنوان 3X-UI در نظر گرفته می‌شود.

معنی

هر نصب پنلی را که به آن سرویس می‌دهد در فایلی به نام PANEL ثبت می‌کند. این فایل مقداری دارد که این نسخه نمی‌شناسد — دستی ویرایش یا خراب شده — پس نصب مانند نصب 3X-UI مدیریت می‌شود.

راه حل

اگر این نصب به PasarGuard یا Rebecca سرویس می‌دهد، تا درست شدن رکورد فرمانی روی آن اجرا نکنید: آن را حذف و دوباره نصب کنید، یا مقدار فایل را به pasarguard یا rebecca برگردانید.

کجا دیده می‌شود:هر فرمانی
FAIL

nothing was changed.

ترجمه: هیچ تغییری اعمال نشد.

معنی

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

راه حل

مشکلی را که در خط بالا نام برده شده برطرف کنید و نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کننده
FAIL

could not record the panel this install serves.

ترجمه: پنلی که این نصب به آن سرویس می‌دهد ثبت نشد.

معنی

فایلی که ثبت می‌کند این نصب به کدام پنل سرویس می‌دهد (PANEL در پوشهٔ نصب) نوشته نشد — معمولاً به‌دلیل پر بودن دیسک یا فقط‌خواندنی بودن فایل‌سیستم. نصب پیش از فعال کردن هر چیزی متوقف شد.

راه حل

df -h /etc و قابل نوشتن بودن /etc را بررسی کنید و نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کننده

دانلود و بررسی نسخه

install:

curl is required to download the release.curl is required for RT_RELEASE_URL.

ترجمه: برای دانلود نسخه به curl نیاز است. / برای RT_RELEASE_URL به curl نیاز است.

معنی

نسخه با curl دانلود می‌شود و curl نصب نیست. هیچ تغییری اعمال نشده است.

راه حل

  1. آن را نصب کنید — apt-get install -y curl یا dnf install -y curl — و نصب‌کننده را دوباره اجرا کنید.
  2. یا با RT_RELEASE_DIR از یک پوشهٔ محلی نصب کنید که به curl نیازی ندارد: نصب دستی.
کجا دیده می‌شود:نصب‌کننده
install:FAIL

RT_RELEASE_URL must use https:// (set RT_ALLOW_INSECURE_URL=1 to override for local testing).the release URL must use https:// (set RT_ALLOW_INSECURE_URL=1 to override for local testing).

ترجمه: RT_RELEASE_URL باید از https:// استفاده کند (برای آزمایش محلی می‌توانید RT_ALLOW_INSECURE_URL=1 را تنظیم کنید).

معنی

RT_RELEASE_URL به یک نشانی http:// اشاره می‌کند. نسخه‌ها فقط از طریق HTTPS دریافت می‌شوند تا کسی در مسیر شبکه نتواند فایل‌ها را عوض کند. چیزی دانلود نشده است.

راه حل

  1. آینهٔ (mirror) خود را روی HTTPS ارائه کنید و نشانی https:// آن را بدهید.
  2. RT_ALLOW_INSECURE_URL=1 فقط برای آزمایش محلی است — روی سرور اصلی از آن استفاده نکنید.
کجا دیده می‌شود:نصب‌کنندهrow-template updateمنوی مدیریت
install:FAIL

RT_RELEASE_URL must be an http(s) URL.the release URL must be an http(s) URL: ‹نشانی›

ترجمه: RT_RELEASE_URL باید یک نشانی http(s) باشد. / نشانی نسخه باید یک نشانی http(s) باشد: ‹نشانی›

معنی

مقدار RT_RELEASE_URL نشانی وب نیست. چیزی دانلود نشده است.

راه حل

  1. نشانی پوشه‌ای را بدهید که فایل‌های نسخه در آن است، مثلاً https://mirror.example.com/row-template/1.3.0.
  2. برای پوشه‌ای روی خود سرور، به‌جای آن از RT_RELEASE_DIR استفاده کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template updateمنوی مدیریت
warn

the release URL uses http:// (insecure); proceeding because RT_ALLOW_INSECURE_URL is set.

ترجمه: نشانی نسخه از http:// (ناامن) استفاده می‌کند؛ چون RT_ALLOW_INSECURE_URL تنظیم شده، ادامه می‌دهم.

معنی

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

راه حل

فقط برای آزمایش محلی از آن استفاده کنید. روی سرور واقعی RT_ALLOW_INSECURE_URL را حذف کنید و نسخه‌ها را روی HTTPS ارائه دهید.

کجا دیده می‌شود:row-template updateمنوی مدیریت
install:FAIL

cannot create a work directory.

ترجمه: پوشهٔ کاری ساخته نشد.

معنی

پوشهٔ موقتی برای دانلود ساخته نشد — معمولاً چون /tmp پر است یا قابل نوشتن نیست. هیچ تغییری اعمال نشده است.

راه حل

  1. فضای آزاد را با df -h /tmp بررسی کنید و فضا آزاد کنید.
  2. از قابل نوشتن بودن /tmp مطمئن شوید و فرمان را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

cannot fetch manifest.txt from the release source.cannot fetch manifest.txt

ترجمه: manifest.txt از منبع نسخه دریافت نشد.

معنی

اولین فایل نسخه دانلود نشد — منبع نسخه در دسترس نیست. اگر از RT_RELEASE_DIR استفاده کرده‌اید، آن پوشه فایل manifest.txt ندارد. هیچ تغییری اعمال نشده است.

راه حل

  1. دسترسی سرور به GitHub را بررسی کنید: curl -I https://github.com.
  2. اگر GitHub مسدود است، از یک پوشهٔ محلی نصب یا به‌روزرسانی کنید — نصب دستی را ببینید.
  3. با RT_RELEASE_DIR، مطمئن شوید پوشه فایل‌های manifest.txt، SHA256SUMS و tarball را دارد.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

cannot fetch SHA256SUMS from the release source.cannot fetch SHA256SUMS

ترجمه: SHA256SUMS از منبع نسخه دریافت نشد.

معنی

فایل چک‌سام نسخه دانلود نشد و بدون آن هیچ چیزی نصب نمی‌شود. هیچ تغییری اعمال نشده است.

راه حل

  1. دوباره امتحان کنید — ممکن است اتصال قطع شده باشد.
  2. با RT_RELEASE_DIR، فایل SHA256SUMS نسخه را در آن پوشه کپی کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

manifest.txt has no artifact= entry.manifest has no artifact= entry

ترجمه: manifest.txt ورودی artifact= ندارد.

معنی

فایل manifest.txt مشخص نمی‌کند کدام آرشیو باید باز شود، پس manifest نسخهٔ Row-Template نیست. هیچ تغییری اعمال نشده است.

راه حل

  1. manifest.txt را دوباره از صفحهٔ رسمی نسخه دانلود کنید.
  2. اگر از آینه استفاده می‌کنید، مطمئن شوید همان فایل اصلی نسخه را بدون تغییر آپلود کرده‌اید.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

manifest artifact name is unsafe: ‹فایل›manifest artifact name is unsafe: ‹فایل›

ترجمه: نام آرشیو در manifest ناامن است: ‹فایل›

معنی

نام آرشیو در manifest.txt شامل / یا .. است که می‌تواند به بیرون از پوشهٔ دانلود اشاره کند؛ پس رد می‌شود. هیچ تغییری اعمال نشده است.

راه حل

از manifest.txt رسمی و دست‌نخورده استفاده کنید. چنین manifestی را هیچ نسخهٔ Row-Template تولید نمی‌کند.

کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

cannot fetch the release artifact: ‹فایل›cannot fetch ‹فایل›

ترجمه: آرشیو نسخه دریافت نشد: ‹فایل›

معنی

آرشیو نسخه‌ای که در manifest نام برده شده دانلود نشد، یا در پوشهٔ RT_RELEASE_DIR نیست. هیچ تغییری اعمال نشده است.

راه حل

  1. دوباره امتحان کنید — دانلودهای بزرگ روی اتصال کند ممکن است به مهلت زمانی بخورند.
  2. با RT_RELEASE_DIR، مطمئن شوید tarball با همان نامی که در manifest.txt آمده در پوشه است.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

no checksum for ‹فایل› in SHA256SUMS; refusing to proceed.no checksum for ‹فایل› in SHA256SUMS; aborting (no override exists)

ترجمه: هیچ چک‌سامی برای ‹فایل› در SHA256SUMS نیست؛ ادامه نمی‌دهم.

معنی

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

راه حل

  1. مطمئن شوید SHA256SUMS و tarball هر دو متعلق به یک نسخه‌اند.
  2. هر دو را دوباره از صفحهٔ نسخه دانلود کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:

checksum for ‹فایل› is not 64 hex characters.

ترجمه: چک‌سام ‹فایل› ۶۴ نویسهٔ هگزادسیمال نیست.

معنی

چک‌سامی که برای آرشیو ثبت شده مقدار SHA-256 معتبری نیست؛ پس SHA256SUMS خراب است یا فایل نسخه نیست. هیچ تغییری اعمال نشده است.

راه حل

SHA256SUMS را دوباره از صفحهٔ نسخه دانلود کنید.

کجا دیده می‌شود:نصب‌کننده
install:FAIL

release checksum verification failed; aborting (no --skip exists).release checksum verification failed; aborting

ترجمه: بررسی چک‌سام نسخه ناموفق بود؛ عملیات لغو شد (گزینه‌ای برای رد شدن از آن وجود ندارد).

معنی

آرشیو دانلودشده با چک‌سام منتشرشده‌اش یکی نیست: دانلود ناقص یا خراب است، یا همان فایل منتشرشده نیست. آرشیو باز نشد و هیچ تغییری اعمال نشده است.

راه حل

  1. فرمان را دوباره اجرا کنید — بیشتر این موارد دانلودهای نیمه‌کاره‌اند.
  2. اگر باز هم خطا داد، چهار فایل نسخه را دستی دانلود کنید و با sha256sum -c SHA256SUMS بررسی کنید (نصب دستی).
  3. هرگز سعی نکنید این بررسی را دور بزنید: همین بررسی است که جلوی نصب نسخهٔ دست‌کاری‌شده با دسترسی root را می‌گیرد.
کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

unsafe path in archive: ‹مسیر›

ترجمه: مسیر ناامن در آرشیو: ‹مسیر›

معنی

آرشیو شامل مسیر مطلق یا مسیری با .. است که می‌تواند بیرون از پوشهٔ استخراج بنویسد؛ پیش از استخراج رد می‌شود. نسخه‌های رسمی هرگز چنین مسیری ندارند.

راه حل

از فایل‌های رسمی نسخه استفاده کنید و آن‌ها را دوباره از صفحهٔ نسخه دانلود کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template update
install:FAIL

unsafe member type in archive: '‹نوع›'unsafe member type in archive: '‹نوع›' (symlink/hardlink/special refused)

ترجمه: نوع عضو ناامن در آرشیو: ‹نوع› (پیوند نمادین، پیوند سخت و فایل ویژه پذیرفته نمی‌شوند)

معنی

آرشیو شامل پیوند نمادین (symlink)، پیوند سخت یا فایل ویژه است. چنین پیوندی می‌تواند نوشتن بعدی را به بیرون از پوشهٔ استخراج هدایت کند، پس آرشیو پیش از استخراج رد می‌شود.

راه حل

از فایل‌های رسمی نسخه استفاده کنید. نسخه‌های رسمی فقط فایل و پوشهٔ معمولی دارند.

کجا دیده می‌شود:نصب‌کنندهrow-template update
install:

could not extract the release artifact.

ترجمه: آرشیو نسخه استخراج نشد.

معنی

tar نتوانست آرشیو بررسی‌شده را باز کند — معمولاً به‌دلیل پر بودن دیسک. چیزی نصب نشده است.

راه حل

فضای آزاد را با df -h /tmp /etc بررسی کنید، فضا آزاد کنید و نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کننده
install:

extracted payload has no lib/row-template.sh.

ترجمه: محتوای استخراج‌شده فایل lib/row-template.sh ندارد.

معنی

آرشیو بررسی و باز شد، اما کتابخانهٔ مدیریتی ندارد؛ پس نسخهٔ Row-Template نیست. چیزی نصب نشده است.

راه حل

بررسی کنید manifest.txt به tarball خود Row-Template اشاره کند و از فایل‌های رسمی نسخه استفاده کنید.

کجا دیده می‌شود:نصب‌کننده
install:

unexpected error (line ‹خط›); nothing was committed.

ترجمه: خطای پیش‌بینی‌نشده (خط ‹خط›)؛ هیچ تغییری ثبت نشد.

معنی

یکی از فرمان‌های داخل راه‌انداز (bootstrap) به شکلی شکست خورد که پیام مشخصی برایش وجود ندارد. راه‌انداز فقط دانلود و بررسی می‌کند، پس چیزی نصب نشده است.

راه حل

  1. نصب‌کننده را دوباره اجرا کنید؛ قطع شدن شبکه می‌تواند باعث این خطا شود.
  2. اگر تکرار شد، با خروجی کامل و شمارهٔ خط یک issue باز کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

internal: install payload directory missing.

ترجمه: داخلی: پوشهٔ محتوای نصب وجود ندارد.

معنی

کتابخانه بدون پوشهٔ نسخهٔ استخراج‌شده اجرا شده است. این فقط وقتی پیش می‌آید که rt_cmd_install دستی و بدون آرگومان اجرا شود. هیچ تغییری اعمال نشده است.

راه حل

به‌جای فراخوانی مستقیم کتابخانه، از طریق install.sh نصب کنید.

کجا دیده می‌شود:نصب‌کننده
FAIL

install payload has no template.html.the release payload has no template.html.

ترجمه: محتوای نسخه فایل template.html ندارد.

معنی

نسخهٔ استخراج‌شده فایل template.html ندارد، پس نسخهٔ کامل Row-Template نیست. هیچ تغییری اعمال نشده است.

راه حل

نسخه را دوباره دانلود کنید و مطمئن شوید manifest.txt و tarball مال یک نسخه‌اند.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

payload artifact checksum mismatch.

ترجمه: چک‌سام فایل صفحه در محتوای نسخه مطابقت ندارد.

معنی

فایل صفحهٔ داخل نسخه با چک‌سامی که در SHA256SUMS داخلی همان نسخه آمده یکی نیست؛ یعنی آرشیو پس از ساخت تغییر کرده است. هیچ تغییری اعمال نشده است.

راه حل

از فایل‌های رسمی و دست‌نخوردهٔ نسخه استفاده کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

install artifact failed structural validation.the release artifact failed structural validation.

ترجمه: فایل صفحهٔ نسخه در اعتبارسنجی ساختاری رد شد.

معنی

صفحهٔ داخل نسخه یک صفحهٔ کامل Row-Template نیست (بخش ساخت صفحه را ببینید). هیچ تغییری اعمال نشده است.

راه حل

نسخه را دوباره از صفحهٔ رسمی نسخه دانلود کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

the release payload declares an invalid companion: ‹مسیر›the release payload is incomplete: ‹مسیر› is missing.payload checksum mismatch: ‹مسیر›the release payload is incomplete; nothing was changed.

ترجمه: محتوای نسخه یک فایل همراه نامعتبر اعلام کرده: ‹مسیر› / محتوای نسخه ناقص است: ‹مسیر› وجود ندارد. / چک‌سام محتوا مطابقت ندارد: ‹مسیر› / محتوای نسخه ناقص است؛ هیچ چیزی تغییر نکرد.

معنی

کتابخانهٔ مدیریتی نسخه فایل‌های همراهی دارد (lib/transaction.sh و panels/) که باید با آن نصب شوند. یکی از آن‌ها وجود ندارد، چک‌سامش نمی‌خواند، یا با مسیر نامعتبر اعلام شده است؛ پس کل نسخه رد می‌شود — نصب کتابخانهٔ جدید بدون همراهانش row-template را خراب می‌کرد. هیچ تغییری اعمال نشده است.

راه حل

  1. نسخه را دوباره دانلود کنید؛ هر چهار فایل باید از یک نسخه باشند.
  2. اگر نسخه را خودتان ساخته‌اید، آن را با tools/make-release.sh بسازید که فایل‌های همراه را هم بسته‌بندی می‌کند.
کجا دیده می‌شود:نصب‌کنندهrow-template update
warn

payload template directory is not a plain id: ‹شناسه› (skipped)payload template ‹شناسه› has no ‹فایل› (skipped)

ترجمه: پوشهٔ تمپلیت در محتوای نسخه شناسهٔ ساده‌ای نیست: ‹شناسه› (نادیده گرفته شد) / تمپلیت ‹شناسه› در محتوای نسخه ‹فایل› ندارد (نادیده گرفته شد)

معنی

یکی از پوشه‌های templates/ در نسخه تمپلیتی نیست که Row-Template بشناسد، یا صفحه‌ای برای پنل این سرور ندارد، پس نادیده گرفته می‌شود. بقیهٔ تمپلیت‌ها معمولی نصب می‌شوند.

راه حل

برای نسخهٔ رسمی کاری لازم نیست. اگر خودتان پوشه‌ای به نسخه اضافه کرده‌اید، حذفش کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

payload template ‹شناسه› has no checksum sidecarpayload template ‹شناسه› failed its checksumpayload template ‹شناسه› failed structural validation

ترجمه: تمپلیت ‹شناسه› در محتوای نسخه فایل چک‌سام ندارد / چک‌سام تمپلیت ‹شناسه› مطابقت ندارد / تمپلیت ‹شناسه› در اعتبارسنجی ساختاری رد شد

معنی

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

راه حل

نسخه را دوباره از صفحهٔ رسمی نسخه دانلود کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

the release template store failed verification; nothing was activated.the release template store failed verification.

ترجمه: مخزن تمپلیت‌های نسخه در بررسی رد شد؛ چیزی فعال نشد.

معنی

پس از یکی از پیام‌های تمپلیت در بالا می‌آید: یکی از تمپلیت‌های نسخه بررسی نشد. چیزی فعال نشده و صفحه‌ای که مشترکان می‌بینند تغییری نکرده است.

راه حل

پیامی را که درست پیش از این چاپ شده برطرف کنید — معمولاً با دانلود دوبارهٔ نسخه.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

could not obtain a verified release.

ترجمه: نسخهٔ بررسی‌شده‌ای به دست نیامد.

معنی

row-template update نتوانست نسخه را دانلود، بررسی یا باز کند. علت در خط بالاتر چاپ شده است. هیچ تغییری اعمال نشده است.

راه حل

  1. خطایی را که درست پیش از این چاپ شده برطرف کنید.
  2. اگر به GitHub دسترسی ندارید، از پوشهٔ محلی به‌روزرسانی کنید: RT_RELEASE_DIR=/path row-template update.
کجا دیده می‌شود:row-template update
FAIL

payload template ‹شناسه› is not a ‹پنل› page

ترجمه: تمپلیت ‹شناسه› در محتوای نسخه صفحه‌ای برای ‹پنل› نیست

معنی

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

راه حل

نسخه را دوباره از صفحهٔ رسمی نسخه دانلود کنید؛ هر چهار فایل باید از یک نسخه باشند.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

this release carries no ‹پنل› pages; nothing was activated.this release carries no ‹پنل› pages; nothing was changed.

ترجمه: این نسخه هیچ صفحه‌ای برای ‹پنل› ندارد؛ چیزی فعال نشد. / …؛ هیچ تغییری اعمال نشد.

معنی

نسخه هیچ صفحه‌ای ندارد که برای پنل این سرور ساخته شده باشد. هر نسخه از 1.3.0 به بعد صفحه‌هایی برای 3X-UI، PasarGuard و Rebecca دارد؛ نسخه‌های پیش از 1.3.0 هیچ صفحه‌ای برای PasarGuard یا Rebecca ندارند. پس نسخه ناقص است یا برای این پنل قدیمی است. چیزی فعال نشد و صفحه‌ای که مشترکان می‌بینند تغییری نکرده است.

راه حل

  1. از Row-Template نسخهٔ 1.3.0 یا جدیدتر استفاده کنید — آن را دوباره از صفحهٔ رسمی نسخه دانلود کنید.
  2. اگر از RT_RELEASE_DIR یا RT_RELEASE_URL استفاده می‌کنید، مطمئن شوید به نسخهٔ 1.3.0 یا جدیدتر اشاره می‌کنند.
کجا دیده می‌شود:نصب‌کنندهrow-template update

نصب

FAIL

ترجمه: ریشهٔ نصب یک پیوند نمادین است؛ ادامه نمی‌دهم.

معنی

پوشهٔ نصب — /etc/3x-ui/sub_templates/row-template در 3X-UI و /etc/row-template در PasarGuard و Rebecca — یک پیوند نمادین (symlink) است. Row-Template هرگز از طریق symlink نمی‌نویسد، چون می‌تواند نوشتن با دسترسی root را به هر جایی هدایت کند. هیچ تغییری اعمال نشده است.

راه حل

  1. پیوند را با یک پوشهٔ واقعی جایگزین کنید — مثلاً در 3X-UI: rm /etc/3x-ui/sub_templates/row-template && mkdir -p /etc/3x-ui/sub_templates/row-template (در PasarGuard و Rebecca مسیر /etc/row-template است).
  2. اگر می‌خواهید فایل‌ها روی دیسک دیگری باشند، به‌جای پیوند، آن دیسک را روی همین مسیر bind-mount کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

an existing install was found at ‹پوشهٔ نصب›; re-run interactively or set RT_ASSUME_YES=1 to repair.

ترجمه: نصب قبلی در ‹پوشهٔ نصب› پیدا شد؛ برای تعمیر، نصب‌کننده را به‌صورت تعاملی اجرا کنید یا RT_ASSUME_YES=1 را تنظیم کنید.

معنی

Row-Template از قبل نصب است و نصب‌کننده بدون ترمینال اجرا شده؛ پس بدون رضایت صریح شما نصب را تعمیر نمی‌کند. هیچ تغییری اعمال نشده است.

راه حل

  1. برای رفتن به آخرین نسخه، row-template update را اجرا کنید.
  2. برای تعمیر در همان جا (برندینگ و تمپلیت حفظ می‌شوند و اول پشتیبان گرفته می‌شود)، نصب‌کننده را با RT_ASSUME_YES=1 دوباره اجرا کنید، یا آن را در ترمینال اجرا کنید و 4 — Repair / Verify را انتخاب کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

could not create the install tree.

ترجمه: ساختار پوشه‌های نصب ساخته نشد.

معنی

پوشه‌های پوشهٔ نصب (/etc/3x-ui/sub_templates/row-template در 3X-UI و /etc/row-template در PasarGuard و Rebecca) ساخته نشدند — معمولاً به‌دلیل پر بودن دیسک، فقط‌خواندنی بودن /etc یا وجود یک فایل به‌جای پوشه.

راه حل

  1. فضای آزاد را با df -h /etc بررسی کنید.
  2. مطمئن شوید پوشهٔ والد (/etc/3x-ui/sub_templates در 3X-UI و در غیر این صورت /etc) پوشه‌ای قابل نوشتن است (نه فایل) و نصب‌کننده را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کننده
warn

could not create a pre-install backup.

ترجمه: پشتیبانِ پیش از نصب ساخته نشد.

معنی

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

راه حل

فضای آزاد دیسک زیر /etc را بررسی کنید و پس از پایان نصب، row-template verify را اجرا کنید.

کجا دیده می‌شود:نصب‌کننده
FAIL

could not install the canonical artifact.could not install VERSION.

ترجمه: فایل اصلی صفحه نصب نشد. / فایل VERSION نصب نشد.

معنی

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

راه حل

df -h /etc و قابل نوشتن بودن /etc را بررسی کنید و نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کننده
warn

could not install the management library; the CLI may be unavailable.could not install the row-template CLI to /usr/local/bin/row-template.

ترجمه: کتابخانهٔ مدیریتی نصب نشد؛ ممکن است فرمان row-template در دسترس نباشد. / فرمان row-template در /usr/local/bin/row-template نصب نشد.

معنی

صفحه نصب شده، اما کتابخانهٔ مدیریتی یا فرمان row-template نوشته نشد؛ پس ممکن است بعداً نتوانید نصب را مدیریت کنید.

راه حل

  1. فضای آزاد و وجود و قابل نوشتن بودن /usr/local/bin را بررسی کنید.
  2. نصب‌کننده را دوباره اجرا کنید؛ نصب را در همان جا تعمیر می‌کند.
کجا دیده می‌شود:نصب‌کننده
warn

could not install the management library's companions; run 'row-template update' to retry.

ترجمه: فایل‌های همراه کتابخانهٔ مدیریتی نصب نشدند؛ برای تلاش دوباره row-template update را اجرا کنید.

معنی

فایل‌های همراه کتابخانهٔ مدیریتی (lib/transaction.sh و panels/) نوشته نشدند. صفحه کار می‌کند، اما verify نصب را ناقص گزارش می‌کند.

راه حل

فضای آزاد را بررسی کنید و بعد row-template update را اجرا کنید تا آن‌ها را نصب کند.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template verifyمنوی مدیریت
FAIL

configuration was not completed; the panel was not changed.

ترجمه: پیکربندی کامل نشد؛ پنل تغییری نکرد.

معنی

مرحلهٔ برندینگ شکست خورد — خط بالا می‌گوید کدام مقدار رد شده است (نام سرویس، نشانی پشتیبانی یا لوگو). پنل و صفحهٔ زنده تغییری نکرده‌اند.

راه حل

  1. مقداری را که درست در بالا نام برده شده اصلاح کنید و نصب‌کننده را دوباره اجرا کنید.
  2. در نصب بدون پرسش، مقادیر RT_SERVICE_NAME، RT_SUPPORT_URL و RT_LOGO_PATH را بررسی کنید.
کجا دیده می‌شود:نصب‌کننده
FAIL

RT_TEMPLATE='‹مقدار›' is not a template this release offers (available: row editorial canvas prism terminal pulse brutal arcade sketch signature saffron pulsenova prismnova terminalnova arcadenova meter notebook).

ترجمه: مقدار ‹مقدار› در RT_TEMPLATE تمپلیتی نیست که این نسخه ارائه کند (موجود: row editorial canvas prism terminal pulse brutal arcade sketch signature saffron pulsenova prismnova terminalnova arcadenova meter notebook).

معنی

شناسهٔ تمپلیت در RT_TEMPLATE جزو تمپلیت‌های این نسخه نیست. نصب به‌جای استفادهٔ بی‌صدا از Row متوقف می‌شود.

راه حل

یکی از شناسه‌های داخل پیام را بدهید — با حروف کوچک و بدون فاصله، مثلاً RT_TEMPLATE=pulsenova. جدول مقایسه همه را فهرست کرده است.

کجا دیده می‌شود:نصب‌کننده
warn

selected template '‹شناسه›' is not in this release's template store; using Row.

ترجمه: تمپلیت انتخاب‌شدهٔ '‹شناسه›' در مخزن تمپلیت‌های این نسخه نیست؛ از Row استفاده می‌شود.

معنی

هنگام تعمیر، تمپلیتی که در پیکربندی شما ذخیره شده جزو این نسخه نیست؛ پس Row نصب می‌شود.

راه حل

بعداً از منوی مدیریت تمپلیت دیگری انتخاب کنید: 2 — Reconfigure branding → 4 — Template.

کجا دیده می‌شود:نصب‌کننده
FAIL

template '‹شناسه›' is not in this release's template store.could not stage the selected template.

ترجمه: تمپلیت '‹شناسه›' در مخزن تمپلیت‌های این نسخه نیست. / تمپلیت انتخاب‌شده آماده نشد.

معنی

تمپلیت انتخاب‌شده از مخزن تمپلیتی که همین حالا نصب شد برداشته نشد — مخزن ناقص است یا دیسک پر است. صفحهٔ زنده جایگزین نشده است.

راه حل

فضای آزاد دیسک را بررسی کنید و نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کننده
FAIL

could not persist the template selection.

ترجمه: انتخاب تمپلیت ذخیره نشد.

معنی

تمپلیت انتخابی شما در config.env ذخیره نشد. نصب پیش از فعال‌سازی متوقف می‌شود و به‌روزرسانی پس از آماده‌سازی نسخهٔ جدید اما پیش از فعال‌سازی آن؛ پس صفحهٔ زنده تغییری نکرده است.

راه حل

فضای آزاد و قابل نوشتن بودن config.env را بررسی کنید و همان فرمان را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template update
FAIL

the template failed to generate/validate; the panel was not changed.

ترجمه: ساخت یا اعتبارسنجی تمپلیت شکست خورد؛ پنل تغییری نکرد.

معنی

صفحه از روی تمپلیت و برندینگ شما ساخته نشد یا در اعتبارسنجی رد شد؛ علت در خط بالا آمده است. صفحهٔ زنده جایگزین نشده و تنظیم پنل دست نخورده است.

راه حل

مشکلی را که درست در بالا نام برده شده برطرف کنید — اغلب برندینگی با نویسهٔ کنترلی یا لوگوی ناخوانا — و نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کننده
warn

Choose 1-‹n›, or press Enter for Row.

ترجمه: عددی بین 1 و ‹n› وارد کنید، یا برای Row کلید Enter را بزنید.

معنی

انتخابگر تمپلیت چیزی غیر از یکی از شماره‌های فهرست دریافت کرده است.

راه حل

شمارهٔ کنار تمپلیت را وارد کنید، یا برای ماندن روی Row کلید Enter را بزنید.

کجا دیده می‌شود:نصب‌کننده

فعال‌سازی و بررسی زنده

warn

Could not set subThemeDir automatically; use the manual step below.

ترجمه: subThemeDir به‌صورت خودکار تنظیم نشد؛ از مرحلهٔ دستی زیر استفاده کنید.

معنی

نصب‌کننده سعی کرد از طریق پایگاه‌دادهٔ پنل آن را به Row-Template متصل کند، اما نتوانست موفقیت را تأیید کند. مطمئن شده است که سرویس پنل دوباره در حال اجراست. خود Row-Template نصب شده است.

راه حل

Panel Settings → Subscription → Sub Theme Directory را روی /etc/3x-ui/sub_templates/row-template بگذارید، ذخیره کنید و پنل را ری‌استارت کنید. فعال‌سازی را ببینید.

کجا دیده می‌شود:نصب‌کننده
warn

Could not set the theme automatically; the panel service state was preserved.

ترجمه: پوسته به‌صورت خودکار تنظیم نشد؛ وضعیت سرویس پنل حفظ شد.

معنی

گزینهٔ Activate / Re-apply theme در منوی مدیریت نتوانست subThemeDir را تنظیم کند. سرویس پنل در حال اجرا ماند (یا دوباره اجرا شد).

راه حل

همان‌طور که منوی مدیریت نشان می‌دهد، Sub Theme Directory را دستی در پنل تنظیم کنید.

کجا دیده می‌شود:منوی مدیریت
warn

Automatic activation is unavailable here (sqlite3 is not installed).

ترجمه: فعال‌سازی خودکار اینجا در دسترس نیست (sqlite3 نصب نیست).

معنی

تنظیم پنل خوانده نشد، پس منوی مدیریت نمی‌تواند آن را برای شما تنظیم کند. پیام علت معمول را می‌گوید — نصب نبودن sqlite3 — اما وقتی پایگاه‌دادهٔ پنل پیدا نشود هم نمایش داده می‌شود.

راه حل

  1. همان‌طور که نشان داده می‌شود، Sub Theme Directory را دستی در پنل تنظیم کنید.
  2. یا sqlite3 را نصب کنید (و اگر پایگاه‌داده در مسیر غیرمعمولی است، XUI_DB_FOLDER را تنظیم کنید) و دوباره 5 — Activate / Re-apply theme را انتخاب کنید.
کجا دیده می‌شود:منوی مدیریت
warn

Live check: the panel served its built-in page. If you just set the theme dir, restart the panel; otherwise run 'row-template verify'.

ترجمه: بررسی زنده: پنل صفحهٔ داخلی خودش را ارائه کرد. اگر همین حالا پوشهٔ پوسته را تنظیم کرده‌اید، پنل را ری‌استارت کنید؛ وگرنه row-template verify را اجرا کنید.

معنی

یک درخواست آزمایشی مانند مرورگر، صفحهٔ خود پنل را برگرداند، نه Row-Template را. یا پنل هنوز پوشهٔ پوستهٔ جدید را اعمال نکرده، یا اصلاً تنظیم نشده است.

راه حل

  1. اگر همین حالا تنظیمش کرده‌اید: پنل را ری‌استارت کنید (systemctl restart x-ui).
  2. در غیر این صورت row-template verify را اجرا کنید و خط مربوط به subThemeDir را ببینید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
warn

Live check could not reach the subscription endpoint.

ترجمه: بررسی زنده به نشانی اشتراک دسترسی پیدا نکرد.

معنی

درخواست آزمایشی به نشانی اشتراک روی همین سرور پاسخی نگرفت. این فقط یک هشدار است و خود نصب موفق بوده است.

راه حل

  1. در حال اجرا بودن پنل را بررسی کنید: systemctl status x-ui.
  2. مطمئن شوید سرویس اشتراک پنل فعال است و گوش می‌دهد، سپس row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
warn

Live check: a VPN client received HTML instead of subscription content.

ترجمه: بررسی زنده: یک کلاینت VPN به‌جای محتوای اشتراک، HTML دریافت کرد.

معنی

درخواستی آزمایشی که مانند اپ VPN ارسال شد، به‌جای پیکربندی صفحهٔ وب را دریافت کرد. در این حالت اپ‌های VPN نمی‌توانند اشتراک را به‌روز کنند.

راه حل

  1. بررسی کنید پراکسی یا CDNی که جلوی پنل است هدرهای User-Agent یا Accept را تغییر ندهد و آن‌ها را دست‌نخورده عبور دهد.
  2. برای تکرار بررسی row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

the installer's panel components are missing; run 'row-template update'.

ترجمه: اجزای پنل نصب‌کننده وجود ندارند؛ row-template update را اجرا کنید.

معنی

ساخت یا فعال‌سازی صفحه روی PasarGuard یا Rebecca به فایل‌های همراه نصب‌کننده (lib/transaction.sh و panels/) نیاز دارد و این فایل‌ها وجود ندارند — مثلاً درست پس از آنکه به‌روزرسان خود 1.1.0 نسخهٔ جدیدتری را نصب کرده است. هیچ تغییری اعمال نشده است.

راه حل

row-template update را اجرا کنید تا آن‌ها را نصب کند و بعد دوباره امتحان کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

could not update the page in ‹پنل›'s template directory.could not put the previous page back at ‹مسیر›.

ترجمه: صفحه در پوشهٔ تمپلیت‌های ‹پنل› به‌روز نشد. / صفحهٔ قبلی به ‹مسیر› بازگردانده نشد.

معنی

روی PasarGuard و Rebecca صفحه در پوشهٔ نصب ساخته و سپس در پوشهٔ تمپلیت‌های خود پنل کپی می‌شود. این کپی شکست خورد، پس صفحهٔ ساخته‌شدهٔ قبلی سر جایش برگردانده شد و پنل همان صفحهٔ قبلی را ارائه می‌کند. پیام دوم یعنی برگرداندن صفحهٔ قبلی هم شکست خورده است.

راه حل

  1. علت را در خط بالا ببینید — اغلب پر بودن دیسک یا پوشهٔ تمپلیتی که پیوند نمادین است.
  2. آن را برطرف کنید و همان فرمان را دوباره اجرا کنید؛ سپس row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
warn

activation on ‹پنل› did not complete; the panel was restored to how it was.Activation did not complete; ‹پنل› was restored to how it was.‹پنل› was restored exactly to its state before the attempt.Activation did not complete and was rolled back; run 'row-template' and choose Activate to retry.

ترجمه: فعال‌سازی روی ‹پنل› کامل نشد؛ پنل به حالت قبلش بازگردانده شد. / ‹پنل› دقیقاً به وضعیت پیش از تلاش بازگردانده شد. / فعال‌سازی کامل نشد و بازگردانده شد؛ برای تلاش دوباره row-template را اجرا کنید و Activate را انتخاب کنید.

معنی

فعال‌سازی روی PasarGuard و Rebecca یک تراکنش است: از تنظیمات پنل عکس فوری (snapshot) گرفته می‌شود، تغییر اعمال و بررسی می‌شود، و اگر هر مرحله شکست بخورد تنظیمات از روی همان عکس فوری بازگردانده می‌شوند. اینجا همین اتفاق افتاد. پیام restored exactly to its state before the attempt یعنی بازگردانی با خواندن دوبارهٔ وضعیت پنل و مقایسه با عکس فوری تأیید شده است؛ اگر خود بازگردانی شکست خورده بود، خطوط بالا به‌جای آن rollback also failed را نشان می‌دادند (توضیح همان پیام را ببینید). خود Row-Template نصب باقی می‌ماند.

راه حل

  1. در خطوط درست بالاتر ببینید کدام مرحله شکست خورد — مثلاً پنل ری‌استارت نشد، یا پنلِ در حال اجرا صفحه را اعمال نکرد.
  2. علت را برطرف کنید، سپس row-template را اجرا کنید و 5 — Activate / Re-apply theme را انتخاب کنید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
FAIL

could not place the page for ‹پنل›.

ترجمه: صفحه برای ‹پنل› جای‌گذاری نشد.

معنی

فعال‌سازی خودکار اینجا ممکن نیست (Rebecca با MySQL/MariaDB یا بدون sqlite3)، پس Row-Template فقط صفحه را در پوشهٔ تمپلیت‌های پنل می‌گذارد تا خودتان انتخابش کنید — و گذاشتن صفحه شکست خورد. هیچ چیزی در پنل تغییر نکرده است.

راه حل

علت را در خط بالا ببینید، برطرفش کنید و دوباره در منوی مدیریت 5 — Activate / Re-apply theme را انتخاب کنید.

کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
warn

Automatic activation is unavailable here; the page will be placed for you to select.

ترجمه: فعال‌سازی خودکار اینجا در دسترس نیست؛ صفحه گذاشته می‌شود تا خودتان انتخابش کنید.

معنی

تنظیمات اشتراک Rebecca اینجا نوشته نمی‌شوند — پنل از MySQL/MariaDB استفاده می‌کند یا sqlite3 نصب نیست — پس منوی مدیریت صفحه را می‌گذارد و دو مقداری را که باید در داشبورد Rebecca وارد شوند چاپ می‌کند.

راه حل

در داشبورد Rebecca Settings → Subscription → Templates را باز کنید و مقادیر نمایش‌داده‌شده را وارد کنید. فعال‌سازی را ببینید.

کجا دیده می‌شود:منوی مدیریت
FAIL

the page could not be generated; nothing was changed.

ترجمه: صفحه ساخته نشد؛ هیچ تغییری اعمال نشد.

معنی

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

راه حل

مشکلی را که درست در بالا نام برده شده برطرف کنید — اغلب برندینگ یا فضای دیسک — و دوباره 5 — Activate / Re-apply theme را انتخاب کنید.

کجا دیده می‌شود:منوی مدیریت
warn

Live check: the running ‹پنل› does not use the Row-Template page yet; run 'row-template verify'.

ترجمه: بررسی زنده: ‹پنل›ِ در حال اجرا هنوز از صفحهٔ Row-Template استفاده نمی‌کند؛ row-template verify را اجرا کنید.

معنی

پس از یک تغییر، از پنلِ در حال اجرا پرسیده شد کدام صفحهٔ اشتراک را ارائه می‌کند و هنوز صفحهٔ Row-Template نیست. روی PasarGuard معمولاً یعنی پنل از زمان تغییر .env ری‌استارت نشده است.

راه حل

  1. row-template verify را اجرا کنید — می‌گوید چه چیزی نمی‌خواند.
  2. روی PasarGuard پنل را با pasarguard restart ری‌استارت کنید و دوباره بررسی کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

transaction: template placement failed for panel '‹پنل›' (status ‹وضعیت›)transaction: static verification did not pass for panel '‹پنل›' (status ‹وضعیت›)transaction: live verification failed for panel '‹پنل›' (status ‹وضعیت›)

ترجمه: تراکنش: گذاشتن تمپلیت برای پنل '‹پنل›' شکست خورد (وضعیت ‹وضعیت›) / تراکنش: بررسی ایستا برای پنل '‹پنل›' رد شد / تراکنش: بررسی زنده برای پنل '‹پنل›' شکست خورد

معنی

مرحله‌ای از تراکنش فعال‌سازی که شکست خورد: گذاشتن صفحه در پوشهٔ تمپلیت‌های پنل و انتخاب آن، بررسی فایل‌ها و تنظیمات پنل پس از آن، یا پرسیدن از پنلِ در حال اجرا که کدام صفحه را ارائه می‌کند. هر کدام باعث می‌شود تراکنش پنل را از روی عکس فوری‌اش بازگرداند؛ پیام بعدی می‌گوید این کار موفق بود یا نه.

راه حل

  1. پیام خودِ آداپتور را درست در بالا بخوانید (با panel pasarguard: یا panel rebecca: شروع می‌شود) — مشکل دقیق را نام می‌برد.
  2. آن را برطرف کنید و در منوی مدیریت 5 — Activate / Re-apply theme را انتخاب کنید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
warn

transaction: live verification was unavailable for panel '‹پنل›'; this is not a rollback triggertransaction: live verification does not apply to panel '‹پنل›'

ترجمه: تراکنش: بررسی زنده برای پنل '‹پنل›' در دسترس نبود؛ این دلیلی برای بازگردانی نیست / تراکنش: بررسی زنده برای پنل '‹پنل›' کاربرد ندارد

معنی

آخرین مرحلهٔ فعال‌سازی از پنلِ در حال اجرا می‌پرسد کدام صفحه را ارائه می‌کند. اینجا نمی‌شد پرسید، و این شکست حساب نمی‌شود: فعال‌سازی برقرار می‌ماند و فایل‌ها و تنظیمات پیش‌تر بررسی شده‌اند.

راه حل

کاری لازم نیست. برای بررسی صفحه‌ای که مشترکان می‌گیرند، یک لینک اشتراک را در مرورگر باز کنید، یا row-template verify را با RT_SMOKE_URL برابر یک لینک اشتراک اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
FAIL

transaction: the safety snapshot could not be created; nothing was changedtransaction: the safety snapshot did not validate; nothing was changed

ترجمه: تراکنش: عکس فوری ایمنی ساخته نشد؛ هیچ تغییری اعمال نشد / تراکنش: عکس فوری ایمنی در بررسی رد شد؛ هیچ تغییری اعمال نشد

معنی

فعال‌سازی پیش از هر تغییری روی PasarGuard یا Rebecca از تنظیمات پنل یک عکس فوری می‌گیرد (زیر backups.v2/ در پوشهٔ نصب). عکس فوری نوشته نشد یا از بررسی خودش عبور نکرد، پس فعال‌سازی متوقف شد. هیچ تغییری اعمال نشده است.

راه حل

  1. فضای آزاد را با df -h /etc بررسی کنید و مطمئن شوید هیچ چیز زیر پوشهٔ نصب پیوند نمادین نیست.
  2. هر خطی را در بالا که با panel شروع می‌شود یا نام عکس فوری را آورده بخوانید و دوباره فعال‌سازی کنید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
FAIL

transaction: another transaction holds the lock (‹مسیر›)transaction: flock is not available; refusing to run without single-flight protection

ترجمه: تراکنش: تراکنش دیگری قفل را در اختیار دارد (‹مسیر›) / تراکنش: flock در دسترس نیست؛ بدون محافظت اجرای تک‌نمونه اجرا نمی‌شود

معنی

در هر لحظه فقط یک فعال‌سازی می‌تواند اجرا شود، پس هر کدام روی نصب قفل می‌گیرد. یک فرمان row-template دیگر همین حالا در حال تغییر پنل است — یا flock (از بستهٔ util-linux) نصب نیست و فعال‌سازی بدون این محافظت اجرا نمی‌شود. هیچ تغییری اعمال نشده است.

راه حل

  1. صبر کنید فرمان دیگر تمام شود و دوباره امتحان کنید.
  2. اگر flock نصب نیست، util-linux را نصب کنید: apt-get install -y util-linux یا dnf install -y util-linux.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
FAIL

transaction: the original failure was status ‹وضعیت›transaction: rollback also failed (‹علت›); the panel was left as the failed attempt left ittransaction: no further recovery is attempted automatically

ترجمه: تراکنش: خطای اصلی وضعیت ‹وضعیت› بود / تراکنش: بازگردانی هم شکست خورد (‹علت›)؛ پنل همان‌طور ماند که تلاش ناموفق رهایش کرد / تراکنش: بازیابی خودکار دیگری انجام نمی‌شود

معنی

فعال‌سازی شکست خورد و بازگرداندن پنل از روی عکس فوری‌اش هم شکست خورد. ممکن است تنظیمات پنل نیمه‌کاره تغییر کرده باشند. این وضعیت به دو شکست مستقل نیاز دارد و خطوط بالا هر دو را نام می‌برند.

راه حل

  1. برای دیدن اینکه پنل الان چه چیزی را انتخاب کرده row-template verify را اجرا کنید.
  2. پنل را دستی برگردانید: روی PasarGuard بلوک # >>> row-template را از /opt/pasarguard/.env حذف کنید و pasarguard restart را اجرا کنید؛ روی Rebecca در Settings → Subscription → Templates مقدار Subscription page template را به صفحهٔ قبلی خودتان برگردانید.
  3. سپس با خروجی کامل گزارش دهید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
warn

transaction: live verification after rollback was not available (status ‹وضعیت›)transaction: live verification after rollback did not pass (status ‹وضعیت›)

ترجمه: تراکنش: بررسی زنده پس از بازگردانی در دسترس نبود (وضعیت ‹وضعیت›) / تراکنش: بررسی زنده پس از بازگردانی رد شد (وضعیت ‹وضعیت›)

معنی

پس از بازگرداندن پنل از روی عکس فوری، تراکنش از پنلِ در حال اجرا می‌پرسد کدام صفحه را ارائه می‌کند. این بررسی اجرا نشد یا نخواند — معمولاً چون ری‌استارت PasarGuard هنوز تمام نشده است. خود بازگردانی با خواندن دوبارهٔ تنظیمات ذخیره‌شده سنجیده می‌شود که پیام بعدی گزارش می‌دهد.

راه حل

یک دقیقه بعد، وقتی پنل دوباره بالا آمد، row-template verify را اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت

PasarGuard

FAIL

panel pasarguard: the Row-Template block in ‹مسیر› is damaged; fix or remove it by handpanel pasarguard: the Row-Template block in .env is damagedpanel pasarguard: the Row-Template block in .env is damaged; fix or remove it by hand

ترجمه: پنل pasarguard: بلوک Row-Template در ‹مسیر› خراب است؛ آن را دستی اصلاح یا حذف کنید / پنل pasarguard: بلوک Row-Template در .env خراب است

معنی

Row-Template صفحه‌اش را با یک بلوک نشان‌دار در انتهای /opt/pasarguard/.env انتخاب می‌کند، از # >>> row-template تا # <<< row-template <<<. این بلوک ناقص است یا ویرایش شده — مثلاً یکی از خطوط نشانگرش وجود ندارد — پس Row-Template به‌جای خطر دست زدن به خطوط خودتان، .env را بازنویسی نمی‌کند. هیچ تغییری اعمال نشده است.

راه حل

  1. /opt/pasarguard/.env را باز کنید و خطوط row-template را پیدا کنید.
  2. کل بلوک را حذف کنید — هر دو خط نشانگر و دو خط میان آن‌ها — یا آن را دقیقاً بازگردانید، و فرمان را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت
FAIL

ترجمه: پنل pasarguard: فایل .env وجود ندارد یا پیوند نمادین است: ‹مسیر›

معنی

فایل .env پنل PasarGuard (در /opt/pasarguard) وجود ندارد یا یک پیوند نمادین است. Row-Template فقط در .env واقعی می‌نویسد، پس هیچ تغییری اعمال نشده است.

راه حل

نصب PasarGuard خود را بررسی کنید: ls -l /opt/pasarguard/.env. پیوند نمادین را با فایل واقعی جایگزین کنید و فرمان را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت
FAIL

panel pasarguard: CUSTOM_TEMPLATES_DIRECTORY is not a plain absolute path: ‹مسیر›panel pasarguard: ‹مسیر› is outside /var/lib/pasarguard, the directory the container shares with the host

ترجمه: پنل pasarguard: CUSTOM_TEMPLATES_DIRECTORY یک مسیر مطلق ساده نیست: ‹مسیر› / پنل pasarguard: ‹مسیر› بیرون از /var/lib/pasarguard است، پوشه‌ای که کانتینر با میزبان به اشتراک می‌گذارد

معنی

Row-Template صفحه‌اش را در CUSTOM_TEMPLATES_DIRECTORY خودِ شما در .env می‌گذارد. این مقدار باید یک مسیر مطلق ساده باشد و در نصب Docker باید داخل /var/lib/pasarguard باشد — تنها پوشه‌ای که کانتینر با میزبان به اشتراک می‌گذارد؛ صفحه در هر جای دیگری هرگز به چشم پنل نمی‌آید. هیچ تغییری اعمال نشده است.

راه حل

  1. CUSTOM_TEMPLATES_DIRECTORY را روی یک مسیر مطلق زیر /var/lib/pasarguard بگذارید — یا خط خودتان را حذف کنید تا مقدار پیش‌فرض /var/lib/pasarguard/templates استفاده شود.
  2. اگر آن را تغییر دادید PasarGuard را ری‌استارت کنید و فرمان را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyrow-template uninstallمنوی مدیریت
FAIL

ترجمه: پنل pasarguard: پوشهٔ تمپلیت‌ها پیوند نمادین است: ‹مسیر› / ‹مسیر› پیوند نمادین است / ‹مسیر› وجود دارد و مال Row-Template نیست؛ دست‌نخورده ماند

معنی

صفحه در row-template/index.html داخل پوشهٔ تمپلیت‌های PasarGuard قرار می‌گیرد. یا آن پوشه (یا پوشهٔ row-template داخلش) پیوند نمادین است، یا فایلی که Row-Template نساخته از قبل در همان مسیر هست. Row-Template هرگز از طریق پیوند نمی‌نویسد و هرگز فایلی را که مال خودش نیست بازنویسی نمی‌کند. هیچ تغییری اعمال نشده است.

راه حل

  1. پیوند را با یک پوشهٔ واقعی جایگزین کنید.
  2. اگر row-template/index.html موجود مال شماست، آن را جای دیگری ببرید؛ سپس فرمان را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

panel pasarguard: the panel could not be restarted

ترجمه: پنل pasarguard: پنل ری‌استارت نشد

معنی

PasarGuard فایل .env را فقط هنگام شروع می‌خواند، پس Row-Template پس از تغییر آن، پنلِ در حال اجرا را یک بار ری‌استارت می‌کند — در نصب Docker با docker compose up -d و در نصب از سورس با systemctl restart pasarguard. این کار شکست خورد. هنگام فعال‌سازی، تغییر سپس بازگردانده می‌شود؛ هنگام حذف، بلوک پیش‌تر حذف شده و پنل دفعهٔ بعد که شروع شود آن را اعمال می‌کند.

راه حل

  1. پنل را بررسی کنید: pasarguard status در نصب رسمی (Docker)، یا systemctl status pasarguard در نصب از سورس.
  2. خودتان آن را ری‌استارت کنید (pasarguard restart) و row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template uninstallمنوی مدیریت
FAIL

panel pasarguard: the running panel does not use the Row-Template page yet (restart it)panel pasarguard: the running panel cannot see ‹مسیر›/row-template/index.html

ترجمه: پنل pasarguard: پنلِ در حال اجرا هنوز از صفحهٔ Row-Template استفاده نمی‌کند (ری‌استارتش کنید) / پنل pasarguard: پنلِ در حال اجرا ‹مسیر›/row-template/index.html را نمی‌بیند

معنی

بررسی زنده از کانتینرِ در حال اجرای PasarGuard می‌پرسد از کدام صفحه استفاده می‌کند و آیا فایل صفحه را می‌بیند. یا کانتینر هنوز تنظیم قبلی را دارد — از زمان تغییر .env دوباره ساخته نشده — یا صفحه داخل کانتینر دیده نمی‌شود؛ یعنی پوشهٔ تمپلیت‌ها در پوشه‌ای نیست که کانتینر با میزبان به اشتراک می‌گذارد.

راه حل

  1. PasarGuard را ری‌استارت کنید (pasarguard restart) و row-template verify را دوباره اجرا کنید.
  2. اگر صفحه هنوز دیده نمی‌شود، بررسی کنید CUSTOM_TEMPLATES_DIRECTORY شما زیر /var/lib/pasarguard باشد.
کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
FAIL

panel pasarguard: the page is not in place: ‹مسیر›panel pasarguard: the placed page differs from the generated onepanel pasarguard: .env does not select the Row-Template page

ترجمه: پنل pasarguard: صفحه سر جایش نیست: ‹مسیر› / صفحهٔ گذاشته‌شده با صفحهٔ ساخته‌شده فرق دارد / .env صفحهٔ Row-Template را انتخاب نمی‌کند

معنی

PasarGuard برای Row-Template تنظیم شده، اما اجزا دیگر با هم نمی‌خوانند: صفحه در پوشهٔ تمپلیت‌ها نیست، نسخهٔ موجود آنجا همان صفحه‌ای نیست که Row-Template آخرین بار ساخته، یا .env دیگر آن را انتخاب نمی‌کند (بلوک حذف شده، یا خطی از خودتان پایین‌تر دوباره SUBSCRIPTION_PAGE_TEMPLATE را تنظیم می‌کند).

راه حل

  1. از منوی مدیریت دوباره اعمالش کنید: row-template و سپس 5 — Activate / Re-apply theme.
  2. اگر خودتان SUBSCRIPTION_PAGE_TEMPLATE را زیر بلوک Row-Template تنظیم کرده‌اید، خط خودتان را حذف کنید — آخرین مقداردهی در .env اعمال می‌شود.
کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
FAIL

panel pasarguard: the artifact is missing: ‹مسیر›panel pasarguard: the artifact is not a valid PasarGuard pagepanel pasarguard: the artifact does not match its recorded checksumpanel pasarguard: the generated page is missing or invalid: ‹مسیر›panel pasarguard: SOURCE is not a PasarGuard page this release can serve

ترجمه: پنل pasarguard: فایل صفحه وجود ندارد / صفحهٔ معتبر PasarGuard نیست / با چک‌سام ثبت‌شده‌اش نمی‌خواند / صفحهٔ ساخته‌شده وجود ندارد یا نامعتبر است: ‹مسیر› / منبع، صفحهٔ PasarGuardی نیست که این نسخه بتواند ارائه کند

معنی

فایل‌های خود Row-Template برای PasarGuard درست نیستند: تمپلیت نصب‌شده (dist/template.html) وجود ندارد، خراب است، برای PasarGuard ساخته نشده یا با چک‌سامش نمی‌خواند؛ یا صفحهٔ ساخته‌شده (sub.html) وجود ندارد یا ناقص است. این بررسی چیزی را در پنل تغییر نداده است.

راه حل

با row-template update تمپلیت‌ها را دوباره نصب کنید و صفحه را دوباره بسازید، سپس row-template verify را اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
warn

panel pasarguard: ‹n› admin(s) set their own subscription page (sub_template); their users keep that page.

ترجمه: پنل pasarguard: ‹n› ادمین صفحهٔ اشتراک خودشان را تنظیم کرده‌اند (sub_template)؛ کاربرانشان همان صفحه را می‌بینند.

معنی

در PasarGuard هر ادمین می‌تواند تمپلیت اشتراک خودش را داشته باشد که بر تنظیم کلی پنل — همان که Row-Template استفاده می‌کند — مقدم است. کاربرانِ آن ادمین‌ها همچنان همان صفحه را می‌بینند. این پیکربندی پنل خودتان است، پس Row-Template فقط گزارشش می‌دهد و چیزی را تغییر نمی‌دهد.

راه حل

اگر آن کاربران هم باید Row-Template را ببینند، تمپلیت اشتراک آن ادمین را در تنظیمات ادمین PasarGuard پاک کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
warn

panel pasarguard: the panel's 'disable subscription template' setting is on, so browsers get the raw subscription instead of any page.

ترجمه: پنل pasarguard: تنظیم 'disable subscription template' پنل روشن است، پس مرورگرها به‌جای هر صفحه‌ای خود اشتراک خام را دریافت می‌کنند.

معنی

تنظیم disable subscription template در PasarGuard روشن است، پس پنل به‌جای هر صفحه‌ای — از جمله صفحهٔ Row-Template — خود اشتراک را برای مرورگرها می‌فرستد. Row-Template فقط گزارشش می‌دهد و چیزی را تغییر نمی‌دهد.

راه حل

اگر مشترکان باید صفحه را ببینند، این تنظیم را در تنظیمات اشتراک PasarGuard خاموش کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
warn

panel pasarguard: ‹مسیر› is not Row-Template's; left in place

ترجمه: پنل pasarguard: ‹مسیر› مال Row-Template نیست؛ سر جایش ماند

معنی

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

راه حل

کاری لازم نیست. اگر به آن فایل نیازی ندارید، خودتان حذفش کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت
FAIL

panel pasarguard: after restoring, the Row-Template block is '‹وضعیت›', expected '‹وضعیت›'panel pasarguard: after restoring, the block's directory is not the recorded valuepanel pasarguard: after restoring, SUBSCRIPTION_PAGE_TEMPLATE is set, but the record says it was unsetpanel pasarguard: after restoring, SUBSCRIPTION_PAGE_TEMPLATE is not the recorded value

ترجمه: پنل pasarguard: پس از بازگردانی، بلوک Row-Template '‹وضعیت›' است، در حالی که '‹وضعیت›' انتظار می‌رفت / پس از بازگردانی، پوشهٔ بلوک مقدار ثبت‌شده نیست / پس از بازگردانی، SUBSCRIPTION_PAGE_TEMPLATE تنظیم شده اما رکورد می‌گوید تنظیم نبوده / پس از بازگردانی، SUBSCRIPTION_PAGE_TEMPLATE مقدار ثبت‌شده نیست

معنی

Row-Template پس از بازگرداندن .env از روی عکس فوری، آن را دوباره می‌خواند و با آنچه ثبت شده مقایسه می‌کند — و نمی‌خواند. پس بازگردانی به‌جای اینکه موفق فرض شود، ناموفق گزارش می‌شود.

راه حل

  1. /opt/pasarguard/.env را باز کنید و بلوک row-template و خط SUBSCRIPTION_PAGE_TEMPLATE خودتان را با آنچه انتظار دارید مقایسه کنید.
  2. اگر فعال‌سازی موفق نبوده، بلوک را دستی حذف کنید، PasarGuard را ری‌استارت کنید و row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت

Rebecca

FAIL

panel rebecca: this is Rebecca 0.0.x, the Python edition (Docker image ‹ایمیج›). Row-Template's Rebecca page is built for Rebecca 1.x, the Go edition, which Rebecca publishes for its binary install: install it with Rebecca's rebecca-binary.sh, then run this installer again.

ترجمه: پنل rebecca: این Rebecca نسخهٔ 0.0.x، یعنی نسخهٔ پایتونی است (ایمیج Docker ‹ایمیج›). صفحهٔ Rebecca در Row-Template برای Rebecca 1.x، یعنی نسخهٔ Go ساخته شده که Rebecca برای نصب باینری‌اش منتشر می‌کند: آن را با rebecca-binary.sh خود Rebecca نصب کنید، سپس این نصب‌کننده را دوباره اجرا کنید.

معنی

Row-Template از Rebecca 1.x، یعنی نسخهٔ Go پشتیبانی می‌کند. ایمیج rebeccapanel/rebecca در Docker Hub هنوز نسخهٔ پایتونی 0.0.x است که صفحه‌ها را از زمینهٔ دیگری رندر می‌کند: تنظیم را می‌پذیرفت و بی‌صدا همان صفحهٔ خودش را ارائه می‌داد. پس نصب‌کننده پیش از هر تغییری آن را رد می‌کند — پنل تغییری نمی‌کند.

راه حل

  1. Rebecca نسخهٔ 1.x را با نصب‌کنندهٔ باینری Rebecca (rebecca-binary.sh) نصب کنید — نصبی که Row-Template روی آن آزموده شده.
  2. سپس نصب‌کنندهٔ Row-Template را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
FAIL

panel rebecca: cannot tell which Rebecca edition this is (the Docker image could not be inspected); refusing rather than placing a page Rebecca may not be able to render.

ترجمه: پنل rebecca: مشخص نیست این کدام نسخهٔ Rebecca است (ایمیج Docker بررسی نشد)؛ به‌جای گذاشتن صفحه‌ای که شاید Rebecca نتواند رندرش کند، ادامه نمی‌دهد.

معنی

در نصب Docker، Row-Template ایمیج را می‌خواند تا نسخهٔ Go (1.x) را از نسخهٔ پایتونی (0.0.x) تشخیص دهد. ایمیج بررسی نشد — Docker در حال اجرا نیست یا ایمیجی که در فایل compose آمده موجود نیست — پس به‌جای حدس زدن متوقف می‌شود. هیچ تغییری اعمال نشده است.

راه حل

  1. Docker و پنل را بررسی کنید: docker ps و rebecca status.
  2. ایمیج پنل را دریافت یا اجرا کنید و فرمان را دوباره اجرا کنید. نصب باینری Rebecca (1.x) به بررسی ایمیج نیازی ندارد.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
FAIL

panel rebecca: custom_templates_directory is not a usable absolute pathpanel rebecca: ‹مسیر› is outside /var/lib/rebecca, the directory the container shares with the host

ترجمه: پنل rebecca: custom_templates_directory مسیر مطلق قابل استفاده‌ای نیست / ‹مسیر› بیرون از /var/lib/rebecca است، پوشه‌ای که کانتینر با میزبان به اشتراک می‌گذارد

معنی

وقتی Rebecca از قبل Custom templates directory دارد، Row-Template صفحه‌اش را همان‌جا می‌گذارد. مقداری که در Rebecca تنظیم شده مسیر مطلق ساده‌ای نیست، یا — در نصب Docker — بیرون از /var/lib/rebecca است، پوشه‌ای که کانتینر با میزبان به اشتراک می‌گذارد. هیچ تغییری اعمال نشده است.

راه حل

در داشبورد Rebecca مقدار Settings → Subscription → Templates → Custom templates directory را روی یک مسیر مطلق زیر /var/lib/rebecca بگذارید (یا خالی‌اش کنید) و فرمان را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyrow-template uninstallمنوی مدیریت
FAIL

panel rebecca: cannot read subscription_settingspanel rebecca: cannot read custom_templates_directorypanel rebecca: cannot read the panel selection (sqlite3 and a SQLite database are needed)

ترجمه: پنل rebecca: subscription_settings خوانده نشد / custom_templates_directory خوانده نشد / انتخاب پنل خوانده نشد (به sqlite3 و پایگاه‌دادهٔ SQLite نیاز است)

معنی

تنظیمات اشتراک Rebecca از پایگاه‌داده‌اش خوانده نشد. فعال‌سازی خودکار و این بررسی‌ها به پایگاه‌دادهٔ پیش‌فرض SQLite پنل Rebecca و فرمان sqlite3 نیاز دارند. هیچ تغییری اعمال نشده است.

راه حل

  1. sqlite3 را نصب کنید (apt-get install -y sqlite3) و فرمان را دوباره اجرا کنید.
  2. با MySQL/MariaDB فعال‌سازی دستی است: فعال‌سازی را ببینید.
کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
FAIL

ترجمه: پنل rebecca: پوشهٔ تمپلیت‌ها پیوند نمادین است: ‹مسیر› / ‹مسیر› پیوند نمادین است / ‹مسیر› وجود دارد و مال Row-Template نیست؛ دست‌نخورده ماند

معنی

صفحه در row-template/index.html داخل پوشهٔ تمپلیت‌های Rebecca قرار می‌گیرد. یا آن پوشه (یا پوشهٔ row-template داخلش) پیوند نمادین است، یا فایلی که Row-Template نساخته از قبل در همان مسیر هست. Row-Template هرگز از طریق پیوند نمی‌نویسد و هرگز فایلی را که مال خودش نیست بازنویسی نمی‌کند. هیچ تغییری اعمال نشده است.

راه حل

  1. پیوند را با یک پوشهٔ واقعی جایگزین کنید.
  2. اگر row-template/index.html موجود مال شماست، آن را جای دیگری ببرید؛ سپس فرمان را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

panel rebecca: the page is not in place: ‹مسیر›panel rebecca: the placed page differs from the generated onepanel rebecca: the panel does not select the Row-Template page

ترجمه: پنل rebecca: صفحه سر جایش نیست: ‹مسیر› / صفحهٔ گذاشته‌شده با صفحهٔ ساخته‌شده فرق دارد / پنل صفحهٔ Row-Template را انتخاب نمی‌کند

معنی

Rebecca برای Row-Template تنظیم شده، اما اجزا دیگر با هم نمی‌خوانند: صفحه در پوشهٔ تمپلیت‌ها نیست، نسخهٔ موجود آنجا همان صفحه‌ای نیست که Row-Template آخرین بار ساخته، یا Subscription page template در Rebecca دیگر آن را نام نمی‌برد (کسی در داشبورد صفحهٔ دیگری انتخاب کرده است).

راه حل

از منوی مدیریت دوباره اعمالش کنید: row-template و سپس 5 — Activate / Re-apply theme. اگر عمداً صفحهٔ دیگری انتخاب کرده‌اید، دست نزنید.

کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
FAIL

panel rebecca: the artifact is missing: ‹مسیر›panel rebecca: the artifact is not a valid Rebecca pagepanel rebecca: the artifact does not match its recorded checksumpanel rebecca: the generated page is missing or invalid: ‹مسیر›panel rebecca: SOURCE is not a Rebecca page this release can serve

ترجمه: پنل rebecca: فایل صفحه وجود ندارد / صفحهٔ معتبر Rebecca نیست / با چک‌سام ثبت‌شده‌اش نمی‌خواند / صفحهٔ ساخته‌شده وجود ندارد یا نامعتبر است: ‹مسیر› / منبع، صفحهٔ Rebeccaای نیست که این نسخه بتواند ارائه کند

معنی

فایل‌های خود Row-Template برای Rebecca درست نیستند: تمپلیت نصب‌شده (dist/template.html) وجود ندارد، خراب است، برای Rebecca ساخته نشده یا با چک‌سامش نمی‌خواند؛ یا صفحهٔ ساخته‌شده (sub.html) وجود ندارد یا ناقص است. این بررسی چیزی را در پنل تغییر نداده است.

راه حل

با row-template update تمپلیت‌ها را دوباره نصب کنید و صفحه را دوباره بسازید، سپس row-template verify را اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
warn

panel rebecca: ‹n› admin(s) override the subscription page for their own users; those users keep the admin's page.

ترجمه: پنل rebecca: ‹n› ادمین صفحهٔ اشتراک را برای کاربران خودشان جایگزین کرده‌اند؛ آن کاربران صفحهٔ ادمین را می‌بینند.

معنی

در Rebecca هر ادمین می‌تواند تنظیمات تمپلیت اشتراک خودش را داشته باشد که بر تنظیمات کلی پنل — همان که Row-Template تنظیم می‌کند — مقدم است. کاربرانِ آن ادمین‌ها همچنان همان صفحه را می‌بینند. Row-Template فقط گزارشش می‌دهد و چیزی را تغییر نمی‌دهد.

راه حل

اگر آن کاربران هم باید Row-Template را ببینند، تنظیمات تمپلیت اشتراک آن ادمین را در Rebecca پاک کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template verifyمنوی مدیریت
warn

panel rebecca: ‹مسیر› is not Row-Template's; left in place

ترجمه: پنل rebecca: ‹مسیر› مال Row-Template نیست؛ سر جایش ماند

معنی

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

راه حل

کاری لازم نیست. اگر به آن فایل نیازی ندارید، خودتان حذفش کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت
FAIL

panel rebecca: cannot read subscription_page_template back after restoringpanel rebecca: after restoring, subscription_page_template is '‹مقدار›', expected '‹مقدار›'panel rebecca: cannot read custom_templates_directory back after restoringpanel rebecca: after restoring, custom_templates_directory is not the recorded value

ترجمه: پنل rebecca: subscription_page_template پس از بازگردانی خوانده نشد / پس از بازگردانی، subscription_page_template برابر '‹مقدار›' است، در حالی که '‹مقدار›' انتظار می‌رفت / custom_templates_directory پس از بازگردانی خوانده نشد / پس از بازگردانی، custom_templates_directory مقدار ثبت‌شده نیست

معنی

Row-Template پس از نوشتن دوبارهٔ دو تنظیم اشتراک Rebecca از روی عکس فوری، آن‌ها را دوباره می‌خواند و با آنچه ثبت شده مقایسه می‌کند — و نمی‌خوانند، یا خوانده نمی‌شوند. پس بازگردانی به‌جای اینکه موفق فرض شود، ناموفق گزارش می‌شود.

راه حل

  1. در داشبورد Rebecca Settings → Subscription → Templates را باز کنید و Subscription page template و Custom templates directory را بررسی کنید.
  2. آن‌ها را روی مقادیر دلخواه بگذارید (صفحهٔ خود Rebecca subscription/index.html است) و row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت

تمپلیت‌ها و تعویض

warn

config.env stores an unknown template id (‹شناسه›); resetting the selection to Row.config.env stores an unknown template id (‹شناسه›); using Row.

ترجمه: config.env یک شناسهٔ تمپلیت ناشناخته (‹شناسه›) ذخیره کرده؛ انتخاب به Row بازنشانی می‌شود. / …؛ از Row استفاده می‌شود.

معنی

تمپلیتی که در config.env ذخیره شده برای این نسخه شناخته‌شده نیست — فایل دستی ویرایش شده یا از جای دیگری آمده است. به‌جای آن از Row استفاده می‌شود تا صفحه کار کند، و انتخاب ذخیره‌شده دفعهٔ بعد که فایل نوشته شود اصلاح می‌شود.

راه حل

تمپلیت دلخواه را از منوی مدیریت انتخاب کنید (2 — Reconfigure branding → 4 — Template). config.env را دستی ویرایش نکنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template verifyمنوی مدیریت
FAIL

unknown template id: ‹شناسه›unknown template id: ‹شناسه›unknown template id: ‹شناسه› (available: row editorial canvas prism terminal pulse brutal arcade sketch signature saffron pulsenova prismnova terminalnova arcadenova meter notebook)

ترجمه: شناسهٔ تمپلیت ناشناخته: ‹شناسه›

معنی

شناسهٔ تمپلیتی درخواست شده که این نسخه آن را ندارد. چیزی نوشته نشد: شناسهٔ ناشناخته هرگز ذخیره نمی‌شود.

راه حل

یکی از شناسه‌های جدول مقایسه را به کار ببرید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

the effective template '‹شناسه›' is missing from the template storethe effective template '‹شناسه›' failed its store checksum

ترجمه: تمپلیت مؤثر '‹شناسه›' در مخزن تمپلیت‌ها نیست / تمپلیت مؤثر '‹شناسه›' در بررسی چک‌سام مخزن رد شد

معنی

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

راه حل

  1. برای دیدن وضعیت مخزن تمپلیت‌ها row-template verify را اجرا کنید.
  2. با row-template update همهٔ تمپلیت‌ها را دوباره نصب کنید و سپس تغییر را دوباره اعمال کنید.
کجا دیده می‌شود:row-template configمنوی مدیریت
FAILwarn

template '‹شناسه›' is not installed; re-run the installer to refresh the template storeNo templates are installed, and they could not be restored automatically (see above).

ترجمه: تمپلیت '‹شناسه›' نصب نیست؛ برای به‌روز کردن مخزن تمپلیت‌ها نصب‌کننده را دوباره اجرا کنید / هیچ تمپلیتی نصب نیست و به‌صورت خودکار هم بازگردانده نشدند (بالا را ببینید).

معنی

تمپلیتی که انتخاب کرده‌اید — یا همهٔ تمپلیت‌ها — در مخزن تمپلیت‌های نصب وجود ندارد. منوی مدیریت هنگام باز شدن، تمپلیت‌های ناموجود را خودش از نسخهٔ نصب‌شده دانلود و بازگردانی می‌کند؛ این پیام وقتی می‌آید که این کار ممکن نبود و خط بالا علتش را می‌گوید.

راه حل

مطمئن شوید سرور به منبع نسخه دسترسی دارد و منوی مدیریت را دوباره باز کنید — یا row-template update را اجرا کنید (یا نصب‌کننده را دوباره اجرا کنید) که همهٔ تمپلیت‌های نسخه را نصب می‌کند.

کجا دیده می‌شود:منوی مدیریت
FAIL

template ‹شناسه› failed its checksum; refusing to switch

ترجمه: چک‌سام تمپلیت ‹شناسه› مطابقت ندارد؛ تعویض انجام نمی‌شود

معنی

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

راه حل

با row-template update همهٔ تمپلیت‌ها را دوباره نصب کنید و بعد دوباره تعویض کنید.

کجا دیده می‌شود:منوی مدیریت
FAIL

the ‹شناسه› template failed to generate with the current branding

ترجمه: ساخت تمپلیت ‹شناسه› با برندینگ فعلی شکست خورد

معنی

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

راه حل

  1. خطی را که درست بالاتر چاپ شده بخوانید — مشکل دقیق را نام می‌برد.
  2. اگر به برندینگ مربوط است، اصلاحش کنید (مثلاً با Reset branding) و دوباره تعویض کنید.
کجا دیده می‌شود:منوی مدیریت
FAIL

could not snapshot the current state; aborting

ترجمه: از وضعیت فعلی پشتیبان گرفته نشد؛ عملیات لغو شد

معنی

پیش از تعویض تمپلیت باید پشتیبان گرفته شود و این کار انجام نشد. تعویض لغو شد و چیزی تغییر نکرد.

راه حل

فضای آزاد دیسک زیر /etc را بررسی کنید و دوباره امتحان کنید.

کجا دیده می‌شود:منوی مدیریت
FAIL

could not stage the selected template; the previous state was restoredcould not persist the template selection; the previous state was restoredactivation of the new template failed; the previous state was restoredthe switched template failed post-activation validation; the previous state was restored

ترجمه: تمپلیت انتخاب‌شده آماده نشد / انتخاب تمپلیت ذخیره نشد / فعال‌سازی تمپلیت جدید شکست خورد / تمپلیت جدید در اعتبارسنجی پس از فعال‌سازی رد شد — در همهٔ این موارد وضعیت قبلی بازگردانده شد

معنی

یکی از مراحل تعویض تمپلیت پس از گرفتن پشتیبان شکست خورد، پس پشتیبان بازگردانده شد: تمپلیت قبلی دقیقاً مثل قبل دوباره فعال است.

راه حل

  1. برای اطمینان از سالم بودن نصب، row-template verify را اجرا کنید.
  2. فضای آزاد دیسک را بررسی کنید و دوباره تعویض را امتحان کنید. اگر به همان شکل شکست خورد، گزارش دهید.
کجا دیده می‌شود:منوی مدیریت
FAIL

automatic restore failed; run 'row-template rollback'

ترجمه: بازگردانی خودکار شکست خورد؛ row-template rollback را اجرا کنید

معنی

تعویض تمپلیت شکست خورد و بازگرداندن پشتیبانی که درست پیش از آن گرفته شده بود هم شکست خورد. ممکن است نصب نیمه‌کاره تعویض شده باشد.

راه حل

  1. row-template rollback را اجرا کنید — همان پشتیبان را بازمی‌گرداند.
  2. سپس row-template verify را اجرا کنید.
کجا دیده می‌شود:منوی مدیریت
FAIL

ترجمه: مسیر مخزن تمپلیت‌ها یک پیوند نمادین است؛ تعمیر نمی‌شود: ‹مسیر› / مسیر مخزن تمپلیت‌ها پوشه نیست: ‹مسیر›

معنی

مخزن تمپلیت‌ها — یعنی dist/templates/ در پوشهٔ نصب — به‌جای پوشه، یک پیوند نمادین یا فایل است؛ پس Row-Template تمپلیت‌ها را در آن نمی‌نویسد. هیچ تغییری اعمال نشده است.

راه حل

پیوند یا فایلی را که در پیام آمده (داخل پوشهٔ نصب) حذف کنید و همان فرمان را دوباره اجرا کنید؛ مخزن با همهٔ تمپلیت‌ها دوباره ساخته می‌شود.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template verifyمنوی مدیریت
warn

not reading templates from ‹مسیر›: it is not a plain directory.the copy of design '‹شناسه›' in ‹مسیر› fails its checksum or structural check; it was not moved.left ‹مسیر› in place: it holds files Row-Template does not recognise.

ترجمه: تمپلیت‌ها از ‹مسیر› خوانده نمی‌شوند: پوشهٔ معمولی نیست. / نسخهٔ تمپلیت '‹شناسه›' در ‹مسیر› در بررسی چک‌سام یا ساختار رد شد؛ جابه‌جا نشد. / ‹مسیر› سر جایش ماند: فایل‌هایی دارد که Row-Template نمی‌شناسد.

معنی

تمپلیت‌هایی که بیرون از مخزن تمپلیت‌ها مانده‌اند — جایی که به‌روزرسانی از نسخه‌های قبلی ممکن است آن‌ها را گذاشته باشد — به dist/templates/ بازگردانده می‌شوند. این هشدارها یعنی بخشی از این کار با اطمینان انجام نشد: آن پوشه پیوند یا فایل ویژه است، یکی از نسخه‌ها خراب است و سر جایش ماند، یا پوشه فایل‌هایی دارد که Row-Template نمی‌شناسد و به همین دلیل حذف نشد. تمپلیت‌های داخل مخزن آسیبی ندیده‌اند.

راه حل

  1. row-template verify را با root اجرا کنید تا وضعیت مخزن را ببینید؛ row-template update هر تمپلیت ناموجود را دوباره نصب می‌کند.
  2. وقتی مخزن کامل شد، می‌توانید پوشهٔ باقی‌مانده‌ای را که در پیام آمده دستی حذف کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template verifyمنوی مدیریت

برندینگ و پیکربندی

FAIL

logo file not found: ‹مسیر›

ترجمه: فایل لوگو پیدا نشد: ‹مسیر›

معنی

در مسیری که برای لوگو داده‌اید فایلی وجود ندارد. لوگو تغییری نکرد.

راه حل

مسیر کامل تصویر را بدهید، مثلاً /root/logo.png، و آن را با ls -l بررسی کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

ترجمه: مسیر لوگو یک پیوند نمادین است؛ خوانده نمی‌شود / مسیر لوگو پس از اعتبارسنجی به پیوند نمادین تبدیل شد؛ عملیات لغو شد.

معنی

مسیر لوگو یک پیوند نمادین (symlink) است — یا بین بررسی و خواندن با یک پیوند جایگزین شده است. لوگو فقط از فایل معمولی خوانده می‌شود. هیچ تغییری اعمال نشده است.

راه حل

مسیر فایل واقعی را بدهید. readlink -f /path/to/logo.png نشان می‌دهد پیوند به کجا اشاره می‌کند.

کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

logo path is not a regular file

ترجمه: مسیر لوگو یک فایل معمولی نیست

معنی

مسیر لوگو یک پوشه یا فایل ویژه است، نه فایل تصویر.

راه حل

مسیر خود فایل تصویر را بدهید، نه پوشهٔ آن را.

کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

cannot size logo filelogo file is empty

ترجمه: اندازهٔ فایل لوگو خوانده نشد / فایل لوگو خالی است

معنی

فایل لوگو خوانده نشد، یا خالی است.

راه حل

فایل را با ls -l بررسی کنید — باید قابل خواندن و بزرگ‌تر از صفر بایت باشد — یا تصویر را دوباره خروجی بگیرید.

کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

logo too large: ‹اندازه› bytes (max 262144)

ترجمه: لوگو خیلی بزرگ است: ‹اندازه› بایت (حداکثر 262144)

معنی

حجم لوگو حداکثر ۲۵۶ کیلوبایت (262144 بایت) است، چون تصویر داخل هر صفحه‌ای که ارائه می‌شود جاسازی می‌شود.

راه حل

  1. اندازهٔ تصویر را کوچک کنید: لوگو کوچک نمایش داده می‌شود، پس ۲۵۶×۲۵۶ پیکسل کافی است.
  2. آن را با فرمت WebP یا PNG بهینه‌شده ذخیره کنید، مثلاً cwebp -q 85 logo.png -o logo.webp.
کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

unsupported image: only PNG, JPEG or WebP by content

ترجمه: تصویر پشتیبانی نمی‌شود: از نظر محتوا فقط PNG، JPEG یا WebP پذیرفته می‌شود

معنی

محتوای فایل PNG، JPEG یا WebP نیست. نوع فایل از بایت‌های ابتدایی آن خوانده می‌شود، نه از نامش؛ پس تغییر پسوند فایل فایده‌ای ندارد. SVG و GIF پذیرفته نمی‌شوند.

راه حل

  1. تصویر را تبدیل کنید، مثلاً با ImageMagick: convert logo.svg -resize 256x256 logo.png.
  2. نوع واقعی فایل را با file logo.png ببینید.
کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

service name rejected (control chars or too long)Rejected: control characters or too long.

ترجمه: نام سرویس رد شد (نویسهٔ کنترلی دارد یا خیلی طولانی است)

معنی

نام سرویس بیش از ۱۲۰ نویسه است یا نویسهٔ کنترلی مانند شکست خط یا Tab دارد. ذخیره نشد.

راه حل

نامی کوتاه‌تر و یک‌خطی وارد کنید. در اسکریپت، بررسی کنید RT_SERVICE_NAME شکست خط انتهایی نداشته باشد.

کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
warn

Use https://, http://, tg:// or mailto: — or clear it with -Use https://, http://, tg:// or mailto:.

ترجمه: از https://، http://، tg:// یا mailto: استفاده کنید — یا با - آن را خالی کنید

معنی

لینک پشتیبانی باید لینکی باشد که مرورگر بتواند با خیال راحت باز کند. هر چیز دیگری — از جمله لینک‌های javascript: و data: — رد می‌شود و دوباره از شما پرسیده می‌شود.

راه حل

لینکی مانند https://t.me/your_support، tg://resolve?domain=your_support یا mailto:support@example.com وارد کنید، یا برای نداشتن لینک - بزنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configمنوی مدیریت
FAIL

support URL rejected

ترجمه: نشانی پشتیبانی رد شد

معنی

لینک پشتیبانی که در RT_SUPPORT_URL داده شده با https://، http://، tg:// یا mailto: شروع نمی‌شود، یا نویسهٔ کنترلی دارد. ذخیره نشد.

راه حل

RT_SUPPORT_URL را اصلاح کنید، یا برای نداشتن لینک پشتیبانی آن را خالی بگذارید.

کجا دیده می‌شود:نصب‌کنندهrow-template config
FAIL

branding contains control characters; refusing to generate.

ترجمه: برندینگ شامل نویسه‌های کنترلی است؛ صفحه ساخته نمی‌شود.

معنی

نام سرویس یا لینک پشتیبانی ذخیره‌شده نویسهٔ کنترلی دارد — که فقط وقتی پیش می‌آید که config.env دستی ویرایش یا از جای دیگری بازگردانده شده باشد. به‌جای ساختن صفحهٔ خراب، ساخت متوقف می‌شود و صفحهٔ زنده همان‌طور که بود می‌ماند.

راه حل

  1. برندینگ را دوباره با ابزارهایی که اعتبارسنجی می‌کنند تنظیم کنید: row-template config یا Reset branding در منوی مدیریت.
  2. config.env را دستی ویرایش نکنید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

cannot create a temp file.

ترجمه: فایل موقت ساخته نشد.

معنی

row-template config پیش از تغییر، پیکربندی فعلی را کنار می‌گذارد و نتوانست فایل موقت این کار را بسازد — معمولاً چون /tmp پر است. هیچ تغییری اعمال نشده است.

راه حل

در /tmp فضا آزاد کنید (df -h /tmp) و فرمان را دوباره اجرا کنید.

کجا دیده می‌شود:row-template config
FAIL

configuration was not changed.

ترجمه: پیکربندی تغییری نکرد.

معنی

یکی از مقادیری که به row-template config داده شد رد شد — خط بالا می‌گوید کدام. پیکربندی قبلی بازگردانده شد، پس چیزی تغییر نکرده است.

راه حل

مقداری را که درست در بالا نام برده شده اصلاح کنید و row-template config را دوباره اجرا کنید.

کجا دیده می‌شود:row-template config
FAIL

the template selection could not be reconciled; the previous state is still in place.could not reconcile the template selection; the previous state was restored.

ترجمه: انتخاب تمپلیت هماهنگ نشد؛ وضعیت قبلی همچنان برقرار است. / …؛ وضعیت قبلی بازگردانده شد.

معنی

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

راه حل

row-template verify و سپس row-template update را اجرا کنید تا تمپلیت‌ها دوباره نصب شوند، و بعد تغییر را دوباره اعمال کنید.

کجا دیده می‌شود:row-template configمنوی مدیریت
FAIL

the new branding failed validation; restoring the previous configuration.reconfiguration aborted; the previous template is still in place.

ترجمه: برندینگ جدید در اعتبارسنجی رد شد؛ پیکربندی قبلی بازگردانده می‌شود. / پیکربندی مجدد لغو شد؛ تمپلیت قبلی همچنان برقرار است.

معنی

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

راه حل

خطوطی را که درست پیش از آن چاپ شده بخوانید — مشکل را نام می‌برند — آن را اصلاح کنید و دوباره امتحان کنید.

کجا دیده می‌شود:row-template configمنوی مدیریت
FAIL

could not write the configuration.

ترجمه: پیکربندی نوشته نشد.

معنی

منوی مدیریت نتوانست config.env را بنویسد — معمولاً به‌دلیل پر بودن دیسک. پیکربندی و صفحهٔ قبلی بازگردانده شدند.

راه حل

فضای آزاد زیر /etc را بررسی کنید و دوباره امتحان کنید.

کجا دیده می‌شود:منوی مدیریت
warn

This clears custom branding (service name, support URL, logo) and

ترجمه: این کار برندینگ سفارشی (نام سرویس، نشانی پشتیبانی، لوگو) را پاک می‌کند و

معنی

خطا نیست: ابتدای پیام تأیید برای Reset branding است که این‌طور ادامه می‌یابد: «Row-Template را به ظاهر پیش‌فرضش برمی‌گرداند. Row-Template را حذف نمی‌کند.»

راه حل

برای پاک کردن نام سرویس، لینک پشتیبانی و لوگو y را وارد کنید، یا برای لغو Enter بزنید.

کجا دیده می‌شود:منوی مدیریت

ساخت صفحه

FAIL

canonical artifact missing: ‹مسیر›

ترجمه: فایل اصلی صفحه وجود ندارد: ‹مسیر›

معنی

فایل تمپلیت نصب‌شده، یعنی dist/template.html، وجود ندارد؛ پس صفحه دوباره ساخته نمی‌شود. به صفحهٔ زنده دست زده نشده است.

راه حل

row-template update را اجرا کنید، یا برای تعمیر نصب، نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

artifact branding markers not found exactly once (open=‹n› close=‹n›)

ترجمه: نشانگرهای برندینگ در فایل صفحه دقیقاً یک بار پیدا نشدند (open=‹n› close=‹n›)

معنی

برندینگ شما بین دو نشانگر در فایل تمپلیت قرار می‌گیرد و هر کدام باید دقیقاً یک بار وجود داشته باشد. این‌طور نیست؛ پس فایل یک تمپلیت دست‌نخوردهٔ Row-Template نیست. هیچ تغییری اعمال نشده است.

راه حل

با row-template update تمپلیت‌ها را دوباره نصب کنید. فایل‌های تمپلیت را دستی ویرایش نکنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

generated template missingcannot size generated templategenerated template implausibly small (‹اندازه› bytes)generated template does not begin with <!doctype html>generated template does not end with </html>branding markers not intact in generated templategenerated template missing the #sub-data islandgenerated template missing the BRANDING blockgenerated template still contains unsubstituted build placeholders

ترجمه: تمپلیت ساخته‌شده وجود ندارد / اندازهٔ آن خوانده نشد / به‌طور غیرعادی کوچک است (‹اندازه› بایت) / با <!doctype html> شروع نمی‌شود / با </html> تمام نمی‌شود / نشانگرهای برندینگ سالم نیستند / بخش داده (#sub-data) را ندارد / بلوک BRANDING را ندارد / هنوز جای‌نگهدارهای ساخت جایگزین‌نشده دارد

معنی

هر صفحه پیش از فعال شدن بررسی می‌شود: باید یک سند HTML کامل با اندازهٔ معقول باشد، بلوک برندینگ و بخش داده‌اش را داشته باشد و هیچ جای‌نگهدار ساختی در آن نمانده باشد. این صفحه یکی از بررسی‌ها را رد کرد، پس فعال نشد — صفحه‌ای که مشترکان می‌بینند تغییری نکرده است. هنگام verify یا تعویض تمپلیت، همین بررسی‌ها می‌توانند فایل خراب را گزارش دهند.

راه حل

  1. فضای آزاد دیسک را بررسی کنید — دیسک پر فایل‌ها را ناقص می‌کند.
  2. با row-template update تمپلیت‌ها را دوباره نصب کنید و صفحه را دوباره بسازید.
  3. اگر با نسخهٔ رسمی تازه هم رخ داد، با متن دقیق پیام گزارش دهید.
کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

refusing to install an invalid artifact

ترجمه: فایل صفحهٔ نامعتبر نصب نمی‌شود

معنی

یک فایل تمپلیت درست پیش از نصب، بررسی‌های صفحه (بالا) را رد کرد، پس نصب نشد. هیچ تغییری اعمال نشده است.

راه حل

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

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت
FAIL

refusing to install an artifact that is not a ‹پنل› page

ترجمه: فایلی که صفحهٔ ‹پنل› نیست نصب نمی‌شود

معنی

فایل تمپلیتی که قرار بود نصب شود برای پنل این سرور ساخته نشده است — هر پنل موتور قالب خودش را دارد، پس صفحه‌ای که برای یک پنل ساخته شده در پنل دیگر ارائه نمی‌شود. نصب نشد و هیچ تغییری اعمال نشده است.

راه حل

با row-template update تمپلیت‌های این نسخه را دوباره نصب کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackمنوی مدیریت

به‌روزرسانی

warn

template '‹شناسه›' is not in this release; falling back to Row.

ترجمه: تمپلیت '‹شناسه›' در این نسخه نیست؛ به Row برمی‌گردد.

معنی

تمپلیتی که استفاده می‌کنید در نسخه‌ای که به آن به‌روز می‌کنید وجود ندارد، پس به‌روزرسانی به‌جای آن Row را نصب می‌کند. برندینگ شما حفظ می‌شود.

راه حل

پس از به‌روزرسانی، از منوی مدیریت تمپلیت دیگری انتخاب کنید (2 — Reconfigure branding → 4 — Template).

کجا دیده می‌شود:row-template update
FAIL

the selected template failed structural validation.

ترجمه: تمپلیت انتخاب‌شده در اعتبارسنجی ساختاری رد شد.

معنی

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

راه حل

دوباره به‌روزرسانی کنید؛ اگر با نسخهٔ رسمی تکرار شد، گزارش دهید.

کجا دیده می‌شود:row-template update
FAIL

could not back up the current install; aborting.

ترجمه: از نصب فعلی پشتیبان گرفته نشد؛ عملیات لغو شد.

معنی

به‌روزرسانی همیشه اول پشتیبان می‌گیرد و این کار انجام نشد. به‌روزرسانی متوقف شد و چیزی جایگزین نشده است.

راه حل

فضای آزاد دیسک زیر /etc را بررسی کنید و row-template update را دوباره اجرا کنید.

کجا دیده می‌شود:row-template update
FAIL

failed to stage the new artifact; the running template is unchanged.

ترجمه: فایل صفحهٔ جدید آماده نشد؛ تمپلیت در حال اجرا تغییری نکرده است.

معنی

صفحهٔ نسخهٔ جدید سر جایش قرار نگرفت — معمولاً به‌دلیل پر بودن دیسک. صفحه‌ای که مشترکان می‌بینند تغییری نکرده است.

راه حل

کمی فضای دیسک آزاد کنید و row-template update را دوباره اجرا کنید.

کجا دیده می‌شود:row-template update
warn

could not update the VERSION file.could not update the management library.could not update the row-template CLI.

ترجمه: فایل VERSION به‌روز نشد. / کتابخانهٔ مدیریتی به‌روز نشد. / فرمان row-template به‌روز نشد.

معنی

صفحهٔ جدید نصب شد، اما یکی از فایل‌های پشتیبان جایگزین نشد. به‌روزرسانی ادامه پیدا می‌کند؛ ممکن است نسخهٔ نمایش‌داده‌شده یا خود فرمان هنوز قدیمی باشد.

راه حل

فضای آزاد دیسک را بررسی کنید و row-template update را دوباره اجرا کنید تا جایگزینی کامل شود.

کجا دیده می‌شود:row-template update
warn

could not update the management library's companions; run 'row-template update' to retry.

ترجمه: فایل‌های همراه کتابخانهٔ مدیریتی به‌روز نشدند؛ برای تلاش دوباره row-template update را اجرا کنید.

معنی

فایل‌های همراه کتابخانهٔ مدیریتی (lib/transaction.sh و panels/) جایگزین نشدند. صفحه کار می‌کند، اما verify نصب را ناقص گزارش می‌کند.

راه حل

فضای آزاد را بررسی کنید و row-template update را دوباره اجرا کنید.

کجا دیده می‌شود:row-template update
FAILwarn

activation of the new version failed; rolling back.rolled back to ‹نسخه›; no changes are live.

ترجمه: فعال‌سازی نسخهٔ جدید شکست خورد؛ بازگردانی انجام می‌شود. / به ‹نسخه› بازگردانده شد؛ هیچ تغییری فعال نیست.

معنی

نسخهٔ جدید نصب شد اما صفحه‌اش فعال نشد، پس پشتیبانی که در شروع گرفته شده بود خودکار بازگردانده شد. مشترکان در تمام این مدت صفحهٔ قبلی را می‌دیدند. فرمان با وضعیت 1 خارج می‌شود.

راه حل

  1. برای اطمینان از سالم بودن نسخهٔ قبلی، row-template verify را اجرا کنید.
  2. علت را در خطوط پیش از این پیام‌ها ببینید، برطرفش کنید (اغلب فضای دیسک یا برندینگ) و دوباره به‌روزرسانی کنید.
کجا دیده می‌شود:row-template update
FAIL

activation failed AND automatic rollback failed; run 'row-template rollback' to recover.

ترجمه: فعال‌سازی شکست خورد و بازگردانی خودکار هم شکست خورد؛ برای بازیابی row-template rollback را اجرا کنید.

معنی

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

راه حل

  1. با row-template rollback پشتیبانی را که پیش از به‌روزرسانی گرفته شده بازگردانید.
  2. سپس row-template verify را اجرا کنید.
کجا دیده می‌شود:row-template update
warn

This installation is incomplete: some installer components are missing, as after an update from 1.1.0.

ترجمه: این نصب ناقص است: برخی از اجزای نصب‌کننده وجود ندارند؛ مانند وضعیت پس از به‌روزرسانی از 1.1.0.

معنی

منوی مدیریت دریافت که فایل‌های همراه نصب‌کننده وجود ندارند — وضعیتی که درست پس از نصب نسخهٔ جدیدتر با به‌روزرسان خود 1.1.0 پیش می‌آید، وقتی کامل کردن خودکار نصب انجام نشده باشد.

راه حل

پرسش Re-install … now to complete it? را تأیید کنید — یا row-template update را اجرا کنید — تا آن‌ها و همهٔ تمپلیت‌ها نصب شوند. ارتقا از 1.1.0 یا 1.2.0 ←

کجا دیده می‌شود:منوی مدیریت
warn

Unable to check for updates right now (network or release source unavailable).

ترجمه: در حال حاضر بررسی به‌روزرسانی ممکن نیست (شبکه یا منبع نسخه در دسترس نیست).

معنی

منوی مدیریت نتوانست manifest.txt آخرین نسخه را بخواند. نصب شما آسیبی ندیده و چیزی تغییر نکرده است.

راه حل

  1. دسترسی سرور به GitHub را بررسی کنید و بعداً دوباره امتحان کنید.
  2. اگر به GitHub دسترسی ندارید، از پوشهٔ محلی به‌روزرسانی کنید: RT_RELEASE_DIR=/path row-template update.
کجا دیده می‌شود:منوی مدیریت
warn

could not download Row-Template ‹نسخه› to complete the installation. It will be retried the next time the manager opens; 'row-template update' also completes it.the release source offers ‹نسخه›, not the installed ‹نسخه›; nothing was changed. Run 'row-template update' to update.the installation is still incomplete; run 'row-template verify' for details.this installation is incomplete and its version is unknown; run 'row-template update' to repair it.

ترجمه: Row-Template نسخهٔ ‹نسخه› برای کامل کردن نصب دانلود نشد. دفعهٔ بعد که منوی مدیریت باز شود دوباره تلاش می‌شود؛ row-template update هم آن را کامل می‌کند. / منبع نسخه ‹نسخه› را ارائه می‌کند، نه نسخهٔ نصب‌شدهٔ ‹نسخه› را؛ هیچ تغییری اعمال نشد. برای به‌روزرسانی row-template update را اجرا کنید. / نصب هنوز ناقص است؛ برای جزئیات row-template verify را اجرا کنید. / این نصب ناقص است و نسخه‌اش نامعلوم است؛ برای تعمیر row-template update را اجرا کنید.

معنی

به‌روزرسان خود 1.1.0 فقط بخشی از نسخهٔ جدیدتر را کپی می‌کند. پس نخستین باری که پس از چنین به‌روزرسانی‌ای row-template را باز می‌کنید، یا row-template config یا row-template verify را با root اجرا می‌کنید، Row-Template پیش از هر کاری بقیهٔ همان نسخه‌ای را که نصب دارید دانلود می‌کند — همهٔ تمپلیت‌ها و بقیهٔ فایل‌های نصب‌کننده. این کار انجام نشد: منبع نسخه در دسترس نبود، نسخهٔ دیگری ارائه می‌کرد (این مسیر هرگز نسخهٔ دیگری نصب نمی‌کند)، نسخهٔ نصب‌شده خوانده نشد، یا پس از آن هنوز چیزی کم است. صفحه، برندینگ، تمپلیت و پشتیبان‌های شما تغییری نکرده‌اند.

راه حل

  1. مطمئن شوید سرور به منبع نسخه دسترسی دارد و منوی مدیریت را دوباره باز کنید.
  2. یا row-template update را اجرا کنید که آخرین نسخه را کامل نصب می‌کند.
کجا دیده می‌شود:row-template configrow-template verifyمنوی مدیریت

پشتیبان‌گیری و بازگردانی

FAIL

nothing to back up: ‹مسیر› missing

ترجمه: چیزی برای پشتیبان‌گیری نیست: ‹مسیر› وجود ندارد

معنی

به پشتیبان نیاز بود، اما فایل تمپلیت نصب‌شده وجود ندارد، پس چیزی برای پشتیبان‌گیری نیست. عملیاتی که به آن نیاز داشت متوقف شد.

راه حل

برای تعمیر نصب، نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template updaterow-template rollbackمنوی مدیریت
warn

could not prune backup: ‹مسیر›

ترجمه: پشتیبان حذف نشد: ‹مسیر›

معنی

یکی از پشتیبان‌های قدیمی (بیش از دو پشتیبانی که نگه داشته می‌شوند) حذف نشد. چیز دیگری تحت تأثیر نیست.

راه حل

مجوزهای آن پوشه را بررسی کنید. می‌توانید پوشهٔ پشتیبان قدیمی زیر backups/ را دستی حذف کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template updateمنوی مدیریت
FAIL

backup failed validation: ‹مسیر›the selected backup failed validation: ‹پشتیبان›

ترجمه: پشتیبان در اعتبارسنجی رد شد: ‹مسیر›

معنی

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

راه حل

فهرست پشتیبان‌ها را ببینید — ls /etc/3x-ui/sub_templates/row-template/backups/ در 3X-UI و ls /etc/row-template/backups/ در PasarGuard و Rebecca — و با row-template rollback --to <name> پشتیبان دیگری انتخاب کنید.

کجا دیده می‌شود:row-template updaterow-template rollbackمنوی مدیریت
warn

could not restore VERSION from the backup.

ترجمه: فایل VERSION از پشتیبان بازگردانده نشد.

معنی

صفحهٔ پشتیبان بازگردانده شد، اما فایل VERSION آن نه؛ پس ممکن است row-template version نسخهٔ اشتباهی نشان دهد.

راه حل

فضای آزاد دیسک را بررسی کنید. اجرای دوبارهٔ بازگردانی آن را دوباره می‌نویسد.

کجا دیده می‌شود:row-template updaterow-template rollbackمنوی مدیریت
FAIL

could not persist the restored template selection

ترجمه: انتخاب تمپلیتِ بازگردانده‌شده ذخیره نشد

معنی

تمپلیت بازگردانده‌شده در config.env ثبت نشد. عملیات بدون فعال کردن صفحهٔ بازگردانده‌شده متوقف می‌شود.

راه حل

فضای آزاد و قابل نوشتن بودن config.env را بررسی کنید و row-template rollback را دوباره اجرا کنید.

کجا دیده می‌شود:row-template updaterow-template rollbackمنوی مدیریت
FAIL

--to requires a backup directory.usage: row-template rollback [--auto | --to <backup-dir>]

ترجمه: گزینهٔ --to به پوشهٔ پشتیبان نیاز دارد. / روش استفاده: row-template rollback [--auto | --to <backup-dir>]

معنی

به rollback گزینه‌ای داده شده که آن را نمی‌شناسد، یا --to بدون نام پشتیبان آمده است.

راه حل

  1. از row-template rollback (جدیدترین پشتیبان)، row-template rollback --auto (همان) یا row-template rollback --to <name> استفاده کنید.
  2. نام پشتیبان‌ها همان نام پوشه‌های زیر backups/ در پوشهٔ نصب است: /etc/3x-ui/sub_templates/row-template/backups/ در 3X-UI و /etc/row-template/backups/ در PasarGuard و Rebecca.
کجا دیده می‌شود:row-template rollback
FAIL

no valid backup is available to roll back to.

ترجمه: هیچ پشتیبان معتبری برای بازگردانی وجود ندارد.

معنی

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

راه حل

چیزی برای بازگردانی نیست. برای نصب دوبارهٔ نسخهٔ فعلی، row-template update را اجرا کنید.

کجا دیده می‌شود:row-template rollback
FAIL

refusing to roll back from a path outside the backups tree.

ترجمه: بازگردانی از مسیری بیرون از پوشهٔ پشتیبان‌ها انجام نمی‌شود.

معنی

--to به پوشه‌ای بیرون از backups/ اشاره کرده است. فقط پشتیبان‌های خود Row-Template بازگردانده می‌شوند. هیچ تغییری اعمال نشده است.

راه حل

نام یکی از پوشه‌های backups/ در پوشهٔ نصب را بدهید (/etc/3x-ui/sub_templates/row-template/backups/ در 3X-UI و /etc/row-template/backups/ در PasarGuard و Rebecca)، یا از row-template rollback --auto استفاده کنید.

کجا دیده می‌شود:row-template rollback
warn

could not snapshot the current version before rollback.

ترجمه: پیش از بازگردانی، از نسخهٔ فعلی پشتیبان گرفته نشد.

معنی

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

راه حل

فضای آزاد دیسک زیر /etc را بررسی کنید و پس از پایان بازگردانی، row-template verify را اجرا کنید.

کجا دیده می‌شود:row-template rollback
FAIL

could not stage the backup; the running template is unchanged.

ترجمه: پشتیبان آماده نشد؛ تمپلیت در حال اجرا تغییری نکرده است.

معنی

پشتیبان سر جایش قرار نگرفت — علت در خط بالا آمده است. صفحه‌ای که مشترکان می‌بینند تغییری نکرده است.

راه حل

مشکلی را که درست در بالا نام برده شده برطرف کنید. اگر گفته پشتیبان برای پنل دیگری ساخته شده، توضیح همان پیام را ببینید.

کجا دیده می‌شود:row-template rollback
FAILwarn

rollback activation failed; attempting to restore the current version.restored the previously-running version; nothing changed.

ترجمه: فعال‌سازی بازگردانی شکست خورد؛ تلاش برای بازگرداندن نسخهٔ فعلی. / نسخهٔ در حال اجرای قبلی بازگردانده شد؛ چیزی تغییر نکرد.

معنی

نسخهٔ قدیمی‌تر آماده شد اما صفحه‌اش فعال نشد، پس پشتیبان ایمنی نسخهٔ فعلی بازگردانده شد. چیزی تغییر نکرد. فرمان با وضعیت 1 خارج می‌شود.

راه حل

علت را در خطوط بالاتر ببینید (اغلب برندینگ یا فضای دیسک)، برطرفش کنید و دوباره امتحان کنید.

کجا دیده می‌شود:row-template rollback
FAIL

rollback failed and the current version could not be restored automatically.

ترجمه: بازگردانی شکست خورد و نسخهٔ فعلی هم به‌صورت خودکار بازگردانده نشد.

معنی

هم بازگردانی و هم بازگشت خودکار به نسخهٔ فعلی شکست خوردند. صفحهٔ زنده همان صفحهٔ قبلی است، اما ممکن است فایل‌های نصب‌شده درهم باشند.

راه حل

  1. برای دیدن وضعیت row-template verify را اجرا کنید.
  2. row-template rollback --to <name> را با پشتیبان ایمنی‌ای که همین حالا ساخته شد (جدیدترین پوشه در backups/) امتحان کنید، یا برای تعمیر نصب‌کننده را دوباره اجرا کنید.
کجا دیده می‌شود:row-template rollback
FAIL

could not create a new backup directory under ‹مسیر›

ترجمه: پوشهٔ پشتیبان جدیدی زیر ‹مسیر› ساخته نشد

معنی

نام پشتیبان‌ها از زمان گرفتنشان تا دقت ثانیه ساخته می‌شود. هیچ نام آزادی در backups/ گرفته نشد — دیسک پر است، پوشه قابل نوشتن نیست، یا نام‌ها پشت سر هم تکراری بودند. عملیاتی که به پشتیبان نیاز داشت در خط بعد می‌گوید چه کرد.

راه حل

  1. فضای آزاد را با df -h /etc بررسی کنید و مطمئن شوید backups/ در پوشهٔ نصب، پوشه‌ای قابل نوشتن است.
  2. فرمان را دوباره اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template updaterow-template rollbackمنوی مدیریت
FAIL

backup ‹پشتیبان› was made for ‹پنل›, not ‹پنل›; refusing to restore it.

ترجمه: پشتیبان ‹پشتیبان› برای ‹پنل› ساخته شده، نه ‹پنل›؛ بازگردانده نمی‌شود.

معنی

هر پشتیبان پنلی را که روی آن ساخته شده ثبت می‌کند و فقط روی همان پنل بازگردانده می‌شود: صفحه‌ای که برای موتور قالب یک پنل ساخته شده، در پنل دیگر ارائه نمی‌شود. پشتیبان‌های ساخته‌شده پیش از 1.3.0 پشتیبان 3X-UI به حساب می‌آیند. هیچ تغییری اعمال نشده است.

راه حل

پشتیبانی را انتخاب کنید که روی همین پنل ساخته شده: فهرست پوشهٔ backups/ در پوشهٔ نصب را ببینید و از row-template rollback --to <name> استفاده کنید.

کجا دیده می‌شود:row-template updaterow-template rollbackمنوی مدیریت
warn

backup artifact has no store match and no recorded template; defaulting to Row.backup artifact recorded template '‹شناسه›' is not installed; defaulting to Row.

ترجمه: صفحهٔ پشتیبان با هیچ تمپلیتی در مخزن مطابقت ندارد و تمپلیتی هم ثبت نکرده؛ Row استفاده می‌شود. / تمپلیت ثبت‌شده در پشتیبان ('‹شناسه›') نصب نیست؛ Row استفاده می‌شود.

معنی

صفحهٔ داخل پشتیبان بایت‌به‌بایت با هیچ تمپلیتی از نسخهٔ فعلی یکی نیست — نسخهٔ قدیمی‌تری آن را ساخته — پس بازگردانی به‌جای آن از تمپلیتی استفاده می‌کند که پشتیبان ثبت کرده است. این پشتیبان هیچ تمپلیتی ثبت نکرده (نسخه‌های قدیمی‌تر ثبت نمی‌کردند) یا تمپلیتی را ثبت کرده که این نسخه ندارد؛ پس Row بازگردانده می‌شود. صفحه از تمپلیت‌های نصب‌شدهٔ فعلی برداشته می‌شود، شمارهٔ نسخهٔ پشتیبان بازگردانده می‌شود و برندینگ فعلی شما حفظ می‌شود.

راه حل

کاری لازم نیست. اگر بعداً تمپلیت دیگری می‌خواهید، از منوی مدیریت انتخابش کنید (2 — Reconfigure branding → 4 — Template).

کجا دیده می‌شود:row-template updaterow-template rollbackمنوی مدیریت

نتایج verify

FAIL

ترجمه: ریشهٔ نصب وجود ندارد یا یک پیوند نمادین است: ‹پوشهٔ نصب›

معنی

پوشهٔ نصب وجود ندارد یا یک پیوند نمادین است. Row-Template به‌درستی نصب نشده است.

راه حل

نصب‌کننده را دوباره اجرا کنید. اگر پوشه symlink است، اول آن را با یک پوشهٔ واقعی جایگزین کنید.

کجا دیده می‌شود:row-template verify
FAIL

canonical artifact missing checksum or does not match it.canonical artifact missing or unreadable: ‹مسیر›

ترجمه: فایل اصلی صفحه چک‌سام ندارد یا با آن مطابقت ندارد. / فایل اصلی صفحه وجود ندارد یا خوانا نیست: ‹مسیر›

معنی

فایل تمپلیت نصب‌شده (dist/template.html) وجود ندارد، یا دیگر با چک‌سامی که هنگام نصب ثبت شده یکی نیست — تغییر کرده یا خراب شده است.

راه حل

با row-template update آن را دوباره نصب کنید. در این فاصله صفحهٔ زنده کار می‌کند.

کجا دیده می‌شود:row-template verify
FAIL

a template in the store does not match its checksum:‹شناسه‌ها›.

ترجمه: یکی از تمپلیت‌های مخزن با چک‌سامش مطابقت ندارد: ‹شناسه‌ها›.

معنی

یک یا چند تمپلیت در مخزن — که در انتهای پیام نام برده شده‌اند — پس از نصب تغییر کرده یا خراب شده‌اند.

راه حل

با row-template update همهٔ تمپلیت‌ها را دوباره نصب کنید.

کجا دیده می‌شود:row-template verify
FAIL

canonical artifact does not match the selected template (‹شناسه›).

ترجمه: فایل اصلی صفحه با تمپلیت انتخاب‌شده (‹شناسه›) مطابقت ندارد.

معنی

config.env یک تمپلیت را نام می‌برد ولی تمپلیت دیگری نصب است. Row-Template خودش هرگز چنین وضعیتی نمی‌سازد؛ نشانهٔ ویرایش دستی یا عملیات نیمه‌کاره است.

راه حل

row-template config را اجرا کنید و در همهٔ پرسش‌ها Enter بزنید — تمپلیت نصب‌شده را با انتخاب ذخیره‌شده هماهنگ می‌کند — یا row-template update را اجرا کنید.

کجا دیده می‌شود:row-template verify
FAIL

selected template '‹شناسه›' is missing from the template store.

ترجمه: تمپلیت انتخاب‌شدهٔ '‹شناسه›' در مخزن تمپلیت‌ها وجود ندارد.

معنی

تمپلیتی که انتخاب کرده‌اید در مخزن تمپلیت‌های نصب نیست.

راه حل

با row-template update مخزن تمپلیت‌ها را دوباره نصب کنید.

کجا دیده می‌شود:row-template verify
FAIL

template store missing or empty; run 'row-template update' to install it.

ترجمه: مخزن تمپلیت‌ها وجود ندارد یا خالی است؛ برای نصب آن row-template update را اجرا کنید.

معنی

نصب مخزن تمپلیت ندارد — وضعیتی که درست پس از نصب نسخهٔ جدیدتر با به‌روزرسان خود 1.1.0 پیش می‌آید، چون آن به‌روزرسان نمی‌داند چطور نصب را کامل کند. verify وقتی با root اجرا شود، اول خودش نصب را کامل می‌کند (همهٔ تمپلیت‌های همان نسخه‌ای که دارید)؛ پس این خط یعنی verify با root اجرا نشده یا این کار ممکن نبوده است.

راه حل

row-template verify را با root اجرا کنید، یا row-template update را اجرا کنید. ارتقا از 1.1.0 یا 1.2.0 ←

کجا دیده می‌شود:row-template verify
FAIL

live template failed structural validation.live template missing or unreadable: ‹مسیر›

ترجمه: تمپلیت زنده در اعتبارسنجی ساختاری رد شد. / تمپلیت زنده وجود ندارد یا خوانا نیست: ‹مسیر›

معنی

صفحه‌ای که پنل ارائه می‌کند، یعنی sub.html، وجود ندارد یا ناقص است. ممکن است مشترکانی که لینکشان را در مرورگر باز می‌کنند خطا ببینند.

راه حل

آن را دوباره بسازید: row-template update را اجرا کنید، یا برای تعمیر نصب‌کننده را دوباره اجرا کنید.

کجا دیده می‌شود:row-template verify
FAIL

VERSION file missing or empty.

ترجمه: فایل VERSION وجود ندارد یا خالی است.

معنی

فایل VERSION نصب وجود ندارد، پس نسخهٔ آن نامعلوم است.

راه حل

نصب‌کننده را دوباره اجرا کنید، یا row-template update را اجرا کنید.

کجا دیده می‌شود:row-template verify
warn

config present but not readable.

ترجمه: پیکربندی وجود دارد اما خوانا نیست.

معنی

config.env وجود دارد اما کاربر فعلی نمی‌تواند آن را بخواند. عمداً فقط root و گروه آن می‌توانند آن را بخوانند.

راه حل

row-template verify را با root اجرا کنید.

کجا دیده می‌شود:row-template verify
warn

config.env is other-writable (mode ‹مجوز›); tighten to 640.

ترجمه: config.env برای همه قابل نوشتن است (مجوز ‹مجوز›)؛ آن را به 640 محدود کنید.

معنی

هر کاربری روی سرور می‌تواند فایل برندینگ شما را تغییر دهد. خود Row-Template همیشه آن را با مجوز 640 می‌نویسد.

راه حل

در 3X-UI: chmod 640 /etc/3x-ui/sub_templates/row-template/config.env؛ در PasarGuard و Rebecca: chmod 640 /etc/row-template/config.env.

کجا دیده می‌شود:row-template verify
warn

management library not found under the install root.CLI not found or not executable at /usr/local/bin/row-template.

ترجمه: کتابخانهٔ مدیریتی زیر ریشهٔ نصب پیدا نشد. / فرمان row-template در /usr/local/bin/row-template پیدا نشد یا قابل اجرا نیست.

معنی

کتابخانهٔ مدیریتی در پوشهٔ نصب، یا فرمان row-template، وجود ندارد. صفحه کار می‌کند، اما ممکن است مدیریت آن ممکن نباشد.

راه حل

نصب‌کننده را دوباره اجرا کنید؛ نصب را در همان جا تعمیر می‌کند و پیکربندی شما را نگه می‌دارد.

کجا دیده می‌شود:row-template verify
warn

installer components are missing (lib/transaction.sh, panels/), as after an update from 1.1.0; run 'row-template update' to complete the installation.

ترجمه: اجزای نصب‌کننده وجود ندارند (lib/transaction.sh و panels/)، مانند وضعیت پس از به‌روزرسانی از 1.1.0؛ برای کامل کردن نصب row-template update را اجرا کنید.

معنی

فایل‌های همراه نصب‌کننده وجود ندارند — وضعیتی که درست پس از نصب نسخهٔ جدیدتر با به‌روزرسان خود 1.1.0 پیش می‌آید، چون آن فقط کتابخانه و فرمان را کپی می‌کند. verify وقتی با root اجرا شود اول نصب را کامل می‌کند؛ پس این خط یعنی با root اجرا نشده یا این کار ممکن نبوده است. صفحه کار می‌کند.

راه حل

row-template verify را با root اجرا کنید، یا row-template update را اجرا کنید. ارتقا از 1.1.0 یا 1.2.0 ←

کجا دیده می‌شود:row-template verify
warn

could not determine the 3x-ui version.3x-ui installation was not detected.

ترجمه: نسخهٔ 3x-ui مشخص نشد. / نصب 3x-ui پیدا نشد.

معنی

verify پنل را پیدا نکرد یا نتوانست نسخه‌اش را بخواند. فایل‌های صفحه به هر حال بررسی می‌شوند.

راه حل

  1. verify را روی سروری که 3X-UI روی آن است و با root اجرا کنید.
  2. بررسی کنید /usr/local/x-ui/x-ui -v نسخه‌ای چاپ کند.
کجا دیده می‌شود:row-template verify
warn

panel subThemeDir is empty; set it to ‹پوشهٔ نصب›.

ترجمه: subThemeDir پنل خالی است؛ آن را روی /etc/3x-ui/sub_templates/row-template تنظیم کنید.

معنی

Row-Template نصب شده اما فعال نشده است: پنل هنوز صفحهٔ داخلی خودش را ارائه می‌کند.

راه حل

آن را فعال کنید — با گزینهٔ 5 — Activate / Re-apply theme در منوی مدیریت، یا از داخل پنل. فعال‌سازی را ببینید.

کجا دیده می‌شود:row-template verify
warn

panel subThemeDir does not point at Row-Template.

ترجمه: subThemeDir پنل به Row-Template اشاره نمی‌کند.

معنی

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

راه حل

اگر عمدی نیست، Row-Template را فعال کنید — فعال‌سازی را ببینید.

کجا دیده می‌شود:row-template verify
warn

leftover staging files found under the install root (possible interrupted update).

ترجمه: فایل‌های موقت باقی‌مانده زیر ریشهٔ نصب پیدا شد (احتمالاً به‌روزرسانی نیمه‌کاره).

معنی

فایل‌های موقتی که با .stage. یا .live. شروع می‌شوند از یک فرمان نیمه‌کاره باقی مانده‌اند. هرگز استفاده نمی‌شوند.

راه حل

  1. وقتی هیچ فرمان row-template در حال اجرا نیست، حذفشان کنید — در 3X-UI: find /etc/3x-ui/sub_templates/row-template -maxdepth 2 \( -name '.stage.*' -o -name '.live.*' \) -delete (در PasarGuard و Rebecca از /etc/row-template استفاده کنید).
  2. سپس row-template verify را دوباره اجرا کنید.
کجا دیده می‌شود:row-template verify
warn

live render check: the panel served its built-in page.

ترجمه: بررسی نمایش زنده: پنل صفحهٔ داخلی خودش را ارائه کرد.

معنی

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

راه حل

فعال‌سازی را بررسی کنید، سپس پنل را ری‌استارت کنید (systemctl restart x-ui) و verify را دوباره اجرا کنید.

کجا دیده می‌شود:row-template verify
warn

live render check: the subscription endpoint was unreachable.

ترجمه: بررسی نمایش زنده: نشانی اشتراک در دسترس نبود.

معنی

نشانی اشتراک روی همین سرور به درخواست محلی پاسخ نداد.

راه حل

بررسی کنید پنل در حال اجرا باشد و سرویس اشتراکش روی پورتی که در پنل تنظیم شده فعال باشد.

کجا دیده می‌شود:row-template verify
warn

VPN-client check: HTML was returned instead of subscription content.

ترجمه: بررسی کلاینت VPN: به‌جای محتوای اشتراک، HTML برگردانده شد.

معنی

درخواستی محلی که مانند اپ VPN ارسال شد، به‌جای پیکربندی صفحهٔ وب را دریافت کرد؛ پس اپ‌های VPN نمی‌توانند به‌روز شوند.

راه حل

مطمئن شوید چیزی که جلوی پنل قرار دارد، هدرهای User-Agent یا Accept درخواست‌ها را تغییر نمی‌دهد.

کجا دیده می‌شود:row-template verify
FAIL

verification FAILED (‹n› hard issue(s), ‹n› warning(s)).

ترجمه: بررسی ناموفق بود (‹n› مشکل جدی، ‹n› هشدار).

معنی

جمع‌بندی verify: دست‌کم یکی از بررسی‌های جدی رد شده است. فرمان با وضعیت 1 خارج می‌شود.

راه حل

خطوط FAIL بالای آن را برطرف کنید — توضیح هر کدام در همین صفحه آمده است.

کجا دیده می‌شود:row-template verify
warn

verification passed with ‹n› warning(s).

ترجمه: بررسی با ‹n› هشدار موفق بود.

معنی

جمع‌بندی verify: هیچ خطای جدی‌ای نیست، پس نصب کار می‌کند، اما برخی بررسی‌ها هشدار داده‌اند.

راه حل

خطوط warn بالای آن را مرور کنید؛ توضیح هر کدام در همین صفحه آمده است.

کجا دیده می‌شود:row-template verify
warn

templates were found outside the store at ‹پوشهٔ نصب›/‹مسیر›; run 'row-template verify' as root to move them.

ترجمه: تمپلیت‌هایی بیرون از مخزن در ‹پوشهٔ نصب›/‹مسیر› پیدا شد؛ برای جابه‌جا کردنشان row-template verify را با root اجرا کنید.

معنی

تمپلیت‌هایی در پوشهٔ نصب اما بیرون از مخزن تمپلیت‌ها پیدا شد؛ جایی که به‌روزرسانی از نسخه‌های قبلی ممکن است آن‌ها را جا گذاشته باشد. بی‌خطرند اما استفاده نمی‌شوند. verify فقط وقتی با root اجرا شود آن‌ها را جابه‌جا می‌کند.

راه حل

row-template verify را با root اجرا کنید: آن‌ها را به dist/templates/ منتقل می‌کند و چیز دیگری را تغییر نمی‌دهد.

کجا دیده می‌شود:row-template verify
warn

template store is incomplete (‹n› of ‹n› designs); missing:‹شناسه‌ها›. Run 'row-template update' to restore them.

ترجمه: مخزن تمپلیت‌ها ناقص است (‹n› از ‹n› تمپلیت)؛ ناموجود: ‹شناسه‌ها›. برای بازگرداندنشان row-template update را اجرا کنید.

معنی

برخی از تمپلیت‌هایی که این نسخه ارائه می‌کند در مخزن تمپلیت‌های نصب وجود ندارند. صفحهٔ زنده کار می‌کند؛ تا بازگردانده نشوند، تمپلیت‌های ناموجود قابل انتخاب نیستند. verify وقتی با root اجرا شود اول آن‌ها را از نسخهٔ نصب‌شده دانلود می‌کند؛ پس این خط یعنی این کار ممکن نبود.

راه حل

row-template update را اجرا کنید — همهٔ تمپلیت‌ها را دوباره نصب می‌کند.

کجا دیده می‌شود:row-template verify
FAIL

the panel components are missing; run 'row-template update'.

ترجمه: اجزای پنل وجود ندارند؛ row-template update را اجرا کنید.

معنی

روی PasarGuard و Rebecca، verify پنل را از طریق فایل‌های همراه نصب‌کننده (lib/transaction.sh و panels/) بررسی می‌کند و این فایل‌ها وجود ندارند، پس پنل بررسی نشد. این یک خطای جدی است.

راه حل

row-template update را اجرا کنید تا آن‌ها را نصب کند و بعد دوباره row-template verify را اجرا کنید.

کجا دیده می‌شود:row-template verify
warn

‹پنل› was not detected on this host.the ‹پنل› configuration could not be read.

ترجمه: ‹پنل› روی این سرور پیدا نشد. / پیکربندی ‹پنل› خوانده نشد.

معنی

پنلی که این نصب به آن سرویس می‌دهد روی سرور پیدا نشد، یا پیکربندی‌اش (فایل .env پنل PasarGuard یا تنظیمات اشتراک Rebecca) خوانده نشد. فایل‌های صفحه به هر حال بررسی می‌شوند.

راه حل

  1. verify را با root و روی سروری که پنل روی آن است اجرا کنید.
  2. خود پنل را بررسی کنید: rebecca status، یا برای PasarGuard فرمان pasarguard status (نصب رسمی Docker) یا systemctl status pasarguard (نصب از سورس). اگر پنل حذف شده، Row-Template را هم با row-template uninstall حذف کنید.
کجا دیده می‌شود:row-template verify
warn

‹پنل› does not select the Row-Template page; activate it from the manager.

ترجمه: ‹پنل› صفحهٔ Row-Template را انتخاب نمی‌کند؛ از منوی مدیریت فعالش کنید.

معنی

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

راه حل

row-template را اجرا کنید و 5 — Activate / Re-apply theme را انتخاب کنید. فعال‌سازی را ببینید.

کجا دیده می‌شود:row-template verify
FAIL

‹پنل›'s Row-Template page is out of step (see above); re-apply it from the manager (Activate).

ترجمه: صفحهٔ Row-Template در ‹پنل› با بقیه هماهنگ نیست (بالا را ببینید)؛ از منوی مدیریت دوباره اعمالش کنید (Activate).

معنی

پنل Row-Template را انتخاب کرده، اما یکی از بررسی‌های درست بالاتر رد شد — صفحه در پوشهٔ تمپلیت‌های پنل نیست، با صفحهٔ ساخته‌شده فرق دارد، یا فایل‌های خود Row-Template خراب‌اند. این یک خطای جدی است.

راه حل

خط panel … درست بالاتر را بخوانید، سپس row-template را اجرا کنید و 5 — Activate / Re-apply theme را انتخاب کنید. اگر فایل‌های Row-Template خراب‌اند، اول row-template update را اجرا کنید.

کجا دیده می‌شود:row-template verify
warn

the running ‹پنل› does not use the Row-Template page yet; restart the panel.

ترجمه: ‹پنل›ِ در حال اجرا هنوز از صفحهٔ Row-Template استفاده نمی‌کند؛ پنل را ری‌استارت کنید.

معنی

فایل‌ها و تنظیمات درست‌اند، اما پنلِ در حال اجرا هنوز از صفحهٔ قبلی‌اش استفاده می‌کند. روی PasarGuard یعنی کانتینر پس از تغییر .env دوباره ساخته نشده است.

راه حل

پنل را ری‌استارت کنید (pasarguard restart) و row-template verify را دوباره اجرا کنید.

کجا دیده می‌شود:row-template verify

حذف

FAIL

refusing to delete ‹پوشهٔ نصب›: it does not look like a Row-Template install root.refusing to delete a system path: ‹پوشهٔ نصب›

ترجمه: ‹پوشهٔ نصب› حذف نمی‌شود: به ریشهٔ نصب Row-Template شبیه نیست. / مسیر سیستمی حذف نمی‌شود: ‹پوشهٔ نصب›

معنی

حذف‌کننده پیش از پاک کردن هر چیزی تأیید می‌کند که پوشه نصب Row-Template است (باید VERSION و تمپلیت یا کتابخانه را داشته باشد) و مسیر سیستمی نیست. این بررسی رد شد، پس چیزی حذف نشد.

راه حل

  1. محتوای پوشهٔ نصب را بررسی کنید (/etc/3x-ui/sub_templates/row-template در 3X-UI و /etc/row-template در PasarGuard و Rebecca).
  2. اگر نصب خراب Row-Template است، اول با اجرای دوبارهٔ نصب‌کننده تعمیرش کنید و بعد حذف کنید — یا دستی حذفش کنید.
کجا دیده می‌شود:row-template uninstall
FAIL

refusing to uninstall non-interactively without RT_ASSUME_YES=1.

ترجمه: بدون RT_ASSUME_YES=1 حذف غیرتعاملی انجام نمی‌شود.

معنی

حذف نیاز به تأیید دارد و ترمینالی برای پرسیدن وجود ندارد. چیزی حذف نشد.

راه حل

برای تأیید از داخل اسکریپت، RT_ASSUME_YES=1 row-template uninstall را اجرا کنید.

کجا دیده می‌شود:row-template uninstall
warn

could not clear subThemeDir automatically. In the panel, clear Settings -> Subscription -> Sub Theme Directory.

ترجمه: subThemeDir به‌صورت خودکار پاک نشد. در پنل، Settings -> Subscription -> Sub Theme Directory را خالی کنید.

معنی

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

راه حل

در پنل، Panel Settings → Subscription → Sub Theme Directory را خالی کنید، ذخیره کنید و پنل را ری‌استارت کنید.

کجا دیده می‌شود:row-template uninstall
warn

could not read subThemeDir (sqlite3/DB unavailable). If it points at ‹پوشهٔ نصب›, clear it in the panel.

ترجمه: subThemeDir خوانده نشد (sqlite3 یا پایگاه‌داده در دسترس نیست). اگر به /etc/3x-ui/sub_templates/row-template اشاره می‌کند، آن را در پنل خالی کنید.

معنی

بدون sqlite3 (یا پایگاه‌دادهٔ پنل)، حذف‌کننده نمی‌تواند بفهمد پوشهٔ پوستهٔ پنل به کجا اشاره می‌کند، پس به آن دست نمی‌زند.

راه حل

Panel Settings → Subscription را باز کنید. اگر Sub Theme Directory برابر /etc/3x-ui/sub_templates/row-template است، خالی‌اش کنید، ذخیره کنید و پنل را ری‌استارت کنید.

کجا دیده می‌شود:row-template uninstall
FAIL

uninstall could not complete safely; see the message above. No forced deletion was performed.

ترجمه: حذف به‌طور ایمن کامل نشد؛ پیام بالا را ببینید. هیچ حذف اجباری‌ای انجام نشد.

معنی

حذف فایل‌ها به دلیلی که درست بالاتر چاپ شده ادامه پیدا نکرد. هیچ چیزی به‌اجبار حذف نشد.

راه حل

مشکلی را که در بالا نام برده شده برطرف کنید و row-template uninstall را دوباره اجرا کنید.

کجا دیده می‌شود:row-template uninstall
FAIL

the panel components are missing, so ‹پنل› cannot be reverted automatically; run 'row-template update' first.could not revert ‹پنل›.uninstall stopped before removing anything; the panel and Row-Template are unchanged.

ترجمه: اجزای پنل وجود ندارند، پس ‹پنل› به‌صورت خودکار برگردانده نمی‌شود؛ اول row-template update را اجرا کنید. / ‹پنل› برگردانده نشد. / حذف پیش از پاک کردن هر چیزی متوقف شد؛ پنل و Row-Template تغییری نکرده‌اند.

معنی

روی PasarGuard و Rebecca، حذف اول پنل را به صفحه‌ای که پیش از Row-Template داشت برمی‌گرداند و فقط بعد از آن فایل‌های Row-Template را پاک می‌کند. پنل برگردانده نشد — خطوط بالا علت را می‌گویند — پس حذف پیش از پاک کردن هر چیزی متوقف شد. پنل و Row-Template هر دو دقیقاً مثل قبل‌اند.

راه حل

  1. اگر اجزای نصب‌کننده وجود ندارند، row-template update را اجرا کنید و دوباره حذف کنید.
  2. در غیر این صورت مشکلی را که در بالا نام برده شده برطرف کنید (مثلاً بلوک خراب در .env یا پنلی که ری‌استارت نشد) و row-template uninstall را دوباره اجرا کنید.
کجا دیده می‌شود:row-template uninstall
warn

‹پنل›'s selection cannot be changed automatically here.

ترجمه: انتخاب ‹پنل› اینجا به‌صورت خودکار تغییر نمی‌کند.

معنی

حذف‌کننده اینجا نمی‌تواند صفحهٔ انتخاب‌شدهٔ پنل را تغییر دهد — در Rebecca چون تنظیماتش نوشته نمی‌شوند (MySQL/MariaDB یا نبود sqlite3)، در PasarGuard چون .env خوانده نشد — پس فایل‌های Row-Template را پاک می‌کند و از شما می‌خواهد صفحه را خودتان برگردانید. تا این کار را نکنید، پنل به صفحه‌ای اشاره می‌کند که دیگر وجود ندارد.

راه حل

  1. Rebecca: در داشبورد Settings → Subscription → Templates را باز کنید و Subscription page template را به subscription/index.html (صفحهٔ خود Rebecca) یا صفحهٔ دلخواهتان برگردانید.
  2. PasarGuard: بلوک # >>> row-template را از /opt/pasarguard/.env حذف کنید و سپس pasarguard restart را اجرا کنید.
کجا دیده می‌شود:row-template uninstall

فرمان و منوی مدیریت

FAIL

Row-Template is not installed (run the installer first).Row-Template is not installed; run the installer first.Row-Template is not installed.Row-Template is not installed at ‹پوشهٔ نصب›; run the installer first.Row-Template does not appear to be installed at ‹پوشهٔ نصب›.

ترجمه: Row-Template نصب نیست (اول نصب‌کننده را اجرا کنید).

معنی

این فرمان به نصب موجود نیاز دارد و پوشهٔ نصب هیچ تمپلیت نصب‌شده‌ای (یا فایل VERSION) ندارد.

راه حل

  1. اول Row-Template را نصب کنید — شروع سریع را ببینید.
  2. اگر نصب بوده، نصب‌کننده را دوباره اجرا کنید تا تعمیرش کند؛ پیکربندی شما حفظ می‌شود.
کجا دیده می‌شود:row-template configrow-template updaterow-template rollbackrow-template uninstallمنوی مدیریت
FAIL

unknown command: ‹فرمان›

ترجمه: فرمان ناشناخته: ‹فرمان›

معنی

row-template چنین فرمانی ندارد. راهنما پس از این خط چاپ می‌شود و فرمان با وضعیت 2 خارج می‌شود.

راه حل

از یکی از config، update، rollback، verify، version، uninstall، menu یا help استفاده کنید — مرجع فرمان‌ها را ببینید.

کجا دیده می‌شود:هر فرمانی
row-template:

management library not found at ‹مسیر›the install may be damaged; re-run the installer.

ترجمه: کتابخانهٔ مدیریتی در ‹مسیر› پیدا نشد / ممکن است نصب آسیب دیده باشد؛ نصب‌کننده را دوباره اجرا کنید.

معنی

فرمان row-template فقط یک راه‌انداز است و کتابخانهٔ مدیریتی‌ای که بارگذاری می‌کند در پوشهٔ نصب وجود ندارد.

راه حل

نصب‌کننده را دوباره اجرا کنید. نصب را در همان جا تعمیر می‌کند و برندینگ و تمپلیت شما را نگه می‌دارد.

کجا دیده می‌شود:هر فرمانی
FAIL

unexpected error (line ‹خط›); no partial change was committed.

ترجمه: خطای پیش‌بینی‌نشده (خط ‹خط›)؛ هیچ تغییر ناقصی ثبت نشد.

معنی

فرمانی در نقطه‌ای شکست خورد که پیام مشخصی برایش وجود ندارد. تغییرات Row-Template اول آماده و بعد به‌صورت اتمی جایگزین می‌شوند، پس هیچ فایل نیمه‌نوشته‌ای سر جایش قرار نگرفته است.

راه حل

  1. برای بررسی وضعیت row-template verify را اجرا کنید.
  2. فرمان را دوباره اجرا کنید. اگر تکرار شد، با خروجی کامل و شمارهٔ خط یک issue باز کنید.
کجا دیده می‌شود:هر فرمانی
warn

Invalid option. Choose a number 0-‹n›.

ترجمه: گزینهٔ نامعتبر. عددی بین 0 و ‹n› انتخاب کنید.

معنی

منو چیزی غیر از یکی از شماره‌هایش دریافت کرده است و دوباره می‌پرسد.

راه حل

یکی از شماره‌های نمایش‌داده‌شده در منو را وارد کنید و Enter بزنید.

کجا دیده می‌شود:منوی مدیریت
FAIL

could not load panel interfacecould not load panel registrycould not load the transaction engine

ترجمه: رابط پنل بارگذاری نشد / فهرست پنل‌ها بارگذاری نشد / موتور تراکنش بارگذاری نشد

معنی

فایل‌های همراه کتابخانهٔ مدیریتی (panels/ و lib/transaction.sh) وجود دارند اما بارگذاری نشدند — خراب شده‌اند یا ویرایش شده‌اند. همهٔ فرمان‌های row-template همین‌جا متوقف می‌شوند. (اگر اصلاً وجود نداشته باشند — مثل درست پس از نصب نسخهٔ جدیدتر با به‌روزرسان خود 1.1.0 — فرمان اجرا می‌شود، در صورت امکان نصب را کامل می‌کند و verify کمبودها را گزارش می‌دهد.)

راه حل

برای تعمیر، نصب‌کننده را دوباره اجرا کنید؛ این فایل‌ها را جایگزین می‌کند.

کجا دیده می‌شود:هر فرمانی
FAIL

panel registry: the 3xui adapter exists but could not be loadedpanel registry: the pasarguard adapter exists but could not be loadedpanel registry: the rebecca adapter exists but could not be loaded

ترجمه: فهرست پنل‌ها: آداپتور 3xui / pasarguard / rebecca وجود دارد اما بارگذاری نشد

معنی

یکی از آداپتورهای پنل زیر panels/ در پوشهٔ نصب وجود دارد اما بارگذاری نشد — خراب شده یا ویرایش شده است. فرمان همین‌جا متوقف می‌شود.

راه حل

برای تعمیر نصب، نصب‌کننده را دوباره اجرا کنید؛ این فایل‌ها را جایگزین می‌کند و پیکربندی شما را نگه می‌دارد.

کجا دیده می‌شود:هر فرمانی

بررسی‌های ایمنی داخلی

FAIL

ترجمه: روی پیوند نمادین عملیاتی انجام نمی‌شود: ‹مسیر›

معنی

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

راه حل

پیوندی را که در پیام آمده با فایل یا پوشهٔ واقعی جایگزین کنید یا حذفش کنید و فرمان را دوباره اجرا کنید. هیچ چیزی زیر پوشهٔ نصب نباید symlink باشد.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template uninstallمنوی مدیریت
FAIL

refusing to recursively delete /refusing to recursively delete path outside backups: ‹مسیر›

ترجمه: حذف بازگشتی / انجام نمی‌شود / حذف بازگشتی مسیری بیرون از پشتیبان‌ها انجام نمی‌شود: ‹مسیر›

معنی

محافظی که حذف بازگشتی را فقط دقیقاً داخل پوشهٔ پشتیبان‌ها اجازه می‌دهد، جلوی یک حذف را گرفت. در استفادهٔ عادی نباید رخ دهد؛ چیزی حذف نشد.

راه حل

با خروجی کامل و فرمانی که اجرا کردید گزارش دهید.

کجا دیده می‌شود:نصب‌کنندهrow-template updateمنوی مدیریت
FAIL

expected checksum is not 64 hex characterscannot checksum missing file: ‹مسیر›

ترجمه: چک‌سام مورد انتظار ۶۴ نویسهٔ هگزادسیمال نیست / برای فایل ناموجود چک‌سام محاسبه نمی‌شود: ‹مسیر›

معنی

یک فایل چک‌سام (*.sha256) خراب یا خالی است، یا فایلی که توصیف می‌کند وجود ندارد. آن فایل بررسی‌نشده تلقی می‌شود و استفاده نمی‌شود.

راه حل

با row-template verify پیدا کنید کدام است و بعد با row-template update فایل‌ها را دوباره نصب کنید.

کجا دیده می‌شود:نصب‌کنندهrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
FAIL

checksum mismatch (expected ‹هش›… got ‹هش›…)

ترجمه: چک‌سام مطابقت ندارد (انتظار ‹هش›… دریافت ‹هش›…)

معنی

یک فایل با SHA-256 ثبت‌شده‌اش یکی نیست — ۱۲ نویسهٔ اول هر دو نمایش داده می‌شود. فایل تغییر کرده، خراب یا ناقص شده و استفاده نمی‌شود. خط دوم می‌گوید چه چیزی بررسی می‌شد.

راه حل

  1. برای دانلود: فرمان را دوباره اجرا کنید یا نسخه را دوباره دانلود کنید.
  2. برای فایل نصب‌شده: row-template update آن را دوباره نصب می‌کند.
کجا دیده می‌شود:نصب‌کنندهrow-template updaterow-template rollbackrow-template verifyمنوی مدیریت
FAIL

ترجمه: بررسی‌های نویسندهٔ عکس فوری: از طریق پیوند نمادین نوشته نمی‌شود / عکس فوری موقت ساخته نشد / عکس فوری از قبل وجود دارد / عکس فوری جدید در بررسی رد شد و کنار گذاشته شد / … و بررسی‌های قالب رکوردهای پنل (panel write:، aux:)

معنی

فعال‌سازی پیش از هر تغییری روی PasarGuard یا Rebecca، از تنظیمات پنل یک عکس فوری در backups.v2/ داخل پوشهٔ نصب می‌نویسد، همراه با فهرستی (manifest) از همهٔ فایل‌های آن. این‌ها بررسی‌های خودِ نویسندهٔ عکس فوری‌اند. چندتایشان علتی روی سرور دارند — backups.v2/ پیوند نمادین است، دیسک پر است، یا عکس فوری‌ای با همان نام از قبل هست؛ بقیه از قالب عکس فوری محافظت می‌کنند و نباید هرگز دیده شوند. در همهٔ حالت‌ها فعال‌سازی پیش از تغییر پنل متوقف می‌شود.

راه حل

  1. فضای آزاد را با df -h /etc بررسی کنید و مطمئن شوید backups.v2/ در پوشهٔ نصب پوشهٔ واقعی است، نه پیوند. سپس دوباره از منوی مدیریت فعال‌سازی کنید.
  2. اگر پیام یک فیلد را نام می‌برد (state، mechanism، aux و…)، با خروجی کامل گزارش دهید.
کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت
FAIL

transaction: RT_ROOT is unset; refusing to locktransaction: refusing a symlinked install root: ‹پوشهٔ نصب›transaction: could not create the lock directory: ‹مسیر›transaction: refusing a symlinked lock directory: ‹مسیر›transaction: refusing a symlinked lock file: ‹مسیر›transaction: fd 9 is already open; refusing to reuse the lock descriptortransaction: could not open the lock file: ‹مسیر›transaction: RT_PANEL_STAGE is unset; refusing to clear ittransaction: refusing to clear /transaction: refusing to clear a symlinked stage: ‹مسیر›transaction: unexpected stage path (expected a .panel-stage directory): ‹مسیر›transaction: refusing to clear a stage outside the install root: ‹مسیر›transaction: could not clear the stage: ‹مسیر›

ترجمه: تراکنش: بررسی‌های قفل و پوشهٔ کاری (.panel-stage) — قفل یا پاک‌سازی از طریق پیوند نمادین، بیرون از پوشهٔ نصب یا با مسیر خالی انجام نمی‌شود

معنی

تراکنش فعال‌سازی روی نصب قفل می‌گیرد و از یک پوشهٔ کاری به نام .panel-stage داخل آن استفاده می‌کند. این بررسی‌ها اجازه نمی‌دهند چیزی از طریق پیوند نمادین، بیرون از پوشهٔ نصب یا با مسیر خالی قفل یا پاک شود. یک پیوند یا دیسک پر می‌تواند باعثشان شود؛ در غیر این صورت نباید هرگز دیده شوند. فعال‌سازی پیش از تغییر پنل متوقف می‌شود.

راه حل

  1. مطمئن شوید هیچ چیز زیر پوشهٔ نصب پیوند نمادین نیست و دیسک فضای آزاد دارد، سپس دوباره فعال‌سازی کنید.
  2. اگر تکرار شد، با خروجی کامل گزارش دهید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
FAIL

transaction: unknown state '‹وضعیت›'transaction: invalid transition ‹وضعیت› -> ‹وضعیت›transaction: unknown panel id '‹پنل›' (known: 3xui pasarguard rebecca)transaction: SOURCE is requiredtransaction: panel '‹پنل›' is not present on this host (status ‹وضعیت›)transaction: panel '‹پنل›' cannot be identified in this build (status ‹وضعیت›)transaction: detection failed for panel '‹پنل›' (status ‹وضعیت›)transaction: capabilities are unavailable for panel '‹پنل›' (status ‹وضعیت›)transaction: panel '‹پنل›' reported an unknown capability '‹قابلیت›'transaction: panel '‹پنل›' does not declare the required capability '‹قابلیت›'transaction: panel '‹پنل›' declares no apply capability (needs one of: file_placement selection_write)transaction: could not capture the state of panel '‹پنل›' (status ‹وضعیت›)

ترجمه: تراکنش: بررسی‌های پیش از تغییر — شناسهٔ پنل، حضور پنل روی سرور، قابلیت‌های اعلام‌شدهٔ آداپتور، و خواندن وضعیت فعلی پنل برای عکس فوری

معنی

بررسی‌های تراکنش فعال‌سازی پیش از هر تغییری: پنل باید موجود و شناسایی‌شده باشد، آداپتورش باید قابلیت‌هایی را که فعال‌سازی لازم دارد اعلام کند، و تنظیمات فعلی‌اش باید برای عکس فوری خوانده شود. could not capture the state علتی روی سرور دارد — پیام خود آداپتور درست بالاتر آن را نام می‌برد (مثلاً پایگاه‌دادهٔ Rebecca خوانده نمی‌شود). بقیه از خود موتور تراکنش محافظت می‌کنند. فعال‌سازی متوقف می‌شود و هیچ تغییری اعمال نمی‌شود.

راه حل

  1. اگر خط panel … در بالا هست، آن را بخوانید و مشکلی را که نام می‌برد برطرف کنید.
  2. در غیر این صورت با خروجی کامل گزارش دهید.
کجا دیده می‌شود:نصب‌کنندهمنوی مدیریت
FAIL

panel pasarguard: malformed selection.statepanel pasarguard: malformed panel metapanel pasarguard: mechanism is '‹سازوکار›', expected 'env'panel pasarguard: malformed files recordpanel pasarguard: refusing to restore: the record lists a file this adapter never places: ‹مسیر›panel pasarguard: malformed block recordpanel pasarguard: malformed root recordpanel pasarguard: malformed dir recordpanel rebecca: subscription_page_template cannot have been absent (state '‹وضعیت›')panel rebecca: malformed dir_state recordpanel rebecca: malformed selection.statepanel rebecca: malformed panel metapanel rebecca: mechanism is '‹سازوکار›', expected 'db'panel rebecca: malformed files recordpanel rebecca: refusing to restore: the record lists a file this adapter never places: ‹مسیر›panel rebecca: malformed root record

ترجمه: پنل pasarguard / rebecca: رکوردهای عکس فوری نامعتبرند (selection.state، اطلاعات پنل، فهرست فایل‌ها، بلوک، ریشه یا پوشه) یا فایلی را نام می‌برند که آداپتور هرگز نمی‌گذارد

معنی

عکس فوری تنظیمات پنل پیش از بازگردانی دوباره خوانده می‌شود و هر رکورد آن باید دقیقاً همان باشد که آداپتور نوشته است. این یکی نیست — ویرایش یا خراب شده، یا از جایی غیر از Row-Template آمده — پس به‌جای بازگردانی نیمه‌کاره، اصلاً بازگردانده نمی‌شود. پنل همان‌طور که هست می‌ماند.

راه حل

  1. فایل‌های زیر backups.v2/ را ویرایش نکنید.
  2. انتخاب پنل را خودتان بررسی کنید (PasarGuard: بلوک row-template در /opt/pasarguard/.env؛ Rebecca: Settings → Subscription → Templates) و row-template verify را اجرا کنید.
کجا دیده می‌شود:نصب‌کنندهrow-template uninstallمنوی مدیریت
FAIL

panel pasarguard: SOURCE is requiredpanel pasarguard: refusing a symlinked SOURCEpanel pasarguard: SOURCE is not a regular file: ‹مسیر›panel pasarguard: SOURCE is outside ‹پوشهٔ نصب›panel pasarguard: unknown verification mode '‹حالت›'panel rebecca: SOURCE is requiredpanel rebecca: refusing a symlinked SOURCEpanel rebecca: SOURCE is not a regular file: ‹مسیر›panel rebecca: SOURCE is outside ‹پوشهٔ نصب›panel rebecca: unknown verification mode '‹حالت›'panel dispatch: no dispatch arm for implementation '‹آداپتور›' verb '‹عملیات›'panel ‹عملیات›: unknown panel id '‹پنل›' (known: 3xui pasarguard rebecca)panel install_template: SOURCE is requiredpanel verify: takes exactly PANEL MODE, got $# argumentspanel verify: MODE must be static|live, got '‹مقدار›'panel restore_state: SNAPSHOT is required

ترجمه: بررسی‌های ورودی رابط پنل: منبع (SOURCE) باید فایل معمولی داخل پوشهٔ نصب باشد و پیوند نمادین نباشد؛ هر فراخوانی باید پنل و عملیات شناخته‌شده‌ای را نام ببرد

معنی

بررسی‌های ورودی رابط پنل: صفحه‌ای که به آداپتور داده می‌شود باید فایل معمولی داخل پوشهٔ نصب باشد و هرگز پیوند نباشد، و هر فراخوانی باید پنل و عملیات شناخته‌شده‌ای را نام ببرد. فرمان‌های خود Row-Template همیشه ورودی معتبر می‌دهند، پس این پیام‌ها نباید هرگز دیده شوند؛ عملیات بدون هیچ تغییری متوقف می‌شود.

راه حل

با خروجی کامل و فرمانی که اجرا کردید گزارش دهید.

کجا دیده می‌شود:نصب‌کنندهrow-template configrow-template updaterow-template rollbackrow-template verifyمنوی مدیریتهیچ فرمانی (بررسی داخلی)
FAIL

panel 3xui: the stored selection contains a newline and cannot be recorded exactlypanel 3xui: SOURCE is requiredpanel 3xui: refusing a symlinked SOURCE: ‹مسیر›panel 3xui: SOURCE is not a regular file: ‹مسیر›panel 3xui: SOURCE is outside the Row-Template root (‹پوشهٔ نصب›): ‹مسیر›panel 3xui: unknown verification mode '‹حالت›'panel 3xui: the artifact is missing: ‹مسیر›panel 3xui: the artifact failed structural validationpanel 3xui: the recorded checksum is unreadablepanel 3xui: the artifact does not match its recorded checksumpanel 3xui: cannot read the panel selectionpanel 3xui: subThemeDir is '‹مقدار›', expected '‹پوشهٔ نصب›'panel 3xui: the snapshot's selection.state is malformedpanel 3xui: selection.state must be absent|empty|present, got '‹وضعیت›'panel 3xui: the snapshot's panel meta is malformedpanel 3xui: mechanism is '‹سازوکار›', expected 'db'panel 3xui: was_running must be 0|1, got '‹مقدار›'panel 3xui: the snapshot's files record is malformedpanel 3xui: refusing to restore: this panel places no file, but the snapshot lists onepanel 3xui: state=present but the selection value is unreadablepanel 3xui: cannot read the selection back after restoringpanel 3xui: after restoring, the selection state is '‹وضعیت›', expected '‹وضعیت›'panel 3xui: cannot read the selection value back after restoringpanel 3xui: after restoring, subThemeDir is not the recorded value

ترجمه: پنل 3xui: بررسی‌های داخلی آداپتور 3X-UI (منبع، فایل صفحه و چک‌سامش، خواندن subThemeDir، و رکوردهای عکس فوری)

معنی

بررسی‌های داخل آداپتور 3X-UI در رابط پنل. در 1.3.0 فرمان‌های row-template، 3X-UI را مستقیم تنظیم می‌کنند — دقیقاً مثل قبل خودشان subThemeDir را می‌نویسند — و از این آداپتور استفاده نمی‌کنند؛ پس هیچ فرمانی این پیام‌ها را چاپ نمی‌کند. فقط چون در سورس نصب‌کننده هستند اینجا آمده‌اند.

راه حل

اگر روزی یکی از آن‌ها را دیدید، با خروجی کامل و فرمانی که اجرا کردید گزارش دهید.

کجا دیده می‌شود:هیچ فرمانی (بررسی داخلی)
ویرایش این صفحه در GitHubمربوط به Row-Template نسخهٔ 1.4.0
Esc
↑↓ برای جابه‌جایی↵ برای انتخابEsc برای بستن