Установка 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:

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

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

Оглавление

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

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

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

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

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

sudo whoami

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

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

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

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

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

sudo apt update && sudo apt upgrade -y

Что делает: Обновляет список пакетов и устанавливает последние обновления.

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

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

2.1 Установка зависимостей

sudo apt install -y ca-certificates curl gpg

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

2.2 Добавление 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 — сохраняет ключ в системную директорию

2.3 Добавление репозитория Beekeeper Studio

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

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

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

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]

2.5 Установка Beekeeper Studio

sudo apt install -y beekeeper-studio

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

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

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

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

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

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

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

3.2 Добавление репозитория Flathub (если ещё не добавлен)

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

3.3 Проверка, что Flathub доступен

flatpak remotes

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

3.4 Установка Beekeeper Studio

sudo flatpak install flathub io.beekeeperstudio.Studio -y

3.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

4. 🖥️ Запуск Beekeeper Studio

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

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

beekeeper-studio

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

flatpak run io.beekeeperstudio.Studio

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

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

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

5.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: Если остался устаревший ключ в связке apt-key, удалите его:

if command -v apt-key >/dev/null 2>&1 && sudo apt-key list 2>/dev/null | grep -q 'AD1B 460B'; then
    sudo apt-key del AD1B460B
fi

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

sudo apt update

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

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

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

5.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

5.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/).

5.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;"

5.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, у неё нет таких ограничений.

6. 🔄 Обновление Beekeeper Studio

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

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

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

sudo flatpak update io.beekeeperstudio.Studio -y

7. ❌ Удаление 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

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

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

9. ❓ Часто задаваемые вопросы (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 ARM64 (Raspberry Pi)?
Ответ: Да, начиная с версии 5.x, официальный APT-репозиторий Beekeeper Studio поддерживает архитектуру arm64.

Заключение

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

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

Что дальше?

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