Гайды · документация

Установка

открывает подробности ведёт к полному разбору

Приложение ставится как обычная программа: один файл, без серверной части. Выберите свою систему — ниже порядок действий, зависимости и проверка того, что всё встало.

Перед установкой. Скачайте файл со страницы загрузки и сверьте контрольную сумму с опубликованной. Если сумма совпала — файл дошёл целым и его не подменили.

Linux: пакет .deb

Подходит для Debian 12/13 и Ubuntu 22.04+. Пакет ставит всё нужное сам, включая утилиты командной строки.

  1. Скачайте privjobs-node_0.19.2_amd64.deb.
  2. Поставьте через apt, а не dpkg -i: так подтянутся зависимости.
  3. Запустите приложение из меню или командой privjobs-node.
sudo apt install ./privjobs-node_0.19.2_amd64.deb privjobs-node
технически зависимости и проверка установки

Зависимости, которые ставит apt: libwebkit2gtk-4.1-0, libgtk-3-0, libayatana-appindicator3-1. Вместе с приложением ставятся утилиты pvctl, pvmod, pvpay, pvdash.

dpkg -l privjobs-node | tail -1 # ожидается ii privjobs-node 0.19.2 pvctl role-get # JSON: роль интерфейса и прогресс мастера pvctl readiness # чек-лист готовности узла
Проверка установки пакета privjobs-node в терминале
Проверка после установки. Версия пакета и ответ pvctl подтверждают, что узел готов к первому запуску.
Трей и закрытие окна. На Linux приложение сворачивается в трей: закрытие окна — это скрытие, а не выход. Выход целиком — через меню трея. Так задумано, чтобы уведомления и живые подписки продолжали работать.

Linux: AppImage

Один файл, без установки. Удобно, если нет прав администратора или не хочется трогать систему.

chmod +x privjobs-node_0.19.2_amd64.AppImage ./privjobs-node_0.19.2_amd64.AppImage
технически если AppImage не запускается

Обычно не хватает библиотек GTK/WebKit:

sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 libayatana-appindicator3-1

В версиях до 0.19.0 AppImage отдавался тремя частями .part и его нужно было склеивать через cat. Начиная с v0.19.0 файл целый: если вы скачали .part, значит попали в архив старой версии.

Android: APK

Поддерживается Android 7.0 и новее. Интерфейс рисуется системным компонентом телефона, поэтому дополнительный компонент для интерфейса, как в Windows, здесь не нужен.

  1. Скачайте privjobs-0.19.0-android-arm64.apk (почти все телефоны) или universal, если не уверены в архитектуре.
  2. Разрешите установку из этого источника, когда система спросит. Приложение ставится вне Google Play.
  3. Откройте приложение — сразу запустится мастер первого запуска.
Play Protect может предупредить. Это нормально для APK вне магазина: подпись не в реестре Google. Сверьте контрольную сумму файла с опубликованной — и подтвердите установку.
технически подпись и границы версий

APK подписан самоподписанным ключом разработки — отсюда предупреждение Play Protect. Требование API 24 (Android 7.0) задано каркасом приложения: Android 5–6 не поддерживаются. Push через FCM не используется, поэтому в полностью выключенном приложении уведомления не приходят.

Windows

Готовый установщик — privjobs-setup-0.19.0.exe (24,7 МБ): один файл для Windows 7 SP1 … 11. Он сам определяет версию системы, ставит подходящую сборку и нужный компонент для отображения интерфейса: обычный для 10/11, фиксированный 109 — для 7 и 8.1.

  1. Скачайте privjobs-setup-0.19.0.exe со страницы загрузки и запустите.
  2. Первый запуск открывает мастер: роль → ключ → карточка → релеи → сессия.
  3. Удаление — через «Программы и компоненты» или uninstall.exe в папке установки.
Windows 7 SP1 / 8.1. Интерфейс работает только с фиксированным WebView2 109 — поддержка закрыта, обновлений безопасности для него нет. Командная строка работает без WebView2.

Границы платформы:

СистемаЧто работаетОговорки
Windows 10 / 11Приложение и командная строкаWebView2 обычно уже установлен
Windows 8.1Командная строка; интерфейс — с фиксированным WebView2 109Нужна установка конкретной версии WebView2
Windows 7 SP1Командная строка — проверено на совместимость; интерфейс — с фиксированным WebView2 109WebView2 109 — без обновлений безопасности
Windows XP—Современный каркас приложения несовместим; нужен отдельный клиент
технически сборки, флаги установщика и своя сборка

Установщик ставит modern-сборку (Tauri 2.12) на Windows 10/11 и legacy (Tauri 2.0.0 + Rust 1.77.2) на Windows 7 SP1 и 8.1. Обе ветки проверены под Wine; legacy — по импортам PE, то есть без вызовов Win8+/Win10+ API.

privjobs-setup-0.19.0.exe # обычная установка privjobs-setup-0.19.0.exe /S # тихая установка privjobs-setup-0.19.0.exe /S /skipwebview2 # без загрузки WebView2 uninstall.exe /S /deletedata # удалить вместе с данными узла

