PassZit

Установка self-hosted менеджера паролей для вашей команды

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

О чём это руководство

PassZit — бесплатный менеджер паролей с открытым кодом (AGPLv3), который работает на вашем собственном сервере. У каждого пользователя есть хранилище со сквозным шифрованием для входов, одноразовых кодов, защищённых заметок, карт, ключей SSH и файлов; команды совместно используют хранилища с правами для каждого человека. Сервер хранит только шифротекст. Если вы сравниваете инструменты, потому что искали self-hosted альтернативу Bitwarden, это руководство показывает, как на практике выглядят установка и внедрение PassZit.

Что понадобится

  • Виртуальная машина на VMware, VirtualBox, Proxmox VE/KVM или Hyper-V либо физический сервер: 2 vCPU, 2 ГБ ОЗУ и диск 16 ГБ — или существующий 64-битный сервер с Debian 12+, Ubuntu 22.04+, AlmaLinux или Rocky Linux 9+ (x86-64 или ARM64).
  • Браузеры обращаются к серверу по TCP 8443. PostgreSQL настраивают скрипт установки и образы.
  • Для расширений браузера: DNS-имя сервера и сертификат, которому доверяют браузеры (см. ниже).
  • По желанию — SMTP-сервер, чтобы PassZit отправлял приглашения и уведомления по электронной почте.

Установка сервера

Есть четыре способа; все они на странице загрузки, и каждый выпуск подписан.

СпособЛучше всего для
Образ VM: OVA (VMware, VirtualBox), QCOW2 (Proxmox VE, KVM), VHDX (Hyper-V поколения 1)Импортировать, запустить, войти — Debian, PostgreSQL и PassZit готовы
ISO applianceНовая VM или физический сервер; автоматическая установка стирает первый диск
Скрипт установкиСуществующий сервер Debian, Ubuntu, AlmaLinux или Rocky Linux
Пакеты (deb, rpm; amd64, arm64)Собственный PostgreSQL и управление конфигурацией

Образ VM или ISO: запустите VM. На её экране показаны адрес консоли и токен настройки. На консоли VM можно войти как pzadmin (первый пароль passzit, меняется при первом входе): меню настраивает сеть, имя сервера и часовой пояс, снова показывает токен и восстанавливает резервные копии. Открыты только порты 22 (SSH) и 8443.

Скрипт установки: от root на сервере:

curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh

Скрипт устанавливает PostgreSQL, загружает новейший выпуск, проверяет его подпись, создаёт базу данных со случайным паролем, запускает службу и выводит адрес и токен настройки. Параметры вроде --version, --db (существующая база PostgreSQL) или --no-auto-updates передаются через sh -s --.

Пакеты: установите deb или rpm, задайте PASSZIT_DB в /etc/passzit/server.env и выполните systemctl start passzit-server. Токен настройки лежит в /var/lib/passzit/setup-token.txt.

Первый вход и первый администратор

  1. Откройте https://<сервер>:8443. Новый сервер использует самоподписанный сертификат; браузер один раз предупредит — примите его.
  2. Введите Токен настройки, свой адрес электронной почты и мастер-пароль. Браузер создаст ваши ключи; это занимает секунду. Эта первая учётная запись — администратор.
  3. Отсканируйте QR-код приложением-аутентификатором (Microsoft Authenticator, Google Authenticator, Authy, 2FAS …). Двухфакторный вход обязателен для всех учётных записей. Сохраните десять кодов восстановления; каждый один раз заменяет приложение.
  4. Создайте ключ восстановления (см. ниже) и добавьте первый вход кнопкой Новый элемент.

Позже в разделе Моя учётная запись можно добавить ключи безопасности (YubiKey и другие) или ключ доступа своего устройства как второй фактор.

Сертификат, которому доверяют браузеры

