نصب دستی

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

از این صفحه وقتی استفاده کنید که:

سرور به GitHub دسترسی ندارد (بدون اینترنت، فیلترشده یا پشت فایروال سخت‌گیر)؛
می‌خواهید پیش از اجرای هر چیزی با root، نسخه را بخوانید و بررسی کنید؛
به‌جای آخرین نسخه، نسخهٔ مشخصی را نصب می‌کنید.

روی 3X-UI، PasarGuard و Rebecca یکسان کار می‌کند.

روش الف — نصب از پوشهٔ محلی (پیشنهادی)

چهار فایل نسخه را دانلود کنید

روی هر دستگاهی که اینترنت دارد، این فایل‌ها را از صفحهٔ نسخه در یک پوشهٔ خالی دانلود کنید:

فایل	چیست
`row-template-1.4.0.tar.gz`	خود نسخه: همهٔ طرح‌ها برای هر پنل، کتابخانهٔ مدیریتی و فرمان `row-template`
`SHA256SUMS`	چک‌سام SHA-256 فایل tarball
`manifest.txt`	اطلاعات متنی ساده: `name`، `version`، `artifact`، `min_xui`، `created`
`install.sh`	نصب‌کننده

از ترمینال:

mkdir row-template-1.4.0-release && cd row-template-1.4.0-release
base=https://github.com/iitzSeriZdev/Row-Template/releases/download/v1.4.0
for f in row-template-1.4.0.tar.gz SHA256SUMS manifest.txt install.sh; do
  curl -fLO "$base/$f"
done

چک‌سام را بررسی کنید

در همان پوشه:

sha256sum -c SHA256SUMS

باید این را ببینید:

row-template-1.4.0.tar.gz: OK

هر چیز دیگری — FAILED یا هشدار نبودن فایل — یعنی دانلود ناقص است یا فایل منتشرشده نیست. دوباره دانلود کنید و ادامه ندهید. در macOS از shasum -a 256 -c SHA256SUMS استفاده کنید.

چک‌سامِ منطبق چه چیزی را ثابت می‌کند

ثابت می‌کند tarball دقیقاً همان فایلی است که در SHA256SUMS نام برده شده و در مسیر خراب نشده است. به‌تنهایی ثابت نمی‌کند چه کسی آن را منتشر کرده — برای آن به دانلود از طریق HTTPS از مخزن رسمی تکیه کنید. بررسی نسخه مدل اعتماد را توضیح می‌دهد.

manifest را بررسی کنید

cat manifest.txt

name=row-template
version=1.4.0
artifact=row-template-1.4.0.tar.gz
min_xui=3.6.0
created=…

artifact باید نام همان tarballی باشد که بررسی کردید — نصب‌کننده آن را می‌خواند تا بداند کدام فایل را باز کند. min_xui فقط به 3X-UI مربوط است.

محتوا را ببینید (اختیاری)

tarball فهرست چک‌سام همهٔ فایل‌های داخلش را هم همراه دارد:

tar -xzf row-template-1.4.0.tar.gz
cd row-template-1.4.0
sha256sum -c SHA256SUMS --quiet && echo "all files OK"
cd ..

row-template-1.4.0/

├── template.html # the Row design (3X-UI)

├── templates/<id>/ # all seventeen designs for 3X-UI, each with template.html.sha256

├── shells/<panel>/<id>/ # every design for each panel (3xui, pasarguard, rebecca),

│ # each with shell.html.sha256 — the installer places

│ # the PasarGuard and Rebecca ones on those panels

├── lib/row-template.sh # the management library

├── lib/transaction.sh # the activation transaction engine

├── panels/ # one adapter per panel

├── bin/row-template # the row-template command

├── install.sh

├── VERSION

└── SHA256SUMS # checksums of every file above

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

پوشه را به سرور کپی کنید

scp -r row-template-1.4.0-release root@your-server:/root/

هر روشی کار می‌کند — scp، rsync یا فلش USB. فقط هر چهار فایل را کنار هم در یک پوشه نگه دارید.

