Установка Beekeeper Studio на Debian 13, 12, 11: полное руководство

Beekeeper Studio — это современный, красивый и удобный SQL-клиент с графическим интерфейсом для работы с базами данных. Он поддерживает MySQL, MariaDB, PostgreSQL, SQLite, SQL Server, MongoDB, Redis, CockroachDB и многие другие СУБД.

В отличие от терминальных клиентов (вроде mysql или psql), Beekeeper Studio даёт вам:

  • Визуальное отображение структуры таблиц
  • Автодополнение SQL-запросов
  • Сохранение часто используемых запросов
  • SSH-туннелирование (подключение к удалённым базам через SSH)
  • Тёмную тему и удобный интерфейс

В этом руководстве я покажу два способа установки Beekeeper Studio на Debian:

  1. APT-репозиторий (рекомендуемый) — нативный пакет Debian, обновляется через apt
  2. Flatpak — изолированная установка через Flathub
МетодКаналВерсияОбновленияДля кого
APT-репозиторийОфициальный
репозиторий
Beekeeper		АктуальнаяАвтоматически
через
apt upgrade		Пользователи,
привыкшие к
нативной
установке
FlatpakFlathubАктуальнаяАвтоматически
через
flatpak update		Те, кто
предпочитает
изоляцию или
уже использует
Flatpak

⚠️ Важно: Beekeeper Studio не входит в стандартные репозитории Debian. Мы добавим официальный репозиторий (или Flathub) и установим оттуда.

Оглавление

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

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

  • У вас есть графическая среда (GNOME, KDE, Xfce и т.д.) — Beekeeper Studio работает только под графикой
  • Подключение к интернету
  • Вы имеете права sudo (администратора)

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

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

sudo whoami

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

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

root

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

Способ 1: Установка из официального APT-репозитория (рекомендуемый)

Этот способ наиболее привычен для Debian — программа устанавливается через apt и обновляется вместе с системой.

Шаг 1: Обновите систему

sudo apt update && sudo apt upgrade -y

Шаг 2: Установите зависимости

sudo apt install -y ca-certificates curl gpg

Что делает: Устанавливает пакеты для работы с HTTPS и GPG-ключами.

Шаг 3: Добавьте GPG-ключ Beekeeper Studio

curl -fsSL https://deb.beekeeperstudio.io/beekeeper.key | sudo gpg --dearmor -o /usr/share/keyrings/beekeeper.gpg

Что делает:

  • curl -fsSL — скачивает открытый ключ Beekeeper Studio
  • | sudo gpg --dearmor — преобразует в бинарный формат (требуется APT)
  • -o /usr/share/keyrings/beekeeper.gpg — сохраняет ключ в системную директорию

Шаг 4: Добавьте репозиторий Beekeeper Studio

printf '%s\n' \
'Types: deb' \
'URIs: https://deb.beekeeperstudio.io' \
'Suites: stable' \
'Components: main' \
'Architectures: amd64' \
'Signed-By: /usr/share/keyrings/beekeeper.gpg' | sudo tee /etc/apt/sources.list.d/beekeeper-studio.sources > /dev/null

Что делает: Создаёт файл репозитория в современном формате DEB822.

Шаг 5: Обновите список пакетов

sudo apt update

Ожидаемый вывод (должны быть строки с deb.beekeeperstudio.io):

Get:1 https://deb.beekeeperstudio.io stable InRelease [3,068 B]
Get:2 https://deb.beekeeperstudio.io stable/main amd64 Packages [4,806 B]

Шаг 6: Установите Beekeeper Studio

sudo apt install -y beekeeper-studio

Что делает: Устанавливает саму программу.

Шаг 7: Проверьте установку

apt-cache policy beekeeper-studio

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

beekeeper-studio:
  Installed: 5.x.x
  Candidate: 5.x.x
  Version table:
 *** 5.x.x 500
        500 https://deb.beekeeperstudio.io stable/main amd64 Packages
        100 /var/lib/dpkg/status

Способ 2: Установка из Flatpak (альтернатива)

Этот способ подойдёт, если вы уже используете Flatpak для других приложений или хотите изолированную установку.

Шаг 1: Установите Flatpak (если ещё не установлен)

Если Flatpak не установлен, сначала пройдите наше руководство по установке Flatpak на Debian.

Шаг 2: Добавьте репозиторий Flathub (если ещё не добавлен)

