Установка KeePassXC на Debian 13, 12, 11: подробное руководство

KeePassXC — это безопасный менеджер паролей с открытым исходным кодом, который хранит все ваши пароли, SSH-ключи и TOTP-токены в зашифрованной базе данных. В отличие от облачных решений (LastPass, Bitwarden), данные никогда не покидают ваш компьютер. Главные сложности для новичка: нужно выбрать правильный способ установки. В стандартных репозиториях Debian версии могут быть старыми (Debian 11 — KeePassXC 2.6.2, Debian 12 — 2.7.4). На Debian 11 и 12 можно использовать репозиторий NotesAlexp для более свежей версии. Debian 13 уже содержит актуальную версию (2.7.10). Также есть Flatpak и сборка из исходников для энтузиастов.

💡 В этом руководстве вы установите KeePassXC на Debian четырьмя способами: из стандартных репозиториев (APT), из репозитория NotesAlexp (свежая версия для Debian 11/12), через Flatpak и сборкой из исходников. Вы также узнаете, как настроить интеграцию с браузером и решить типичные проблемы.

В этой статье вы узнаете:

  • Как установить KeePassXC из стандартных репозиториев Debian
  • Как установить свежую версию из репозитория NotesAlexp (для Debian 11/12)
  • Как установить KeePassXC через Flatpak
  • Как собрать KeePassXC из исходников (для разработчиков)
  • Как настроить интеграцию с браузером
  • Как решить типичные проблемы: не работает интеграция, не видит YubiKey, ошибка версии базы данных

Для кого: пользователи Debian, которые хотят безопасно хранить пароли на своём компьютере, а также разработчики, которым нужна свежая версия KeePassXC.

Оглавление

1. 🔧 Предварительные требования

Перед установкой убедитесь, что:

  • У вас установлена Debian 11, 12 или 13
  • Подключение к интернету стабильно
  • У вас есть права sudo

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo whoami

Что делает: sudo выполняет команду от имени суперпользователя, whoami показывает имя текущего пользователя.

Зачем: Эта команда проверяет, есть ли у вас права sudo. Без них вы не сможете устанавливать пакеты.

✅ Если выводит root — всё в порядке, можете продолжать.

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

1.1 Обновление системы

Перед установкой всегда обновляйте список пакетов.

sudo apt update && sudo apt upgrade -y

Что делает:

  • sudo — права суперпользователя
  • apt update — обновляет список доступных пакетов из репозиториев
  • && — выполняет следующую команду только если предыдущая успешна
  • apt upgrade -y — обновляет все установленные пакеты до последних версий

Зачем: Это стандартная практика безопасности перед установкой нового ПО.

2. 📊 Сравнение способов установки KeePassXC

В Debian есть четыре основных способа установки KeePassXC. Вот их сравнение:

МетодОткудаВерсияОбновленияПлюсыМинусы
APT
(стандартный)		Репозитории
Debian		Debian 13: 2.7.10,
Debian 12: 2.7.4,
Debian 11: 2.6.2		Автоматически
через
apt upgrade		Простота,
безопасность		Старые
версии на
Debian 11/12
APT
(NotesAlexp)		Сторонний
репозиторий
NotesAlexp		Свежая
(2.7.11+)		Автоматически
через
apt upgrade		Свежие
версии на
старых Debian		Нужно
добавлять
репозиторий
FlatpakFlathubСвежаяАвтоматически
через
flatpak update		Изоляция,
чистое
удаление		Требует
установки
Flatpak
Сборка из
исходников		GitHubЛюбая
(стабильная
или dev)		ВручнуюМаксимальная
свежесть,
кастомизация		Сложно,
ручное
обновление

💡 Рекомендация: Если у вас Debian 13 — используйте стандартный APT (версия свежая). Если Debian 11 или 12 — либо NotesAlexp, либо Flatpak. Сборку из исходников оставьте для разработчиков.

3. 📦 Способ 1: Установка KeePassXC из стандартных репозиториев Debian

Этот способ подходит для большинства пользователей. Вы получаете версию, протестированную для вашего выпуска Debian.

3.1 Установка пакета

sudo apt install keepassxc -y

Что делает: Устанавливает KeePassXC из официальных репозиториев Debian.

3.2 Проверка версии

keepassxc --version

✅ Ожидаемый вывод в терминале (Debian 13):

KeePassXC 2.7.10

Какие версии в разных Debian:

Версия DebianВерсия KeePassXC
Debian 13 (Trixie)2.7.10
Debian 12 (Bookworm)2.7.4
Debian 11 (Bullseye)2.6.2

4. 📦 Способ 2: Установка свежей версии из репозитория NotesAlexp (для Debian 11/12)

Этот способ подходит, если у вас Debian 11 или 12 и нужна свежая версия KeePassXC.

4.1 Установка вспомогательных пакетов

sudo apt install curl gnupg lsb-release ca-certificates -y

4.2 Импорт GPG-ключа NotesAlexp

curl -fsSL https://notesalexp.org/debian/alexp_key.asc | sudo gpg --dearmor -o /usr/share/keyrings/alexp_key.gpg

4.3 Добавление репозитория (DEB822)

sudo tee /etc/apt/sources.list.d/alexp.sources > /dev/null <<EOF
Types: deb
URIs: https://notesalexp.org/debian/$(lsb_release -cs)/
Suites: $(lsb_release -cs)
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /usr/share/keyrings/alexp_key.gpg
EOF

4.4 Обновление списка пакетов и установка

sudo apt update
sudo apt install keepassxc -y

4.5 Проверка версии

keepassxc --version

✅ Ожидаемый вывод: Свежая версия (2.7.11+).

5. 📦 Способ 3: Установка KeePassXC через Flatpak

Этот способ подходит, если вы предпочитаете изолированные приложения.

5.1 Установка Flatpak (если ещё не установлен)

sudo apt install flatpak -y
sudo flatpak remote-add --system --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

💡 Если вы не знакомы с Flatpak: У нас есть подробное руководство по установке Flatpak на Debian.

5.2 Установка KeePassXC из Flathub

sudo flatpak install flathub org.keepassxc.KeePassXC -y

5.3 Проверка установки

flatpak list | grep -i keepass

✅ Ожидаемый вывод:

KeePassXC    org.keepassxc.KeePassXC 2.7.11  stable  flathub

5.4 Запуск (Flatpak)

flatpak run org.keepassxc.KeePassXC

6. 🔧 Способ 4: Сборка KeePassXC из исходников (для разработчиков)

Этот способ подходит, только если вы хотите собрать самую последнюю версию с кастомными опциями.

6.1 Установка инструментов сборки и зависимостей

sudo apt install build-essential cmake g++ asciidoctor git -y
sudo apt install qtbase5-dev qtbase5-private-dev qttools5-dev qttools5-dev-tools \
  libqt5svg5-dev libargon2-dev libminizip-dev libbotan-2-dev libqrencode-dev \
  libkeyutils-dev zlib1g-dev libreadline-dev libpcsclite-dev libusb-1.0-0-dev \
  libxi-dev libxtst-dev libqt5x11extras5-dev -y

6.2 Клонирование и сборка последней стабильной версии

git clone https://github.com/keepassxreboot/keepassxc.git ~/keepassxc
cd ~/keepassxc
LATEST_TAG=$(git tag -l | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1)
git checkout $LATEST_TAG
mkdir build && cd build
cmake -DWITH_XC_ALL=ON -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
sudo make install

Что делает: Собирает KeePassXC со всеми опциями (-DWITH_XC_ALL=ON) и устанавливает в /usr/local.

6.3 Проверка установки

keepassxc --version

7. 🖥️ Запуск и базовая настройка

7.1 Запуск из терминала

keepassxc

7.2 Запуск из меню приложений

Нажмите Super (клавиша с логотипом Windows), введите KeePassXC, нажмите на иконку.

7.3 Интеграция с браузером

Для автозаполнения паролей в браузере нужно:

  1. В KeePassXC: Tools → Settings → Browser Integration → включить Enable browser integration
  2. Установить расширение для браузера: KeePassXC-Browser для Chrome/Chromium/Brave, для Firefox.

8. ⚠️ Решение типичных проблем

8.1 Интеграция с браузером не работает (Flatpak)

Симптом: Расширение браузера не подключается к KeePassXC.

Причина: Flatpak изолирует приложение. Нужны дополнительные разрешения.

Решение: Добавьте доступ к сокету D-Bus:

sudo flatpak override org.keepassxc.KeePassXC --socket=session-bus

8.2 YubiKey или другой аппаратный ключ не определяется

Симптом: KeePassXC не видит YubiKey.

Решение: Добавьте пользователя в группу plugdev:

sudo usermod -aG plugdev $USER

Выйдите из системы и зайдите снова.

8.3 Ошибка: база данных создана в новой версии, не могу открыть

Симптом: KeePassXC выдаёт ошибку, что база данных создана в более новой версии.

Причина: Вы пытаетесь открыть базу данных, созданную в более новой версии KeePassXC, в старой версии.

Решение: Обновите KeePassXC до той же версии или новее.

8.4 Ошибка: keepassxc: command not found

Симптом: keepassxc не найден после установки.

Решение: Если устанавливали через Flatpak, используйте flatpak run org.keepassxc.KeePassXC. Для source-сборки убедитесь, что /usr/local/bin в PATH.

9. ❌ Удаление KeePassXC

Удаление APT-версии

sudo apt remove --purge keepassxc -y
sudo apt autoremove -y

Удаление репозитория NotesAlexp (если добавляли):

sudo rm -f /etc/apt/sources.list.d/alexp.sources
sudo rm -f /usr/share/keyrings/alexp_key.gpg
sudo apt update

Удаление Flatpak-версии

sudo flatpak uninstall org.keepassxc.KeePassXC -y
sudo flatpak uninstall --unused -y

Удаление source-сборки

cd ~/keepassxc/build
sudo make uninstall
rm -rf ~/keepassxc

Удаление файлов базы данных (опционально)

⚠️ Осторожно: Удаляет все пароли.

rm ~/Documents/Passwords.kdbx   # или путь к вашему файлу

10. 📝 Чек-лист: всё готово к работе

  • [ ] Система обновлена (sudo apt update && sudo apt upgrade -y)
  • [ ] Выбран и выполнен один из способов установки (APT / NotesAlexp / Flatpak / Source)
  • [ ] keepassxc --version показывает ожидаемую версию
  • [ ] KeePassXC запускается из меню приложений
  • [ ] Настроена интеграция с браузером
  • [ ] Создана тестовая база данных паролей

Заключение

Вы установили KeePassXC на Debian. Если вы использовали стандартные репозитории — получили стабильную версию, но на Debian 11 и 12 она может быть старой. Если добавили репозиторий NotesAlexp — получили свежую версию на старых Debian. Если выбрали Flatpak — получили изолированную среду. KeePassXC — это безопасное, офлайн-решение для хранения паролей, SSH-ключей и TOTP-токенов.

Что дальше:

  • Создайте новую базу данных паролей (Database → New Database)
  • Настройте интеграцию с браузером для автозаполнения
  • Импортируйте пароли из другого менеджера (CSV, 1Password, LastPass)
  • Настройте TOTP (Google Authenticator) для двухфакторной аутентификации
  • Регулярно делайте резервные копии файла .kdbx

Связанные записи