پیکربندی

برندینگ

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

Row-Template به‌طور پیش‌فرض بدون برند است: هیچ چیزی در صفحه نام Row-Template را نشان نمی‌دهد. می‌توانید سه چیز از خودتان اضافه کنید که همه اختیاری‌اند.

فیلد قواعد کجا نمایش داده می‌شود
نام سرویس حداکثر ۱۲۰ نویسه. بدون نویسهٔ کنترلی (مثل شکست خط). همان جایی که طرح برندش را نشان می‌دهد. برای صفحهٔ بدون برند خالی بگذارید.
لینک پشتیبانی باید با https://، http://، tg:// یا mailto: شروع شود. به‌عنوان دکمه یا پیوند پشتیبانی و تماس در صفحه.
لوگو PNG، JPEG یا WebP، حداکثر ۲۵۶ کیلوبایت، که از روی محتوای فایل شناسایی می‌شود، نه پسوندش. symlink پذیرفته نمی‌شود. به‌جای مونوگرامی که خودکار ساخته می‌شود.

بدون لوگو، صفحه یک مونوگرام از روی نام سرویس نشان می‌دهد — مثلاً Katze-VPN به K-V تبدیل می‌شود. نصب‌کننده برای نام‌های لاتین آن را پیش‌نمایش می‌دهد؛ برای خط‌های دیگر، مرورگر آن را محاسبه می‌کند.

تغییر برندینگ

از منوی مدیریت (یک فیلد در هر بار)

row-template

گزینهٔ 2 — Reconfigure branding را انتخاب کنید:

  1  Service name
  2  Support URL
  3  Logo
  4  Template
  5  Reset branding
  6  Reconfigure everything
  0  Back
  • Service name — نام جدید را وارد کنید، برای نگه داشتن نام فعلی Enter بزنید، یا برای پاک کردن - وارد کنید.
  • Support URL — نگه داشتن، تغییر یا حذف لینک. لینک نامعتبر رد و دوباره پرسیده می‌شود.
  • Logo — استفاده یا جایگزینی تصویر، حذف آن (بازگشت به مونوگرام) یا نمایش وضعیت فعلی.
  • Reset branding — هر سه را پاک می‌کند و به ظاهر پیش‌فرض برمی‌گرداند. Row-Template را حذف نمی‌کند.
  • Reconfigure everything — همان row-template config.

با فرمان config (همهٔ فیلدها)

row-template config

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

از تنظیمات خود پنل (PasarGuard، Rebecca)

PasarGuard و Rebecca در تنظیمات خودشان یک عنوان اشتراک و یک لینک پشتیبانی نگه می‌دارند. Row-Template می‌تواند از همان‌ها استفاده کند تا مجبور نباشید دو بار واردشان کنید (1.4.0):

  • در نصب تازهٔ تعاملی، نصب‌کننده آن‌ها را نشان می‌دهد و می‌پرسد Use them for this page? [Y/n]. برای استفاده از آن‌ها Enter بزنید — آن وقت پرسش‌های نام و لینک رد می‌شوند — یا برای وارد کردن مقادیر خودتان n را بزنید.
  • روی نصب موجود، row-template را باز کنید و 2 — Reconfigure branding و سپس 7 — Use PasarGuard’s (or Rebecca’s) name and support link را انتخاب کنید، یا RT_PANEL_BRANDING=1 row-template config را اجرا کنید.
  • در اسکریپت، RT_PANEL_BRANDING=1 را تنظیم کنید. RT_SERVICE_NAME و RT_SUPPORT_URL همچنان برای فیلدی که تنظیم می‌کنند مقدم‌اند.

پیش‌فرض‌های خود پنل‌ها — عنوان Subscription و https://t.me/ خالی — هرگز پیشنهاد نمی‌شوند، و نه عنوانی از PasarGuard که هنوز یک جای‌نگهدار مخصوص هر مشترک مثل {USERNAME} دارد؛ هر مقدار هم از همان بررسی‌هایی می‌گذرد که مقداری که خودتان وارد می‌کنید. این تنظیمات فقط خوانده می‌شوند، و فقط از پایگاه‌دادهٔ SQLite؛ با MySQL، MariaDB یا PostgreSQL چیزی پیشنهاد نمی‌شود.

