Всем привет. Этот гайд — про то, как разбирать Electron-приложения: от первого взгляда на папку до рабочего патчера-скрипта, всё на пальцах, но без упрощений — после прочтения сможешь взять почти любую прогу на электроне и понять как она устроена.
Часть 1. Что такое Electron и где что лежит
Electron — это Chromium + Node.js в одном флаконе. Разработчик пишет обычный веб-фронт (HTML/CSS/JS) и node-бэк, electron упаковывает это в десктопную прогу. На нём сидят Discord, VS Code, Slack, Figma, куча оптимизаторов, трекеров, лаунчеров.
Структура установленной проги всегда одинаковая:
Данные юзера лежат отдельно, обычно в %AppData%/Roaming/Prog/: LevelDB-хранилища (localStorage, IndexedDB), кэши, логи, куки. Туда пойдём в части про сеть и кэш.
Два процесса внутри: main (node, доступ к системе — файлы, сеть, реестр, железо) и renderer (chromium, интерфейс). Общаются через IPC. Для реверса важно: проверки лицензий бывают в обоих, патчить иногда надо оба.
app.asar — и есть цель. asar — простой архив без сжатия: в начале json-хедер с деревом файлов (имена, размеры, оффсеты, хеши), дальше сырые байты всех файлов подряд. Весь JS лежит внутри открытым текстом — обычно минифицированный (переменные e,t,i), но не шифрованный и не обфусцированный. Строки, URL API, ключи — всё читается.
Часть 2. Инструменты реверсёра
Минимальный набор, всё бесплатное:
Часть 3. Разведка: первые 15 минут с новой прогой
Алгоритм первичного осмотра, работает всегда:
Уже после этого обычно понятно: где проверка, какой API, какая защита. Дальше — вглубь.
Часть 4. Формат asar изнутри
Чтобы не зависеть от npm-пакета и писать свои патчеры, разберём формат.
Json-хедер — обычный объект с деревом файлов: files → dist → files → main → files → main.js, у каждого файла size, offset (строка! от начала контент-блока) и integrity. Header-хеш (тот что проверяет electron) — это sha256 от байт json-хедера как есть. Не весь файл, не контент — только json-кусок. Это главная деталь, на ней все спотыкаются.
Per-file integrity у каждого файла:
Файл режется на куски по 4 МБ, хешируется каждый кусок + целиком. Правишь байт и не обновляешь запись — получишь ASAR Integrity Violation.
Часть 5. Как устроена проверка премиума
В 90% приложений схема одинаковая:
Ключевое понимание: флаг живёт на клиенте, решение принимает клиент. Точек воздействия три:
Как найти проверку: не ищи где флаг читается (таких мест десятки), ищи где он вычисляется (1-3 на всё приложение). Маркеры: hasActiveSubscription, status === active, includes('trialing'). Проверок бывает несколько: отдельно в renderer, отдельно в main — патчить надо все.
Часть 6. Сеть: API, pinning, кэш
Часть 7. Техника in-place патча (ядро гайда)
Проблема: поменяешь размер файла — поплывут оффсеты всех следующих. Чистый путь — in-place: новая функция занимает ровно столько же байт. Было function(e) с проверкой на 200 байт — стало function(e) с return true + паддинг-коммент, те же 200 байт.
Пошаговый алгоритм:
Три грабли:
Часть 8. Автоматизация: патчер-скрипт
Руками — один раз интересно, после каждой обновы проги — обязательно (апдейт перезаписывает asar и exe). Поэтому цикл упаковывается в скрипт на чистом питоне:
Зависимостей ноль: struct, json, hashlib, ctypes. Если сигнатуры не найдутся — скрипт честно скажет «версия не поддерживается».
Часть 9. Что ещё можно крутить
Часть 10. Этика и риски
Разбирать для учёбы — нормально. Бесплатный патчер — максимум DMCA и снос темы. Акки под мод-клиентом держи одноразовые. Токены и пароли в открытые чаты не кидай никогда. Патчеры протухают после обнов — отслеживай версии.
Удачи в реверсе. Вопросы — в комменты, конкретные кейсы разберём вместе.
Практический пример по этому гайду — патчер Hone: тык