sudo flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Шаг 3: Проверьте, что Flathub доступен

flatpak remotes

✅ Ожидаемый вывод: Должна быть строка flathub system.

Шаг 4: Установите Beekeeper Studio

sudo flatpak install flathub io.beekeeperstudio.Studio -y

Шаг 5: Проверьте установку

flatpak info io.beekeeperstudio.Studio

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

Beekeeper Studio - The SQL Editor and Database Manager Of Your Dreams

          ID: io.beekeeperstudio.Studio
         Ref: app/io.beekeeperstudio.Studio/x86_64/stable
        Arch: x86_64
      Branch: stable
     Version: 5.x.x
      Origin: flathub
Installation: system

Запуск Beekeeper Studio

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

Для APT-версии:

beekeeper-studio

Для Flatpak-версии:

flatpak run io.beekeeperstudio.Studio

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

Найдите Beekeeper Studio в меню приложений (обычно в категории «Разработка» или «Утилиты»).

Решение типичных проблем

8.1 Ошибка: Duplicate repository warnings после установки APT-версии

Симптом: При sudo apt update появляется предупреждение о дублировании репозитория:

W: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list.d/beekeeper-studio-app.list:1 and /etc/apt/sources.list.d/beekeeper-studio.sources:1

Причина: Установщик Beekeeper Studio на Debian 12/11 создаёт старый файл beekeeper-studio-app.list в дополнение к нашему новому .sources-файлу.

Пошаговое решение:

Шаг 1: Удалите устаревший .list-файл:

sudo rm -f /etc/apt/sources.list.d/beekeeper-studio-app.list

Шаг 2: Обновите список пакетов:

sudo apt update

Шаг 3: Проверьте, что остался только один файл:

ls -1 /etc/apt/sources.list.d | grep beekeeper

✅ Ожидаемый вывод: beekeeper-studio.sources.

8.2 Ошибка: Missing X server или $DISPLAY

Симптом: При попытке запустить Beekeeper Studio из терминала появляется ошибка:

Missing X server or $DISPLAY

Причина: Вы пытаетесь запустить графическое приложение через SSH или в сессии без графической оболочки.

Пошаговое решение:

Шаг 1: Убедитесь, что вы находитесь в графической сессии (GNOME, KDE, Xfce и т.д.), а не в чистом терминале.

Шаг 2: Запускайте Beekeeper Studio из меню приложений или из терминала внутри графической сессии.

Шаг 3: Если вы подключаетесь по SSH с пробросом X11, убедитесь, что:

  • На клиенте (вашем компьютере) запущен X-сервер (например, XQuartz на macOS или Mobaxterm на Windows)
  • В SSH-подключении включён проброс: ssh -X user@server

8.3 Ошибка: SSH tunnel не работает

Симптом: Вы настроили SSH-подключение в Beekeeper Studio, но соединение с базой данных не устанавливается.

Причина: Beekeeper Studio не может подключиться через указанный SSH-хост (неверные данные, закрытый порт, проблемы с ключами).

Пошаговое решение:

Шаг 1: Убедитесь, что SSH-сервер на удалённой машине запущен и доступен:

ssh user@remote_host

Шаг 2: Проверьте, что Beekeeper Studio использует правильный порт (по умолчанию 22).

Шаг 3: Если вы используете ключи вместо пароля, убедитесь, что ключ добавлен в ~/.ssh/authorized_keys на удалённой машине.

Шаг 4: Для Flatpak-версии Beekeeper Studio доступ к SSH-сокету разрешён автоматически, но если вы используете кастомные ключи, они должны лежать в домашней директории (~/.ssh/).

8.4 Ошибка: Не удаётся подключиться к локальной базе данных

Симптом: Beekeeper Studio не может подключиться к базе данных, запущенной на том же компьютере (например, localhost:3306).

Причина: База данных не запущена, не принимает подключения или настроена только на сокет.

Пошаговое решение:

Шаг 1: Проверьте, что сервер базы данных запущен:

Для MariaDB/MySQL:

sudo systemctl status mariadb

Для PostgreSQL:

sudo systemctl status postgresql

Шаг 2: Если сервер запущен, но Beekeeper Studio не подключается — попробуйте использовать 127.0.0.1 вместо localhost (разное поведение с сокетами).

Шаг 3: Убедитесь, что вы создали пользователя и базу данных. Для MariaDB/MySQL:

