DODO / ДЛЯ ПРОВАЙДЕРОВ

DoDo для
вашего VPN.

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

Регистрация провайдеров открыта в раннем доступе. Полный production-запуск скоро. Вход через Google, без тарифов и оплаты. Автоматическая привязка абонентов в приложении проходит отдельный интеграционный пилот.

Доступно

Подписки вашего сервиса

Импорт, обновление, название, логотип и данные тарифа. Подойдёт Remnawave или собственная панель с поддерживаемым форматом подписки.

Бесплатный ранний доступ

Кабинет и сторис

Зарегистрируйте сервис через Google, подтвердите домен и подготовьте бренд и черновики. Доставка контента абонентам требует отдельного одобрения и интеграции.

В разработке

Уведомления и автовыбор

Проверка принадлежности подписки, адресные уведомления и выбор сервера через API вашей панели.

01 / ПОДПИСКИ

Подключите свою панель

Для импорта подписок достаточно HTTPS-ссылки. Регистрация в кабинете DoDo не требуется.

Доступно

Форматы подписок

Список ссылок на серверы, Base64 и совместимый Xray JSON. Полные JSON-профили сохраняют собственные DNS, правила маршрутизации и балансировщики.

Форматы и примеры
Доступно

Данные сервиса и тарифа

Передайте название, логотип, поддержку, страницу продления, срок действия и трафик в заголовках ответа. DoDo покажет их в карточке подписки.

HTTP-заголовки
Доступно

Лимиты устройств

При запросе подписки iOS и Android передают HWID, модель, ОС и её версию. Ваша панель может использовать эти данные для ограничения числа устройств. Сам лимит проверяется на вашем сервере.

Данные устройства и лимиты

Можно использовать собственную панель. DoDo читает подписку напрямую с вашего сервера. Для этого не нужны административный API-токен или переход на Remnawave. Поддерживаемые протоколы и ограничения конфигураций перечислены в документации.

Выдавайте защищённые ссылки DoDo crypt1. В iOS 2.2.0 и Android APK 2.2.0 поддерживается dodoapp://crypt1/…: генератор зашифрует существующий HTTPS-адрес подписки, а приложение расшифрует его на устройстве без обращения к API DoDo. Обычные списки, Base64 и полный JSON продолжат работать без изменений панели. Для бота есть SDK и CLI под Node.js 24+. Отдельно можно настроить AGE1 — шифрование самого ответа сервера. Регистрация, премиум-доступ и providerid для этих форматов не требуются. Защищённая ссылка остаётся ключом доступа: её нельзя публиковать. В Android используйте буфер или ручной ввод: распознавание crypt1 QR на некоторых HUAWEI ещё дорабатывается. Для опубликованной macOS эти форматы пока недоступны; Windows готовится.

Открыть генератор

Параметры, примеры для бота и AGE-ответы · Скачать инструменты

Подготовьте запасной адрес подписки. В iOS 2.2.0 и Android APK 2.2.0 работает fallback-url: при временной недоступности основного источника DoDo попробует ранее сохранённый резерв для того же пользователя. Механизм подходит для обычных списков, Base64 и JSON, в том числе при использовании crypt1. Передавайте полный резервный HTTPS-адрес с нужным путём и токеном — приложение не придумывает зеркала само. Резерв нужно получить при успешном обращении к основному адресу: если он недоступен уже при первом добавлении, узнать запасной адрес из его ответа невозможно. Регистрация и премиум-доступ не нужны; в опубликованной macOS этот механизм пока недоступен.

Резервный домен, providerid и пример для Remnawave

02 / ОФОРМЛЕНИЕ ПОДПИСКИ

Покажите свой бренд и условия тарифа

Добавьте нужные заголовки к ответу сервера подписок. Все поля необязательны; ниже — пример с демонстрационными значениями.

Название, логотип и срок действия

profile-title задаёт название, x-dodo-provider-logo-url — адрес логотипа. Ссылки поддержки и страницы продления добавят соответствующие кнопки в приложение.

profile-update-interval задаёт интервал обновления: целое число часов от 1 до 168. Приложение проверяет, пора ли обновить подписку, когда может выполнять сетевые запросы; система не гарантирует запуск в фоне точно по расписанию.

