Перейти к основному содержимому

Профили конфигурации

Профиль конфигурации — это полный конфиг Xray-core, из которого ноды собирают свой рабочий конфиг. В профиле лежат инбаунды, outbounds и правила маршрутизации; нода берёт из профиля только те инбаунды, которые у неё включены.

Создание профиля​

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": [] }
}

Инбаунды из config.inbounds панель разбирает автоматически: у каждого появляются tag, type, port и security. Эти инбаунды затем выбираются в сквадах и хостах.

Примечание

Профиль не настраивает Xray «за вас» — синтаксис и поведение ядра описаны в документации Xray. Здесь важно только то, как панель хранит и раздаёт конфиг.

Сниппеты​

Сниппет — переиспользуемый фрагмент конфигурации. Он избавляет от копирования одинаковых правил по десяткам профилей.

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

Сниппет подключается по имени в массивах outbounds, routing.rules, routing.balancers и snippets:

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

Сниппеты общие для всех профилей: правка одного фрагмента меняет поведение сразу везде, где он подключён.

Внимание

Удалить сниппет, который где-то используется, нельзя — панель проверяет ссылки на него в профилях.

Применение к нодам​

У каждой ноды есть активный профиль и список активных инбаундов. Меняются они в карточке ноды (Change Profile) или пакетно на странице Bulk actions → Profile modification — сразу для нескольких нод, с одним списком инбаундов.

После правки конфигурации профиля ноды, которые его используют, получают новый конфиг при следующей синхронизации; если набор клиентов не изменился, Xray не перезапускается. Принудительный перезапуск — кнопка Restart node, см. Ноды.

Версии и откат​

Панель не хранит историю версий профиля: у профиля есть только текущее состояние и updatedAt. Поэтому откат — это ваша задача, и лучше подготовить его заранее:

# снимок базы перед правками
docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

Практичные приёмы:

  • держите рядом копию профиля с именем вида Sample-backup и переключайте ноды на неё, если что-то пошло не так;
  • выгружайте JSON профиля в файл или git перед крупными изменениями;
  • правьте конфигурацию небольшими шагами, чтобы понимать, что именно сломало конфиг.
Осторожно

Смена профиля на ноде применяется сразу. Ошибочный конфиг Xray означает неработающий прокси на всех нодах этого профиля — проверяйте JSON до сохранения.

Что дальше​

  • Ноды — применение профиля и перезапуск.
  • Хосты — инбаунды в подписке.
  • Сквады — доступ пользователей к инбаундам.
  • Обновление — резервные копии и миграции.