Добавление серверов

Нажмите Добавить сервер или подписку на главном экране. Можно:

Вставить из буфера обмена: URL подписки или отдельную ссылку на сервер.
Сканировать QR-код: камера используется только для сканирования, и ссылку всегда можно вставить вместо этого.
Добавить вручную: ввести ссылку и задать параметры самостоятельно.

Material Xray также открывает диплинки mxray://add/, поэтому кнопка на сайте провайдера может добавить подписку в одно касание.

Что можно добавить

Ввод	Результат
URL подписки `https://`	Подписка, которая обновляется по расписанию.
Одна ссылка `vless://`, `vmess://`, `trojan://`, `ss://` или `hysteria2://`	Один сервер.

Подписки могут содержать и другое: строки HTTP, SOCKS и WireGuard, а также конфигурации Xray в формате JSON. См. формат подписки и ссылки на серверы.

Параметры подписки

Меню подписок на главной странице использует горизонтальное троеточие, как в маршрутизации.

Удерживайте название в заголовке подписки и перетаскивайте, чтобы изменить порядок подписок, свёрнутых или развёрнутых. Остальные карточки плавно сдвигаются на новые места. Виброотклик отмечает начало перетаскивания и каждую смену позиции. Это движение срабатывает только при изменении порядка; разворачивание и сворачивание карточки сохраняют обычную анимацию. Во время перетаскивания элементы управления в заголовке сменяются маркером перетаскивания по центру. Название подписки и счётчик использованного трафика остаются на месте. У краёв список прокручивается, а новый порядок сохраняется, когда вы отпускаете палец. Программы чтения с экрана предлагают действия Переместить вверх и Переместить вниз для каждого заголовка.

У каждой подписки свои параметры: их задают при ручном добавлении или позже, при редактировании подписки. Разверните Дополнительно, чтобы увидеть тип загрузки, User-Agent, свои заголовки и параметры небезопасных обновлений; диалог плавно меняет размер, а поля в нём прокручиваются. Оба диалога поднимаются над клавиатурой при её появлении и возвращаются в центр, когда она скрывается, в том числе со свёрнутым разделом Дополнительно. Поля своего User-Agent и заголовков разворачиваются и сворачиваются так же плавно.

Параметр	Что делает
Название	Оставьте пустым, чтобы использовать `profile-title` провайдера.
Автообновление	Каждые 1, 3, 6, 24 или 72 часа либо только вручную. Новые подписки обновляются каждый час.
Сначала JSON	Сначала запрашивать `<url>/json`, а при неудаче — сохранённый URL. Включено по умолчанию. См. формат подписки.
Разрешить небезопасные обновления	Принимать обычный HTTP и недоверенные или несовпадающие сертификаты. Выключено по умолчанию.
User-Agent	Автоматически — представляться как Material Xray, Happ — User-Agent, совместимый с Happ, Пользовательский — задать свой User-Agent и дополнительные заголовки. См. заголовки запроса.

В строках серверов заполненный карандаш означает изменённую конфигурацию, заполненный замок — заблокированную, а значок маршрутизации — изменённые правила сервера или подписки. Эти значки одного размера, с одинаковыми отступами и идут в этом порядке. Сброс маршрутизации убирает её значок, но изменения конфигурации сохраняются.

Идентификатор устройства

Некоторые провайдеры требуют идентификатор устройства (HWID). Material Xray отправляет его по умолчанию. Отключить это можно в Настройки → Отправлять HWID. Если подписка требует HWID, а отправка выключена, приложение спросит, прежде чем её добавить. Отмена — подписка не добавляется. Продолжить — HWID разрешается для этой подписки, и она загружается заново уже с HWID; общая настройка не меняется. В предупреждении сказано, что HWID может помочь связать трафик с вашим устройством и снизить анонимность. Если выбрана подписка, требующая HWID, переключатель в настройках включается и блокируется. При переключении на другую подписку восстанавливается ваш сохранённый выбор.

Для автоматического профиля с несколькими серверами на главной странице показывается только количество подключаемых серверов.