В subscription-userinfo трафик указывается в байтах, expire — Unix timestamp в секундах.

Полное описание заголовков

ПРИМЕР ЗАГОЛОВКОВ ОТВЕТА

profile-title: Example 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

Не помещайте настоящие UUID, пароли, HWID, API-токены и секретные ссылки в публичные примеры или URL логотипа.

Что передать с подпиской и где появится результат
Ваша настройкаHTTP-заголовок ответаВ приложении
Название сервисаprofile-titleНазвание карточки подписки. Для кириллицы и других символов вне ASCII можно использовать base64:… с кодировкой UTF-8.
Логотипx-dodo-provider-logo-urlЛоготип в верхнем блоке. Публичное HTTPS-изображение, не иконка приложения в магазине.
Поддержка и кабинетsupport-url
profile-web-page-url
Кнопки поддержки и перехода на страницу продления.
Срок и трафикsubscription-userinfoСтатус, дата окончания и объём. Значения задаёт ваш сервер.
Когда обновлять подпискуprofile-update-intervalИнтервал проверки обновлений в часах, с учётом ограничений фоновой работы ОС.
Резервный адресfallback-url
providerid — необязательно
Полный запасной HTTPS-адрес для той же подписки. Если указан providerid, резервный ответ должен вернуть то же значение. Это не проверка оплаты и не доступ в кабинет DoDo.
ОбъявлениеannounceТекст в карточке подписки. Он не создаёт сторис и не отправляет уведомление.
Правила трафикаrouting / autoroutingМаршрутизация для этой подписки. Правила также можно передать внутри полного Xray JSON.

Заголовки передаются вместе с успешным ответом по HTTPS-ссылке подписки. Форматы значений, поддерживаемые комментарии в теле ответа и ограничения описаны в справочнике заголовков.

Название и контакт поддержки помогают вести статистику сервиса. В iOS 2.2.0 DoDo группирует отчёты по публичному profile-title и очищенному support-url. В них входят модель устройства, версия iOS и приложения, число сохранённых конфигураций. Адреса ключей, сами конфигурации, HWID и содержимое трафика в эти отчёты не передаются. Это учёт установок DoDo, приславших данные, а не всех ваших абонентов или пользователей онлайн.

Аналитика включена по умолчанию; ранее сохранённый отказ учитывается. Выключить отправку и запросить удаление данных можно в приложении: «Настройки → Политика конфиденциальности». Не более двух попыток отправки за 24 часа; недоступность сервера статистики не блокирует импорт или VPN. Отчёты пока доступны только разработчику DoDo — отдельный доступ провайдеров к своим отчётам готовится. Название сервиса и контакт поддержки не подтверждают владение сервисом и не дают доступа к его кабинету.

03 / КАБИНЕТ ПРОВАЙДЕРА

Подготовьте бренд и сторис

Создайте кабинет самостоятельно через Google. Регистрация бесплатна; каждый провайдер работает только со своим сервисом и материалами.

Закрытое тестирование

Команда и роли

Владелец управляет сервисом и приглашает редакторов. Редакторы готовят материалы, владелец публикует сторис. Другим провайдерам ваши настройки и материалы недоступны.

Закрытое тестирование

Предпросмотр на iPhone

Укажите название, логотип, поддержку и сайт. Макет покажет, как они выглядят в светлой и тёмной теме. Выбранный в макете акцент пока служит для предпросмотра — в iOS используется системный цвет.

Название и иконка самого DoDo в магазине и на устройстве не меняются.

Закрытое тестирование

Сторис на 12 или 24 часа

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

Доступность функций

Публичный бренд и сторис — без установки модуля. Создайте кабинет через Google, подтвердите точный домен подписки через DNS TXT, дождитесь одобрения DoDo и добавьте x-dodo-provider-id из своего кабинета к успешному HTTPS-ответу подписки. Ключ подписи и API-токен панели не нужны. Подготовка настроек не подтверждает развёртывание сервера, публикацию новой версии приложения или проверку на iPhone.

Кабинет, DNS и один заголовок
Требования к сторис
ТипФорматОграничения
ИзображениеJPEG, PNG, WebPДо 10 МиБ. После загрузки изображение сохраняется в JPEG.
ВидеоMP4До 20 МиБ и до 30 секунд. Файл проходит проверку и обработку на сервере.
ПубликацияЗаголовок и короткая подписьЗаголовок до 80 символов, подпись до 500; срок 12 или 24 часа.

04 / ПУБЛИЧНЫЙ КОНТЕНТ

Бренд и сторис вашего сервиса

Публичный контент связан с точным доменом сервиса и его ID. Это не проверка действующей или оплаченной подписки и не закрытая аудитория.

Подготовка интеграции

Один заголовок

x-dodo-provider-id — UUID из своего кабинета. Приложение принимает его только из реального успешного HTTPS-ответа на том же точном host подписки, не из комментариев тела, ошибки или редиректа.

Нужны действующий DNS TXT и одобрение DoDo. Подписанный коннектор для публичного бренда и сторис не требуется.

Публичные материалы

Бренд и сторис

Оформление и публикации обслуживаются отдельно через /api/provider-content/v1. Публикация сторис требует действующего DNS-подтверждения и допуска сервиса. Для показа нужна совместимая версия приложения.

Не входит в этот способ

Закрытая аудитория и push

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

Подтвердите точный домен через DNS TXT. Кабинет выдаст уникальную запись и проверит её. История ручных одобрений хранится отдельно и не считается DNS-подтверждением. Проверка одного host не распространяется на соседние поддомены. Публичный контент не меняет тело подписки, HWID-политику или работу VPN.

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

Необязательный подписанный протокол остаётся отдельно от публичного контента. DNS не заменяет проверку абонента. Панель должна проверить абонента и устройство, затем вернуть динамическое подписанное подтверждение на x-dodo-subscriber-challenge в x-dodo-subscriber-token. Общая постоянная строка для всех пользователей недопустима; публичный ID не ослабляет эти проверки.

Адресная рассылка требует отдельной проверенной аудитории и разрешения пользователя; готовая доставка push здесь не обещается. Храните административный токен панели, закрытый ключ подписи и пароли только на сервере. Их нельзя передавать в подписке, приложении или публичной странице.

Расширенный протокол и ограничения

05 / ПАНЕЛЬ ОСТАЁТСЯ У ВАС

Remnawave — вариант, не требование

Ваши серверы и управление абонентами остаются у вас. Для подключения VPN в DoDo не нужен административный доступ к панели.

Доступно

Remnawave и собственные панели

Выдавайте подписки в одном из поддерживаемых форматов. Для полного Xray JSON передавайте профиль целиком: DNS, маршрутизацию, балансировщики и все связанные настройки.

Проверить формат
Без модуля

ID в ответе подписки

Добавьте x-dodo-provider-id к существующему успешному HTTPS-ответу. Для публичного бренда и сторис не нужны новый endpoint, signer или полный административный API панели. Подойдёт Remnawave или своя система с настройкой HTTP-заголовков.

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

Закрытое тестирование

Карта сетей

Карта показывает распределение запросов подписок по странам, примерным городским группам и сетям операторов (ASN) за 24 часа, 7 или 30 дней. Источник данных Remnawave подключается вручную с правами только на чтение; для собственной панели потребуется отдельное подключение.

Карта не показывает точное местоположение или число пользователей онлайн. Малые группы скрываются, исходные IP и HWID в кабинет не передаются.

Геофайлы для маршрутизации уже встроены в приложение. geosite.dat и geoip.dat позволяют задавать правила по категориям доменов и IP-адресам. Они не используются для построения карты абонентов.

Геоданные и маршрутизация

06 / АВТОВЫБОР СЕРВЕРА

Выберите подходящий способ балансировки

Передавайте балансировщик в полном Xray JSON-профиле. Отдельная кнопка автовыбора DoDo в iOS пока скрыта; балансировка через API панели ещё разрабатывается.

Выбор и балансировка серверов
СпособКак работаетСтатус
Балансировщик XrayВы задаёте правила выбора внутри полного JSON-профиля: теги, observatory и balancers. DoDo использует совместимую конфигурацию целиком.Доступно
Автовыбор DoDoОтдельная кнопка выбора сервера по замерам временно скрыта в iOS. Балансировщики внутри полных JSON-профилей от этого не отключаются.Пока скрыт в iOS
Автовыбор через API провайдераПанель сможет рекомендовать сервер с учётом его нагрузки, приоритетов и доступных абоненту маршрутов.В разработке
Подробнее о профилях маршрутизации

