DODO APP / ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

Подключите свой сервис к DoDo.

Настройте выдачу подписок, добавьте название сервиса и полезные ссылки для пользователей. Для этого достаточно совместимого HTTPS-ответа — доступ к API вашей панели передавать не нужно.

HTTPS-подписки Remnawave или своя панель Статусы по платформам

Android 2.2.0 доступен как APK, сборка 2107 от 10 ноября. Скачать APK. Этот выпуск распространяется вне Google Play; публикация обновления в магазине будет объявлена отдельно. Если DoDo установлен из Google Play, обновляйте его через магазин: подписи могут отличаться. Не удаляйте приложение или данные ради установки APK.

iOS 2.2.0 опубликована в App Store 6 ноября, поддерживает iOS 15 и новее и использует Xray 26.10.31. Возможности Android ниже относятся к APK 2.2.0 (2107). Сведения о macOS и Windows приведены отдельно.

Возможности по платформам

01 / НАЧАЛО

Быстрый старт

Реализовано
  1. Выдайте пользователю HTTPS-ссылку подписки: список URI, Base64 или поддерживаемый Xray JSON.
  2. Если панель выбирает формат по User-Agent, настройте выдачу полного Xray JSON для DoDoApp в iOS и префикса DoDoApp/ в Android.
  3. Добавьте название сервиса, интервал обновления и другие данные подписки в HTTP-заголовки ответа.
  4. Пользователь добавляет ссылку через «+»: из буфера, вручную или QR-кодом. Для бота или сайта используйте описанный ниже dodoapp://import.
  5. Проверьте добавление, обновление подписки и подключение к серверам.