sudo mariadb -e "CREATE USER 'myuser'@'localhost' IDENTIFIED BY 'mypassword'; CREATE DATABASE mydb; GRANT ALL ON mydb.* TO 'myuser'@'localhost'; FLUSH PRIVILEGES;"

8.5 Ошибка: Flatpak-версия не видит базу данных на хосте

Симптом: Flatpak-версия Beekeeper Studio не может подключиться к базе данных, которая запущена на том же компьютере (но вне Flatpak).

Причина: Flatpak-приложения изолированы и по умолчанию не видят сервисы хоста, кроме специально разрешённых.

Пошаговое решение:

Шаг 1: Проверьте, что Beekeeper Studio из Flatpak имеет доступ к сети. Обычно он есть, но убедиться можно:

flatpak info io.beekeeperstudio.Studio | grep sockets

Шаг 2: Если база данных слушает сокет (/var/run/mysqld/mysqld.sock), Beekeeper Studio из Flatpak не сможет его использовать. Переключитесь на TCP-подключение: в настройках укажите host: 127.0.0.1, а не localhost.

Шаг 3: Если проблема остаётся — установите APT-версию Beekeeper Studio, у неё нет таких ограничений.

Чек-лист: что проверить после установки

  • [ ] Репозиторий добавлен (для APT): apt-cache policy beekeeper-studio показывает версию из deb.beekeeperstudio.io
  • [ ] Пакет установлен: dpkg -s beekeeper-studio | grep Status (APT) или flatpak info io.beekeeperstudio.Studio (Flatpak)
  • [ ] Программа запускается: beekeeper-studio (APT) или flatpak run io.beekeeperstudio.Studio (Flatpak) открывает окно
  • [ ] Можно подключиться к БД: создайте тестовое подключение (например, к SQLite)
  • [ ] Для Debian 12/11: нет дублирующихся файлов репозитория (см. проблему 8.1)

Обновление Beekeeper Studio

Обновление APT-версии

sudo apt update && sudo apt install --only-upgrade beekeeper-studio -y

Обновление Flatpak-версии

sudo flatpak update io.beekeeperstudio.Studio -y

Удаление Beekeeper Studio

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

sudo apt remove beekeeper-studio -y
sudo rm -f /etc/apt/sources.list.d/beekeeper-studio.sources
sudo rm -f /etc/apt/sources.list.d/beekeeper-studio-app.list
sudo rm -f /usr/share/keyrings/beekeeper.gpg
sudo apt update

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

sudo flatpak remove io.beekeeperstudio.Studio -y

Удаление пользовательских данных (опционально — безвозвратно!)

Эти команды удаляют все сохранённые подключения, историю запросов и настройки Beekeeper Studio.

rm -rf ~/.config/beekeeper-studio/
rm -rf ~/.var/app/io.beekeeperstudio.Studio

Часто задаваемые вопросы (FAQ)

Вопрос: Beekeeper Studio бесплатен?
Ответ: Да, для обычного использования. Есть платная версия для команд (Beekeeper Studio Enterprise), но личная версия полностью бесплатна.

Вопрос: Какой способ установки лучше: APT или Flatpak?
Ответ: Оба работают отлично. APT даёт нативную интеграцию с системой, Flatpak — изоляцию и независимость от версий библиотек. Выбирайте тот, который вам привычнее.

Вопрос: Поддерживает ли Beekeeper Studio подключение через SSH-туннель?
Ответ: Да, и APT-версия, и Flatpak-версия поддерживают SSH-туннелирование (напрямую в интерфейсе подключения).

Вопрос: Какие базы данных поддерживаются?
Ответ: MySQL, MariaDB, PostgreSQL, SQLite, SQL Server, MongoDB, Redis, CockroachDB и другие.

Вопрос: Могу ли я использовать Beekeeper Studio для управления базами на удалённом сервере без прямого доступа, только через SSH?
Ответ: Да. В настройках подключения включите опцию «Use SSH Tunnel» и укажите данные SSH-сервера (хост, порт, пользователь, способ аутентификации).

Заключение

Теперь Beekeeper Studio установлен на вашем Debian. Вы можете:

  • Удобно управлять базами данных через графический интерфейс
  • Использовать SSH-туннели для доступа к удалённым базам
  • Сохранять часто используемые SQL-запросы
  • Работать с MySQL, PostgreSQL, SQLite и многими другими СУБД

Что дальше?

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