Пинг и скорость — разные показатели. В iOS 2.2.0 и Android APK 2.2.0 обычный TCP показывает измеренное время соединения без деления. В Android обычный JSON с одним TCP-сервером также проверяется прямым соединением; Hysteria, балансировщики и сложные профили — через HTTP. HTTP GET и HEAD проверяют запрос через конфигурацию сервера. Только оценочный режим DoDo Ping делит результат HTTP GET на 3,3. TCP или ICMP могут отвечать и у сервера с неработающим VPN, а успешный HTTP-замер не гарантирует скорость загрузки или работу всех маршрутов.

07 / КАК НАЧАТЬ

Проверьте свой сервис в DoDo

Начните с тестовой подписки. Кабинет и сторис можно подключить позже — на работу VPN это не влияет.

  1. Добавьте тестовую подписку

    Подготовьте HTTPS-ссылку со списком серверов, Base64 или Xray JSON. Проверьте импорт, обновление и подключение. Не используйте рабочие ключи в публичных примерах.

    Быстрый старт
  2. Передайте данные сервиса

    Добавьте название, логотип, срок действия, трафик и ссылки поддержки в заголовки ответа. Убедитесь, что карточка подписки отображается так, как вы ожидаете.

  3. Создайте бесплатный кабинет

    Войдите через Google, укажите название сервиса и поддержку. Подтвердите точный домен с помощью TXT-записи из кабинета. После этого можно подготовить бренд и сторис.

    Открыть кабинет провайдера
  4. Добавьте ID и дождитесь допуска

    Добавьте x-dodo-provider-id из своего кабинета к успешному HTTPS-ответу подписки. После одобрения DoDo и DNS-проверки подготовьте публичный бренд и сторис. Модуль и пара ключей не нужны; для показа требуется совместимая версия приложения.

    Порядок подключения

DODO PROVIDER CONSOLE

Свой кабинет на своём сервере

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

Установите панель через Docker Compose и откройте её на своём HTTPS-домене. Войдите через Google на сайте DoDo, подтвердите установку и управляйте оформлением, DNS и сторис своего сервиса. Центральный API проверяет права каждого запроса и не отдаёт чужие данные. Модуль Remnawave и доступ к VPN-нодам не требуются.

Статистика 0.1.1 разделяется по provider ID и подтверждённому домену: модели, версии ОС и приложения, отчёты за 1/7/30 дней. Нужен обновлённый совместимый iOS-клиент; старые версии и Android пока не передают этот scope. Это устройства с отчётами, не люди онлайн и не число оплаченных абонентов. Данные и опубликованные файлы остаются у DoDo. Работа VPN не зависит от кабинета.

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

Что можно использовать сейчас

Основные функции ключей доступны без регистрации. Бесплатный кабинет открыт в раннем доступе; полный production-запуск и адресные рассылки готовятся отдельно.

Работает — можно использовать. Тестируется — доступ по приглашению. В разработке — пока недоступно. Не поддерживается — функция не входит в текущие возможности DoDo.