GET /sub/demo-token HTTP/1.1
Host: example.invalid
User-Agent: DoDoApp
Accept: */*

Минимальный ответ вашего сервера

По HTTPS-ссылке подписки верните HTTP 200, данные подписки в заголовках ответа и конфигурацию в теле. Для Xray JSON укажите Content-Type: application/json и передайте JSON вместо списка URI.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
profile-title: Demo Provider
profile-update-interval: 1
support-url: https://example.invalid/support

vless://00000000-0000-4000-8000-000000000001@example.invalid:443?security=tls&type=ws&path=%2Fdemo#Demo

После добавления ссылки пользователь увидит карточку подписки и список серверов. Название и кнопка поддержки берутся из вашего ответа. Адрес example.invalid и ключи в примерах замените своими; рабочие ссылки подписок храните в секрете.

DoDo — приложение для подключения. Серверы и доступ предоставляет ваш сервис. Можно использовать Remnawave или собственную панель, которая выдаёт подписки в одном из форматов ниже.

DODO PARTNERS / РАННИЙ ДОСТУП

Бесплатная регистрация провайдеров

Полный production-запуск скоро

Регистрация провайдеров открыта в раннем доступе. Войдите через Google, создайте кабинет своего сервиса и подтвердите точный домен выдачи ключей. Тарифов, оплаты и срока бесплатного доступа нет; действуют технические ограничения против спама и перегрузки.

1. Создайте свой сервис

После Google-входа укажите название и необязательную публичную HTTPS-ссылку поддержки. Кабинет принадлежит вошедшему аккаунту; вводить Firebase UID, пароль панели или ключ пользователя не нужно. Повторное нажатие не создаёт второй кабинет. Можно готовить бренд и черновики; публичный показ требует DNS-подтверждения и одобрения DoDo.

2. Подтвердите домен

В разделе «Домены и доступ» укажите точный host, например sub.example.com, без протокола, пути и порта. Нажмите «Получить TXT-запись», скопируйте имя и уникальное значение в DNS-панель, затем нажмите «Проверить DNS». Пример структуры записи:

Тип: TXT
Имя: _dodo-verify.sub.example.com
Значение: dodo-verification=v1:КОД_ИЗ_ВАШЕГО_КАБИНЕТА

Не копируйте этот пример вместо реального кода. DNS-панель может сама дописывать домен — проверьте итоговое полное имя записи. Если код истёк, получите новый. Кабинет отдельно показывает срок подтверждения и результат последней DNS-проверки.

Подтверждение действует 30 дней. За семь дней до окончания кабинет покажет предупреждение. Нажмите «Продлить DNS», разместите новую TXT-запись и завершите проверку до истечения срока. Автоматического фонового продления нет. Если срок уже истёк или домен был отозван, потребуется повторное подтверждение. Ключ подписи для публичного бренда и сторис не нужен; в необязательном расширенном протоколе прежние ключи после утраты доверия не включаются автоматически.

Подтверждение относится только к указанному домену, не ко всем поддоменам и не к другим сервисам на общем CDN. Для общего домена с разными секретными путями используйте собственный домен или выделенный поддомен. История ручных решений DoDo сохраняется отдельно: ручное одобрение не равно DNS-подтверждению.

3. Дождитесь одобрения DoDo и добавьте один заголовок

Google подтверждает аккаунт владельца, DNS — контроль точного домена. Одобрение сервиса командой DoDo остаётся отдельным обязательным условием. После этих шагов возьмите ID провайдера из своего кабинета и добавьте его к реальному успешному HTTPS-ответу выдачи подписки на том же точном host:

x-dodo-provider-id: UUID_ПРОВАЙДЕРА_ИЗ_КАБИНЕТА_DODO

Это настоящий HTTP-заголовок ответа, не комментарий тела и не поле JSON. Ошибка, HTML-заглушка, редирект или ответ другого host не подходят. Не путайте этот UUID с коротким providerid для резервного адреса.

4. Настройте публичный бренд и сторис

Настройте оформление сервиса и публикации в своём кабинете. Для публичного бренда и сторис не нужно устанавливать модуль, создавать signer или пару ключей, передавать API-токен панели либо менять Xray, VPN-ноды и тело подписки. Публикация сторис по-прежнему требует действующего DNS-подтверждения и допуска DoDo.

Публичный контент отделён в /api/provider-content/v1. Он не подтверждает действующую или оплаченную подписку, не создаёт закрытую аудиторию и не включает адресные push. Не публикуйте здесь материалы, предназначенные только платным абонентам. Ошибка контента не должна блокировать импорт, обновление подписки или VPN.

Расширенно: подписанное подтверждение конкретного абонента

Это необязательный отдельный протокол, не требование для публичного бренда и сторис. Его строгие проверки сохраняются; публичный ID не заменяет подпись сервера.

Google подтверждает аккаунт владельца, DNS — контроль домена, а подписанный ответ вашего сервера — право конкретного абонента получать контент сервиса. Это разные проверки. Само совпадение profile-title, support-url или публичного ID не предоставляет доступ к чужим материалам или отчётам.

  1. Создайте ключ подписи Ed25519 в своей инфраструктуре. В кабинете зарегистрируйте только публичный JWK после DNS-проверки. Закрытый ключ остаётся на вашем сервере.
  2. Добавьте x-dodo-provider-id из своего кабинета к успешному HTTPS-ответу выдачи ключа. Необязательный x-dodo-connector-id для обычного сценария не требуется.
  3. При запросе приложения с x-dodo-subscriber-challenge проверьте ключ, право абонента и свою политику устройств, затем сформируйте подписанный x-dodo-subscriber-token.
  4. После проверки интеграции и одобрения DoDo контентная сессия предоставляет доступ только к этому сервису. Пользователю не нужен Google-аккаунт в самом приложении.
Заголовки интеграционного пилота
ЗаголовокНаправлениеНазначение
x-dodo-provider-idСервер провайдера → DoDoПостоянный UUID кабинета. Только обнаружение сервиса, не авторизация.
x-dodo-subscriber-challengeПриложение → сервер провайдераОдноразовый запрос подтверждения, связанный с конкретной установкой.
x-dodo-subscriber-tokenСервер провайдера → приложениеДинамический подписанный ответ на этот запрос. Нельзя заменить общей строкой для всех.

Отдельный endpoint и полный административный API Remnawave не обязательны: проверку можно добавить в существующий обработчик выдачи ключей. Для собственной панели применяется тот же принцип. Xray и VPN-ноды менять не нужно. Ответы с токеном должны обходить общий CDN-кеш и использовать Cache-Control: private, no-store; не записывайте ключи, HWID, challenge или токены в открытые логи.

Ошибка проверки контента не должна ломать обычную выдачу ключа, импорт или VPN. Несколько сервисов на одном устройстве привязываются независимо; удаление ключа или отзыв разрешения прекращает показ связанного контента. Этот протокол остаётся в пространстве /api/provider-binding/v1, отдельно от публичного контента.

Инструкция не означает готовый production-запуск. Подготовка кабинета и DNS не подтверждает развёртывание сервера, публикацию новой сборки в App Store или тест на iPhone. Показ требует совместимой версии приложения. Массовые адресные push в простой способ подключения не входят.

DODO PROVIDER CONSOLE

Панель на своём сервере

Ранний доступ · 0.1.1

Установите отдельный кабинет на Linux-сервере и откройте его на своём HTTPS-домене. Оформление, домены и сторис управляются через API DoDo. Основная админка, чужие сервисы, общая диагностика и ключи отправки push в поставку не входят. Данные и опубликованные файлы хранятся на стороне DoDo.

  1. Распакуйте архив, проверьте SHA256SUMS и задайте в .env точный адрес кабинета.
  2. Запустите Docker Compose и настройте HTTPS-прокси к 127.0.0.1:8795. Контейнер работает без root и доступа к VPN-нодам.
  3. Получите приватный код настройки командой из инструкции. В своей панели нажмите «Подключить к DoDo», затем на сайте DoDo войдите через Google, выберите сервис и подтвердите одноразовый код.
  4. Для работы с данными выполните отдельный вход владельца или редактора. Каждая установка получает свой отзывной доступ; сама установка не заменяет права человека.
  5. Подтвердите домен выдачи ключей через DNS TXT и добавьте x-dodo-provider-id в успешный ответ. Домен кабинета и домен выдачи ключей могут отличаться.

Модуль Remnawave, пароль VPN-панели или её административный API-токен не нужны. Управлять установками и отзывать их доступ можно в основном кабинете DoDo, в разделе своего провайдера. Не передавайте приватный код настройки в поддержку или на скриншотах.

Статистика только вашего сервиса. Панель 0.1.1 показывает устройства с отчётами, модели, версии ОС и DoDo, дату последней отправки и историю за 1/7/30 дней. Используются provider ID и точный домен из успешного ответа выдачи ключа; сервер сверяет действующее DNS-подтверждение. Нужен совместимый обновлённый iOS-клиент; до его выпуска старые приложения этих данных не передают. Старые отчёты по совпадению названия или поддержки провайдерам не выдаются. Это не онлайн-счётчик и не база платящих абонентов. Адресные push и платежи пока не подключены.

При недоступности API кабинет предложит повторить действие; бесконечной очереди повторов нет. После таймаута записи сначала обновите раздел и проверьте результат. Работа ключей и VPN не зависит от доступности этого кабинета.

02 / СОВМЕСТИМОСТЬ

Протоколы

Ниже перечислены форматы iOS 2.2.0. При настройке сервиса проверьте импорт и подключение с теми транспортами и параметрами, которые выдаёт ваша панель. Особенности Android указаны после таблицы.

ПротоколВходной форматПоддержка и особенности
VLESSvless://, Xray JSONРеализовано В том числе совместимые TLS / Reality-профили.
VMessvmess:// с Base64 JSON, Xray JSONРеализовано Транспортные и защитные параметры проходят проверку.
Trojantrojan://, Xray JSONРеализовано Для URI по умолчанию используется TLS.
Shadowsocksss://, Xray JSONРеализовано Распространённые варианты SIP002 / Base64. Поддержка шифра зависит от ядра; внешние плагины в URI не поддерживаются.
Hysteria2hy2://, hysteria2://, совместимый Xray JSONРеализовано Версия 2; предусмотрены Salamander и параметры hopping в поддерживаемом формате.
SOCKS5socks://, socks5://, Xray JSONРеализовано С именем/паролем или без них. Это SOCKS-подключение, а не дополнительная защита само по себе.
Обычный WireGuardwg://, wireguard://С ограничениями URI с параметрами либо Base64-профиль wg-quick внутри URI. Файлы с произвольным набором peers и параметры AmneziaWG не поддерживаются.
AmneziaWG, TUIC, SSR, Hysteria v1Их собственные схемы и расширенияНе поддерживаются в iOS Профиль AmneziaWG не преобразуется в обычный WireGuard.

В полном Xray JSON допускаются вспомогательные выходы HTTP, SOCKS и WireGuard. Для отдельного импорта используйте только указанные в таблице URI.

Особенности Android APK 2.2.0. AmneziaWG сохранён в Android и недоступен в iOS. Для Hysteria2 предусмотрены импорт и запуск; проверьте подключение с параметрами вашего сервера. Полный JSON принимается, если приложение распознаёт основной прокси-протокол и все связанные с ним выходы.

03 / ТРАНСПОРТЫ

Транспорты и TLS

Зависит от профиля
Параметр URIПоддерживаемые значенияПримечание
type / networktcp, raw, ws, websocket, grpc, xhttp, splithttp, httpupgrade, kcp, mkcpwebsocket читается как WS, splithttp — как XHTTP. Сложные настройки транспорта передавайте полным JSON.
securitynone, tls, realityСочетание должно поддерживаться самим протоколом и ядром.
TLS / Realitysni / peer, fp / fingerprint, alpn; для Reality — pbk, sid, spxИспользуйте значения, соответствующие настройкам сервера. Приложение передаст их в Xray.
WS / gRPC / XHTTPhost, path; gRPC serviceName, authority; XHTTP mode, JSON-объект extraДля сложных вложенных параметров предпочтителен полный JSON.
Проверка сертификатаpcs / pinnedPeerCertSha256, vcn / verifyPeerCertByNameНекорректный pin, неподдерживаемое требование ECH или обход проверки сертификата приводят к отказу импорта такого URI, а не к ослаблению проверки TLS.

Hysteria2 использует QUIC без type=quic. Передавайте его через hy2:// или hysteria2://. Значения URI-транспорта quic, h2 и http в iOS не поддерживаются.

04 / ОТВЕТ ПОДПИСКИ

Форматы и сохранность профиля

Реализовано
  • Текстовый список URI: отдельные серверы, обычно по одному на строку.
  • Base64: кодированный список или поддерживаемый JSON-контейнер. Base64 не является шифрованием.
  • Полный Xray JSON: один логический профиль с DNS, правилами, балансировщиками и зависимостями выходов.
  • Массив JSON-профилей: самостоятельные конфигурации отображаются отдельными вариантами выбора.
  • Коллекция независимых outbounds: отображается как набор отдельных серверов, без добавления балансировщика.

Полная конфигурация сохраняется как один профиль, а не заменяется ссылкой на первый outbound. DoDo сохраняет совместимые правила, теги, DNS, observatory / burstObservatory, policy / stats и связи между выходами. Возможности профиля зависят от используемой версии Xray.

Настройка через JSON TLS-фрагментацию, в том числе freedom.settings.fragment, можно передавать в совместимом полном профиле. Отдельного редактора фрагментации в приложении нет. Служебные inbound, локальные порты и параметры запуска адаптируются для iOS.

vless://00000000-0000-4000-8000-000000000001@example.invalid:443?type=ws&security=tls&path=%2Fdemo#Demo
trojan://demo-not-a-real-password@example.invalid:443?security=tls#Demo
hy2://demo-not-a-real-password@example.invalid:443?sni=example.invalid#Demo

Повреждённый или неподдерживаемый профиль отклоняется целиком. При неудачном обновлении прежние серверы остаются. Для совпадающих серверов сохраняются ID, порядок, закрепление, выбранный сервер и последние значения пинга.

Временная совместимость JSON-выдачи Happ

Временная совместимость Сначала DoDo отправляет обычный запрос. Если сервер вернул полный пригодный JSON, дополнительных запросов нет. Иначе приложение может повторить запрос того же URL с User-Agent: Happ/DoDoApp-compat и X-DoDo-Client, который указывает настоящий клиент DoDo. Ответы не объединяются в один список.

Для полной JSON-выдачи настройте правило DoDo по User-Agent или выдавайте явную ссылку с /json. Приложение не добавляет этот путь к произвольным ссылкам. Если запрос совместимости не удался, пригодный основной ответ сохраняется; уже сохранённый полный профиль не заменяется неполным списком URI.

Не поддерживается happ://crypto…, happ://crypt…, закрытые шифрованные форматы Happ и открытие Happ deeplink. Собственный DoDo crypt1 и AGE1 с получателем DoDo доступны в iOS 2.2.0 и Android APK 2.2.0. AGE-файлы, зашифрованные только для Happ или другого получателя, DoDo не расшифрует.

Пределы загрузки в iOS 2.2.0: до 8 000 000 байт на ответ, до 12 000 000 байт суммарно на операцию и до 2 000 000 байт на отдельный JSON-профиль. Для AGE1 действует отдельный предел зашифрованного тела — 2 MiB. В Android 2.2.0 пределы ответа и операции — 2 / 4 MiB соответственно. Общий лимит времени — 25 секунд, число попыток ограничено. Проверка TLS не отключается при ошибке. Частично загруженный ответ с сетевой ошибкой не импортируется.

04.1 / ЗАЩИЩЁННЫЕ ССЫЛКИ

DoDo crypt1: выдавайте подписку без открытого URL

Реализовано

Доступно в iOS 2.2.0 из App Store и Android APK 2.2.0 (2107). В Android добавляйте защищённую ссылку из буфера или вручную. На некоторых устройствах HUAWEI QR-коды с crypt1 пока могут не распознаваться; исправление сканирования готовится. Поддержка Windows запланирована. Перенос в новую Mac-версию ещё не опубликован в Mac App Store.

crypt1 шифрует существующую HTTPS-ссылку пользователя и выдаёт ссылку вида dodoapp://crypt1/<JWE>. После открытия DoDo просит подтвердить добавление и только затем обращается к серверу подписки. Внутри может оставаться ваш обычный источник: список URI, Base64, один полный Xray JSON или массив профилей. DNS, маршрутизация и балансировщики читаются тем же парсером.

Для обычного crypt1 с response: "auto" менять панель или содержимое подписки не нужно. Ссылка шифруется локально — без API шифрования, регистрации в DoDo, премиум-доступа и обязательного providerid. Remnawave и собственные панели подходят одинаково. Это собственный формат DoDo, а не способ открыть закрытые криптоссылки Happ или INCY.

Генератор работает в браузере через WebCrypto. Введённый URL не отправляется на сервер; cookies и хранилище браузера для ссылок не используются. Для автоматической выдачи используйте Node.js 24+ и тот же SDK из архива. Публичный манифест ключей содержит только открытые RSA-ключи и AGE-получателей.

Быстрый запуск без изменений панели

  1. Возьмите существующий HTTPS-адрес подписки конкретного пользователя.
  2. Откройте генератор, вставьте адрес и оставьте «Автоматически». Название необязательно.
  3. Передайте полученную crypt1-ссылку этому пользователю в личном сообщении или кнопке бота. Не выдавайте одну персональную подписку всем абонентам.
  4. В iOS 2.2.0 откройте ссылку или добавьте её через «+» из буфера, вручную либо QR-кодом. В Android APK 2.2.0 используйте буфер или ручной ввод; известное ограничение QR на HUAWEI описано выше. Подтвердите добавление и проверьте обновление и VPN.

При «Поделиться QR-кодом» и копировании DoDo использует исходную crypt1-ссылку, а не раскрытый URL. Очень длинная ссылка может не поместиться в QR-код — в таком случае отправьте её текстом. Повторное шифрование того же URL даёт другую строку, но приложение обновляет прежнюю карточку подписки.

Генерация в Telegram-боте или на вашем сервере

Распакуйте архив инструментов. Внутри находятся cli/, generator/, keys/, инструкция и спецификация. SDK не требует npm-пакетов и не загружает ключи по сети. Храните URL пользователя в защищённом хранилище своего сервиса.

# Запускайте из папки распакованного архива; требуется Node.js 24+.
# subscription-url.txt содержит HTTPS-ссылку одного пользователя.
node cli/dodo-crypt1.mjs --name "Demo Provider" < subscription-url.txt

# Для полного payload из JSON-файла:
node cli/dodo-crypt1.mjs --input-json < payload.json

CLI читает исходный URL через stdin и выводит только защищённую ссылку. Не помещайте настоящий токен в аргументы команды, историю терминала или логи бота. Результат CLI тоже является секретной ссылкой — передавайте его только владельцу подписки.

import { readFile } from 'node:fs/promises';
import { createCrypt1Link } from './generator/crypt1.mjs';

const publicManifest = JSON.parse(
  await readFile(new URL('./keys/public-keys.json', import.meta.url), 'utf8')
);

const protectedLink = await createCrypt1Link({
  v: 1,
  type: 'subscription-url',
  url: 'https://primary.example/sub/demo-token?format=json',
  response: 'auto',
  name: 'Demo Provider',
}, publicManifest);

// Передайте protectedLink пользователю; не записывайте её в общий лог.

createCrypt1Link(payload, publicManifest) возвращает Promise<string>. Первый аргумент описывает подписку, второй — содержимое опубликованного манифеста. SDK использует его activeKid; закрытый ключ провайдеру не нужен. Обновляйте локальную копию публичного манифеста при смене ключей DoDo, а не при каждом пользовательском запросе.

Поля payload для createCrypt1Link
ПолеОбязательноЧто передать
vДаЧисло 1.
typeДаСтроку subscription-url.
urlДаПолный HTTPS-адрес пользователя, до 4096 байт UTF-8. Без логина/пароля, фрагмента, пробелов, IP-литералов и локальных адресов.
responseДаauto для обычного или AGE1-ответа; age1-required только для уже настроенного AGE1-источника.
nameНетНепустое название до 120 байт UTF-8 после удаления пробелов по краям. Управляющие символы запрещены. Это имя для подтверждения, не доказательство личности провайдера.

Не добавляйте собственные поля к payload. URL сохраняется без повторного декодирования: %2F, %252F, знак +, путь и query должны остаться такими, как их выдала ваша панель. primary.example, backup.example и demo-token — только примеры, не рабочие адреса и ключи.

Формат crypt1 для собственной реализации

Если используете готовый SDK, заголовок и случайные значения он создаёт сам. Для другой реализации нужна JWE Compact Serialization: пять сегментов protected.encrypted_key.iv.ciphertext.tag, канонический base64url без =, пробелов и дополнительных слоёв кодирования.

{"alg":"RSA-OAEP-256","enc":"A256GCM","typ":"dodo-subscription+jwe","kid":"dodo-crypt1-20261102"}

Значение kid здесь приведено как пример текущего ключа. В своей реализации выбирайте его из activeKid публичного манифеста, а не фиксируйте навсегда в коде.

{"v":1,"type":"subscription-url","url":"https://primary.example/sub/demo-token","response":"auto","name":"Demo Provider"}
Точные параметры crypt1 v1
ПараметрЗначение
RSA3072 бита, exponent 65537; RSA-OAEP-256 с SHA-256 и MGF1 SHA-256, пустой OAEP label.
AES-GCMНовый случайный CEK 32 байта, IV 12 байт, tag 16 байт. AAD — ASCII первого закодированного сегмента JWE.
ЗаголовокТолько обязательные alg, enc, typ, kid. kid должен быть известен приложению.
ЛимитыВся crypt1-ссылка — 16 384 байта UTF-8; JSON payload — 8192 байта; исходный URL — 4096 байт; имя — 120 байт.
НедопустимоПовторяющиеся JSON-имена, неизвестные поля/алгоритмы, zip, crit, jku, встроенные ключи и загрузка ключей из URL заголовка.

AGE1: шифрование ответа сервера — отдельная настройка

crypt1 защищает ссылку; AGE1 защищает тело HTTP-ответа по этой ссылке. AGE1 можно использовать и с обычным HTTPS-адресом. Для него сервер должен отдельно зашифровать пригодный JSON, список URI или Base64 на опубликованный X25519-получатель DoDo.

age1-required не включает шифрование на сервере. Этот параметр требует от приложения отклонять незашифрованный ответ, в том числе от резервного адреса. Сначала настройте и проверьте AGE1 на сервере, затем выдавайте ссылку с этой политикой. При auto принимается обычный поддерживаемый ответ или AGE1; распознанный повреждённый AGE не разбирается повторно как открытый текст.

Приложение не отправляет заголовок, который включает AGE на вашем сервере: в запросе остаются обычный Accept: */*, User-Agent и данные устройства. Значение response из crypt1 тоже не является командой серверу. Надёжный вариант — отдельный HTTPS-адрес, который всегда отдаёт AGE1, а остальным клиентам оставить прежнюю ссылку. Если используете правила User-Agent, учтите: само значение DoDoApp не сообщает номер сборки пользователя.

