Установка 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), через официальный DEB-пакет с GitHub, через Flatpak (работает на всех версиях) и через официальный bash-скрипт (AppImage). Вы также узнаете, как обновлять Joplin, удалять и решать типичные проблемы.

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

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

Оглавление

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

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

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

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

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

sudo whoami

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

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

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

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

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

sudo apt update && sudo apt upgrade -y

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

1.2 Установка вспомогательных пакетов (для DEB-метода)

sudo apt install -y ca-certificates wget jq

Что делает: Устанавливает утилиты для скачивания файлов и парсинга JSON.

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

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

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

💡 Рекомендация:

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

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

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

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

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: Установка через официальный DEB-пакет (Debian 12/13)

Этот метод скачивает .deb-пакет напрямую с GitHub Releases и устанавливает его через APT. Подходит для тех, кто не хочет добавлять сторонний репозиторий.

⚠️ Важно: Этот метод работает только на Debian 12 и 13. Для Debian 11 используйте Flatpak или официальный скрипт.

4.1 Создание скрипта для установки/обновления

mkdir -p "$HOME/.local/bin"

cat > "$HOME/.local/bin/update-joplin-deb" << 'EOF'
#!/usr/bin/env bash
set -euo

for cmd in apt-get dpkg dpkg-deb dpkg-query jq mktemp sudo wget; do
  if ! command -v "$cmd" >/dev/null 2>&1; then
    printf 'Missing required command: %s\n' "$cmd" >&2
    exit 1
  fi
done

tmp_dir="$(mktemp -d)"
cleanup() {
  rm -rf -- "$tmp_dir"
}
trap cleanup EXIT

release_json="$(wget -qO- https://api.github.com/repos/laurent22/joplin/releases/latest)"
deb_url="$(jq -r 'first(.assets[]? | select((.name | startswith("Joplin-")) and (.name | endswith(".deb"))) | .browser_download_url) // empty' <<<"$release_json")"

if [ -z "$deb_url" ]; then
  printf 'No Joplin .deb asset found in the latest release.\n' >&2
  exit 1
fi

deb_file="$tmp_dir/joplin-latest.deb"
wget -q --show-progress -O "$deb_file" "$deb_url"

package_name="$(dpkg-deb -f "$deb_file" Package)"
package_arch="$(dpkg-deb -f "$deb_file" Architecture)"
package_version="$(dpkg-deb -f "$deb_file" Version)"
system_arch="$(dpkg --print-architecture)"

if [ "$package_name" != "joplin" ]; then
  printf 'Downloaded package name was %s, not joplin.\n' "$package_name" >&2
  exit 1
fi

if [ "$package_arch" != "$system_arch" ]; then
  printf 'Downloaded package architecture %s does not match this system (%s).\n' "$package_arch" "$system_arch" >&2
  exit 1
fi

installed_version="$(dpkg-query -W -f='${Version}' joplin 2>/dev/null || true)"

printf 'Resolved Joplin package for %s (version %s).\n' "$package_arch" "$package_version"

if [ "$installed_version" = "$package_version" ]; then
  printf 'Joplin is already current.\n'
  exit 0
fi

printf 'Installing or updating Joplin with APT.\n'
sudo apt-get install "$deb_file"
EOF

chmod +x "$HOME/.local/bin/update-joplin-deb"

Что делает: Создаёт скрипт, который автоматически определяет последнюю версию Joplin на GitHub, скачивает .deb-пакет и устанавливает его через APT.

4.2 Добавление PATH (для текущей сессии)

case ":$PATH:" in
  *":$HOME/.local/bin:"*) ;;
  *) export PATH="$HOME/.local/bin:$PATH" ;;
esac

4.3 Запуск установки

update-joplin-deb

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

Resolved Joplin package for amd64 (version 3.2.x).
Installing or updating Joplin with APT.

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

dpkg-query -W -f='${db:Status-Abbrev} ${Package} ${Architecture}\n' joplin

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

5. 📦 Способ 3: Установка через Flatpak (Debian 11, 12, 13)

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

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

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

sudo flatpak install flathub net.cozic.joplin_desktop -y

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

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

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

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

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

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

Для Debian 11 и 12:

sudo apt install libfuse2 -y

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

sudo apt install libfuse2t64 -y

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

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

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

test -x "$HOME/.joplin/Joplin.AppImage" && echo "Joplin AppImage installed"

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

7. 🖥️ Запуск Joplin

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

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

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

Способ установкиКоманда запуска
extrepo / APTjoplin-desktop
DEB-пакет (GitHub)joplin
Flatpakflatpak run net.cozic.joplin_desktop
bash-скрипт (AppImage)~/.joplin/Joplin.AppImage

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

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

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

Обновление DEB-версии (GitHub)

update-joplin-deb

Обновление 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

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

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

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

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

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

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

9.3 Ошибка: DEB-скрипт не может определить архитектуру

Симптом: Скрипт update-joplin-deb выдаёт ошибку о несоответствии архитектуры.

Причина: Скрипт рассчитан на amd64. На ARM-системах не работает.

Решение: Используйте Flatpak (поддерживает aarch64) или официальный bash-скрипт.

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

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

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

Решение:

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

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

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

9.5 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

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

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

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

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

sudo apt remove joplin -y
sudo apt autoremove -y
rm -f "$HOME/.local/bin/update-joplin-deb"

Удаление 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 перед удалением.

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

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

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

Вопрос: Какой способ установки выбрать на Debian 12/13?
Ответ: extrepo — самый простой, даёт автоматические обновления через APT. DEB-пакет — альтернатива без добавления репозитория.

Вопрос: Какой способ установки выбрать на Debian 11?
Ответ: Flatpak (работает на всех версиях) или официальный bash-скрипт (AppImage). extrepo не поддерживает Joplin на Debian 11.

Вопрос: Joplin бесплатен?
Ответ: Да, Joplin полностью бесплатен и с открытым исходным кодом.

Вопрос: Могу ли я синхронизировать заметки между устройствами?
Ответ: Да, Joplin поддерживает синхронизацию через Dropbox, Nextcloud, OneDrive, WebDAV и Joplin Cloud.

Вопрос: Поддерживает ли Joplin шифрование?
Ответ: Да, Joplin поддерживает сквозное шифрование (End-to-End Encryption) для заметок и вложений.

Вопрос: В чём разница между joplin и joplin-desktop?
Ответ: joplin-desktop — это графическое приложение (DEB/AppImage/Flatpak). joplin (в терминале) — это CLI-версия, которая устанавливается через npm.

13. 🏁 Заключение

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

Что дальше?

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

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