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

Joplin — это открытый менеджер заметок и задач, который хранит заметки в формате Markdown. Это делает их портативными и удобными для редактирования в любом текстовом редакторе. Joplin поддерживает сквозное шифрование и синхронизацию с облачными сервисами: Dropbox, Nextcloud, OneDrive, WebDAV и собственным Joplin Cloud. Это отличная приватная альтернатива Evernote или Notion. Сложность установки на Debian в том, что есть три способа, и для Debian 11 Joplin недоступен через extrepo (только Flatpak или официальный скрипт). Кроме того, для запуска AppImage на Debian 13 изменилось название пакета libfuse2 (теперь libfuse2t64).

💡 В этом руководстве вы установите Joplin на Debian. Мы разберём три способа: через extrepo (рекомендованный для Debian 12/13), через Flatpak (работает на всех версиях) и через официальный bash-скрипт (AppImage). Вы также узнаете, как обновлять Joplin, удалять и решать типичные проблемы.

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

  • Как установить Joplin через extrepo (рекомендовано для Debian 12/13)
  • Как установить Joplin через Flatpak (для всех версий Debian, включая 11)
  • Как установить Joplin через официальный bash-скрипт (AppImage)
  • Как запускать и обновлять Joplin разными способами
  • Как решить типичные проблемы: AppImage не запускается, ошибки синхронизации, права Flatpak

Для кого: пользователи Debian, которые ищут безопасную альтернативу Evernote, ведут заметки в Markdown, синхронизируют их между устройствами.

Оглавление

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. 📊 Сравнение способов установки Joplin

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

МетодКаналВерсияОбновленияПлюсыМинусы
extrepo
рекомендовано		Репозиторий
Joplin
(SourceForge)		Последняя
стабильная		Автоматически
через
apt upgrade		Интеграция
с APT,
простое
удаление		Не работает
на Debian 11
FlatpakFlathubПоследняя
стабильная		Автоматически
через
flatpak update		Изоляция,
работает на
всех версиях
Debian		Больше места,
sandbox
Официальный
bash-скрипт
(AppImage)		GitHubПоследняя
стабильная		Вручную
(перезапуск
скрипта)		Прямо от
разработчиков,
портативно		Нужно
вручную
обновлять,
требует
libfuse2

💡 Рекомендация: Если у вас Debian 12 или 13 — используйте extrepo (проще всего). Если Debian 11 — Flatpak (так как extrepo не поддерживает Joplin на 11-й версии). Официальный bash-скрипт подходит тем, кто хочет портативную версию (AppImage) и не боится обновлять вручную.

3. 📦 Способ 1: Установка Joplin через extrepo (рекомендовано для Debian 12/13)

extrepo — это официальный инструмент Debian для управления сторонними репозиториями. Он сам скачивает GPG-ключи и создаёт файлы репозиториев.

⚠️ Важно: Joplin недоступен в extrepo для Debian 11 (Bullseye). Используйте Flatpak или bash-скрипт.

3.1 Установка extrepo и включение репозитория Joplin

sudo apt install extrepo -y
sudo extrepo enable joplin

Что делает: Устанавливает extrepo и добавляет официальный репозиторий Joplin в источники APT.

3.2 Установка Joplin через APT

sudo apt update
sudo apt install joplin -y

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

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

apt-cache policy joplin

✅ Ожидаемый вывод в терминале (сокращённо):

joplin:
  Installed: 3.2.x
  Candidate: 3.2.x
  Version table:
 *** 3.2.x 500
        500 https://sourceforge.net/projects/joplin-desktop-linux-package/files/deb-repo packages/main amd64 Packages

4. 📦 Способ 2: Установка Joplin через Flatpak (для всех версий Debian)

Flatpak устанавливает Joplin в изолированную среду. Этот способ работает на всех версиях Debian (включая 11).

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

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

Что делает: Устанавливает Flatpak и добавляет репозиторий Flathub.

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

4.2 Установка Joplin из Flathub

sudo flatpak install flathub net.cozic.joplin_desktop -y

Что делает: Устанавливает Joplin из репозитория Flathub.

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

flatpak info net.cozic.joplin_desktop

✅ Ожидаемый вывод в терминале (сокращённо):

Joplin - open source note taking and to-do application

          ID: net.cozic.joplin_desktop
         Ref: app/net.cozic.joplin_desktop/x86_64/stable
     Version: 3.2.x

5. 📦 Способ 3: Установка Joplin через официальный bash-скрипт (AppImage)

Этот способ устанавливает Joplin в виде AppImage — одного исполняемого файла, который содержит всё приложение. Обновления — вручную (перезапуском скрипта).

5.1 Установка libfuse2 (зависимость для AppImage)

AppImage требуют библиотеку FUSE для запуска. Название пакета отличается в зависимости от версии Debian.

Для Debian 11 и 12:

sudo apt install libfuse2 -y

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

sudo apt install libfuse2t64 -y

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

5.2 Скачивание и выполнение установочного скрипта

wget -O - https://raw.githubusercontent.com/laurent22/joplin/dev/Joplin_install_and_update.sh | bash

Что делает: Скачивает официальный скрипт установки Joplin с GitHub и выполняет его. Скрипт создаст директорию ~/.joplin, скачает AppImage и создаст ярлык.

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

