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

GitHub Desktop — это графическое приложение, которое упрощает работу с Git-репозиториями. Вместо запоминания команд командной строки вы можете клонировать репозитории, создавать ветки, делать коммиты и отправлять изменения на GitHub через визуальный интерфейс.

💡 Важно: Официальный GitHub Desktop от GitHub поддерживает только Windows и macOS.
На Linux используется форк shiftkey/desktop — это открытое сообщественное решение, которое поддерживается разработчиком shiftkey и сообществом. Функционал может незначительно отличаться от официальной версии для Windows/macOS, но все основные возможности работы с репозиториями доступны.

В этом руководстве мы рассмотрим четыре способа установки: через APT-репозиторий (рекомендуется), вручную через .deb-пакет, через Flatpak и через AppImage. Выберите тот, который лучше всего подходит для вашего рабочего процесса.

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

  • Как установить GitHub Desktop через APT-репозиторий (проще всего)
  • Как установить вручную через .deb-пакет
  • Как установить через Flatpak (песочница)
  • Как запустить через AppImage без установки
  • Как обновлять и удалять приложение
  • Как решить типичные проблемы (зависимости, AppImage, аутентификация)

Для кого: новички в Git (нужен визуальный интерфейс), разработчики, которые хотят упростить работу с репозиториями, пользователи Debian 11, 12 и 13.

Оглавление

Оглавление

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

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

  • У вас установлена Debian 11, 12 или 13 (любая редакция)
  • Подключение к интернету стабильно
  • У вас есть учётная запись GitHub (для входа в приложение)

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

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

sudo -l

Что делает: Проверяет, есть ли у текущего пользователя права суперпользователя.

⚠️ Пароль при первом запуске! В зависимости от настроек в /etc/sudoers, при первом выполнении sudo -l в текущей сессии система может запросить ваш пароль (если не активировано правило NOPASSWD).

✅ Ожидаемый результат: Список разрешённых команд. Если видите (ALL : ALL) ALL — у вас полный доступ.

❌ Если видите ошибку user is not in the sudoers file или may not run sudo — сначала пройдите наше руководство по настройке sudo. Без этого дальнейшие шаги не сработают.

Проверка архитектуры системы

GitHub Desktop доступен для 64-битных систем (amd64/x86_64), а также для ARM64 и ARMHF. Проверьте вашу архитектуру. Выполните в терминале:

dpkg --print-architecture

✅ Ожидаемый вывод: amd64 (для большинства компьютеров), arm64 (для Raspberry Pi 4/5) или armhf (для старых ARM-устройств).

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

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

sudo apt update
sudo apt upgrade

Что делает:

  • sudo — права суперпользователя
  • apt update — обновляет список доступных пакетов
  • apt upgrade — обновляет все установленные пакеты

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

💡 Примечание: Флаг -y автоматически подтверждает все действия. В обучающих инструкциях его лучше не использовать: так вы видите список пакетов и можете отменить установку, если что-то выглядит подозрительно. Если вы уверены в своих действиях, можно добавить -y.

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

МетодИсточникОбновленияДля кого
APT
(рекомендуемый)		Mwt Mirror (зеркало)Автоматически через
apt upgrade		Большинство
пользователей, кто хочет
автоматических
обновлений
Ручной .debGitHub ReleasesВручнуюПользователи, которые
хотят контролировать
версии
FlatpakFlathubАвтоматически через
flatpak update		Пользователи, которые
предпочитают песочницу
AppImageGitHub ReleasesВручнуюТестирование или запуск
без установки

💡 Рекомендация: Для большинства пользователей подойдёт метод APT — приложение будет обновляться вместе с системой.

⚠️ Важно: Mwt Mirror — это стороннее зеркало репозитория shiftkey/desktop. Используйте его на свой страх и риск; для большей прозрачности можно ставить напрямую из релизов (через .deb или AppImage).

3. 📦 Способ 1: Установка через APT-репозиторий (рекомендуемый)

Этот метод интегрирует GitHub Desktop в вашу систему. Обновления будут приходить автоматически через стандартные команды apt upgrade.

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

Выполните в терминале:

sudo apt install curl gnupg

Что делает:

  • curl — утилита для скачивания файлов
  • gnupg — инструмент для работы с GPG-ключами

Зачем: Эти пакеты нужны для безопасного импорта GPG-ключа репозитория.

3.2 Импорт GPG-ключа и добавление репозитория Mwt Mirror

