# Audion Browsers Portable - руководство

**Содержание**

- [Как устроено окно](#как-устроено-окно)
- [Первый запуск](#первый-запуск)
- [Скачать официальные файлы](#скачать-официальные-файлы)
- [Какие браузеры поддерживает сборка с DLL и почему](#какие-браузеры-поддерживает-сборка-с-dll-и-почему)
- [Что внутри собранной папки](#что-внутри-собранной-папки)
- [Обновление](#обновление)
- [Сертификаты Минцифры](#сертификаты-минцифры)
- [Настройки сборки](#настройки-сборки)
- [Рабочие папки](#рабочие-папки)
- [Из командной строки](#из-командной-строки)
- [Что стоит знать](#что-стоит-знать)

Программа делает портативные браузеры: такие, которые лежат папкой, запускаются
откуда угодно и не ставятся в Windows. Закладки, пароли и вкладки хранятся внутри
этой же папки, поэтому её можно унести на флешке или отдать другому человеку.

## Как устроено окно

Программа открывается файлом `Start.exe`.

Под заголовком - ряд из пяти крупных кнопок, это разделы: `УСТАНОВКА`,
`СКАЧИВАНИЕ`, `ОБНОВЛЕНИЕ`, `СЕРТИФИКАТ`, `ОБСЛУЖИВАНИЕ`. Нажали раздел - слева
сразу его команды и их настройки, никуда проваливаться не нужно.

Команда с настройками - это форма. Кнопка, которая её запускает, стоит справа в
шапке формы, залита цветом и названа по действию: `СОБРАТЬ`, `СКАЧАТЬ`,
`ОБНОВИТЬ`. Редкие настройки лежат под заголовком `ДОПОЛНИТЕЛЬНО` - они на виду,
раскрывать ничего не надо. Команда без настроек - крупная кнопка со строкой о
том, что она делает.

Выбор везде делается кнопками: выбранная залита, невыбранная остаётся с
окантовкой. Браузер - кнопка с его значком в цвете этого значка, так что ряд
читается с одного взгляда.

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

Справа - рабочие папки и журнал. `ИСТОЧНИК` - где лежат готовые сборки,
`НАЗНАЧЕНИЕ` - куда кладутся новые сборки, архивы и скачанные файлы. В журнале
видно всё, что говорит команда; загрузка идёт одной живой строкой - сколько
скачано, сколько всего и с какой скоростью. Внизу - строка состояния с часами и
кнопкой `СТОП`.

Справа вверху - язык (`RU` / `EN`) и тема оформления, их четыре. Обе настройки
меняются сразу, без перезапуска.

## Первый запуск

1. Раздел `ОБСЛУЖИВАНИЕ` → `7-ZIP`. Без него ничего не распакуется.
2. Раздел `УСТАНОВКА` → выберите браузеры кнопками и нажмите `СОБРАТЬ`.

Каждый браузер - это от 120 до 240 МБ загрузки и около полугигабайта на диске.
Готовые сборки появятся в папке назначения (`output\Portable`), запускать -
файлом `<Браузер> Portable.cmd` в корне каждой.

Собрать тот же браузер ещё раз можно смело: если его сборка уже лежит в папке
назначения, в ней заменяется только `App`. Профиль в `Data`, кэш и всё, что вы
положили в эту папку сами, остаётся как было.

Папку назначения выбирайте с коротким путём. Windows не открывает файлы, полный
путь к которым длиннее 260 символов, и браузер из слишком глубокой папки не
запустится. Сборка при этом соберётся, а программа предупредит и назовёт, сколько
файлов браузера оказалось за этим пределом: перенесите папку повыше - она рабочая.

Если один браузер не собрался, остальные всё равно соберутся: неудачи
перечисляются в конце.

## Скачать официальные файлы

Откройте `СКАЧИВАНИЕ`, выберите браузеры и разрядность, нажмите `СКАЧАТЬ`.
Оригинальные файлы сохраняются в `Browser Downloads` внутри папки назначения.
7-Zip для этой команды не нужен. Она только скачивает, без запуска, распаковки
и замены DLL.

- **Cent Browser**: портативный самораспаковывающийся EXE, x86/x64.
- **LibreWolf**: портативный ZIP, x64/ARM64.
- **Vivaldi**: установщик, x86/x64/ARM64. Откройте его самостоятельно и выберите
  «Дополнительно → Установить автономную версию» ([инструкция разработчика](https://help.vivaldi.com/desktop/install-update/standalone-version-of-vivaldi/)).
- **DuckDuckGo**: обычный установщик для Windows, x64. Это обычная установка.

Проверенные скачанные файлы используются повторно после проверки SHA256.
DuckDuckGo каждый раз скачивается во временный файл: если хэш совпадает,
сохраняется прежняя копия; если отличается, она заменяется новой под исходным
именем файла. Ошибки перечисляются по браузерам,
остальные загрузки продолжаются. Zen не включён: в текущем официальном выпуске
Windows нет портативного пакета (проверено 01.10.2026).

## Какие браузеры поддерживает сборка с DLL и почему

В списке те, у кого нет своей портативной сборки с автообновлением:

- **Google Chrome** - портативной версии не существует;
- **Yandex Browser** - портативной нет, зато сертификаты Минцифры уже внутри;
- **Brave** - портативные сборки только чужие, и они не обновляются;
- **Chromium-Gost** - умеет ГОСТ-шифрование, нужное на госпорталах;
- **Ungoogled Chromium** - Chromium без сервисов Google.

Из сборки с DLL исключены **Vivaldi**, **Cent Browser** и **Opera** - у них своя
портативная установка, которая сама обновляется. Vivaldi и Cent Browser доступны
в отдельном разделе `СКАЧИВАНИЕ`.
**Thorium** пробовали и убрали: сборки только 32-битные, а расширения из
магазина в нём не ставятся.

## Что внутри собранной папки

| Папка или файл | Что это |
| --- | --- |
| `App` | Сам браузер. При обновлении заменяется целиком. |
| `Data` | Ваш профиль: закладки, пароли, вкладки, расширения. |
| `Cache` | Кэш. Можно чистить. |
| `Certificates` | Сертификаты Минцифры и два файла - поставить и снять. |
| `<Браузер> Portable.cmd` | Запуск. |
| `Portable-Build.json` | Какие версии внутри. |

## Обновление

Раздел `ОБНОВЛЕНИЕ`. В нём две части, переключаются кнопками над формой:
`БРАУЗЕР` - проверить и обновить сборку целиком, `БИБЛИОТЕКА ПОРТАТИВНОСТИ` -
заменить одну библиотеку, не трогая браузер.

`ПРОВЕРИТЬ` и `ОБНОВИТЬ` стоят рядом в шапке одной формы и работают с одними и
теми же настройками: сначала смотрите, потом меняете.

`ПРОВЕРИТЬ` показывает, что вышло, рядом с версией вашей сборки. Ничего не
скачивается.

У Chrome новая версия расходится по пользователям постепенно, и в установщик
Google кладёт её не сразу. Поэтому сравнение идёт с версией, которая уже
раздаётся всем, а сборка, сделанная из того же установщика, что лежит у Google
сейчас, считается свежей - скачивать пока нечего.

`ОБНОВИТЬ` меняет в сборке только браузер и не трогает `Data` и `Cache` -
профиль остаётся. Остаётся и файл настроек библиотеки портативности (INI) - таким,
каким вы его оставили; при смене библиотеки создаётся её стандартный файл. Сборка, где и браузер, и обёртка свежие, пропускается без
загрузки.

**Браузер отмечать не обязательно.** Если в блоке `Браузеры` ничего не отмечено,
берутся все сборки, найденные в `Источнике`: каждая сама говорит, что в ней за
браузер. Отметки нужны, чтобы сузить выбор - обновить, например, только Яндекс.

**Сборок может быть несколько.** Положите в `Источник` сколько угодно сборок -
разных браузеров или нескольких одного - каждую в своей папке, и они обновятся за
один запуск. Ошибка с одной не останавливает остальные.

**Обновление идёт там же, где лежит сборка.** Укажите её папку в `Источнике` -
на флешке, в сетевой папке, где угодно - и она обновится на месте. Никуда
копировать не нужно, папка назначения при этом не используется: она нужна для
новых сборок.

Если в `Источнике` сборки нет, программа посмотрит в `output\Portable` - то, что
собрала сама. Если отмеченного браузера нет и там, обновление заканчивается
ошибкой и говорит, где искало: «готово» означает, что что-то действительно
обновлено или уже свежее.

`Источник` можно направить и прямо на одну сборку - на её собственную папку.
Она обновится на месте, вместе со своим профилем, и не будет переименована.

**Сборку можно принести со стороны.** Положите в `Источник` портативный браузер,
собранный где угодно: папка может называться как угодно, а браузер - лежать в
`Chrome\`, в `App\Chrome-bin\` или прямо в ней. Программа находит браузер по его
исполняемому файлу, а профиль - по файлу `Local State`, и при обновлении приводит
сборку к своему виду: `App`, `Data`, `Cache`. Профиль при этом только
переименовывается - не копируется и не удаляется. `ПРОВЕРИТЬ` заранее скажет, что
расклад не стандартный.

Из того, что лежало рядом с браузером, не удаляется ничего. Заменяется только сам
браузер. Ваши папки и файлы остаются на своих местах, а то, что мешает новому
раскладу, - файлы запуска прежнего упаковщика, его настройки - переносится в
папку `Old files` внутри сборки. Удалите её сами, когда убедитесь, что нужного
там нет.

Папка получает стандартное имя (например, `Google Chrome Portable`), если сборка
этого браузера в `Источнике` одна. Несколько сборок одного браузера остаются под
своими именами - по ним вы их и различаете. Не переименовывается и папка, на
которую `Источник` указывает напрямую.

Браузер должен быть закрыт: иначе обновление этой сборки остановится до загрузки,
ничего не тронув. Chromium-Gost и Ungoogled Chromium по файлам друг от друга не
отличить: такая сборка узнаётся по имени папки (`Chromium-Gost Portable`,
`Ungoogled Chromium Portable`) либо по отметке - отметьте один из двух, и папка с
любым именем будет считаться им. Чужой браузер под отметку не попадёт: если
`chrome.exe` называет себя Cent Browser, Supermium или Iron, сборка остаётся как
была, а журнал говорит, что программа такой браузер не собирает.

Папку с вашими файлами рядом с браузером программа не тронет, даже если она
названа датой - `10.10.2026` или `2025.03.01`: за папку версии браузера
принимается только та, где лежат его файлы.

`ОБНОВИТЬ ТОЛЬКО DLL` обновляет выбранную библиотеку в существующих сборках.
Выберите браузеры, библиотеку и разрядность (`Авто` читает её из браузера).
Можно указать в `Источнике` одну сборку или папку с несколькими: сборки находятся
так же, как в `ПРОВЕРИТЬ` и `ОБНОВИТЬ`, - на любой глубине и под любым именем
папки, все сборки отмеченного браузера. Сборку, собранную не здесь, где браузер
ещё не лежит в `App`, сначала приведите к виду программы кнопкой `ОБНОВИТЬ`.
Установщик браузера не скачивается, `App` целиком не заменяется, профиль и кэш сохраняются.
INI той же библиотеки остаётся прежним; при переключении библиотеки создаётся
её стандартный INI. Если файл занят браузером, изменения откатываются: закройте
браузер и повторите.

В `ДОПОЛНИТЕЛЬНО` можно задать HTTP(S)-ссылки полных установщиков Chrome и
Yandex. Пусто — официальный источник. По своей ссылке файл при сборке/обновлении
скачивается заново. Версия своего установщика Chrome известна после распаковки;
`ПРОВЕРИТЬ` сообщает неизвестную версию, а `ОБНОВИТЬ` его не пропускает по версии
из API Google.

`Отключить обновлятор Yandex` включено по умолчанию в сборке и обновлении.
Удаляется только `service_update.exe` внутри его `App`, даже если версия браузера
уже актуальна. Другие браузеры и файлы профиля не затрагиваются. Выключенная галка
сохраняет обновлятор в новой `App`; вернуть ранее удалённый файл можно пересборкой.

## Сертификаты Минцифры

Российские госсайты подписаны удостоверяющим центром, которому Windows по
умолчанию не доверяет, поэтому такой сайт открывается с предупреждением.
Шаги разделены, чтобы ничего не происходило само.

**При сборке и обновлении** - галка `Сертификаты госсайтов`. Кладёт в сборку
файлы и два ярлыка, установить и отозвать. Сама ничего не устанавливает. Снятая
галка ничего из сборки не убирает: файлы, положенные раньше, остаются.

Каждый файл сертификата перед использованием сверяется по отпечатку с тем, что
записан в программе. Файл с тем же именем, но другим содержимым не используется:
он откладывается в сторону под другим именем, а сертификат скачивается заново.

**Раздел `СЕРТИФИКАТ` → `ДОБАВИТЬ В СБОРКУ`** — выберите готовые сборки и
укажите их папку в `Источнике`. Сохраняет в `Certificates` два файла сертификатов
и команды установки/отзыва. Chrome выбран по умолчанию. Браузер и профиль
сохраняются, доверие Windows не меняется.

**Раздел `СЕРТИФИКАТ` → `УСТАНОВИТЬ`** - добавляет сертификаты в хранилище
вашей учётной записи Windows, откуда их читает любой браузер на Chromium. Права
администратора не нужны, другие пользователи компьютера ничего не заметят.

**`ОТОЗВАТЬ`** - удаляет ровно эти два сертификата по отпечатку, чужие остаются
на месте.

**`ПРОВЕРИТЬ`** показывает, установлены они или нет, и ничего не меняет.

Яндекс.Браузеру сертификаты не нужны: они у него уже встроены.

## Настройки сборки

**Портативность.** Основная библиотека — [прокси библиотека](https://gitflic.ru/project/neyrostalker/proksi-biblioteka) (x86/x64). Все переключатели в `App/version.ini` равны `0`. Альтернативы — [Chrome++ (DeftKing)](https://github.com/DeftKing/chrome_plus) и [Vivaldi++](https://github.com/ca-x/vivaldi_plus), обе для x86/x64/ARM64. Если проверка выпуска или загрузка недоступны, используется архив выбранной библиотеки, сохранённый от прежней загрузки (в `Portable\_archives` папки назначения) и проверенный заново. Созданный командный файл запускает браузер из `App`, чтобы относительные пути к `Data` и `Cache` оставались внутри сборки. Очистка реестра применяется только к Chrome++.

**Разрядность обёртки.** Оставьте `АВТО`. Программа сама смотрит, 32- или
64-битный браузер, и кладёт DLL выбранной библиотеки той же архитектуры. Это не формальность:
32-битный браузер с 64-битной обёрткой запускается как ни в чём не бывало, но
профиль уезжает в систему, и сборка перестаёт быть портативной.

**Очистить реестр с Chrome++.** Только для Chrome++ (DeftKing). По умолчанию выключено. С этой галкой браузер
при выходе стирает свою ветку реестра. Ветка общая с установленной копией того
же браузера, поэтому включайте только там, где этот браузер не установлен.

**Упаковать в архив.** Включите, если сборки надо отдать: вместо папки получится
один файл. Формат рядом: `ZIP` открывается везде, `7Z` меньше, но требует 7-Zip
у получателя. При обновлении архив называется по папке сборки, так что у
нескольких сборок одного браузера у каждой свой архив. В архив обновлённой
сборки идут браузер, файл запуска и сертификаты - **без профиля и кэша**:
закладки, пароли и история остаются у вас, в самой сборке.

**Остановить.** Кнопка `СТОП` в строке состояния. Команда останавливается сама, в
ближайшей безопасной точке: загрузка прерывается, распаковка и упаковка
обрываются, сборка, которую ещё не трогали, остаётся прежней, и операция
завершается как остановленная. Если браузер уже встаёт на место, эта замена
доводится до конца, а следующие сборки не начинаются. Архив либо готов целиком,
либо его нет - половины архива под настоящим именем не остаётся.

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

**Оставить рабочие файлы** (в `ДОПОЛНИТЕЛЬНО`). Распакованные установщики
останутся в `Portable\_tmp` в папке назначения - нужно, если сборка не удалась и
надо разобраться. Сами скачанные файлы в любом случае лежат рядом, в
`Portable\_archives`: по одному на браузер, прежние версии убираются сами.

**Обойти Defender.** Библиотека портативности - `version.dll` - иногда
принимается Защитником Windows за угрозу прямо во время сборки. С этой галкой
папки источника и назначения исключаются из проверки на время операции и
возвращаются сразу после неё; Windows один раз спросит разрешение. Там, где
Защитник выключен, галка ничего не делает и ничего не спрашивает. Если операцию
оборвали и исключение осталось, его снимает `ОБСЛУЖИВАНИЕ` → `DEFENDER: УБРАТЬ
ИСКЛЮЧЕНИЕ` - в том числе с папок прошлых запусков.

## Рабочие папки

`ИСТОЧНИК` и `НАЗНАЧЕНИЕ` справа вверху. При каждом запуске это папки `input` и
`output` самой программы; другую папку можно выбрать кнопкой, вписать руками или
перетащить в окно.

- Кнопка с часами открывает историю путей, булавка закрепляет путь в ней.
- `СБРОСИТЬ` возвращает обе папки к `input` и `output`.
- `СПИСОК` показывает в журнале, что лежит в источнике.
- `ОЧИСТИТЬ` удаляет **содержимое** выбранной папки - сама папка остаётся.
  Сначала спрашивает, что очищать, и называет пути. Удалённое уходит в Корзину;
  у флешки и сетевой папки Корзины нет, и вопрос скажет об этом заранее. Папка
  вне программы спрашивается отдельно: в ней могут лежать сборки с чьим-то
  профилем. Корень диска, саму программу и её служебные папки очистить нельзя.

Кнопка `ОЧИСТИТЬ WORKSPACE` в заголовке убирает рабочий материал: скачанные
установщики и распакованное из них (`Portable\_archives` и `Portable\_tmp` в
папке назначения). Готовые сборки не трогает; следующая сборка скачает нужное
заново.

## Из командной строки

Всё, что делает кнопка, можно сделать командой - с теми же настройками:

```bat
browsers_cli.cmd describe
browsers_cli.cmd run --operation browsers_build --set browsers=chrome,brave --target D:\Portable
browsers_cli.cmd run --operation browsers_check --source E:\Flash\Browsers
browsers_cli.cmd run --operation browsers_update --source E:\Flash\Browsers
```

`describe` печатает все разделы, команды и настройки с их именами. Команда,
которой окно запускает операцию, пишется в журнал при каждом запуске - её можно
скопировать оттуда. Код завершения: `0` - готово, `1` - ошибка или сделано не
всё, `130` - остановлено, `2` - команда написана неверно, и тогда ничего не
запускается.

## Что стоит знать

Первый запуск любой сборки дольше обычного - браузер раскладывает профиль.

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