EN · RU

Audion Sync Tools

Содержание

• С чего начать
• Что где лежит
• Окно
• Цвета
• Маршруты к домашним машинам
• Документация
• Правила, которые важно знать заранее
• OpenVPN из папки данных

Программа, которая держит на машине копию MAIN VPS и всё, без чего эта копия бесполезна: ключи, клиент туннеля, доступ к домашним машинам. Плюс снимок приватных архивов Build-стека в R2 bucket.

Отсюда ничего не уходит наружу: ни карточек, ни релизов, ни репозиториев. Публикацией занимается Audion Build Publisher.

С чего начать

После переустановки Windows: выбрать прежнюю DATA FOLDER, затем SETUP → RESTORE. До форматирования один раз выполнить SSHD для сохранения хост-ключей в DATA. Порядок, ограничения и CLI: восстановление Windows.

Запустить Start.exe. Окно один раз попросит права администратора — они нужны для корректной работы с системными сетевыми соединениями: служба туннеля, состояние интерфейсов WireGuard и рукопожатия отдаются системой только администратору. Отказать можно: всё, кроме туннелей, работает и без прав.

На новой машине порядок такой:

1. распаковать программу и принести с собой папку данных этой машины — Audion Backup <Машина>;
2. запустить Start.exe: окно первого запуска спросит папку данных и скачает инструменты, которых в выпуске нет, — rclone, cloudflared, терминал, PeaZip и редакторы;
3. SETUP → IMPORT KEYS — разложит ключи по трём местам, где их ищут программы; то же делает Runs\import-keys.cmd;
4. STORAGE → SYNC ALL — первое наполнение зеркала. Дальше зеркало обновляется той же кнопкой или Runs\sync-backup.cmd: заданий в Планировщике Windows программа не заводит, а ночной снимок MAIN VPS делает сам, своим таймером.

Проверка, что всё встало: кнопка ДИАГНОСТИКА в разделе TUNNEL или Tunnel\RemoteDesktop\check-routes.cmd из консоли.

Что где лежит

Программа — эта папка: окно, сценарии, свой rclone, клиент туннеля. Здесь нет ни одного файла, который жалко потерять: ни ключей, ни адресов, ни паролей — только указатель на профиль.

Данные — соседняя Audion Backup: снимки, шесть зеркал кода MAIN VPS, ключи, токены. Здесь нет ни одного исполняемого файла.

Профиль машины — сама папка данных: у каждой машины своя, например Audion Backup Laptop или Audion Backup Work. В ней то, чем эта машина отличается от такой же программы у другого человека: rclone.conf, ключи R2, отпечатки хостов, адреса машин, план зеркала, пароль роутера. Настройки окна — тема, язык, терминал — часть самой программы и в профиль не уходят.

Имя профиля даёт человек — Laptop, Work, Base, — потому что папку данных носят между машинами, а имя компьютера на работе не переделать. Сама программа хранит только указатель на профиль: config\profile.json, две строки. Всё остальное она берёт из профиля и туда же дописывает.

Рабочие файлы соединений лежат только в папке данных: программа их не хранит. Посмотреть их списком — кнопка СПИСОК в разделе SSH KEYS.

Путь к данным считается от расположения программы. Если данные лежат в другом месте, путь задаётся ключом -Root — у окна и у каждого враппера. Буква диска нигде не зашита: на ноутбуке это E:, на станции S:.

Start.exe                       запуск окна
Runs\sync-backup.cmd            зеркало MAIN VPS
Runs\import-keys.cmd            разложить ключи
Runs\export-keys.cmd            собрать Export Keys в Tunnel\Export
Runs\backup.cmd                 PRIVATE BACKUP: архивы Build-стека в R2
App\                            окно и свой PowerShell 7
Engine\                         сценарии
Tunnel\                         клиент туннеля
Tunnel\RemoteDesktop\           доступ к машинам, роутер, маршруты
Tools\                          rclone, терминал, PeaZip, редакторы
config\                         версия, указатель на папку данных, настройки окна
logs\                           журналы окна и мастеров