Возможности для провайдера
ВозможностьСтатусЧто важно знать
Импорт и обновление подписокРаботаетРаботает без кабинета. Форматы и протоколы перечислены в документации.
Защищённые ссылки DoDo crypt1 и AGE1iOS и Android APKДоступны в iOS 2.2.0 из App Store и Android APK 2.2.0. Для crypt1 с обычным ответом менять панель не нужно; шифрование AGE на сервере настраивается отдельно. На некоторых HUAWEI защищённую ссылку нужно вставить из буфера или вручную вместо QR. Как подключить.
Название, логотип, срок, трафик, ссылкиРаботаетНастраиваются заголовками ответа сервера подписок.
Команда, роли, бренд и предпросмотрРанний доступДоступны после регистрации кабинета. Цвет акцента макета пока не применяется в iOS. Публичный бренд требует DNS, одобрения DoDo и x-dodo-provider-id, но не подписанного коннектора.
Резервная подписка: fallback-urliOS и Android APKДоступна в iOS 2.2.0 и Android APK 2.2.0: обычные списки, Base64 и JSON. providerid необязателен и не проверяет оплату. В опубликованной macOS этого механизма пока нет. Как подготовить сервер.
Статистика сервиса по названию и поддержкеiOS и Android APKiOS 2.2.0 и Android APK 2.2.0 передают ограниченную статистику по profile-title и support-url с сохранением выбора пользователя. Отправка отключается в политике конфиденциальности. Учёт по provider ID для кабинета провайдера в Android ещё не подключён. Как устроена статистика.
Редактор сторис и загрузка медиаТестируетсяЧерновики, предпросмотр, публикации на 12 или 24 часа и архив.
Показ бренда и сторис в приложенииТестируетсяДоступен на отдельно подключённых устройствах iOS. Для простого публичного способа нужны DNS, одобрение и заголовок с ID, без модуля. Новая production-версия и живой тест этим описанием не подтверждаются.
Автоматическое подтверждение абонентаВ разработкеПотребуется проверка подписки и подписанный ответ сервера провайдера.
Уведомления своим абонентамВ разработкеАдресная доставка после проверки подписки и согласия пользователя.
Закрытые сторис для проверенных абонентовВ разработкеОтдельная задача с проверкой подписок. Не относится к публичным сторис и не включается одним provider ID.
Карта стран, городских групп и ASNТестируетсяИсточник данных подключается отдельно. На карте только обобщённая статистика.
Автовыбор через API панелиВ разработкеВыбор сервера по данным провайдера о нагрузке и доступных маршрутах.
Самостоятельная регистрация провайдераРанний доступGoogle-вход, создание своего кабинета и DNS TXT-проверка домена. Бесплатно, без тарифов и оплаты. Полный production-запуск скоро.
Lite Mode и Premium API других клиентовНе поддерживаетсяКоманды чужих клиентов для смены темы, принудительных настроек, управления HWID и кнопки premium-url не выполняются.
Шифрованные ссылки и команды HappНе поддерживаютсяСовместимая JSON-подписка может быть прочитана; Happ crypto и Happ deeplink не обрабатываются.

Версии приложения

Доступность по платформам
Платформа / версияВозможностиПримечание
iOS · 2.2.0 в App StoreИмпорт и обновление, полные JSON-профили и балансировщики, crypt1 и AGE1, резервный адрес, HWID, режимы пинга, маршрутизация, геофайлы, логи и отчёты об ошибках с согласия пользователя.Для iOS 15 и новее. Управление аналитикой — в политике конфиденциальности. Кабинет и сторис тестируются; адресная доставка всем абонентам пока недоступна.
Android · APK 2.2.0 (2107)Полный JSON и балансировщики, crypt1 и AGE1, резервный адрес, данные ключа и интервал обновления, маршрутизация, геофайлы, пинг без деления в TCP, MTU и IPv4 / IPv6, живые логи и добровольные отчёты об ошибках.APK от 10 ноября. Выход обновления в Google Play будет объявлен отдельно. На некоторых HUAWEI для crypt1 используйте буфер или ручной ввод вместо QR. Сторис и провайдерские уведомления в Android пока не включены.
macOS · 2.0.8 в Mac App StoreПриложение доступно на общей с iOS странице App Store.Для Mac пока доступна предыдущая версия 2.0.8.
Windows · скороВерсия для Windows готовится.Ссылка на установщик появится после выпуска.

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

В следующем обновлении iOS — защита локального SOCKS. Изменения ещё не опубликованы в App Store. Служебные данные внутреннего соединения создаются для каждого сеанса и не переходят к другому провайдеру. Пригодные локальные учётные данные из полного профиля сохраняются. Авторизация удалённого SOCKS-сервера не меняется; перенастройка нод не требуется. Совместимость зависит от параметров профиля — требования защиты не отключаются ради подключения.

Подробности защиты и новой диагностики

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

Какие данные входят в отчёт

НАЧНИТЕ СЕЙЧАС

Подготовьте подписку для DoDo

В документации — поддерживаемые форматы, примеры заголовков, ссылки для импорта и правила маршрутизации.