Расширения браузера отклоняют самоподписанные сертификаты, поэтому до развёртывания расширения дайте серверу настоящий сертификат. В разделе Настройки → Сертификат загрузите сертификат (от корпоративного УЦ или купленный; PEM с промежуточными сертификатами и закрытым ключом) или выберите Let's Encrypt. Let’s Encrypt требует публичного DNS-имени и проверяет его через порт 80 сервера или через DNS-запись в Cloudflare — второй вариант подходит и для сервера, доступного только внутри вашей сети. Сертификат применяется сразу, без перезапуска; DNS вашей сети должен указывать имя на сервер.

Пригласите команду

Учётные записи создаются только по приглашению. В разделе Пользователи → Пригласить пользователя укажите адрес электронной почты и роль (Пользователь или Администратор). PassZit один раз показывает ссылку-приглашение; отправьте её человеку. Ссылка работает один раз и по умолчанию 7 дней. Если в Настройки → Электронная почта настроен SMTP-сервер, отметьте Также отправить приглашение по электронной почте, и PassZit отправит его за вас.

Приглашённый выбирает мастер-пароль и настраивает двухфакторный вход, как и вы. Администраторы могут отключать пользователей, сбрасывать утерянный второй фактор и отзывать открытые приглашения. Чтобы делиться паролями, создайте общее хранилище и дайте доступ людям или группам.

Корпоративные учётные записи подключаются в Настройки → Корпоративный вход: единый вход через OpenID Connect или SAML 2.0, а также Active Directory / LDAP. Мастер-пароль остаётся всегда, ведь это ключ к хранилищу.

Мастер-пароль и ключ восстановления

Мастер-пароль никогда не покидает браузер пользователя. В этом смысл сквозного шифрования, и у него есть следствие: никто — ни администратор, ни MaxZit — не может открыть хранилище без мастер-пароля или ключа восстановления. Администраторы не могут увидеть или сбросить мастер-пароли.

  • Фраза из четырёх–шести случайных слов легко запоминается и трудно угадывается. Политика хранилища задаёт минимальную длину (по умолчанию 12 символов).
  • В Моя учётная запись кнопка Создать ключ восстановления показывает ключ из 32 букв и цифр, только один раз. Распечатайте или запишите его и храните офлайн — не в хранилище и не рядом с телефоном.
  • С ключом восстановления и кодом из приложения-аутентификатора пользователь, забывший мастер-пароль, задаёт новый на странице входа. Без ключа восстановления хранилище потеряно; администратор может лишь удалить учётную запись и снова пригласить человека с пустым хранилищем. Список пользователей показывает, кто создал ключ восстановления.

Попросите всех создать ключ восстановления в первый же день.

Установка расширения браузера

Расширение заполняет входы и одноразовые коды только на том сайте, которому они принадлежат, предлагает сохранить новые и изменённые входы, заполняет карты и адреса в формах оплаты и доставки и генерирует пароли. Установите его из магазина своего браузера, который его обновляет:

  • Chrome Web Store — Chrome, Brave, Opera и Vivaldi
  • Firefox Add-ons — Firefox 128 или новее
  • Microsoft Edge Add-ons — Microsoft Edge