نصب‌کننده را روی پوشه اجرا کنید

روی سرور، در پوستهٔ root:

RT_RELEASE_DIR=/root/row-template-1.4.0-release bash /root/row-template-1.4.0-release/install.sh

RT_RELEASE_DIR به نصب‌کننده می‌گوید manifest.txt، SHA256SUMS و tarball را به‌جای دانلود، از همین پوشه بخواند. به curl هم نیازی نیست. از اینجا به بعد نصب دقیقاً مثل نصب معمولی است: چک‌سام دوباره بررسی می‌شود، آرشیو بررسی و استخراج می‌شود، پنل شما تشخیص داده می‌شود و همان سؤال‌ها پرسیده می‌شوند.

برای نصب بدون پرسش، همان متغیرهای نصب بدون پرسش را اضافه کنید — و روی سروری با بیش از یک پنل پشتیبانی‌شده، RT_PANEL را هم:

RT_ASSUME_NONINTERACTIVE=1 RT_TEMPLATE=row \
RT_RELEASE_DIR=/root/row-template-1.4.0-release bash /root/row-template-1.4.0-release/install.sh

فعال کنید و بررسی کنید

اگر نصب‌کننده نتوانست صفحه را برایتان فعال کند — 3X-UI بدون sqlite3 یا Rebecca با MySQL/MariaDB — مرحلهٔ دستی‌ای را که چاپ کرد و در فعال‌سازی توضیح داده شده انجام دهید. سپس:

row-template verify

به‌روزرسانی سرور بدون اینترنت

row-template update همین متغیر را می‌خواند، پس سرور بدون اینترنت هم به همین شکل به‌روز می‌شود — پوشه‌ای با چهار فایل نسخهٔ جدید آماده کنید، بررسی‌شان کنید، به سرور کپی کنید و سپس:

RT_RELEASE_DIR=/root/row-template-X.Y.Z-release row-template update

متغیر فقط روی فرمانی اثر دارد که پیش از آن آمده؛ چیزی به خاطر سپرده نمی‌شود.

استفاده از آینهٔ خودتان

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

RT_RELEASE_URL=https://mirror.example.com/row-template/1.4.0 bash install.sh

نشانی باید از https:// استفاده کند. http:// ساده رد می‌شود، مگر اینکه RT_ALLOW_INSECURE_URL=1 را هم تنظیم کنید که فقط برای آزمایش محلی است.

روش ب — بدون نصب‌کننده (پیشرفته، فقط 3X-UI)

در 3X-UI می‌توان یک طرح را بدون هیچ نصب‌کننده‌ای ارائه کرد: صفحه یک فایل تکی است که 3X-UI آن را با نام sub.html از Sub Theme Directory می‌خواند. در PasarGuard و Rebecca از روش الف استفاده کنید: نصب‌کننده صفحه را می‌گذارد، انتخابش می‌کند و — روی این پنل‌ها — از تنظیمات پنل عکس فوری می‌گیرد و در صورت لزوم بازمی‌گرداند.

چه چیزهایی را از دست می‌دهید

بدون نصب‌کننده برندینگی نیست (صفحه بدون برند می‌ماند)، فرمان row-template نیست و در نتیجه verify، update، rollback و تعویض تمپلیت هم نیست. بررسی‌های ایمنی نصب‌کننده هم اجرا نمی‌شوند. مگر دلیلی داشته باشید، از روش الف استفاده کنید.

دانلود، بررسی و استخراج

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

طرح دلخواه را بررسی کنید

هر طرح چک‌سام خودش را دارد. مثلاً برای Editorial:

sha256sum -c templates/editorial/template.html.sha256

templates/editorial/template.html: OK

شناسه‌های طرح‌ها در گالری تمپلیت‌ها آمده‌اند.

آن را سر جایش کپی کنید

install -d -m 755 /etc/3x-ui/sub_templates/row-template
install -m 644 templates/editorial/template.html /etc/3x-ui/sub_templates/row-template/sub.html

پنل را به آن متصل کنید

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

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