Downloading Joplin...
Downloaded Joplin 3.2.x

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

ls ~/.joplin

✅ Ожидаемый вывод: Файл Joplin.AppImage и другие вспомогательные файлы.

6. 🖥️ Запуск Joplin

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

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

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

Для extrepo / APT:

joplin-desktop

Для Flatpak:

flatpak run net.cozic.joplin_desktop

Для bash-скрипта (AppImage):

~/.joplin/Joplin.AppImage

7. 🔄 Обновление Joplin

Для extrepo (APT)

sudo apt update
sudo apt install --only-upgrade joplin -y

Для Flatpak

sudo flatpak update net.cozic.joplin_desktop

Для bash-скрипта (AppImage)

Просто повторно выполните скрипт:

wget -O - https://raw.githubusercontent.com/laurent22/joplin/dev/Joplin_install_and_update.sh | bash

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

8.1 Ошибка: AppImage не запускается (FUSE-related)

Симптом: При попытке запустить ~/.joplin/Joplin.AppImage ничего не происходит или появляется ошибка:

fuse: failed to exec fusermount: Permission denied

Причина: Отсутствует или неправильно установлена библиотека libfuse2.

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

Шаг 1: Проверьте, установлена ли библиотека:

ldconfig -p | grep libfuse.so.2

Если вывода нет — библиотека не установлена.

Шаг 2: Установите правильный пакет для вашей версии Debian:

Debian 11 и 12:

sudo apt install libfuse2 -y

Debian 13:

sudo apt install libfuse2t64 -y

Шаг 3: Повторите попытку запуска AppImage.

8.2 Ошибка: Joplin недоступен в extrepo на Debian 11

Симптом: sudo extrepo enable joplin выдаёт ошибку или Joplin не находится в списке.

Причина: В extrepo для Debian 11 (Bullseye) Joplin действительно отсутствует.

Решение: Используйте Flatpak или официальный bash-скрипт для Debian 11.

8.3 Ошибка синхронизации с Nextcloud / WebDAV

Симптом: Joplin не может подключиться к Nextcloud, Dropbox или другому облачному сервису.

Причина: Проблемы с сетью, неверный URL WebDAV, или фаервол блокирует соединение.

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

Шаг 1: Проверьте, что URL WebDAV в настройках Joplin указан верно. Для Nextcloud обычно: https://ваш-сервер/nextcloud/remote.php/webdav/

Шаг 2: Убедитесь, что ваше устройство имеет доступ к интернету.

Шаг 3: Если используется синхронизация с файловой системой (например, через Nextcloud client), проверьте права на директорию.

8.4 Flatpak: Joplin не видит файлы за пределами домашней директории

Симптом: В Joplin, установленном через Flatpak, вы не можете выбрать папку для экспорта/импорта за пределами вашей домашней директории.

Причина: Flatpak изолирует приложения. По умолчанию Joplin видит только домашнюю папку пользователя.

Решение: Добавьте доступ к нужной директории с помощью flatpak override:

flatpak override --user net.cozic.joplin_desktop --filesystem=/путь/к/директории

Пример для доступа к /mnt/notes:

flatpak override --user net.cozic.joplin_desktop --filesystem=/mnt/notes

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

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

sudo apt remove --purge joplin -y
sudo apt autoremove -y
sudo extrepo disable joplin
sudo apt update

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

sudo flatpak uninstall net.cozic.joplin_desktop -y
sudo flatpak uninstall --unused -y

Удаление пользовательских данных Flatpak (опционально):

rm -rf ~/.var/app/net.cozic.joplin_desktop

Удаление bash-скрипта (AppImage)

rm -rf ~/.joplin
rm -rf ~/.config/joplin-desktop
rm -rf ~/.config/Joplin
rm -f ~/.local/share/applications/appimagekit-joplin.desktop

⚠️ Осторожно: Эти команды удаляют все заметки, настройки и привязанные файлы. Если хотите сохранить заметки, сделайте экспорт из Joplin перед удалением.

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

  • [ ] Система обновлена (sudo apt update && sudo apt upgrade -y)
  • [ ] Выбран и выполнен один из способов установки (extrepo / Flatpak / bash-скрипт)
  • [ ] Joplin запускается из меню приложений или терминала
  • [ ] (Для AppImage) libfuse2 или libfuse2t64 установлены
  • Настроена синхронизация с облачным сервисом

Заключение

Вы установили Joplin на Debian. Если вы использовали extrepo (на Debian 12/13) — получили интеграцию с APT и автоматические обновления. Если выбрали Flatpak — получили изолированную среду, работающую на всех версиях Debian, включая 11. Если выбрали официальный bash-скрипт — получили портативную AppImage, которую можно запускать с флешки, но обновлять придётся вручную. Главное, что нужно запомнить: для Debian 11 extrepo не подходит, используйте Flatpak или скрипт. Для AppImage на Debian 13 нужен libfuse2t64 (а не libfuse2).

Что дальше:

  • Настройте синхронизацию с Nextcloud, Dropbox или Joplin Cloud
  • Установите браузерное расширение Joplin Web Clipper для сохранения страниц
  • Изучите возможности плагинов и тем оформления
  • Настройте шифрование заметок в настройках Joplin (End-to-End Encryption)

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