پرش به مطلب اصلی

پروفایل‌های تنظیمات

پروفایل تنظیمات — پیکربندی کامل Xray-core است که نودها پیکربندی کاری خود را از آن می‌سازند. در پروفایل، inboundها، outboundها و قواعد مسیریابی قرار دارند؛ نود از پروفایل فقط آن inboundهایی را برمی‌دارد که برایش فعال شده‌اند.

ساخت پروفایل​

Config Profiles → Create Config Profile. نامی وارد کنید (2–30 کاراکتر)، سپس JSON پیکربندی را در ویرایشگر ویرایش کنید.

کمینه پروفایل چنین است:

{
  "log": { "loglevel": "info" },
  "inbounds": [
    {
      "tag": "VLESS",
      "port": 443,
      "protocol": "vless",
      "settings": { "clients": [], "decryption": "none" },
      "streamSettings": { "network": "tcp", "security": "reality" }
    }
  ],
  "outbounds": [
    { "protocol": "freedom", "tag": "DIRECT" },
    { "protocol": "blackhole", "tag": "BLOCK" }
  ],
  "routing": { "rules": [] }
}

inboundهای config.inbounds را پنل به‌صورت خودکار تجزیه می‌کند: برای هرکدام tag، type، port و security پدید می‌آید. این inboundها سپس در گروه‌ها و هاست‌ها انتخاب می‌شوند.

توجه

پروفایل Xray را «به‌جای شما» تنظیم نمی‌کند — نحو و رفتار هسته در مستندات Xray توضیح داده شده است. اینجا فقط این مهم است که پنل پیکربندی را چگونه نگه می‌دارد و توزیع می‌کند.

Snippetها​

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

[
  {
    "ip": ["geoip:private"],
    "outboundTag": "BLOCK"
  }
]

snippet با نام در آرایه‌های outbounds، routing.rules، routing.balancers و snippets متصل می‌شود:

"routing": {
  "rules": [
    { "snippet": "Block Private" }
  ]
}

Snippetها برای همه پروفایل‌ها مشترک‌اند: ویرایش یک قطعه، رفتار را بی‌درنگ همه‌جایی که متصل است تغییر می‌دهد.

هشدار

حذف snippetی که جایی استفاده شده ممکن نیست — پنل ارجاع‌های آن در پروفایل‌ها را بررسی می‌کند.

اعمال به نودها​

هر نود یک پروفایل فعال و فهرست inboundهای فعال دارد. آن‌ها در کارت نود (Change Profile) یا به‌صورت گروهی در صفحه Bulk actions → Profile modification تغییر می‌کنند — برای چند نود با هم و با یک فهرست inbound.

پس از ویرایش پیکربندی پروفایل، نودهایی که از آن استفاده می‌کنند در همگام‌سازی بعدی پیکربندی جدید را می‌گیرند؛ اگر مجموعه کلاینت‌ها تغییر نکرده باشد، Xray راه‌اندازی مجدد نمی‌شود. راه‌اندازی مجدد اجباری — دکمه Restart node، ببینید نودها.

نسخه‌ها و بازگردانی​

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

# پیش از ویرایش، از پایگاه داده نسخه پشتیبان بگیرید
docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

روش‌های کاربردی:

  • نسخه‌ای از پروفایل را با نامی مانند Sample-backup کنار دست نگه دارید و اگر چیزی خراب شد نودها را به آن سوئیچ کنید؛
  • پیش از تغییرهای بزرگ، JSON پروفایل را در فایل یا git بیرون بکشید؛
  • پیکربندی را با گام‌های کوچک ویرایش کنید تا بفهمید دقیقاً چه چیزی پیکربندی را شکسته است.
خطر

تغییر پروفایل روی نود بی‌درنگ اعمال می‌شود. پیکربندی اشتباه Xray یعنی پروکسی از کار افتاده روی همه نودهای این پروفایل — پیش از ذخیره JSON را بررسی کنید.

گام‌های بعدی​