Подписки вашего сервиса
Импорт, обновление, название, логотип и данные тарифа. Подойдёт Remnawave или собственная панель с поддерживаемым форматом подписки.
DODO / ДЛЯ ПРОВАЙДЕРОВ
Дайте клиентам ссылку на подписку — они смогут добавить её в 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 этот механизм пока недоступен.
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-urlprofile-web-page-url | Кнопки поддержки и перехода на страницу продления. |
| Срок и трафик | subscription-userinfo | Статус, дата окончания и объём. Значения задаёт ваш сервер. |
| Когда обновлять подписку | profile-update-interval | Интервал проверки обновлений в часах, с учётом ограничений фоновой работы ОС. |
| Резервный адрес | fallback-urlproviderid — необязательно | Полный запасной 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. Регистрация бесплатна; каждый провайдер работает только со своим сервисом и материалами.
Владелец управляет сервисом и приглашает редакторов. Редакторы готовят материалы, владелец публикует сторис. Другим провайдерам ваши настройки и материалы недоступны.
Укажите название, логотип, поддержку и сайт. Макет покажет, как они выглядят в светлой и тёмной теме. Выбранный в макете акцент пока служит для предпросмотра — в iOS используется системный цвет.
Название и иконка самого DoDo в магазине и на устройстве не меняются.
Добавьте изображение или короткое видео, заголовок и подпись. Материал можно сохранить в черновик, посмотреть перед публикацией и убрать в архив. Показ в приложении пока доступен участникам тестирования.
Доступность функцийПубличный бренд и сторис — без установки модуля. Создайте кабинет через Google, подтвердите точный домен подписки через DNS TXT, дождитесь одобрения DoDo и добавьте x-dodo-provider-id из своего кабинета к успешному HTTPS-ответу подписки. Ключ подписи и API-токен панели не нужны. Подготовка настроек не подтверждает развёртывание сервера, публикацию новой версии приложения или проверку на iPhone.
| Тип | Формат | Ограничения |
|---|---|---|
| Изображение | 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-подтверждения и допуска сервиса. Для показа нужна совместимая версия приложения.
Публичный ID не доказывает оплату абонента, не создаёт проверенную приватную аудиторию и не разрешает адресную рассылку. Материалы только для платных абонентов здесь размещать нельзя.
Подтвердите точный домен через DNS TXT. Кабинет выдаст уникальную запись и проверит её. История ручных одобрений хранится отдельно и не считается DNS-подтверждением. Проверка одного host не распространяется на соседние поддомены. Публичный контент не меняет тело подписки, HWID-политику или работу VPN.
Необязательный подписанный протокол остаётся отдельно от публичного контента. DNS не заменяет проверку абонента. Панель должна проверить абонента и устройство, затем вернуть динамическое подписанное подтверждение на x-dodo-subscriber-challenge в x-dodo-subscriber-token. Общая постоянная строка для всех пользователей недопустима; публичный ID не ослабляет эти проверки.
Адресная рассылка требует отдельной проверенной аудитории и разрешения пользователя; готовая доставка push здесь не обещается. Храните административный токен панели, закрытый ключ подписи и пароли только на сервере. Их нельзя передавать в подписке, приложении или публичной странице.
Расширенный протокол и ограничения05 / ПАНЕЛЬ ОСТАЁТСЯ У ВАС
Ваши серверы и управление абонентами остаются у вас. Для подключения VPN в DoDo не нужен административный доступ к панели.
Выдавайте подписки в одном из поддерживаемых форматов. Для полного Xray JSON передавайте профиль целиком: DNS, маршрутизацию, балансировщики и все связанные настройки.
Проверить форматДобавьте 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 / КАК НАЧАТЬ
Начните с тестовой подписки. Кабинет и сторис можно подключить позже — на работу VPN это не влияет.
Подготовьте HTTPS-ссылку со списком серверов, Base64 или Xray JSON. Проверьте импорт, обновление и подключение. Не используйте рабочие ключи в публичных примерах.
Быстрый стартДобавьте название, логотип, срок действия, трафик и ссылки поддержки в заголовки ответа. Убедитесь, что карточка подписки отображается так, как вы ожидаете.
Войдите через Google, укажите название сервиса и поддержку. Подтвердите точный домен с помощью TXT-записи из кабинета. После этого можно подготовить бренд и сторис.
Открыть кабинет провайдераДобавьте x-dodo-provider-id из своего кабинета к успешному HTTPS-ответу подписки. После одобрения DoDo и DNS-проверки подготовьте публичный бренд и сторис. Модуль и пара ключей не нужны; для показа требуется совместимая версия приложения.
Порядок подключенияDODO PROVIDER CONSOLE
Установите панель через 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 и AGE1 | iOS и 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-url | iOS и Android APK | Доступна в iOS 2.2.0 и Android APK 2.2.0: обычные списки, Base64 и JSON. providerid необязателен и не проверяет оплату. В опубликованной macOS этого механизма пока нет. Как подготовить сервер. |
| Статистика сервиса по названию и поддержке | iOS и Android APK | iOS 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-заголовки при запросе подписки поступают вашему серверу отдельно.
Какие данные входят в отчётНАЧНИТЕ СЕЙЧАС
В документации — поддерживаемые форматы, примеры заголовков, ссылки для импорта и правила маршрутизации.