Mwt Mirror — это зеркало официального репозитория shiftkey/desktop с корректными SSL-сертификатами. Выполните в терминале:

curl -fsSL https://mirror.mwt.me/shiftkey-desktop/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/mwt-desktop.gpg

Что делает:

  • curl -fsSL — скачивает GPG-ключ тихо, с обработкой ошибок
  • gpg --dearmor — преобразует ключ из текстового формата в бинарный
  • -o /usr/share/keyrings/mwt-desktop.gpg — сохраняет ключ в стандартную директорию

Зачем: Бинарный формат ключа требуется для корректной работы APT с опцией Signed-By.

3.3 Создание конфигурации репозитория

Выполните в терминале:

ARCH=$(dpkg --print-architecture)
sudo tee /etc/apt/sources.list.d/mwt-desktop.sources > /dev/null <<EOF
Types: deb
URIs: https://mirror.mwt.me/shiftkey-desktop/deb/
Suites: any
Components: main
Architectures: ${ARCH}
Signed-By: /usr/share/keyrings/mwt-desktop.gpg
EOF

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

Зачем: Формат .sources является современным стандартом Debian и обеспечивает явную привязку ключа к репозиторию.

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

Выполните в терминале:

sudo apt update
sudo apt install github-desktop

Что делает: Устанавливает GitHub Desktop из добавленного репозитория.

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

Выполните в терминале:

apt show github-desktop | grep Version

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

Version: 3.4.13-linux1

(Версия может отличаться — это актуальная версия на момент установки)

4. 📦 Способ 2: Установка вручную через .deb-пакет

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

4.1 Скачивание .deb-пакета

Посетите страницу релизов shiftkey/desktop и найдите актуальную версию. Затем выполните в терминале, заменив значение переменной VERSION на актуальную версию со страницы релизов:

VERSION="3.4.13-linux1"  # Замените на актуальную версию
ARCH=$(dpkg --print-architecture)
wget "https://github.com/shiftkey/desktop/releases/download/release-${VERSION}/GitHubDesktop-linux-${ARCH}-${VERSION}.deb"

Что делает:

  • VERSION="..." — переменная с номером версии (замените на актуальную)
  • ARCH=$(dpkg --print-architecture) — определяет архитектуру системы
  • wget — скачивает .deb-пакет под вашу архитектуру

Зачем: Ручное скачивание позволяет установить точную версию, которая вам нужна.

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

Выполните в терминале:

sudo apt install "./GitHubDesktop-linux-${ARCH}-${VERSION}.deb"

Что делает: Устанавливает .deb-пакет с автоматическим разрешением зависимостей.

Зачем: Использование apt install вместо dpkg -i автоматически подтянет все необходимые зависимости.

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

Выполните в терминале:

apt show github-desktop | grep Version

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

Version: 3.4.13-linux1

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

Flatpak устанавливает GitHub Desktop в изолированную среду (песочницу). Это хороший выбор, если вы хотите изолировать приложение от системы.

⚠️ Важно: Команды flatpak выполняются без sudo. Установка идёт в пользовательское пространство. Если добавить sudo, могут возникнуть проблемы с правами на данные приложения.

⚠️ Перед установкой: Убедитесь, что Flatpak установлен. Если нет — пройдите наше руководство по установке Flatpak на Debian.

5.1 Добавление репозитория Flathub

Выполните в терминале:

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

Что делает: Добавляет репозиторий Flathub, если он ещё не добавлен.

5.2 Установка GitHub Desktop

Выполните в терминале:

flatpak install flathub io.github.shiftkey.Desktop

Что делает: Устанавливает GitHub Desktop из Flathub.

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

Выполните в терминале:

flatpak info io.github.shiftkey.Desktop | grep Version

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

Version: 3.4.13-linux1

Альтернативная проверка (просто увидеть, что пакет есть):

flatpak list | grep -i github

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

GitHub Desktop    io.github.shiftkey.Desktop    3.4.13    system

6. 📦 Способ 4: Запуск через AppImage (без установки)

AppImage — это портативный формат, который не требует установки. Подходит для тестирования или если у вас нет прав sudo.

6.1 Установка зависимостей для AppImage

AppImage требует библиотеку FUSE для монтирования и запуска. Выполните в терминале:

Для Debian 11 (Bullseye) и Debian 12 (Bookworm):

sudo apt install libfuse2

