مرجع فرمان‌ها

نصب‌کننده یک فرمان روی سرور شما می‌گذارد: /usr/local/bin/row-template. این فرمان فقط یک راه‌انداز ساده برای کتابخانهٔ مدیریتی در پوشهٔ نصب است — /etc/3x-ui/sub_templates/row-template در 3X-UI و /etc/row-template در PasarGuard و Rebecca. فرمان‌ها روی همهٔ پنل‌ها یکسان‌اند.

row-template <command> [options]

اگر آن را بدون آرگومان در ترمینال اجرا کنید، منوی مدیریت تعاملی باز می‌شود. بدون ترمینال — در اسکریپت، cron، CI یا curl | bash — به‌جای آن راهنما را چاپ می‌کند، پس هرگز منتظر ورودی نمی‌ماند.

فرمان‌ها

فرمان	چه می‌کند	root
`row-template config`	نام سرویس، نشانی پشتیبانی یا لوگو را تغییر می‌دهد و صفحه را دوباره می‌سازد. برندینگ ←	بله
`row-template update`	آخرین نسخهٔ پایدار را دانلود، بررسی و فعال می‌کند. به‌روزرسانی ←	بله
`row-template rollback`	نسخهٔ قبلی را از یک پشتیبان بازمی‌گرداند. گزینه‌ها: `--auto` و `--to <backup>`. بازگردانی ←	بله
`row-template verify`	نصب، اتصال پنل و صفحهٔ زنده را بررسی می‌کند. Verify ←	پیشنهاد می‌شود
`row-template version`	نسخهٔ نصب‌شده و پنلی را که به آن سرویس می‌دهد نشان می‌دهد؛ در 3X-UI حداقل نسخهٔ پشتیبانی‌شده و نسخهٔ تشخیص‌داده‌شدهٔ 3X-UI را هم. نام‌های دیگر: `-v` و `--version`.	خیر
`row-template uninstall`	Row-Template را حذف می‌کند و پنل را به صفحه‌ای که پیش‌تر داشت برمی‌گرداند. حذف ←	بله
`row-template menu`	منوی مدیریت تعاملی را صراحتاً باز می‌کند. نام دیگر: `manager`.	بله
`row-template help`	روش استفاده را نشان می‌دهد. نام‌های دیگر: `-h` و `--help`.	خیر

فرمان‌هایی که سیستم را تغییر می‌دهند بدون root اجرا نمی‌شوند:

  FAIL this operation must run as root (e.g. sudo row-template ...)

verify روی root پافشاری نمی‌کند، اما با کاربر دیگر نمی‌تواند config.env یا تنظیمات پنل را بخواند، پس گزارش کمتری می‌دهد. با root، پیش از بررسی مخزن تمپلیت‌ها را هم مرتب می‌کند — Verify را ببینید.

version

row-template version

Row-Template 1.4.0
Panel: 3X-UI
Supported 3x-ui minimum: 3.6.0
Detected 3x-ui: 3.8.5

Row-Template 1.4.0
Panel: PasarGuard

Row-Template 1.4.0
Panel: Rebecca

unknown یعنی مقدار خوانده نشد. این خروجی را در گزارش خطا بیاورید.

گزینه‌های rollback

شکل	چه چیزی را بازمی‌گرداند
`row-template rollback`	جدیدترین پشتیبان معتبر.
`row-template rollback --auto`	همان، به‌صورت صریح.
`row-template rollback --to <backup>`	پشتیبانی مشخص: مسیر کامل آن، یا فقط نام پوشه‌اش زیر `backups/`.

خروجی

هر فرمان خطوط وضعیت کوتاهی چاپ می‌کند:

  ok   Canonical artifact integrity verified.
  warn PasarGuard does not select the Row-Template page; activate it from the manager.
  FAIL verification FAILED (1 hard issue(s), 1 warning(s)).

خطوط ok به خروجی استاندارد و خطوط warn و FAIL به خروجی خطا می‌روند. پیام‌های آداپتور پنل با نام پنل شروع می‌شوند، مثل panel pasarguard: یا panel rebecca:. رنگ فقط در ترمینال استفاده می‌شود و هرگز وقتی NO_COLOR تنظیم شده باشد. همهٔ پیام‌های warn و FAIL در مرجع خطاها توضیح داده شده‌اند.

کد خروج

کد	معنی
`0`	موفقیت. برای `verify`: هیچ خطای جدی (هشدار مجاز است).
`1`	فرمان شکست خورد، یا `verify` خطای جدی پیدا کرد.
`2`	فرمان ناشناخته — پس از خطا راهنما چاپ می‌شود.

فرمان‌هایی که سیستم را تغییر می‌دهند به‌صورت تراکنش کار می‌کنند: اگر یکی در میانه شکست بخورد، پیش از خروج وضعیت قبلی را بازمی‌گرداند و این را اعلام می‌کند. اگر نتواند، به شما می‌گوید row-template rollback را اجرا کنید.

وقتی خود فرمان خراب است

اگر کتابخانهٔ مدیریتی وجود نداشته باشد، راه‌انداز چیزی برای بارگذاری ندارد و مثلاً در 3X-UI این را چاپ می‌کند:

row-template: management library not found at /etc/3x-ui/sub_templates/row-template/lib/row-template.sh
row-template: the install may be damaged; re-run the installer.

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