Выберите способ установки сервера
| Способ | Лучше всего для | Нужно |
|---|---|---|
| 1. Готовый образ ВМ | Импорт, запуск, вход — Debian, PostgreSQL и PassZit уже готовы | VMware, VirtualBox, Proxmox/KVM или Hyper-V |
| 2. ISO appliance | Новая ВМ или физический сервер, без участия человека | Доступ в интернет во время установки |
| 3. Скрипт установки | Существующий сервер с Debian, Ubuntu, AlmaLinux или Rocky Linux | Права root и доступ в интернет |
| 4. Пакеты вручную | Свой PostgreSQL, управление конфигурацией | Пакет deb или rpm выпуска |
Серверу нужны 2 vCPU, 2 ГБ ОЗУ и диск 16 ГБ. Браузеры подключаются к нему по TCP 8443. Для расширений браузера ему нужны имя и сертификат, которому доверяют браузеры, — PassZit получает его у Let's Encrypt или использует ваш (Настройки → Сертификат).
1. Готовый образ ВМ
VMware ESXi, Workstation, VirtualBox
ESXi Host Client: Create / Register VM → Deploy a virtual machine from an OVF or OVA file. vSphere: Deploy OVF Template.
Proxmox VE и KVM
Создайте ВМ без диска (2 vCPU, 2 ГБ ОЗУ, сеть VirtIO), импортируйте диск и подключите его как загрузочный SCSI-диск.
Hyper-V (поколение 1)
Распакуйте, создайте ВМ поколения 1 с 2 ГБ ОЗУ и выберите VHDX в качестве диска.
В Proxmox VE после копирования образа на узел:
qm importdisk <vmid> passzit-appliance.qcow2 local-lvm
Запустите ВМ: на её экране появятся адрес консоли и токен настройки. Откройте https://<адрес>:8443, один раз примите самоподписанный сертификат, введите токен и создайте первого администратора с двухфакторным входом. На экране ВМ войдите как pzadmin (первый пароль passzit, меняется при первом входе): меню настраивает сеть, имя сервера и часовой пояс, показывает токен настройки и восстанавливает резервные копии. Открыты только порты 22 (SSH) и 8443.
2. ISO appliance
passzit-appliance.iso — загрузите с него ВМ или сервер. Через 5 секунд начнётся автоматическая установка: она стирает первый диск, устанавливает из сети Debian, PostgreSQL и PassZit, а затем показывает адрес консоли и токен настройки.
3. Скрипт установки
На Debian 12+, Ubuntu 22.04+, AlmaLinux или Rocky Linux 9+ (x86-64 или ARM64), от root:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh
Скрипт устанавливает PostgreSQL, скачивает самый новый выпуск, проверяет его подпись, создаёт базу данных со случайным паролем, запускает службу и выводит адрес и токен настройки. Для обновления запустите его снова. Параметры (с sh -s -- при передаче через конвейер): --version X, --db postgres://…, --no-auto-updates (автоматические обновления безопасности системы остаются выключенными), --source URL. Чтобы сначала прочитать его:
curl -fsSLO https://github.com/Max-Zit/passzit/releases/latest/download/install.sh
less install.sh
sudo sh install.sh
4. Пакеты и другие файлы
sudo apt install ./passzit-server_X_amd64.deb # Debian, Ubuntu
sudo dnf install ./passzit-server-X-1.x86_64.rpm # AlmaLinux, Rocky Linux
Задайте PASSZIT_DB в /etc/passzit/server.env, затем systemctl start passzit-server. Токен настройки находится в /var/lib/passzit/setup-token.txt. Эти файлы содержат версию в имени и перечислены на странице выпуска:
| Файл | Что это |
|---|---|
passzit-server_X_amd64.deb, _arm64.deb, .rpm | Сервер для ручной установки (x86-64 и ARM64) |
passzit-extension-chromium-X.zip, -firefox-X.zip | Расширение браузера для ручной установки (см. ниже) |
passzit-cli-X-linux-amd64, -windows-amd64.exe, -darwin-arm64 … | Командная строка passzit для Linux, Windows и macOS |
passzit-helper-X-linux-amd64, -arm64 | Открывает удалённые подключения из расширения в Linux; в Windows это делает MaxZit Launcher (скачайте его на странице Launcher своего сервера) |
| SHA256SUMS | Контрольные суммы программ и пакетов |
| SHA256SUMS-appliance | Контрольные суммы образов ВМ и ISO |
Расширение браузера
Расширение заполняет и сохраняет данные входа в Chrome, Edge, Opera, Brave, Vivaldi и Firefox. Установите его из магазина своего браузера — он будет сам его обновлять:
Chrome Web Store
Chrome, Brave, Opera и Vivaldi.
Firefox Add-ons
Firefox 128 или новее.
Microsoft Edge Add-ons
Microsoft Edge.
То же самое предлагает и ваш сервер PassZit: пункт Расширения браузера в меню веб-хранилища ведёт в магазин вашего браузера и предлагает пакеты своей версии для ручной установки. Затем нажмите на значок PassZit, введите адрес сервера и выберите Подключить через веб-хранилище — в расширении не вводится ни одного пароля.
Проверка загрузки
sha256sum -c SHA256SUMS --ignore-missing # программы и пакеты
sha256sum -c SHA256SUMS-appliance --ignore-missing # OVA, QCOW2, zip VHDX, ISO
Сервер и скрипт установки проверяют подписанный манифест выпуска, прежде чем что-либо устанавливать; см. Безопасность.
Обновление
Настройки → Обновления и сервер показывает работающую и самую новую версию и устанавливает обновления, по желанию автоматически в выбранный час. Устанавливаются только выпуски, подписанные ключом выпусков PassZit; сервер сначала делает резервную копию базы данных и программы и возвращает их, если новая версия не запустится. Канал Testing предлагает кандидаты в выпуски для тестового сервера. Настройки → Резервная копия консоли хранит зашифрованные ежедневные копии базы данных, секретного ключа сервера и сертификата для восстановления на новой машине.