Окно

Две файловые панели видны всегда, а лента разделов сверху меняет только то, что в них открыто и какой ряд кнопок показан: SSH KEYS, TUNNEL, REMOTE, STORAGE и CLOUDS; SETUP, SETTINGS и ABOUT — кнопки вверху справа. Справа — журнал, между панелями — узкая полоса кнопок, внизу — ряд файловых операций с их клавишами. Локальный диск, машина по ssh, R2 bucket и облако для программы одинаковы: их читает один rclone, и копировать можно между любыми двумя сторонами.

В шапке — бейдж DATA с именем папки данных, строка пробы (какой маршрут за сколько ответил и каким путём пойдёт окно), число потоков, язык RU / EN и кнопка тем: Audion Vault Dark, Audion Dark, Audion Code Dark и Audion Light. Выбор запоминается между запусками.

Разделы SETUP и SSH KEYS показывают, чем эта машина уже обзавелась: адреса машин, ключи ssh, ключи к R2, список ключей хостов, sshd, пароль роутера. У каждой кнопки индикатор: серый — этого ещё нет, оранжевый — есть, но делом не подтверждено, зелёный — подтверждено чтением панели. Отдельно стоит REMOVE TASK: он удаляет ежедневное задание, оставшееся от прежних версий, и виден, только пока такой остаток есть.

Машины — BASE, LAPTOP, MAIN VPS, HOME, WORK и роутеры — стоят в разделе REMOTE: кнопка машины открывает на ней терминал. Набор кнопок задан targets.json; у машины, чей адрес ещё не вписан, индикатор серый, и нажатие говорит об этом словами. MAIN VPS стоит в панелях наравне с домашними машинами и R2 bucket: файл едет между R2 bucket и MAIN VPS напрямую, без scp и без консоли.

Клавиши как в файловом менеджере: пробел отмечает и считает размер папки, Enter входит, Backspace поднимает на уровень, Tab переходит в соседнюю панель. F2 — переименовать, F3 — публичные ссылки на отмеченное в R2 bucket, F4 — редактор, F5 и F6 — копировать и перенести, F7 — папка, F8 — удалить. F11 доливает недостающее в соседнюю панель, F12 делает её точной копией активной. Alt+F5 и Alt+F9 упаковывают и распаковывают архивы, Ctrl+F ищет от папки панели вглубь, клавиша F сужает список по имени. Esc останавливает идущую операцию.

Звёздочка в полосе между панелями отмечает строки по маскам: свои маски, сохранённые наборы, время изменения и группы расширений. Лупа открывает поиск — на диске, на машине, в R2 bucket и в облаке одинаково; найденное можно вывести в панель плоским списком.

Кнопка СОСТОЯНИЕ под журналом перечитывает панели и пишет сводку: возраст снимка, ключи R2, версия cloudflared, sshd и туннели этой машины — свои и чужого VPN. Та же сводка появляется при старте.

Инструменты программа возит с собой и обновляет сама: SETTINGS → ОБНОВИТЬ ведёт rclone, cloudflared, терминал, PeaZip и редакторы. Версии спрашиваются до закачки, поэтому уже свежее не качается заново. Там же — папка данных, шрифт, прозрачность и показ размеров в байтах.

Подробно — в руководстве.

Цвета

Имена файлов и папок красит App\config\colors\themes.json: в нём цвета и порядок правил для тёмной и светлой сторон. Что считать видео, документом или архивом, говорит соседний App\config\mask-groups.json — те же семьи, что в окне масок; второго списка расширений в программе нет. Цвета сняты с тем Total Commander владельца.

