4net · Документация
Ваш провайдер. Внутри 4net.
Передайте с подпиской название, логотип, светлую и тёмную палитры и ссылку поддержки. Доступно в 4net Android 1.2.11.
Эти заголовки брендирования также работают на iOS. Ниже — настройка встроенного логотипа и автоматического выбора оформления. Перейти к iOS →
1. Добавьте заголовки ответа
В Remnawave откройте настройки подписки → Response Headers / Кастомные хедеры. Каждое имя и значение добавляйте отдельной строкой. Заголовки должны приходить в HTTP-ответе подписки, включая JSON-вариант, если он выдаётся отдельно.
x-4net-brand-name: Example VPN VPN
x-4net-logo-url: https://cdn.example.com/Example VPN-logo.png?v=1
x-4net-theme-dark: {"accent":"#A78BFA","background":"#120D20","card":"#211B31","text":"#F7F5FF"}
x-4net-theme-light: {"accent":"#6D28D9","background":"#F8F7FF","card":"#FFFFFF","text":"#1D1730"}
support-url: https://t.me/example_helpАдреса логотипа и поддержки в примере демонстрационные. Замените оба на реальную публичную картинку и адрес помощи провайдера. Указанный файл логотипа Example VPN на example.com не размещён.
x-4net-* — расширение 4net, а не общий стандарт Happ/INCY. Существующие routing и другие заголовки подписки сохраняйте. Менять движок или конфигурацию маршрутизации не требуется.
2. Настройте палитру
| Поле | Назначение |
|---|---|
accent | Кнопки, значки и выделение |
background | Фон экрана |
card | Фон карточек |
text | Основной текст |
Каждая палитра — отдельный однострочный JSON-объект. Внутри неё обязательны все четыре поля; цвета задаются как #RRGGBB без прозрачности. Контраст текста и акцента на фоне и карточках — не менее 4.5:1. Неподходящая палитра заменяется стандартной 4net. Светлую или тёмную тему выбирает пользователь.
3. Подготовьте логотип и поддержку
- Прямая публичная HTTPS-ссылка на картинку, стандартный порт 443, без входа и перенаправлений. Поддерживаются PNG, JPEG и WebP; SVG не поддерживается.
- До 512 КиБ, не более 4096 пикселей по стороне и 4 мегапикселей в сумме. Подойдёт квадратный PNG 256×256.
- При замене картинки измените версию адреса, например ?v=2. Сохранённый логотип доступен без сети; срок свежего кэша — 24 часа.
- support-url — HTTPS-адрес помощи: например, Telegram поддержки или страница с инструкциями. Ссылка открывается только по нажатию.
- Название бренда — до 64 символов / 256 байт UTF-8. Для кириллицы передавайте base64: и Base64 от UTF-8 текста. В Remnawave префикс rwEncodeBase64: может сформировать нужный заголовок base64: при отдаче.
profile-title остаётся названием самой подписки и не заменяет название бренда. Иконка запуска, название приложения в Android и package остаются 4net.
4. Проверьте на Android
- Сохраните заголовки в Remnawave и обновите подписку в 4net 1.2.11.
- При одной подписке оформление применяется автоматически. При нескольких откройте Настройки → Оформление провайдера → нужная подписка или оставьте 4net.
- Переключите светлую и тёмную темы. Откройте карточку подписки и проверьте кнопку поддержки.
Безопасность и запасное оформление
Логотип загружается отдельным HTTPS-клиентом без токена подписки, HWID, cookies, Authorization и Referer. Сервер картинки видит IP запроса и её URL — не добавляйте туда пользовательские секреты. Локальные сетевые адреса и перенаправления запрещены. Ошибка картинки не блокирует подключение VPN.
У каждой подписки своя поддержка. Смена сервера или фоновое обновление не подменяют явно выбранный бренд чужим. Чтобы убрать оформление, удалите его заголовки и успешно обновите подписку.
Remnawave: документация Response Headers ↗
iOS: встроенные логотипы и автоматическое оформление
На iOS используйте заголовки x-4net выше. Далее — встроенные логотипы и автоматическое оформление на iPhone и iPad; для Android действует настройка, описанная выше.
Если защита сайта блокирует логотип в мобильной сети, передайте картинку с подпиской в aw-icon-light и при необходимости aw-icon-dark. Корректный встроенный логотип не требует отдельного запроса к сайту изображения.
aw-icon-light: <RAW_BASE64_OF_LIGHT_PNG>
aw-icon-dark: <RAW_BASE64_OF_DARK_PNG>Замените заглушки чистым Base64 от файла картинки. Не добавляйте base64:, data: или rwEncodeBase64:. На Mac:
base64 < provider-logo.png | tr -d '\n'- Предпочтителен прозрачный PNG 128×128 размером в несколько килобайт. Лимиты заголовков сервера и CDN могут быть значительно ниже клиентского предела 256 КиБ декодированных данных картинки.
- Брендированный интерфейс проверяет PNG, JPEG или WebP с теми же ограничениями разрешения, что у логотипов по URL. Приоритет: корректная картинка текущей темы → другой темы → x-4net-logo-url → запасной значок. Одного aw-icon-light достаточно для обеих тем.
- Для общего оформления передайте также x-4net-brand-name, палитру или x-4net-logo-url. Одни aw-icon-* не включают общий бренд. Название установленного приложения и иконка на домашнем экране остаются 4net.
Автоматический выбор в iOS
- Одна подписка с оформлением: её бренд применяется и при наличии других подписок без брендирования.
- Несколько оформлений: используется бренд подписки выбранного сервера. Если у неё бренда нет — 4net. Порядок обновления подписок не определяет оформление.
- Явный выбор провайдера или 4net в настройках важнее автоматического режима. Выбранная тема и VPN-сервер сохраняются.
Сохраните заголовки в Remnawave, обновите подписку и проверьте обе темы. Круглая кнопка также использует цвет провайдера. Успешное обновление без заголовков брендирования или иконок удаляет соответствующие сохранённые данные оформления.
Кабинет, анонсы, продление и фильтрация Wi-Fi/LTE →
Розовая тема с фоном-бабочкой
Передайте x-4net-theme: pink: приложение применит встроенную розовую палитру, розовую кнопку и нежный фон с бабочкой. Название, логотип, кабинет и поддержка провайдера сохраняются. Пользователь может выбрать тему в Настройки → Оформление; ручной выбор имеет приоритет. Светлая и тёмная палитры провайдера остаются доступны.
x-4net-theme: pink