از داخل اسکریپت

مقادیر را به‌صورت متغیر بدهید. فیلدهایی که تنظیم نکنید مقدار فعلی‌شان را حفظ می‌کنند:

RT_ASSUME_NONINTERACTIVE=1 \
RT_SERVICE_NAME="Aurora VPN" \
RT_SUPPORT_URL="tg://resolve?domain=aurora_support" \
RT_LOGO_PATH=/root/aurora.png \
row-template config

برای پاک کردن نام از RT_SERVICE_NAME="" و برای حذف لوگو از RT_LOGO_REMOVE=1 استفاده کنید.

امتحان هر تغییری بی‌خطر است

تغییر برندینگ هرگز صفحهٔ سالم را با صفحهٔ خراب جایگزین نمی‌کند:

  1. پیکربندی و صفحهٔ فعلی کنار گذاشته می‌شوند.
  2. پیکربندی جدید نوشته می‌شود و صفحه از روی آن دوباره ساخته و اعتبارسنجی می‌شود.
  3. فقط صفحه‌ای که از اعتبارسنجی عبور کند جایگزین می‌شود. در PasarGuard و Rebecca نسخهٔ داخل پوشهٔ تمپلیت‌های پنل هم جایگزین می‌شود؛ به انتخاب پنل دست زده نمی‌شود و چیزی ری‌استارت نمی‌شود.
  4. اگر چیزی شکست بخورد، پیکربندی و صفحهٔ قبلی بازگردانده می‌شوند و خطا نمایش داده می‌شود.

برندینگ چطور ذخیره می‌شود

مقادیر شما در config.env داخل پوشهٔ نصب نگه داشته می‌شوند — /etc/3x-ui/sub_templates/row-template/config.env در 3X-UI و /etc/row-template/config.env در PasarGuard و Rebecca — که فقط root و گروه آن می‌توانند بخوانند (مجوز 640):

config.env
# Row-Template configuration — generated file. Do NOT source this.
# Values are base64 data, read with grep+base64 and never executed.
RT_CONFIG_VERSION=1
TEMPLATE=row
SERVICE_NAME_B64=QXVyb3JhIFZQTg==
SUPPORT_URL_B64=aHR0cHM6Ly90Lm1lL2F1cm9yYQ==
LOGO_MIME=image/png
LOGO_DATA_B64=iVBORw0KGgo…
  • متن‌ها با کدگذاری base64 ذخیره می‌شوند و فقط به‌عنوان داده خوانده می‌شوند. این فایل هرگز source یا اجرا نمی‌شود.
  • در صفحه، مقادیر به رشتهٔ دادهٔ سادهٔ جاوااسکریپت در یک بلوک ثابت تبدیل می‌شوند و طوری escape می‌شوند که هرگز نتوانند اسکریپت را ببندند یا نشانه‌گذاری اضافه کنند. سپس صفحه آن‌ها را به‌صورت متن قرار می‌دهد، هرگز به‌صورت HTML.
  • لوگو به‌صورت data URI داخل صفحه جاسازی می‌شود، پس بدون درخواست اضافه بارگذاری می‌شود.

config.env را دستی ویرایش نکنید

از منوی مدیریت یا row-template config استفاده کنید. مقداری که دستی ویرایش شده و نویسهٔ کنترلی دارد باعث می‌شود ساخت صفحه تا زمان اصلاح آن رد شود (branding contains control characters; refusing to generate.).

برندینگ در برابر همه چیز ماندگار است

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

ویرایش این صفحه در GitHubمربوط به Row-Template نسخهٔ 1.4.0
Esc
↑↓ برای جابه‌جایی↵ برای انتخابEsc برای بستن