Правила идут сверху вниз, побеждает первое подошедшее — как в самом TC. Поэтому свежесть обычно важнее типа: файл, изменённый сегодня, красится цветом «не старше дня», даже если это архив. Возраст считается календарными сутками: вчерашний файл — «не старше дня», даже если ему тридцать часов.

Цвета самого окна — рамки, кнопки, фон списка — живут отдельно, в темах окна, и на цвета строк не влияют.

Маршруты к домашним машинам

Из дома всё идёт напрямую. Из чужой сети — через jump host MAIN VPS: сначала по имени, потом поверх cloudflared, и последним остаётся SECOND VPS. Маршрут выбирает проба, а кнопки МАРШРУТ в ленте разделов позволяют настоять на своём: АВТО, LAN, SSH MAIN VPS, SSH MAIN VPS CF, SSH SECOND VPS. Подпись источника над панелью говорит, каким путём идёт обращение: BASE · SSH MAIN VPS CF. Где общий выбор не годится, кнопка в полосе между панелями задаёт маршрут каждой машине отдельно.

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

README.md                указатель на описания и руководства
Docs\README_RU.md        это описание
Docs\README_EN.md        то же по-английски
CLAUDE.md                правила работы с проектом
MEMORY.md                история: почему устроено именно так
SKILL.md                 команды, проверки, конфиги
Docs\USER_GUIDE_RU.md    руководство пользователя
Docs\USER_GUIDE_EN.md    то же по-английски
Docs\RESTORE_RU.md       восстановление после переустановки Windows
Docs\RESTORE_EN.md       то же по-английски
Docs\CHANGELOG_RU.md     журнал изменений
Docs\CHANGELOG_EN.md     то же по-английски

Реестр доступов — какой ключ что открывает, где какие туннели — живёт в данных: Audion Backup\Tunnel\ACCESS.md. Значения секретов туда не копируются никогда, только пути и назначение.

Правила, которые важно знать заранее

Ничего не брать у соседних проектов. У программы свой rclone и свои ключи; правка, возвращающая связь с соседями, — неверная правка.

Данные не чистить. Audion Backup не удаляется и не «приводится в порядок»: там ключи, токены и единственная локальная копия MAIN VPS.

Кнопка зовёт враппер. В окне не должно происходить ничего, чего нельзя сделать из консоли — иначе окно и врапперы разойдутся.

Ключи правит владелец. Программа чинит права и пути, содержимое ключей — никогда.

OpenVPN из папки данных

TUNNEL → NET → OPENVPN предлагает подключить VPN и открыть диски WORK в активной панели либо отключить выбранный VPN-профиль. После запроса подключения программа до 90 секунд ждёт чтения work:/ через rclone, с ключами и проверкой сервера из рабочего rclone.conf. Ошибка входа не считается готовым соединением. На новой машине сначала нужны IMPORT KEYS, RCLONE.CONF и доверенные ключи WORK. SETUP → ПРОЧЕЕ → OVPN PATH позволяет выбрать клиент и профиль; Ctrl+OPENVPN проверяет пути без подключения. То же доступно через Tunnel\RemoteDesktop\openvpn.cmd и openvpn-path.cmd с ключом -Root.

Переносимая раскладка: DATA\OpenVPN Portable\openvpn-portable.exe, рядом app, профиль в data\config\*.ovpn, RDP-файл рядом с клиентом. Эти файлы предоставляет владелец; в выпуск Sync Tools они не входят. Если системный OpenVPN GUI установлен, он обнаруживается автоматически; явный выбор клиента сохраняется в данных и имеет приоритет. Запуск внешнего клиента выполняется через UAC. Для отключения служит та же кнопка OPENVPN или значок клиента в трее; СТОП предназначен для файловых операций. В CLI есть -Connect и -Disconnect. OpenVPN даёт маршрут до WORK; SSH/SFTP-соединение для панелей устанавливает rclone. Для одновременных VPN-подключений с разных машин нужны профили, разрешённые администратором сервера: копии одного сертификата могут вытеснять друг друга.