Для примера ниже нужны официальный CLI age с X25519 и jq. Сохраните публичный манифест в keys/public-keys.json; никакие закрытые ключи DoDo провайдеру не передаются. subscription.json должен содержать действующий профиль именно этого пользователя.

# В примере используется первый опубликованный AGE-получатель.
jq -er '.ageRecipients[0].recipient' keys/public-keys.json > age-recipients.txt

# Бинарное тело HTTP-ответа:
age --encrypt --recipients-file age-recipients.txt \
  --output subscription.json.age subscription.json

# Или ASCII armor вместо бинарного тела:
age --encrypt --armor --recipients-file age-recipients.txt \
  --output subscription.json.age.armor subscription.json

Верните содержимое созданного файла непосредственно телом ответа: бинарный age v1 обычно с Content-Type: application/octet-stream, ASCII armor — с text/plain. DoDo распознаёт формат по началу тела, а не только по Content-Type. Не добавляйте JSON-обёртку, ещё один Base64, BOM или HTML. Парольный scrypt, SSH-ключи, плагины и AGE-файлы для чужих получателей не поддерживаются.

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Cache-Control: private, no-store
profile-title: Demo Provider
profile-update-interval: 2
subscription-userinfo: upload=0; download=0; total=107374182400; expire=1893456000
fallback-url: https://backup.example/sub/demo-token
providerid: demo-vpn

Название, срок, трафик, интервал обновления, поддержка и fallback-url остаются настоящими HTTP-заголовками вне AGE-тела. У них сохраняется обычный приоритет и правила проверки. providerid в примере необязателен для crypt1/AGE; если он сохранён вместе с резервом, резерв обязан вернуть тот же ID. Резерв работает по общим правилам fallback, независимо от шифрования ссылки. При age1-required и основной, и резервный адрес должны выдавать AGE1.

Перед выдачей пользователям

  1. Убедитесь, что установлена iOS 2.2.0 или новее. Добавьте одну проверочную подписку и убедитесь, что запрос начинается только после подтверждения.
  2. Сравните число профилей с исходным JSON; проверьте полный профиль с балансировщиком, обновление, выбор сервера и подключение.
  3. Для AGE проверьте основной и резервный адреса. Ошибочный получатель, повреждённое тело и открытый ответ при age1-required должны завершаться ошибкой, а не импортом части серверов.
  4. Проверьте копирование/QR, повторное добавление и обновление: исходная crypt1-ссылка, порядок подписок и настройки должны сохраниться. Не публикуйте рабочие токены в скриншотах.
Если ссылка или ответ не принимаются
ПричинаЧто проверить
Неизвестный ключ или форматВерсию и номер сборки приложения, актуальный публичный манифест и собственную схему dodoapp://crypt1/. Ключи Happ и его crypto-ссылки не подходят.
Не удалось открыть защищённую подпискуЦелостность всей ссылки, пять JWE-сегментов, поддерживаемые поля и отсутствие повторного URL/Base64-кодирования. Прежние серверы не удаляются.
Требуется AGE-ответСервер вернул открытые данные при age1-required. Измените выдачу на сервере, а не отключайте проверки приложения.
Не удалось расшифровать AGEПолучателя DoDo, бинарный формат или ASCII armor, отсутствие обёрток и полную передачу файла. Не пытайтесь извлекать из повреждённого тела отдельные URI.
HTTP, TLS, HWID или срок подпискиОбычные ограничения сервера сохраняются. crypt1/AGE не обходят отказ доступа, лимит устройств или ошибку сертификата.

Защищённая ссылка всё ещё даёт доступ к подписке. Это не DRM и не подтверждение личности провайдера. Ключ расшифрования встроен в приложение и может быть извлечён при его исследовании. Храните исходные и crypt1-ссылки защищённо, не отправляйте их в общий лог, используйте HTTPS, авторизацию и лимиты своей панели. Не помещайте в payload административные API-токены или пароли сервера.

05 / МЕТАДАННЫЕ

HTTP-заголовки ответа

Реализовано

Передавайте эти поля в заголовках HTTP 200 ответа по ссылке подписки. Регистр имён не важен. Для обычных метаданных DoDo сначала читает HTTP-заголовки, затем поддерживаемые поля в комментариях тела, декодированном Base64 и JSON-метаданных. Используется первое корректное значение. x-dodo-provider-id — исключение: только настоящий успешный HTTPS-ответ с того же точного host.

Заголовки подписки; доступность функций зависит от версии приложения
ЗаголовокЧто отправитьЧто увидит пользовательОсобенности
profile-titleНазвание текстом или base64:… UTF-8.Название карточки подписки / сервиса.Если поля нет, используются subscription-name, затем filename / filename* в Content-Disposition.
x-dodo-provider-idUUID провайдера из своего кабинета.Связь с публичным брендом и сторис в совместимой версии приложения; наличие этой функции в опубликованных версиях здесь не заявляется.Нужны точный DNS-подтверждённый host и одобрение DoDo. Не подтверждает оплату, не открывает закрытую аудиторию и не включает push. Модуль подписи не нужен.
x-dodo-provider-logo-urlПубличный HTTPS URL изображения.Логотип сервиса в верхнем блоке.Не включайте пароль или секретную ссылку подписки в адрес картинки. Иконка приложения на устройстве не меняется.
support-urlАдрес поддержки, например HTTPS-ссылка на Telegram.Кнопку «Поддержка» в карточке.Без значения кнопка не создаётся автоматически.
profile-web-page-urlПубличную ссылку на кабинет, бот или страницу подписки.Кнопку перехода на сайт / «Купить / Продлить».Альтернативное имя: homepage. Оплата проходит на вашей странице, а не в DoDo.
subscription-userinfoupload=…; download=…; total=…; expire=….Срок, статус и использованный / доступный трафик.Объёмы передавайте в байтах, expire — как Unix timestamp в секундах. Сам по себе HTTP 403 не задаёт дату окончания.
profile-update-intervalЦелое число часов от 1 до 168. Не минуты и не секунды.Автоматическое обновление, когда наступит срок и приложение получит время на выполнение.По умолчанию — 1 час. В фоне время запуска определяет операционная система.
routingСтатический JSON / Base64 / DoDo routing-ссылку.Правила Direct / Proxy / Block для этой подписки.Для обновления правил по сети используйте autorouting. Новые правила применяются при следующем подключении.
autoroutingHTTPS URL отдельного ресурса правил.Актуальные правила своей подписки.Формат, ограничения и интервалы проверки описаны в разделе «Маршрутизация».
announceТекст или поддерживаемое base64:….Блок объявления внутри карточки.Объявление не отправляется как push-уведомление и не публикуется как сторис.

Если подписка — статический текстовый файл

Для поддерживаемых полей допустимы строки-комментарии в начале тела. Например:

#profile-title: Demo Provider
#profile-update-interval: 2
#support-url: https://example.invalid/support
#announce: Demo announcement
vless://00000000-0000-4000-8000-000000000001@example.invalid:443?security=tls#Demo

HTTP-заголовок имеет приоритет над комментарием. Поля идентификации провайдера, включая x-dodo-provider-id, принимаются только из успешного HTTPS-ответа на том же точном host, а не из комментариев тела. Сам ID не подтверждает доступ к закрытому контенту; публичные бренд и сторис не являются проверкой оплаты.

profile-title: Demo Provider
profile-update-interval: 2
x-dodo-provider-logo-url: https://example.invalid/logo.png
support-url: https://example.invalid/support
profile-web-page-url: https://example.invalid/account
subscription-userinfo: upload=0; download=0; total=107374182400; expire=1893456000
autorouting: https://example.invalid/routing.json

Как работает автоматическое обновление. DoDo проверяет срок во время работы и при возвращении пользователя в приложение. В фоне время выполнения назначает iOS, поэтому обновление может произойти позже заданного интервала. При сетевой ошибке сохранённая подписка остаётся на устройстве.

Не поддерживаются заголовки update-always, profile-description, premium-url, fragmentation-*, noises-*, server-address-resolve-*, а также управление Lite Mode, темой или стилем кнопок со стороны провайдера. DNS и сложные транспортные параметры передавайте в совместимом полном Xray JSON. Произвольные внешние геофайлы по заголовкам не загружаются.

fallback-url и связанный с ним providerid описаны в разделе «Резервная подписка». Для них принимаются только настоящие HTTP-заголовки ответа — не комментарии тела и не поля JSON.

05.1 / РЕЗЕРВНЫЙ АДРЕС

Резервная подписка: fallback-url

iOS и Android 2.2.0

Если основной адрес подписки временно недоступен, DoDo может загрузить обновление по заранее сохранённому резервному адресу. Это работает со списком серверных URI, Base64 и поддерживаемым JSON, включая полные Xray-профили. Криптоссылка для этого не нужна.

Доступность. Резервный адрес поддерживается в опубликованной iOS 2.2.0 и Android APK 2.2.0 (2107). Заголовки можно использовать для обычных HTTPS-ссылок и JSON, независимо от crypt1. В опубликованной Mac-версии этого механизма пока нет.

Регистрация в DoDo и премиум-доступ для резервной загрузки не нужны. Используйте Remnawave или свою панель: важно, чтобы сервер возвращал правильные HTTP-заголовки и подписку нужного пользователя.

Заголовки резервной подписки
ЗаголовокЗначениеТребования
fallback-urlПолная HTTPS-ссылка на резервную подписку конкретного пользователя.Не только домен. Путь, токен и query задаёт провайдер; приложение не переносит их самостоятельно. Принимается из пригодного успешного ответа основного HTTPS-источника на том же origin.
provideridНеобязательный постоянный ID вашего VPN-сервиса, например demo-vpn.Провайдер выбирает ID самостоятельно. Это не лицензия Happ, не ID кабинета DoDo, не HWID и не проверка оплаты. Если основной ответ передал его вместе с резервом, резерв обязан вернуть точно такое же значение.

Имя заголовка нечувствительно к регистру. Значение providerid чувствительно к регистру: Demo-VPN и demo-vpn различаются. Допустимы 1–128 символов ASCII: первая буква или цифра, далее буквы, цифры, точка, дефис, подчёркивание и двоеточие. Не используйте секретный API-токен. Если ваш сервис уже передаёт свой ID, менять его ради DoDo не требуется.

Если вы уже отдаёте fallback-url и providerid для пользователей Happ или INCY, DoDo сможет прочитать их в описанном здесь формате. Пользователю достаточно обычной HTTPS-ссылки подписки; отдельный ID для DoDo не нужен. Это не добавляет поддержку happ://crypto… или команд чужих приложений.

Не путайте providerid с x-dodo-provider-id из раздела привязки провайдера. Резервная загрузка не открывает доступ к сторис, уведомлениям или закрытым данным; эти возможности настраиваются отдельно.

Пример основного и резервного ответа

Основная подписка https://primary.example/sub/demo-token возвращает конфигурацию пользователя в теле и следующие заголовки:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
providerid: demo-vpn
fallback-url: https://backup.example/sub/demo-token

Резервный адрес должен отдавать подписку того же пользователя. Если в основном ответе был providerid, добавьте его и к резервному ответу:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
providerid: demo-vpn

Без providerid резерв также работает — по точному HTTPS-адресу, полученному от основного источника. Если ID был сохранён, а резерв вернул другой ID или не вернул его совсем, обновление отклоняется и прежние серверы остаются. Совпадающий ID сам по себе не подтверждает владение сервисом или принадлежность абонента.

Как настроить в Remnawave

  1. Откройте раздел заголовков ответа подписки: Response Headers или Additional Response Headers. Название раздела зависит от версии панели.
  2. Добавьте fallback-url с персональным резервным URL и, при необходимости, постоянный providerid.
  3. В версиях с поддержкой шаблонов в заголовках используйте {{SHORT_UUID}}, чтобы панель подставляла идентификатор текущей подписки. Задайте домен и путь, по которым резерв действительно выдаёт эту подписку.
  4. Настройте выдачу заголовков для всех нужных форматов, включая JSON, и применяемых User-Agent. Для отдельных клиентов можно использовать Response Rules, не заменяя остальные правила форматов.
providerid: demo-vpn
fallback-url: https://backup.example/sub/{{SHORT_UUID}}

Домены primary.example, backup.example и demo-token — примеры, не рабочие адреса и ключи. Замените их своими. Не прописывайте одну персональную ссылку всем абонентам. В ответе сервера должна быть уже полная ссылка конкретного пользователя, без нераскрытого {{SHORT_UUID}}.

Подготовьте сам резерв

  • Настройте DNS, действующий HTTPS-сертификат и выдачу конфигураций по резервному адресу. Одна DNS-запись не создаёт резервный сервис.
  • Возвращайте конфигурацию, а не главную страницу сайта. Сохраняйте срок подписки, трафик, правила и ограничения устройств; DoDo использует тот же HWID.
  • Запасной домен на том же сервере может помочь при блокировке имени, но не при недоступности самого сервера или его IP. Для такого случая резерву нужна отдельная доступная инфраструктура.

Когда приложение использует резерв

После сетевого сбоя, таймаута, HTTP 408 или ошибки 5xx основного источника приложение может обратиться к сохранённому резерву в пределах общего времени и количества попыток. Ошибки TLS, отказы авторизации, ограничения HWID, явное отключение или истечение подписки, HTTP 404/410 и 429 не обходятся через резерв. Используется один резервный адрес, без цепочек зеркал и угадывания путей.

Успешная загрузка обновляет ту же карточку: исходная ссылка, ID и порядок подписок сохраняются. Если оба адреса не ответили или резерв вернул непригодный профиль, приложение не удаляет прежние серверы и настройки подписки.

Сначала нужно получить резервный адрес. DoDo запоминает fallback-url после успешного добавления или обновления основной подписки. Если основной адрес недоступен уже при первом добавлении, приложение не сможет узнать резерв из недоступного ответа. Сам по себе providerid адрес не ищет.

Для проверки сначала успешно обновите подписку в поддерживающей сборке DoDo. Затем проверьте доступность резерва для того же пользователя и контролируемый сбой только основного адреса. Полное отключение интернета не проверяет fallback: резерву тоже нужна сеть. Не публикуйте настоящие ссылки с токенами в скриншотах или логах.

06 / УСТРОЙСТВО

HWID и лимит устройств

Реализовано

При загрузке подписки DoDo передаёт вашему серверу сохранённый идентификатор установки, модель и версию системы. HWID создаётся приложением; это не серийный номер телефона и не IDFA. Используйте его для учёта устройств вместе с проверкой доступа на вашем сервере.