Часть 1. Что такое Electron и где что лежит
Electron — это Chromium + Node.js в одном флаконе. Разработчик пишет обычный веб-фронт (HTML/CSS/JS) и node-бэк, electron упаковывает это в десктопную прогу. На нём сидят Discord, VS Code, Slack, Figma, куча оптимизаторов, трекеров, лаунчеров.
Структура установленной проги всегда одинаковая:
Код:
Program Files/Prog/
├── Prog.exe ← лаунчер: chromium-движок + node + обвязка
├── resources/
│ └── app.asar ← ВЕСЬ код приложения в одном архиве (цель №1)
├── *.dll ← ffmpeg, swiftshader, системные либы electron
├── locales/ ← переводы интерфейса
└── Uninstall Prog.exe Данные юзера лежат отдельно, обычно в %AppData%/Roaming/Prog/: LevelDB-хранилища (localStorage, IndexedDB), кэши, логи, куки. Туда пойдём в части про сеть и кэш.
Два процесса внутри: main (node, доступ к системе — файлы, сеть, реестр, железо) и renderer (chromium, интерфейс). Общаются через IPC. Для реверса важно: проверки лицензий бывают в обоих, патчить иногда надо оба.
app.asar — и есть цель. asar — простой архив без сжатия: в начале json-хедер с деревом файлов (имена, размеры, оффсеты, хеши), дальше сырые байты всех файлов подряд. Весь JS лежит внутри открытым текстом — обычно минифицированный (переменные e,t,i), но не шифрованный и не обфусцированный. Строки, URL API, ключи — всё читается.
Часть 2. Инструменты реверсёра
Минимальный набор, всё бесплатное:
- Распаковка asar — пакет @electron/asar через npm: npx asar extract app.asar ./out. Листает содержимое: npx asar list app.asar. Если npm ставить лень — формат разбирается руками за вечер (про него в части 4)
- Поиск по коду — VS Code «поиск по папке» или ripgrep (rg). Минифицированный JS — это одна строка на 10 МБ, ищи по словам: premium, license, subscription, isPro, entitlement, hasActive, trial, paywall, billing, stripe, paddle
- Просмотр PE-ресурсов exe — Resource Hacker (GUI) или python-pefile (скриптами). Для записи — WinAPI UpdateResourceW через ctypes, это 15 строк
- Хеши — certutil -hashfile в винде, sha256sum в линуксе, или hashlib в питоне. Понадобится постоянно
- Сеть — Fiddler Classic / Charles / mitmproxy. Смотришь какие API дёргает прога, какие ответы приходят. Но помни про pinning (часть 6)
- Дизассемблер — обычно не нужен для electron-реверса (весь смысл в JS), но если упрёшься в нативную проверку в exe/dll — x64dbg или Ghidra
- Python 3 — основной инструмент для патчеров: парсинг asar, пересчёт хешей, правка PE-ресурсов. Всё из этого гайда делается на чистом питоне без node
Часть 3. Разведка: первые 15 минут с новой прогой
Алгоритм первичного осмотра, работает всегда:
- Открываешь папку установки, проверяешь наличие resources/app.asar — если есть, это electron, гайд применим
- Смотришь package.json внутри asar (имя, версия, автор, точка входа)
- Распаковываешь asar во временную папку, смотришь размеры: main.js (бэк, обычно 1-5 МБ), renderer.js (фронт, 5-15 МБ), preload.js (мост между ними, там список всех IPC-каналов — золотая жила, читай первым)
- Грепаешь https:// в main.js — получаешь список всех API-хостов проги за минуту
- Грепаешь premium|license|subscription|trial в renderer.js — получаешь карту всех мест где премиум упоминается
- Открываешь Roaming/Prog/logs/ — логи часто содержат URL запросов, тексты ошибок, названия внутренних модулей
Уже после этого обычно понятно: где проверка, какой API, какая защита. Дальше — вглубь.
Часть 4. Формат asar изнутри
Чтобы не зависеть от npm-пакета и писать свои патчеры, разберём формат.
Код:
смещение 0: uint32 x4 (служебные, нужен только 4-й)
смещение 12: uint32 H (длина json-хедера в байтах)
смещение 16: H байт json (дерево файлов)
дальше: контент-блок (файлы подряд), начало выровнено до 8 байт Json-хедер — обычный объект с деревом файлов: files → dist → files → main → files → main.js, у каждого файла size, offset (строка! от начала контент-блока) и integrity. Header-хеш (тот что проверяет electron) — это sha256 от байт json-хедера как есть. Не весь файл, не контент — только json-кусок. Это главная деталь, на ней все спотыкаются.
Per-file integrity у каждого файла:
Код:
"integrity": {
"algorithm": "SHA256",
"blockSize": 4194304,
"blocks": ["<sha256 блока 1>", "<sha256 блока 2>"],
"hash": "<sha256 всего файла>"
} Файл режется на куски по 4 МБ, хешируется каждый кусок + целиком. Правишь байт и не обновляешь запись — получишь ASAR Integrity Violation.
Часть 5. Как устроена проверка премиума
В 90% приложений схема одинаковая:
- Клиент при старте дёргает API: GET /subscription, /license, /payments/..., /user
- Ответ кладётся в стор (redux/vuex/pinia): hasPremium = status == active
- UI смотрит на флаг: paywall-модалки, locked-кнопки, лимиты
Ключевое понимание: флаг живёт на клиенте, решение принимает клиент. Точек воздействия три:
- Подменить ответ сервера (прокси) — ломается о pinning, см. часть 6
- Подменить флаг в коде (патч функции проверки) — самое надёжное, сервер вообще не нужен
- Подменить данные в локальном хранилище (LevelDB) — работает до первого опроса сервера
Как найти проверку: не ищи где флаг читается (таких мест десятки), ищи где он вычисляется (1-3 на всё приложение). Маркеры: hasActiveSubscription, status === active, includes('trialing'). Проверок бывает несколько: отдельно в renderer, отдельно в main — патчить надо все.
Часть 6. Сеть: API, pinning, кэш
- Запускаешь Fiddler, смотришь запросы: endpoint подписки, формат ответа, частота опроса (обычно раз в 1-5 минут + по фокусу)
- Если pinning нет — подменяешь ответ прокси: отдаёшь hasActiveSubscription true. Временно, для тестов
- SSL-pinning — проги вешают setCertificateVerifyProc, самоподписанный серт режется. Обход — это уже патч main.js, так что сразу иди в код
- Кэш как запасной путь — при обрыве API многие клиенты работают по кэшу из стора. Можно подсунуть кэш в LevelDB, но endpoint обычно на общем хосте — костыль
Часть 7. Техника in-place патча (ядро гайда)
Проблема: поменяешь размер файла — поплывут оффсеты всех следующих. Чистый путь — in-place: новая функция занимает ровно столько же байт. Было function(e) с проверкой на 200 байт — стало function(e) с return true + паддинг-коммент, те же 200 байт.
Пошаговый алгоритм:
- Распаковываешь asar, находишь функцию проверки, определяешь границы по балансу скобок
- В бинарнике asar заменяешь байты: return true + паддинг до исходной длины. Размер файла не меняется, оффсеты целы
- Считаешь sha256 нового контента + поблочные хеши (куски по 4 МБ)
- В хедере меняешь старую integrity-запись на новую 1-в-1 по длине
- Считаешь sha256 нового json-хедера — это новый header-hash
- Вписываешь его в PE-ресурс exe (INTEGRITY / ELECTRONASAR)
- Бекапы app.asar.bak + Prog.exe.bak — до любых правок, без исключений
Три грабли:
- Ложные совпадения — ищи сигнатуру только внутри диапазона конкретного файла, не по всему архиву
- Порядок ключей в integrity — длина замены обязана совпасть, проверяй assert'ом
- Вторая подпись — JWT от издателя рядом не трогай, локальный рантайм её не проверяет
Часть 8. Автоматизация: патчер-скрипт
Руками — один раз интересно, после каждой обновы проги — обязательно (апдейт перезаписывает asar и exe). Поэтому цикл упаковывается в скрипт на чистом питоне:
Код:
найти установку → убить процессы → бекапы .bak →
для каждого файла: найти диапазон → найти сигнатуры →
заменить in-place → пересчитать integrity →
обновить хедер → посчитать header-hash → вшить в exe →
готово Зависимостей ноль: struct, json, hashlib, ctypes. Если сигнатуры не найдутся — скрипт честно скажет «версия не поддерживается».
Часть 9. Что ещё можно крутить
- preload.js — мост main↔renderer, карта всех IPC-каналов. Читай первым
- Фиче-флаги — isBeta, isDev, скрытые меню. Ищи __DEV__, debug, internal, unleash
- Автообновление — app-update.yml рядом с asar, там URL апдейт-сервера
- LevelDB в Roaming — токены, сессии, кэши. Читать можно, править осторожно
Часть 10. Этика и риски
Разбирать для учёбы — нормально. Бесплатный патчер — максимум DMCA и снос темы. Акки под мод-клиентом держи одноразовые. Токены и пароли в открытые чаты не кидай никогда. Патчеры протухают после обнов — отслеживай версии.
Удачи в реверсе. Вопросы — в комменты, конкретные кейсы разберём вместе.
Практический пример по этому гайду — патчер Hone: тык

Последнее редактирование: