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

Waterfox — это браузер, основанный на Firefox, но с выключенной телеметрией, улучшенной приватностью (DNS-over-HTTPS через приватные реле) и встроенной блокировкой баннеров с cookie. При этом он полностью совместим с расширениями из магазина Firefox. Главная сложность при установке на Debian: Waterfox не предоставляет официального .deb-пакета, а старый сторонний APT-репозиторий больше не поддерживается. Поэтому остаются два способа: Flatpak (рекомендованный) и установка из tarball (портативная версия).

💡 В этом руководстве вы установите Waterfox на Debian двумя способами: через Flatpak (рекомендовано, с автоматическими обновлениями) и через официальный tarball (портативная версия, обновление вручную). Вы также узнаете, как создать скрипт для обновления tarball-версии и решать типичные проблемы.

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

  • Как установить Waterfox через Flatpak (рекомендованный способ)
  • Как установить Waterfox из официального tarball (портативная версия)
  • Как создать ярлык для tarball-версии
  • Как создать скрипт для автоматического обновления tarball-версии
  • Как решить типичные проблемы: браузер не запускается, ошибки Flatpak

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

Оглавление

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

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

МетодКаналВерсияОбновленияПлюсыМинусы
Flatpak
рекомендовано		FlathubПоследняя
стабильная		Автоматически
через
flatpak update		Изоляция,
автоматические
обновления,
простота		Требует
установки
Flatpak,
больше места
Tarball
(портативная)		GitHubПоследняя
стабильная		Вручную
(перекачка
или скрипт)		Портативность,
прямой доступ
к новым
версиям		Нужно
вручную
обновлять,
нужно
создавать
ярлык

💡 Рекомендация: Для большинства пользователей подойдёт Flatpak. Он даёт автоматические обновления, изоляцию и простоту установки. Tarball выбирайте, если вам нужна портативная версия (можно запускать с флешки) или вы хотите получить новую версию сразу после выхода, до того как она появится в Flathub.

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

Этот способ подходит для большинства пользователей. Flatpak устанавливает Waterfox в изолированную среду и автоматически обновляет его.

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

3.2 Установка Waterfox из Flathub

sudo flatpak install flathub net.waterfox.waterfox -y

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

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

flatpak list --app | grep -i waterfox

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

Waterfox    net.waterfox.waterfox    6.6.x    stable    system

3.4 Запуск Waterfox

Из терминала:

flatpak run net.waterfox.waterfox

Из меню приложений: Нажмите Super (клавиша с логотипом Windows), введите Waterfox, нажмите на иконку.

4. 📦 Способ 2: Установка Waterfox из tarball (портативная версия)

Этот способ подходит, если вы хотите получить портативную версию или получить новую версию сразу после выхода.

4.1 Установка вспомогательных утилит

sudo apt install curl tar bzip2 -y

Что делает: Устанавливает curl (для скачивания), tar и bzip2 (для распаковки).

4.2 Определение последней версии и скачивание

LATEST_VERSION=$(curl -s https://api.github.com/repos/BrowserWorks/Waterfox/releases/latest | grep -oP '"tag_name": "\K[^"]+')
echo "Последняя версия: $LATEST_VERSION"
DOWNLOAD_URL="https://cdn1.waterfox.net/waterfox/releases/${LATEST_VERSION}/Linux_x86_64/waterfox-${LATEST_VERSION}.tar.bz2"
curl -Lo /tmp/waterfox-${LATEST_VERSION}.tar.bz2 "$DOWNLOAD_URL"

Что делает: Запрашивает GitHub API для получения последней версии, формирует URL и скачивает tarball во временную директорию.

4.3 Распаковка в /opt

sudo tar -xjf /tmp/waterfox-${LATEST_VERSION}.tar.bz2 -C /opt

Что делает: Распаковывает Waterfox в директорию /opt/waterfox.

4.4 Создание символической ссылки

sudo ln -sf /opt/waterfox/waterfox /usr/local/bin/waterfox

Что делает: Создаёт символическую ссылку, чтобы можно было запускать Waterfox командой waterfox из любого места.

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

waterfox --version

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

BrowserWorks Waterfox 6.6.x

4.6 Создание ярлыка для меню приложений

sudo tee /usr/share/applications/waterfox.desktop > /dev/null << 'EOF'
[Desktop Entry]
Name=Waterfox
Comment=Privacy-focused web browser
Exec=/opt/waterfox/waterfox %u
Terminal=false
Type=Application
Icon=/opt/waterfox/browser/chrome/icons/default/default128.png
Categories=Network;WebBrowser;
MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/vnd.mozilla.xul+xml;x-scheme-handler/http;x-scheme-handler/https;
StartupNotify=true
StartupWMClass=Waterfox
EOF

sudo update-desktop-database

Что делает: Создаёт файл .desktop, чтобы Waterfox появился в меню приложений.

5. 🔄 Обновление tarball-версии (скрипт)

Tarball-версия не обновляется автоматически. Вот скрипт, который проверяет наличие новой версии и обновляет её.

Создание скрипта (Вставьте в терминал следующий код и запустите):

cat > ~/update-waterfox.sh << 'EOF'
#!/bin/bash
set -e

echo "Проверка последней версии Waterfox..."
LATEST_VERSION=$(curl -s https://api.github.com/repos/BrowserWorks/Waterfox/releases/latest | grep -oP '"tag_name": "\K[^"]+')

if [ -z "$LATEST_VERSION" ]; then
    echo "Ошибка: не удалось получить последнюю версию с GitHub"
    exit 1
fi

CURRENT_VERSION=$(waterfox --version 2>/dev/null | grep -oP '\d+\.\d+\.\d+' || echo "Не установлен")
echo "Текущая версия: $CURRENT_VERSION"
echo "Последняя версия: $LATEST_VERSION"

if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
    echo "Waterfox уже последней версии."
    exit 0
fi

echo "Скачивание Waterfox $LATEST_VERSION..."
DOWNLOAD_URL="https://cdn1.waterfox.net/waterfox/releases/${LATEST_VERSION}/Linux_x86_64/waterfox-${LATEST_VERSION}.tar.bz2"
TEMP_DIR=$(mktemp -d)
cd "$TEMP_DIR"
curl -Lo waterfox.tar.bz2 "$DOWNLOAD_URL"

echo "Распаковка в /opt/waterfox..."
sudo tar -xjf waterfox.tar.bz2 -C /opt

echo "Очистка временных файлов..."
cd ~
rm -rf "$TEMP_DIR"

echo "Обновление завершено! Waterfox $LATEST_VERSION установлен."
waterfox --version
EOF

chmod +x ~/update-waterfox.sh

Запуск обновления:

~/update-waterfox.sh

Что делает скрипт: Сравнивает текущую версию с последней на GitHub. Если версии отличаются — скачивает и устанавливает новую.

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

6.1 Waterfox не запускается (вылетает сразу)

Симптом: Waterfox закрывается сразу после запуска, окно не появляется.

Причина: Возможно, проблема с расширениями или графикой.

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

Шаг 1: Запустите Waterfox в безопасном режиме (без расширений):

Для Flatpak:

flatpak run net.waterfox.waterfox --safe-mode

Для tarball:

waterfox --safe-mode

Шаг 2: Если в безопасном режиме работает — проблема в одном из расширений. Отключите их по одному, чтобы найти виновника.

6.2 Ошибка: waterfox: command not found (после tarball)

Симптом: После установки tarball команда waterfox не найдена.

Причина: Символическая ссылка не создана или не добавлена в PATH.

Решение: Создайте ссылку заново:

sudo ln -sf /opt/waterfox/waterfox /usr/local/bin/waterfox

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

Симптом: Waterfox не может загрузить файл с другого диска (например, /mnt/data).

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

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

sudo flatpak override net.waterfox.waterfox --filesystem=/путь/к/директории

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

sudo flatpak override net.waterfox.waterfox --filesystem=/mnt/data

7. ❌ Удаление Waterfox

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

sudo flatpak uninstall net.waterfox.waterfox -y
sudo flatpak uninstall --unused -y

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

sudo rm -rf /opt/waterfox
sudo rm -f /usr/local/bin/waterfox
sudo rm -f /usr/share/applications/waterfox.desktop
sudo update-desktop-database
rm -f ~/update-waterfox.sh

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

⚠️ Осторожно: Удаляет все закладки, пароли, историю.

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

rm -rf ~/.waterfox ~/.cache/waterfox

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

rm -rf ~/.var/app/net.waterfox.waterfox

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

  • [ ] Система обновлена (sudo apt update && sudo apt upgrade -y)
  • [ ] Выбран и выполнен один из способов установки (Flatpak / Tarball)
  • [ ] Waterfox запускается из меню приложений или терминала
  • [ ] (Для tarball) Создан ярлык в меню
  • [ ] (Для tarball) Скрипт обновления работает (~/update-waterfox.sh)

Заключение

Вы установили Waterfox на Debian. Если вы выбрали Flatpak — получили изолированную среду с автоматическими обновлениями. Если выбрали tarball — получили портативную версию, которую можно запускать с флешки, но обновлять придётся вручную (скрипт из раздела 5 упростит эту задачу). Waterfox — отличный выбор, если вы хотите браузер на базе Firefox, но без телеметрии и с усиленной приватностью.

Что дальше:

  • Войдите в свою учётную запись Firefox (если она у вас есть), чтобы синхронизировать закладки и пароли
  • Установите расширения: uBlock Origin, Privacy Badger, Bitwarden
  • Настройте Waterfox как браузер по умолчанию в настройках Debian
  • Изучите настройки приватности Waterfox (они более строгие, чем в Firefox по умолчанию)

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