Гайды · документация
Установка
открывает подробности ведёт к полному разбору
Приложение ставится как обычная программа: один файл, без серверной части. Выберите свою систему — ниже порядок действий, зависимости и проверка того, что всё встало.
Linux: пакет .deb
Подходит для Debian 12/13 и Ubuntu 22.04+. Пакет ставит всё нужное сам, включая утилиты командной строки.
- Скачайте
privjobs-node_0.19.2_amd64.deb. - Поставьте через
apt, а неdpkg -i: так подтянутся зависимости. - Запустите приложение из меню или командой
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 # чек-лист готовности узла
pvctl подтверждают, что узел готов к первому запуску.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, здесь не нужен.
- Скачайте
privjobs-0.19.0-android-arm64.apk(почти все телефоны) илиuniversal, если не уверены в архитектуре. - Разрешите установку из этого источника, когда система спросит. Приложение ставится вне Google Play.
- Откройте приложение — сразу запустится мастер первого запуска.
технически подпись и границы версий
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.
- Скачайте
privjobs-setup-0.19.0.exeсо страницы загрузки и запустите. - Первый запуск открывает мастер: роль → ключ → карточка → релеи → сессия.
- Удаление — через «Программы и компоненты» или
uninstall.exeв папке установки.
Границы платформы:
| Система | Что работает | Оговорки |
|---|---|---|
| Windows 10 / 11 | Приложение и командная строка | WebView2 обычно уже установлен |
| Windows 8.1 | Командная строка; интерфейс — с фиксированным WebView2 109 | Нужна установка конкретной версии WebView2 |
| Windows 7 SP1 | Командная строка — проверено на совместимость; интерфейс — с фиксированным WebView2 109 | WebView2 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 МБ).
- Скачайте архив и распакуйте его двойным щелчком.
- Перенесите privjobs-node.app в папку «Программы».
- Первый запуск — правым щелчком по значку → «Открыть» → в диалоге ещё раз «Открыть». Обычный двойной щелчок в первый раз не сработает: сборка не проходила проверку Apple. Дальше приложение открывается как обычно.
- Значок узла живёт в меню-баре: крестик скрывает окно, полный выход — Cmd+Q или пункт «Выход» в меню значка. Клик по значку в Dock возвращает скрытое окно.
- Данные узла — в
~/Library/Application Support/org.privjobs.node: ключи и база, доступ только у владельца. Пароль ключа живёт до перезапуска приложения.
Границы платформы:
| Система | Что работает | Оговорки |
|---|---|---|
| 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)
Сборка из исходников — задача для разработчиков: нужен набор инструментов и время. Команды — в техническом блоке ниже; готовые файлы появятся в каталоге сборки.
технически команды сборки
- Поставьте системные зависимости Tauri.
- Поставьте Rust через rustup (версия из apt может быть старее требований Tauri 2).
- Соберите пакет — артефакты появятся в
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 / AppImagemacOS-ветка (папка 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.