Ссылки есть на странице загрузки. Сервер PassZit предлагает то же самое: пункт Расширения браузера в меню веб-хранилища показывает Установить в один клик с магазином вашего браузера, а также пакеты своей версии для ручной установки.

  1. Нажмите значок PassZit, введите только адрес своего сервера (например https://vault.example.com) и нажмите Подключить через веб-хранилище. Разрешите браузеру, чтобы PassZit общался с этим сервером. Порт в адресе, например :8443, работает в любом браузере, и в Firefox тоже.
  2. Откроется веб-хранилище; войдите в него, если ещё не вошли.
  3. Хранилище спросит, подключить ли расширение в этом браузере, — нажмите Подключить. В расширении не вводятся ни пароль, ни код.

Веб-хранилище и расширение разблокируются вместе: разблокируйте одно — откроется и другое, заблокируйте одно — заблокируются оба.

Импорт паролей из другой программы

Каждый пользователь импортирует в своё хранилище. Сначала экспортируйте данные из старой программы, затем в хранилище выберите Инструменты → Импорт и файл. PassZit распознаёт формат, показывает, сколько элементов и папок нашёл и сколько из них уже есть в хранилище, и позволяет сохранить папки из файла и пропустить дубликаты.

ОткудаЭкспорт там
Chrome, Edge, Brave, Opera, VivaldiPassword manager → Settings → Export passwords (CSV)
Firefoxabout:logins → … → Export passwords (CSV)
SafariFile → Export → Passwords (CSV)
BitwardenTools → Export vault → .json или .csv, не зашифрованный вариант
KeePass 2 / KeePassXCKeePass XML (2.x) / CSV или XML
1PasswordFile → Export → CSV
LastPassAdvanced options → Export (CSV)

Файл читается в браузере; сервер получает элементы только в зашифрованном виде. Переносятся входы, заметки, сайты, собственные поля, папки, избранное и секреты TOTP (из Bitwarden также карты, личные данные и ключи SSH). Вложенные файлы в эти экспорты не входят. Затем удалите файл экспорта — в нём пароли не зашифрованы.

Как работает шифрование

Браузер выводит из мастер-пароля мастер-ключ с помощью Argon2id (64 МиБ, 3 прохода). Из него получаются два ключа: ключ аутентификации, который отправляется при входе, — сервер хранит только его хеш argon2id, — и ключ-обёртка, который открывает случайный ключ учётной записи пользователя. Каждый элемент, включая название, имя пользователя, сайты и заметки, шифруется AES-256-GCM ключом своего хранилища; у общих хранилищ свой ключ, запечатанный для ключа X25519 каждого участника. Сервер видит шифротекст, идентификаторы, размеры и отметки времени, но никогда — мастер-пароль или ключ, которым мог бы воспользоваться. Подробности — на странице безопасности и в docs/ARCHITECTURE.md репозитория.

Резервные копии сервера

Настройки → Резервная копия консоли каждый день (и по запросу кнопкой Создать копию сейчас) записывает копию в /var/lib/passzit/backups: базу данных со всеми хранилищами, секретный ключ сервера и сертификат консоли — всё, что нужно новому серверу. Копия всегда зашифрована парольной фразой, которую задаёте вы; храните её в другом месте. Каждую копию можно также копировать в папку SFTP на другом сервере. Для восстановления используйте меню appliance или остановите службу и выполните passzit-server -restore, как описано в руководстве в консоли.

Обновления

Настройки → Обновления и сервер показывает работающую и новейшую версии. Установка ещё раз проверяет подпись, делает копию базы данных и программы, устанавливает обновление и проверяет, что сервер снова работает, — если нет, сама возвращает старую версию и базу. Там же включается автоматическая установка в выбранный час. Канал Стабильный получает выпуски; Testing предлагает также кандидаты в выпуски — для тестового сервера. При установке скриптом его повторный запуск тоже обновляет PassZit и сохраняет все данные.

Ограничения, о которых стоит знать

  • PassZit активно разрабатывается: первый публичный выпуск 0.9.0 вышел в ноябре 2026 года, новые версии выходят часто.
  • Нативного мобильного приложения нет. На телефоне веб-хранилище можно добавить на главный экран, и оно открывается в своём окне, но ничего не сохраняется для работы офлайн — без сервера вы увидите страницу «offline».
  • Забытый мастер-пароль без ключа восстановления не может восстановить никто.
  • Расширениям браузера нужен доверенный сертификат, и они входят по мастер-паролю и коду аутентификатора — не через единый вход.
  • Как и у любого веб-хранилища, его JavaScript приходит с сервера, поэтому полностью скомпрометированный сервер мог бы отдать изменённый код; расширение приносит собственный код.
  • Образа Docker нет; устанавливайте из образа, скриптом или из пакетов. Руководство в консоли — на английском и сербском.

Что дальше

Скачайте PassZit, посмотрите все возможности — общие хранилища, секретные ссылки, экстренный доступ, удалённые подключения, командную строку — или прочитайте руководство, встроенное в консоль (документация). Как настроить общие хранилища для команды, описано в руководстве Общий доступ к паролям в команде. Вопросы приветствуются в GitHub Discussions. Компании могут получить коммерческую поддержку от MaxZit (только на английском).