Для Debian 13 (Trixie) и новее:

sudo apt install libfuse2t64

Что делает: Устанавливает библиотеку FUSE, необходимую для работы AppImage.

💡 Примечание: libfuse2t64 — это переходный пакет для Debian 13. В будущих версиях Debian название может измениться.

6.2 Скачивание и запуск AppImage

Выполните в терминале, заменив значение переменной VERSION на актуальную версию со страницы релизов:

VERSION="3.4.13-linux1"  # Замените на актуальную версию
ARCH=$(dpkg --print-architecture)
wget "https://github.com/shiftkey/desktop/releases/download/release-${VERSION}/GitHubDesktop-linux-${ARCH}-${VERSION}.AppImage"
chmod +x "GitHubDesktop-linux-${ARCH}-${VERSION}.AppImage"
./"GitHubDesktop-linux-${ARCH}-${VERSION}.AppImage"

Что делает:

  • wget — скачивает AppImage под вашу архитектуру
  • chmod +x — делает файл исполняемым
  • ./...AppImage — запускает приложение

Зачем: AppImage не требует установки и может быть запущен с любого носителя (флешка, внешний диск).

7. 🖱️ Запуск GitHub Desktop

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

Для APT и .deb, выполните в терминале:

github-desktop

Для Flatpak, выполните в терминале:

flatpak run io.github.shiftkey.Desktop

Для AppImage: Запускается из той директории, где находится файл.

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

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

💡 Если иконка не появилась:

  • Для APT и .deb: можно обновить кэш меню. Выполните в терминале:
  sudo update-desktop-database
  • Для Flatpak: кэш обновляется автоматически. Если иконки нет — выйдите из системы и зайдите снова.

8. 🔄 Обновление GitHub Desktop

8.1 Обновление через APT

Выполните в терминале:

sudo apt update
sudo apt upgrade

Или обновить только GitHub Desktop:

sudo apt update
sudo apt install --only-upgrade github-desktop

8.2 Обновление через Flatpak

Выполните в терминале:

flatpak update io.github.shiftkey.Desktop

8.3 Обновление .deb или AppImage

Скачайте новую версию со страницы релизов и повторите шаги установки.

9. ❌ Удаление GitHub Desktop

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

Выполните в терминале:

sudo apt remove github-desktop
sudo apt autoremove
sudo rm -f /etc/apt/sources.list.d/mwt-desktop.sources
sudo rm -f /usr/share/keyrings/mwt-desktop.gpg
sudo apt update

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

Выполните в терминале:

flatpak uninstall io.github.shiftkey.Desktop
flatpak uninstall --unused

9.3 Удаление .deb-версии

Выполните в терминале:

sudo apt remove github-desktop
sudo apt autoremove

9.4 Удаление AppImage

Просто удалите файл. Выполните в терминале:

rm GitHubDesktop-linux-*.AppImage

💡 Примечание: Если у вас в текущей директории несколько версий AppImage, эта команда удалит их все. Чтобы удалить только конкретную версию, укажите полное имя файла.

9.5 Удаление пользовательских данных

⚠️ Внимание: Следующие команды безвозвратно удаляют ваши сохранённые учётные данные, настройки репозиториев и кэш.

Для APT, .deb и AppImage, выполните в терминале:

rm -rf "~/.config/GitHub Desktop"
rm -rf "~/.cache/GitHub Desktop"

Для Flatpak, выполните в терминале:

rm -rf ~/.var/app/io.github.shiftkey.Desktop

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

10.1 Ошибка зависимостей при установке .deb

Симптом: dpkg -i завершается с ошибкой «dependency problems» или «unmet dependencies».

Решение: Используйте APT для установки .deb-пакета. Выполните в терминале:

sudo apt install ./GitHubDesktop-*.deb

Если уже установили через dpkg и видите ошибки зависимостей:

sudo apt -f install

10.2 Ошибка GPG-ключа или репозитория

Симптом: apt update показывает ошибку «repository not found» или GPG key errors.

Решение: Проверьте, что GPG-ключ скачан корректно. Выполните в терминале:

ls -la /usr/share/keyrings/mwt-desktop.gpg

Если файл отсутствует или повреждён, переустановите ключ и репозиторий:

sudo rm -f /usr/share/keyrings/mwt-desktop.gpg
sudo rm -f /etc/apt/sources.list.d/mwt-desktop.sources
# Затем повторите шаги 3.2 и 3.3
sudo apt update