User-Agent: DoDoApp
Accept: */*
x-hwid: 00000000-0000-4000-8000-000000000001
x-device-os: iOS
x-ver-os: 18.5.0
x-device-model: iPhone 14 Pro

Это пример iOS-запроса. Android передаёт те же имена технических заголовков с x-device-os: Android, своей версией ОС и моделью. Его User-Agent имеет вид DoDoApp/2.2.0+2107 (Android 15; Demo Model); не ограничивайте серверное правило точным равенством DoDoApp.

  • Идентификатор сохраняется на устройстве, в iOS — в том числе в Keychain. Повторная загрузка после отказа не создаёт новый HWID.
  • Сброс настроек приложения не меняет HWID и не сбрасывает лимит устройств у провайдера.
  • HWID передаётся в заголовке и не добавляется в адрес подписки.
  • При перенаправлении на другой origin iOS удаляет чувствительные заголовки, а Android отклоняет переход целиком. Переход с HTTPS на HTTP запрещён.
  • Количество разрешённых устройств и доступ к подписке определяет сервер провайдера.
Ответ провайдераРеакция
x-hwid-max-devices-reached: trueОшибка достижения лимита устройств.
x-hwid-limit: trueСовместимый старый признак того же ограничения.
x-hwid-not-supported: true / явный HWID_REQUIREDПонятный отказ загрузки; идентификатор не заменяется новым.

x-hwid и x-dodo-provider-id не заменяют авторизацию подписчика. Для доступа к закрытым публикациям серверу потребуется отдельно проверить, что подписка принадлежит этому пользователю.

08 / ПРАВИЛА

Статическая и обновляемая маршрутизация

Поддерживаемые поля ниже

Задайте, какие домены и IP направлять напрямую (Direct), через прокси (Proxy) или блокировать (Block). Профиль правил DoDo имеет собственный формат; полный Xray JSON в эти поля передавать нельзя.

{
  "Name": "Demo rules",
  "GlobalProxy": true,
  "DomainStrategy": "IPIfNonMatch",
  "DirectSites": ["domain:example.invalid"],
  "DirectIp": [],
  "ProxySites": ["full:proxy.example.invalid"],
  "ProxyIp": [],
  "BlockSites": ["geosite:category-ads-all"],
  "BlockIp": []
}

Локальная routing-ссылка

Сохраните JSON в UTF-8, закодируйте в Base64 или Base64URL и поместите результат после /add/ либо /onadd/. Для ссылки удобнее Base64URL без завершающих =. Обычный Base64 можно закодировать через percent-encoding один раз.

dodo://routing/add/{BASE64_UTF8_JSON}
dodo://routing/onadd/{BASE64_UTF8_JSON}
dodo://routing/off

Обе команды сохраняют и включают профиль. off отключает правила, не удаляя их. Не добавляйте в ссылку имя пользователя, пароль, порт, query или fragment. Правила применятся при следующем подключении; текущий VPN автоматически не переподключается.

autorouting: отдельный HTTPS JSON

В autorouting передайте публичную HTTPS-ссылку на файл правил, например https://example.invalid/routing.json. Замените адрес на свой домен: .invalid и локальные адреса не принимаются.

  • Ответ — HTTP 200 с JSON-объектом в UTF-8. Base64, routing-ссылка и полный Xray JSON здесь не принимаются.
  • Разрешены только поля примера выше и строковый LastUpdated; поддерживаются их camelCase-алиасы. Неизвестные поля и конфликтующие алиасы отклоняются.
  • Списки — массивы строк: домены, domain:, full:, проверяемый regexp:, geosite:; для IP — IP/CIDR и geoip:. Наличие категории проверяется по доступным геофайлам.
  • Для удалённого формата DomainStrategy: AsIs, IPIfNonMatch или IPOnDemand. GlobalProxy — JSON boolean либо строка "true" / "false".
  • Лимиты: 256 KiB на файл, до 2048 записей суммарно и до 512 байт на запись. В iOS на запрос отводится до 12 секунд.
  • Используйте HTTPS на стандартном порту, без имени пользователя, пароля и fragment. Перенаправления допускаются только в пределах того же origin и в ограниченном количестве. HWID, cookies и API-токены подписки в этот запрос не передаются.
  • Правила хранятся отдельно для каждой подписки. При сетевой ошибке или неверном JSON остаётся последняя рабочая версия.
  • В iOS успешный источник проверяется не чаще раза в час; после ошибки проверка повторяется с паузой. Работа в фоне зависит от системы. Новые правила используются при следующем подключении.

Внутри тела подписки также распознаются dodo://autorouting/add/… и dodo://autorouting/onadd/… с HTTPS-источником. Не используйте их как ссылку для открытия приложения из бота или браузера.

Дополнительные настройки. DNS / FakeDNS, внешние Geoipurl / Geositeurl и routeOrder в этом формате не поддерживаются. Для сложной маршрутизации и балансировщиков используйте совместимый полный Xray JSON.

В Android 2.2.0 интервал проверки autorouting — 24 часа, лимит времени запроса — 8 секунд. Правила также хранятся отдельно для подписки; запрос не содержит HWID, cookies и API-токенов. Интервал autorouting не связан с profile-update-interval, который управляет обновлением самой подписки.

09 / GEOIP И GEOSITE

Геоданные встроены в приложение

Реализовано

В iOS 2.2.0 и Android 2.2.0 встроены geoip.dat и geosite.dat. Перед первым подключением эти файлы не нужно загружать вместе с подпиской.

Источник обновлений — Loyalsoldier/v2ray-rules-dat. Перед установкой проверяются SHA-256, формат файлов и наличие нужных категорий. Если проверка не прошла, остаётся последняя рабочая пара.

В iOS версии файлов и ручная проверка доступны в «Настройки → Для опытных пользователей → Геоданные». Приложение также проверяет обновления автоматически, когда получает время на выполнение и источник доступен.

Используйте категории geosite: / geoip:, которые есть в наборе Loyalsoldier. Категории из других наборов могут отсутствовать. Загрузка произвольных геофайлов по ссылкам провайдера не поддерживается.

В Android работающий VPN продолжает использовать выбранную версию файлов до отключения. Обновлённые файлы применяются при следующем подключении; предусмотрен откат к рабочей версии.

10 / ПРОВЕРКА СЕРВЕРА

Проверка задержки

В iOS режим выбирается в «Настройки → Для опытных пользователей → Пинг». По умолчанию — TCP. Доступны свой HTTPS URL теста и таймаут от 1 до 10 секунд.

РежимЧто проверяетсяКак читать число
TCPУстановка соединения с сервером. Для Hysteria используется отдельная HTTP-проверка через профиль, поскольку протокол работает по UDP.Исходное измеренное время, без деления на 3,3. Открытый TCP-порт сам по себе не подтверждает авторизацию и доступ в интернет.
DoDo PingHTTP GET через поддерживаемый Xray-профиль сервера; для отдельных протоколов используется своя проверка.Оценочное значение: измеренный результат делится на 3,3.
HTTP GET / HTTP HEADЗапрос соответствующего метода через профиль к тестовому HTTPS URL.Измеренное время запроса без деления на 3,3. Скорость передачи данных не измеряется.
ICMPICMP-запрос к серверу.Время ответа. Сервер может блокировать ICMP и при этом нормально обслуживать VPN-подключения.

Исходные измерения сохраняются без пересчёта. При смене способа проверки iOS запускает подходящий замер и не выдаёт результат другого метода за новый. При обновлении ключа последние значения остаются у совпадающих серверов. N/A означает, что проверка не удалась или недоступна для этого профиля; многоточие — что для выбранного метода ещё нет результата.

Число одновременных проверок ограничено. Замер не переподключает текущий VPN. Если JSON содержит балансировщик, проверка выполняется через весь профиль, с его правилами выбора сервера.

В Android APK 2.2.0 (2107) доступны те же пять режимов. Обычный TCP показывает измеренное время соединения без деления: это относится и к однозначному JSON-профилю с одним TCP-сервером. Для Hysteria, балансировщиков и сложных или неоднозначных профилей в TCP-режиме выполняется HTTP GET через полный профиль. Запуск служебного ядра и локальная авторизация не входят в показанное HTTP-время, но расходуют общий таймаут. Только DoDo Ping делит результат HTTP GET на 3,3.

10.1 / НАСТРОЙКИ СЕТИ

DNS, MTU и предпочтительный IP

iOS 2.2.0

Откройте «Настройки → Для опытных пользователей → Сеть». Для обычного подключения рекомендуем оставить значения по умолчанию. Изменения применяются при следующем подключении и не переподключают работающий VPN сами.

Дополнительные настройки iOS
ПараметрЧто доступноКогда пригодится
MTU туннеляПо умолчанию, 1420, 1380, 1280 или целое значение от 1280 до 1500 байт.Для проверки проблем с загрузкой на отдельных сетях. Это размер пакета, а не ограничение скорости; автоматического поиска лучшего MTU нет.
Предпочтительный IP«Как в конфигурации», «Предпочитать IPv4» или «Предпочитать IPv6».Для выбора семейства адреса VPN-сервера с доменным именем. Это не отключение IPv6 на телефоне. Для сложных профилей настройка может не применяться, чтобы сохранить правила провайдера.
DNS из профиляСогласование системного туннеля с DNS Xray, когда конфигурацию можно безопасно адаптировать.Для сохранения DNS-правил провайдера. Неоднозначные схемы, FakeDNS и зависимости от системного DNS не переписываются принудительно; универсальное преобразование любого DNS-профиля не заявляется.
Ресурсы VPNОтдельный экран памяти расширения, Go heap, соединений и файловых дескрипторов.Для диагностики. Нужны включённые диагностические логи и свежий сеанс VPN; если данных нет, приложение сообщает об этом вместо нулевых показателей.

Совместимые полные профили сохраняют собственные DNS, маршруты, балансировщики и параметры транспорта. Выбор IP и MTU не меняет сохранённый ключ. Ручной лимит памяти, No Limit Mode и отдельный редактор всех параметров Xray в приложении не добавлены.

В Android APK 2.2.0 также доступны MTU от 1280 до 1500 байт и предпочтение IPv4 / IPv6. Настройки применяются к новому соединению; сохранённый полный профиль и DNS провайдера не переписываются. Экран ресурсов VPN и особенности DNS могут отличаться от iOS.

IOS / ВЕРСИЯ 2.2.2

Совместимость конфигураций и проверка серверов

Загружено в App Store Connect

Сборка iOS 2.2.2 (113) загружена в App Store Connect 12 ноября 2026 года. Выпуск ещё готовится; о доступности в App Store сообщим отдельно. Изменения ниже относятся только к этой iOS-сборке, не к опубликованным Android и macOS.

Полные JSON-профили

Импорт сохраняет один полный профиль, даже если его единственные дополнительные поля — env и version. Имена переменных окружения сохраняют регистр, ограничения версии ядра продолжают действовать. Массив самостоятельных профилей остаётся списком вариантов выбора; балансировщик не превращается в несколько независимых серверов.

HTTP-проверки и Hysteria2

Подключение и HTTP GET / HEAD используют общую подготовку профиля: правила, DNS, параметры транспорта и область геоданных провайдера. Проверка выполняет запрос через выбранный прокси или балансировщик, не переподключая текущий VPN. Переменные env применяются в изолированном служебном ядре и восстанавливаются после завершения. Служебные переменные самого приложения защищены от подмены.

Исправлена подготовка геоданных для HTTP-замера Hysteria2. В TCP-режиме эти UDP-серверы по-прежнему проверяются через HTTP, а обычный TCP показывает измеренное время соединения без деления. Только оценочный DoDo Ping делит HTTP GET на 3,3. Это не тест скорости и не полная проверка TUN или всех ресурсов.

DNS и ограниченный FakeDNS

Доработаны согласование DNS Xray с системным туннелем, раздельный DoH и локальные DNS-алиасы с защитой от циклов. Поддерживаются совместимые явно заданные FakeDNS-профили со стандартными пулами; произвольные смешанные DNS-схемы не адаптируются автоматически. Для профиля с FakeDNS отдельный HTTP-замер недоступен: это само по себе не означает, что VPN не работает. Lua-скрипты не поддерживаются.

FinalMask и фрагментация

Поддержаны совместимые URI-параметры fm, fragment и fragmentPackets / fragmentLength / fragmentInterval, а также HTTP-заголовки fragmentation-enable, fragmentation-type, fragmentation-packets, fragmentation-length, fragmentation-delay и fragmentation-maxsplit. Маска из заголовков включается только при fragmentation-enable: true и типе xray; fragmentation-interval допускается как альтернативное имя задержки.

Приоритет: готовый полный JSON, затем явная маска URI, затем настройки из успешного HTTP-ответа. Две маски автоматически не складываются; готовый JSON не исправляется молча. Несовместимое активное требование отклоняется, а не заменяется другим способом. На UDP-only / Hysteria автоматическая TCP-фрагментация не накладывается. Проверка TLS не ослабляется.

Интерфейс и локальная защита

Доработаны список уведомлений и карточка VPN на экране блокировки и в Dynamic Island. Основное приложение поддерживает iOS 15 и новее; Live Activity требует iOS 16.1 и поддержки устройства.

  • Защита локального SOCKS. Для внутреннего соединения между VPN-туннелем и Xray на устройстве используются отдельные служебные имя и пароль на каждое подключение. При смене провайдера они не переносятся в следующий сеанс.
  • Пароли провайдера сохраняются. Если полный профиль уже требует авторизацию на локальном SOCKS-входе и содержит пригодную учётную запись, используются его данные, без замены служебным паролем и без отключения требований защиты.
  • Удалённые серверы не перенастраиваются. Защита относится к локальному входу приложения, а не к SOCKS-серверу провайдера. Его адрес, логин и пароль не меняются; перенастройка нод не требуется.
  • Понятнее причина отказа. Добровольный технический отчёт дополняется ограниченной сводкой ошибки импорта: этап, причина, до четырёх последних попыток загрузки, HTTP-код, разрешённый системный сетевой код и время. Сводка — до 1024 байт; URL, ключи, HTTP-заголовки и тела ответов не передаются. Отправка по-прежнему требует согласия пользователя.

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

Обновление ещё не опубликовано. Выдавайте новые параметры после обновления клиента. Совместимость зависит от конфигурации и версии ядра; работу вашего сервиса нужно проверить на его ключах и сети пользователя. О выпуске сообщим в разделе обновлений и Telegram-канале.

11 / ПОДДЕРЖКА

Логи и добровольные отчёты

Реализовано

В iOS откройте «Настройки → Для опытных пользователей → Логи»: здесь можно включить запись, смотреть события в реальном времени, поставить просмотр на паузу, скопировать или очистить лог. Перед отправкой проверьте содержимое: в нём могут остаться технические адреса серверов.

После ошибки DoDo может предложить автоматически отправлять технические отчёты разработчику. Отправка начинается только после согласия пользователя. В настройках её можно отключить, отозвать согласие и удалить отправленные данные.

  • Отчёт содержит код и этап ошибки, модель устройства, версию системы и приложения.
  • Ссылки подписок, HWID, полные VPN-конфигурации и содержимое трафика в технический отчёт не входят.
  • Если сети нет, отчёт ожидает отправки в ограниченной очереди на устройстве.
  • Отчёты получает разработчик DoDo. Провайдер не получает к ним доступ через заголовки подписки.

Автоматические отчёты охватывают обработанные приложением ошибки добавления ключей и работы VPN. В iOS 2.2.0 также подключён Apple MetricKit: после согласия на диагностику DoDo может передать признак полученного отчёта о вылете или зависании основного приложения. Это не полный crash-файл, не стек вызовов и не гарантированный учёт всех сбоев VPN-расширения. Доставка Apple может произойти позже, после следующего запуска.

Диагностика в iOS и Android
ПлатформаВозможностиОграничения
iOS 2.2.0Согласие на отправку, очередь отчётов, доставка, отзыв согласия и удаление данных. Ограниченные признаки crash / hang из MetricKit.Без полных стеков; не охватывает все системные вылеты, завершения из-за памяти и зависания. Разрешение на уведомления не заменяет согласие на диагностику.
Android APK 2.2.0Согласие, защищённая очередь отчётов, отправка во время работы приложения, отзыв согласия и удаление данных. Отчёты загрузки помогают отличить ошибки сети, ответа и импорта.Не все системные вылеты и зависания попадают в отчёты. Постоянной отправки при закрытом приложении нет; ключи и тела конфигураций не отправляются.
ПровайдерМожет получить лог, который пользователь решил передать ему самостоятельно.Нет доступа к общей диагностике DoDo, чужим сервисам или содержимому трафика.

Не путайте сведения устройства в запросе подписки с диагностикой: HWID и технические заголовки получает ваш сервер, а добровольные отчёты — разработчик DoDo. Локальные логи пользователь передаёт отдельно.

11.1 / СТАТИСТИКА

Учёт использования по провайдерам

iOS 2.2.0

DoDo группирует публичное название сервиса из profile-title и очищенный контакт support-url, чтобы учитывать использование приложения с ключами разных провайдеров. Дополнительный providerid для этой статистики не обязателен. Ссылки с токенами, ключи VPN и полные конфигурации для такого учёта не нужны.

Что входит в статистику и как её понимать
ДанныеНазначение и ограничения
Название сервиса и поддержкаДля группировки. Совпадение названий не доказывает, что это один владелец; личные или похожие на секретные значения могут быть пропущены.
Модель, ОС, версия приложенияДля отчётов по моделям iPhone и Android-устройств, версиям ОС и сборкам DoDo. Android APK 2.2.0 также подключён к этому учёту. macOS и Windows пока не подключены.
Установки и число конфигурацийОтчёты за 1 / 7 / 30 дней. Это не точное число людей, не активные VPN-сессии и не счётчик онлайн; одна установка может использовать несколько провайдеров.
Что не передаётсяСекретный URL ключа, VPN-пароли, HWID подписки, имя телефона и история посещений. Геокарта по исходным IP в этом учёте не строится.

В iOS 2.2.0 статистика включена по умолчанию для подходящих публичных групп сервиса. Ранее сохранённый отказ не отменяется. В «Настройки → Политика конфиденциальности» можно отключить отправку и запросить удаление данных. Это отдельная настройка, не согласие на технические отчёты об ошибках.

В Android APK 2.2.0 статистика по публичному названию и контакту поддержки также доступна. Ранее выбранное согласие или отказ сохраняются; управление находится в политике конфиденциальности. Отдельная статистика по подтверждённому provider ID для кабинета провайдера ещё не подключена в Android.

Приложение делает не более двух попыток отправки за 24 часа, с интервалом не меньше 12 часов. Недоступность сервера статистики не блокирует запуск DoDo, импорт ключей или работу VPN. Подробная статистика хранится до 30 дней. Временные отметки для учёта повторных отчётов в календарном месяце хранятся до его закрытия, не более 31 дня; затем отметки и отдельный месячный ключ удаляются.

Начиная с 9 ноября 2026 года сервер ведёт месячную историю: одна установка учитывается один раз за месяц, а одна установка с ключами нескольких сервисов может входить в несколько провайдерских групп. Закрытые сводные отчёты хранятся без автоматического удаления. Они не содержат идентификаторов установок, IP-адресов, ключей или полных конфигураций; малые группы скрываются. История до начала этого учёта не восстанавливается. Отзыв согласия удаляет индивидуальные сведения и пересчитывает открытый месяц; выделить конкретную установку из закрытой обезличенной сводки нельзя.

Доступ к отчётам Сейчас отчёты доступны владельцу DoDo в закрытой админке. Кабинеты с отчётами только своего провайдера готовятся отдельно. Название, контакт поддержки и публичный ID не дают права на чужие данные, сторис или рассылки.

12 / ДОСТУПНОСТЬ

Возможности по платформам

Доступно — можно использовать в указанной версии. С ограничениями — прочитайте особенности в соответствующем разделе. В разработке — функция пока недоступна для общего подключения.

Доступность по платформам

В таблице приведены возможности iOS 2.2.0 и Android APK 2.2.0 (2107). Выход обновления Android в Google Play будет объявлен отдельно. Для macOS в магазине остаётся версия 2.0.8 на общей с iOS странице App Store. Новая нативная Mac-версия с Xray 26.10.31 проходит подготовку отдельно и ещё не опубликована; её возможности не следует считать доступными в Mac App Store. Версия для Windows готовится.

Возможности iOS 2.2.0 и Android APK 2.2.0 (2107)
ВозможностьiOS 2.2.0Android APK 2.2.0
URI / Base64 / полный Xray JSONДоступноДоступно Профиль сохраняется целиком.
DoDo crypt1 и AGE1Доступно в iOS 2.2.0 Настройка и ограничения.Доступно с ограничением QR Используйте буфер или ручной ввод; сканирование crypt1 на некоторых HUAWEI требует доработки.
Резервный адрес fallback-urlДоступно Заранее сохраняется из успешного ответа.Доступно Резерв нужно получить заранее.
Данные подписки и интервал обновленияДоступноДоступно
Routing / autorouting / геоданныеС ограничениями См. формат правил.Доступно с ограничениями Интервалы проверки отличаются от iOS.
Пять режимов пинга, логи, QR и сбросДоступноДоступно с ограничением QR TCP без деления; см. методы пинга и QR crypt1.
MTU, предпочтение IPv4 / IPv6, ресурсы VPNДоступно В разделе для опытных пользователей.MTU и IPv4 / IPv6 доступны Состав ресурсной диагностики отличается от iOS.
Учёт использования по провайдерамДоступно Управление в политике конфиденциальности; отчёты владельцу DoDo.Доступно По названию и поддержке, с настройками согласия и удаления. Provider ID для кабинета пока не передаётся.
Отчёты об ошибках с согласия пользователяДоступно Отправку можно отключить, данные — удалить.Доступно Те же настройки согласия и удаления.
Сторис провайдераЗакрытое тестирование Только на подключённых для теста устройствах.Пока недоступно
Привязка подписчика, адресные push и серверный AutoВ разработкеВ разработке

Версии отличаются. Новые возможности iOS 2.2.0 не появляются автоматически в Android или macOS. Перед выдачей новых форматов убедитесь, что клиент пользователя поддерживает их; ссылки на магазины есть на главной странице.

Дополнительные возможности

ВозможностьСтатусЧто это означает
Импорт, обновление, данные подписки, QRДоступноДля описанных в справочнике форматов. Для QR-сканера требуется разрешение на использование камеры.
Полный Xray JSON и балансировщикиС ограничениямиПрофиль сохраняется целиком со связанными выходами. Допустимые форматы и ограничения описаны в разделе «Форматы подписок».
Защищённые ссылки DoDo crypt1Доступно с ограничениямиiOS 2.2.0 из App Store и Android APK 2.2.0. Локальный генератор и SDK без регистрации или API шифрования. На некоторых HUAWEI для crypt1 используйте буфер или ручной ввод вместо QR. Документация.
Резервная подписка: fallback-urlДоступноiOS 2.2.0 и Android APK 2.2.0. Для обычных HTTPS-ссылок, JSON и crypt1; резерв нужно получить заранее. В опубликованной Mac-версии пока недоступно. Заголовки и настройка резерва.
Кнопка «Автовыбор» DoDoВременно скрыта в iOSПользователь выбирает профиль вручную. Балансировщик внутри полного JSON продолжает работать; он не зависит от этой кнопки.
Live Activity / Dynamic IslandНа совместимых устройствахИндикация VPN для iPhone с iOS 16.1+. Нужны поддерживаемая модель, разрешение Live Activities и включённая настройка в DoDo.
Оформление и сброс настроекРеализованоСветлая/тёмная тема и настройки приложения. Полный сброс запрашивает подтверждение, удаляет подписки и пользовательские настройки; перед сбросом сохраните свои ключи.
Обновляемые правила и геоданныеС ограничениямиЗагружаемые данные проходят проверку. При ошибке остаётся рабочая версия; время выполнения в фоне определяет система.
Сторис провайдераЗакрытое тестированиеПросмотр доступен только на устройствах, подключённых к тестированию. Общее подключение провайдеров откроется позже.
Регистрация кабинета и DNS TXTРанний доступGoogle-вход, бесплатное создание сервиса и подтверждение точного домена. Полный production-запуск скоро. Начать подключение.
Публичный бренд и сторисПодготовка интеграцииКабинет, точный host с DNS TXT, одобрение DoDo и x-dodo-provider-id в HTTPS-ответе подписки. Без модуля и ключа подписи. Это не закрытая аудитория; нужен совместимый клиент, а публикация новой версии здесь не подтверждается.
Подписанное подтверждение абонентаНеобязательный пилотОтдельный расширенный протокол с подписью сервера. Не требуется для публичного контента; публичный ID не заменяет его проверки.
Push своим абонентамПока недоступноАдресные рассылки для отдельных провайдеров ещё не подключены.
Серверный Auto через API панелиВ разработкеБудет отличаться от локального автовыбора и балансировщика Xray. Секретные API-токены нельзя помещать в подписку или приложение пользователя.
Happ crypto / Happ deeplinkНе поддерживаютсяДоступна только описанная выше совместимость JSON-ответов.
Lite Mode, Premium API и принудительное оформлениеНе поддерживаютсяПровайдер не может включить Lite Mode или изменить тему и стиль кнопок приложения через эти поля.

Начните с подписки. Настройте HTTPS-ответ по примерам выше, добавьте его в DoDo и проверьте подключение. Кабинет DoDo и передача нам приватного API-токена для этого не нужны.