Своя сборка (ветка и папка privjobs-windows):

cd privjobs-windows npm ci npm run tauri build # артефакты в src-tauri\target\release\bundle\

Для Windows 7 CLI используется закреплённый тулчейн Rust 1.77.2 и --ignore-rust-version; подробности — в README-WINDOWS.md и docs/windows-compat.md в репозитории.

macOS: архив приложения

Готовый архив — privjobs-node-0.19.0-macos-universal.app.zip (10,2 МБ): внутри приложение privjobs-node.app. Один файл работает и на процессорах Apple, и на Intel. Рядом на странице загрузки лежит архив с утилитами командной строки (privjobs-node-0.19.0-macos-universal-cli.zip, 22,4 МБ).

  1. Скачайте архив и распакуйте его двойным щелчком.
  2. Перенесите privjobs-node.app в папку «Программы».
  3. Первый запуск — правым щелчком по значку → «Открыть» → в диалоге ещё раз «Открыть». Обычный двойной щелчок в первый раз не сработает: сборка не проходила проверку Apple. Дальше приложение открывается как обычно.
  4. Значок узла живёт в меню-баре: крестик скрывает окно, полный выход — Cmd+Q или пункт «Выход» в меню значка. Клик по значку в Dock возвращает скрытое окно.
  5. Данные узла — в ~/Library/Application Support/org.privjobs.node: ключи и база, доступ только у владельца. Пароль ключа живёт до перезапуска приложения.
На живом маке эта сборка ещё не проверялась. Она не нотаризована Apple, поэтому система спросит подтверждение при первом запуске. Если macOS скажет «приложение повреждено» — это карантин, а не поломка: команда для снятия — в подробностях ниже.

Границы платформы:

СистемаЧто работаетОговорки
macOS 11 и новее (процессоры Apple)Приложение и командная строкаПодпись местная, без проверки Apple: подтверждение при первом запуске
macOS 10.15 — 14 (Intel)Командная строка; приложение — заявленоСрез Intel без подписи — для Intel это норма
macOS 10.13 — 10.14—Ниже минимума каркаса приложения (10.15)
технически карантин, утилиты, проверка и как собрано

Карантин (проверьте путь, если приложение лежит не в «Программах»):

xattr -dr com.apple.quarantine /Applications/privjobs-node.app codesign -dv /Applications/privjobs-node.app # ожидается ad-hoc подпись lipo -archs /Applications/privjobs-node.app/Contents/MacOS/privjobs-node # ожидается arm64 x86_64 /usr/libexec/PlistBuddy -c 'Print :LSMinimumSystemVersion' \ /Applications/privjobs-node.app/Contents/Info.plist # ожидается 10.15

Утилиты из второго архива: распакуйте, положите бинари (privjobs-node, pvctl, pvmod, pvpay, pvdash) в ~/.local/bin или /usr/local/bin и при необходимости снимите карантин с каждого файла:

xattr -d com.apple.quarantine pvctl pvctl role-get # роль интерфейса и прогресс мастера pvctl readiness # чек-лист готовности узла

Как собрано (без мака): rustup-таргеты aarch64-/x86_64-apple-darwin, линкер zig (cargo zigbuild) и Apple SDK; универсальный файл склеен скриптом scripts/macos/lipo.py; .app собран вручную — бинарь, icon.icns, Info.plist, PkgInfo (интерфейс вшит в бинарь). Подпись ad-hoc ставит линкер: у среза arm64 она обязательна, у x86_64 её нет — для Intel это норма. Срез arm64 требует macOS 11.0, срез x86_64 — 10.15. Скрипты: scripts/macos/build-cross.sh (с любой системы), build-app.sh/notarize.sh (только на маке — там же делается .dmg и нотаризация). Удаления приложения достаточно для очистки, данные узла лежат отдельно (см. первый запуск).

Сборка из исходников (Linux, macOS)

Сборка из исходников — задача для разработчиков: нужен набор инструментов и время. Команды — в техническом блоке ниже; готовые файлы появятся в каталоге сборки.

технически команды сборки
  1. Поставьте системные зависимости Tauri.
  2. Поставьте Rust через rustup (версия из apt может быть старее требований Tauri 2).
  3. Соберите пакет — артефакты появятся в src-tauri/target/release/bundle/.
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \ libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh npm ci npm run build # tsc --noEmit + vite build npm run tauri build # .deb / AppImage

macOS-ветка (папка privjobs-macos) собирается своими скриптами: на маке — scripts/macos/build-app.sh (универсальный .app + .dmg), а без мака — scripts/macos/build-cross.sh (линкер zig и Apple SDK; получится .app.zip без .dmg). Подробности — в README-MACOS.md и docs/macos-compat.md в репозитории.

Что дальше

После установки откройте гайд по первому запуску: мастер проведёт вас через роль, ключ узла, карточку и релеи. Это семь шагов, и их можно проходить частями — прогресс сохраняется в узле.

технически проверка живости узла

В любой момент: pvctl readiness покажет чек-лист (ключ, карточка, публикация, релеи), а pvctl identity-status — ваш npub и did:key.