10.3 AppImage не запускается (FUSE ошибка)

Симптом: Двойной клик по AppImage не работает, или терминал показывает «permission denied» или «FUSE» ошибки.

Решение: Убедитесь, что файл исполняемый. Выполните в терминале:

chmod +x GitHubDesktop-linux-*.AppImage

Установите библиотеку FUSE для вашей версии Debian (см. раздел 6.1). Запустите AppImage из терминала, чтобы увидеть подробную ошибку:

./GitHubDesktop-linux-*.AppImage

10.4 GitHub Desktop не появляется в меню приложений

Симптом: Установка завершена успешно, но приложения нет в меню.

Решение: Обновите базу данных рабочего стола и проверьте, что бинарный файл существует. Выполните в терминале:

sudo update-desktop-database
which github-desktop

Если бинарный файл есть, но меню не обновилось — выйдите из системы и зайдите снова.

10.5 Ошибка аутентификации или входа в GitHub

Симптом: Не удаётся войти в учётную запись GitHub, аутентификация не проходит.

Решение: Проверьте интернет-соединение, настройки DNS, файрвол и прокси. Если всё в порядке, проверьте системное время. Выполните в терминале:

timedatectl status | grep -E 'Local time|synchronized'

Если часы не синхронизированы:

sudo timedatectl set-ntp true

Если используете SSH-ключи, убедитесь, что они настроены правильно и имеют корректные права доступа.

10.6 Ошибка клонирования или синхронизации репозиториев

Симптом: Клонирование репозиториев не удаётся с ошибками сети, прав доступа или SSL-сертификатов.

Решение: Проверьте базовое подключение к Git. Выполните в терминале:

git ls-remote https://github.com/octocat/Hello-World.git

Если команда не выполняется, проверьте настройки сети и файрвола.

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

  • [ ] GitHub Desktop установлен: версия видна через apt show github-desktop | grep Version (APT) или flatpak info io.github.shiftkey.Desktop | grep Version (Flatpak)
  • [ ] Приложение запускается из терминала (github-desktop или flatpak run io.github.shiftkey.Desktop)
  • [ ] Иконка есть в меню приложений (или вы смогли запустить через терминал, если у вас минималистичное окружение)
  • [ ] Вы вошли в учётную запись GitHub и интерфейс приложения загружается без ошибок
  • [ ] Можете клонировать тестовый репозиторий (например, Hello-World)
  • [ ] Обновление проходит без ошибок: sudo apt upgrade (для APT) или flatpak update (для Flatpak)

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

Вопрос: Это официальная версия GitHub Desktop?
Ответ: Нет, это форк shiftkey/desktop, который поддерживается сообществом. Официальный GitHub Desktop от GitHub доступен только для Windows и macOS. Форк имеет открытый исходный код и активно развивается.

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

Вопрос: Безопасно ли использовать Mwt Mirror?
Ответ: Mwt Mirror — это стороннее зеркало, которое упрощает установку через APT. Если вы хотите полной прозрачности, используйте установку через .deb-пакет или AppImage напрямую с GitHub Releases.

Вопрос: Почему GitHub Desktop не видит мои SSH-ключи?
Ответ: Убедитесь, что SSH-ключи добавлены в агент (ssh-add -l) и имеют правильные права (chmod 600 ~/.ssh/id_rsa). Также проверьте, что в настройках GitHub Desktop выбран правильный метод аутентификации.

Вопрос: Можно ли использовать GitHub Desktop с GitLab или Bitbucket?
Ответ: GitHub Desktop официально ориентирован на GitHub. Он может технически работать с другими платформами (через HTTPS/SSH), но многие функции (например, пул-реквесты, issues, интеграции) будут недоступны. Для других платформ лучше использовать универсальные клиенты (GitKraken, Sourcetree и т.п.) или работать через консоль.

Заключение

Вы успешно установили GitHub Desktop на Debian. Теперь у вас есть графический интерфейс для работы с Git-репозиториями: клонирование, создание веток, коммиты, пул-реквесты — всё без необходимости запоминать команды командной строки.

Что дальше:

  • Настройте Git с вашим именем и email: git config --global user.name "Ваше Имя" и git config --global user.email "your-email@example.com"
  • Клонируйте тестовый репозиторий через интерфейс GitHub Desktop, чтобы убедиться, что всё работает
  • Изучите официальную документацию GitHub Desktop

Связанные статьи:

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