Документация

Руководство по установке, импорту подписки и обновлению приложения Левушка Desktop для macOS.

1. Установка

  1. Скачайте актуальный .dmg с главной страницы или по ссылке /download/macos.
  2. Откройте образ и перетащите «Левушка» в папку «Программы».
  3. При первом запуске: правый клик → «Открыть» (до появления подписанных релизов).

2. Подписка

Приложение работает с подпиской Левушка (199 ₽/мес). Оформите её в личном кабинете или Telegram-боте.

Ссылка подписки имеет вид:

https://subs.levushka.app/sub/{token}/vless

Конфиги серверов, лимит устройств и заголовки подписки отдаются с subs.levushka.app. Сайт app.levushka.app используется только для скачивания и обновлений.

3. Импорт подписки

В приложении: меню → Импорт → вставьте URL подписки.

Через браузер: откройте

https://app.levushka.app/import?url=https://subs.levushka.app/sub/…/vless

Страница перенаправит в levushka://import?url=…. Если приложение не установлено — появится ссылка на скачивание.

Зашифрованные ссылки: приложение поддерживает levushka://crypt1/… (обработка на стороне subs.levushka.app).

4. Обновления

Приложение проверяет манифест:

https://app.levushka.app/desktop/macos/version.json

Формат:

{
  "version": "0.2.0",
  "notes": "…",
  "download_url": "https://app.levushka.app/desktop/macos/releases/Levushka-VPN-0.2.0-universal.dmg",
  "published_at": "2026-07-01T12:00:00Z",
  "min_macos": "12.0"
}

Кнопка «Скачать» на сайте и редирект /download/macos всегда ведут на последний релиз.

5. Устройства (x-hwid)

Приложение отправляет заголовок x-hwid с уникальным идентификатором устройства. На одном аккаунте — до 5 одновременных устройств. Управление — в личном кабинете.

6. Поддержка