FAQ

Настройка заголовков
Добавление конфигурации
Приватность
Автообновление

Что такое кастомные заголовки x-duckray-?

Клиент DuckRay умеет считывать специальные HTTP-заголовки, начинающиеся на x-duckray-, которые передаются сервером вместе с файлом подписки.

Как добавить свои параметры?

Вы можете передавать вашим клиентам любые параметры (например, ссылку на ваши правила, контакты Telegram-саппорта или любой другой текст). Главное условие — заголовок обязательно должен начинаться с префикса x-duckray-.

Инструкция для панели Remnawave

  1. Откройте раздел Подписка.
  2. Перейдите в Настройки.
  3. Найдите раздел Доп. хэдеры.
  4. Укажите Ключ (Key): начиная с x-duckray- (например: x-duckray-faq или x-duckray-support).
  5. Укажите Значение (Value): ваш текст или ссылка.

Поддерживаемые заголовки подписки

DuckRay Client читает стандартные HTTP-заголовки, которые панель возвращает вместе с файлом подписки.

  • profile-title — название подписки, отображается в приложении
  • announce — сообщение от администратора, показывается при подключении
  • support-url — ссылка на поддержку (отображается кнопкой в приложении)
  • profile-update-interval — интервал автообновления в часах
  • subscription-userinfo — трафик (upload=...; download=...; total=...; expire=...)
  • x-duckray-* — кастомные параметры от администратора (см. карточку выше)

Как добавить конфигурацию или подписку?

Внешняя подписка — это URL-ссылка на файл с конфигурацией, который хранится на вашем сервере. Клиент скачивает его и автоматически обновляет при необходимости.

Как подключить

  1. Скопируйте URL вашей подписки, например: https://your-server.com/sub/token
  2. Вставьте его в поле для ввода ключа в клиенте DuckRay.
  3. Клиент автоматически скачает конфигурацию и подключится.

Прямые ключи

Если у вас нет URL-подписки, можно вставить один прямой ключ: vless://..., vmess://..., trojan://..., ss://.... Это разовое подключение без автообновления.

Автообновление конфигурации

Если сервер возвращает заголовок profile-update-interval, клиент будет автоматически обновлять подписку с указанным интервалом (в часах).

Совместимость: внешние подписки работают с любой панелью (Marzban, 3x-ui, Remnawave и др.). Конфигурация клиента обновляется без переподключения.

Что клиент отправляет на сервер?

При каждом обновлении подписки клиент добавляет несколько заголовков в запрос. Это позволяет администраторам видеть статистику устройств и управлять доступом.

Передаваемые заголовки

  • x-hwid — уникальный ID устройства (максимум 36 символов)
  • x-device-model — модель устройства
  • x-device-os — операционная система (Windows, macOS, Android и др.)
  • x-ver-os — версия ОС
  • X-App-Version — версия приложения
  • X-App-Platform — платформа (windows, macos, android и др.)

Как отключить

Отправку HWID и данных устройства можно отключить в настройках клиента: Настройки → отключить опцию «Отправлять HWID».

Данные не передаются третьим лицам. Информация доступна только администратору вашей панели.

Как работает автообновление?

DuckRay Client автоматически обновляет конфигурацию при каждом запуске и периодически, если сервер задаёт интервал.

Как задать интервал автообновления

Сервер должен возвращать заголовок в ответе на запрос подписки:

  • profile-update-interval: 12 — обновлять каждые 12 часов
  • profile-update-interval: 24 — обновлять раз в сутки

Ручное обновление

Нажмите кнопку обновления подписки в главном экране приложения. Конфигурация обновится без переподключения.

Если сервер не возвращает заголовок profile-update-interval, автообновление не выполняется. Обновляйте вручную.