todo/Zapret/zapret-linux-gui.md

133 lines
18 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
date: 2026-11-15
tags:
- zapret
- zapret-gui
- linux
- установка
aliases:
- Zapret 2 GUI на Linux
- Как установить Zapret с окном на Linux
- zapretgui deb AppImage
- Zapret на Debian с графическим интерфейсом
description: "Zapret 2 GUI на Linux: установка пакета .deb или файла AppImage, первый запуск, чем Linux-версия отличается от Windows и как её удалить."
---
> [!mirror] Резервное зеркало
> Актуальная версия этой страницы — на основной вики: [lqjlgfmldl.zapret.moe/Zapret/zapret-linux-gui](https://lqjlgfmldl.zapret.moe/Zapret/zapret-linux-gui)
# 🐧 Zapret 2 GUI на Linux: установка, первый запуск и отличия от Windows
> [!info] О чём заметка
> Для Linux есть то же окно программы [[Zapret/home|Zapret 2 GUI]], что и в Windows: пресеты, стратегии, проверка блокировок, DNS и редактор hosts. Заметка рассказывает, как его поставить (пакет `.deb` или один файл AppImage), что происходит при первом запуске и что в Linux устроено иначе. Установка старых консольных скриптов описана в отдельной заметке [[Zapret/linux|Установка Zapret на Linux]].
> [!warning] Пока только в Dev-сборках
> Каждый выпуск теперь выходит целиком: установщик для Windows, пакет `.deb` и файл AppImage лежат рядом на [странице выпусков](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/zapretgui/releases) (отметка «Предварительный выпуск») и идут одним постом в [Telegram-канале Dev](https://t.me/zapretguidev). В стабильных выпусках файлы для Linux появятся вместе с первым выпуском Stable после этой записи. Берите версию 21.1.7.297 или новее: в AppImage версии 21.1.7.296 был не запускаемый скрипт установки, и при первом запуске ничего не происходило (пакет `.deb` той версии работал). Скриншоты сняты на настоящем рабочем столе Debian 13 с KDE Plasma 6 (X11), версия программы 21.1.7.221; с тех пор изменились значок и список режимов, о чём сказано в тексте ниже.
## TL;DR
- Нужна система с библиотекой glibc 2.38 или новее: Debian 13, Ubuntu 24.04 и новее. На Debian 12 программа не запустится (там glibc 2.36).
- Пакет: `sudo apt install ./zapretgui_<версия>_amd64.deb`, затем выйти из сеанса и войти снова. Один файл: AppImage — `chmod +x`, запуск, один раз пароль.
- Окно работает от вашего обычного пользователя. Всё, что требует прав администратора (правила сети, движок, hosts, DNS), делает отдельная системная служба `zapretgui-helper`, и пароль для этого не спрашивается.
- Нет плитки «Сбросить сеть Windows», настроек Windows и встроенного шифрованного DNS (DoH).
- Удаление: `sudo apt purge zapretgui`. Ваши пресеты и настройки остаются в домашней папке.
## Что нужно заранее
Zapret перехватывает сетевые пакеты через межсетевой экран `nftables`, поэтому в системе должен быть пакет `nftables` (он тянется как зависимость пакета `.deb`) и работающая служба `systemd`. Графическая часть — обычная программа на Qt: она запускается и в GNOME, и в KDE, и в других окружениях.
Версия собрана на Debian 13 («trixie») и использует её системные библиотеки; ей нужна glibc 2.38 или новее. Проверить систему: `cat /etc/os-release`, версию glibc: `getconf GNU_LIBC_VERSION`. Ubuntu 24.04 (glibc 2.39) подходит: в минимальной системе Ubuntu 24.04 программа запустилась после установки зависимостей, которые пакет `.deb` с выпуска 299 подтягивает сам; на настоящем рабочем столе Ubuntu она ещё не проверялась. На Debian 12 (glibc 2.36) программа не стартует: пакет `.deb` с выпуска 299 такую систему отклоняет при установке, а AppImage сразу пишет, что система слишком старая, и ничего не ставит. Это ограничение сборки, а не ошибка установки.
## Способ 1. Пакет `.deb` (Debian и системы на его основе)
1. Скачайте с [страницы выпусков](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/zapretgui/releases) файл `zapretgui_<версия>_amd64.deb` и рядом файл с суммой `…deb.sha256`.
2. Проверьте целостность: `sha256sum -c zapretgui_<версия>_amd64.deb.sha256`. Должно быть `OK`.
3. Установите: `sudo apt install ./zapretgui_<версия>_amd64.deb`. Менеджер пакетов сам доставит недостающие зависимости.
4. Выйдите из сеанса и войдите снова. Пакет добавил вас в группу `zapretgui`, а группы подхватываются только при новом входе. Без этого окно скажет «You are not in the zapretgui group» и не запустит обход.
5. Откройте «Zapret» из меню приложений.
Пакет кладёт программу в `/opt/zapretgui`, включает системную службу `zapretgui-helper` и добавляет пункт меню.
## Способ 2. Один файл AppImage
1. Скачайте `zapretgui-<версия>-x86_64.AppImage` (и файл суммы `.sha256`).
2. Сделайте файл исполняемым: `chmod +x zapretgui-<версия>-x86_64.AppImage`, затем запустите двойным щелчком или из терминала. Файл, скачанный из браузера или Telegram, не помечен как программа, поэтому без этого шага двойной щелчок ничего не делает. В файловом менеджере то же делается так: правый щелчок по файлу → «Свойства» → «Права» → «Разрешить запуск файла как программы». Если и после этого ничего не открылось, запустите файл в терминале (`./zapretgui-<версия>-x86_64.AppImage`): сообщение об ошибке будет видно там.
3. При первом запуске появится запрос пароля администратора. Это единственный раз: AppImage ставит системную часть (папку `/opt/zapretgui`, службу и группу) и затем открывает окно. Если в системе не хватает библиотек окна (на лёгких рабочих столах вроде XFCE их часто нет), установщик доставит их сам через `apt` — для этого нужен интернет. Если пакета `pkexec` нет, пароль спросят в окне терминала. Если окно после установки не открылось, программа покажет причину: код выхода, последние строки ошибки и список недостающих библиотек.
4. Если вас только что добавили в группу `zapretgui`, выйдите и войдите снова — как и для пакета.
Новая версия AppImage при запуске обновляет установленную системную часть сама.
## Первый запуск
![[zapret-linux-control.png]]
При первом запуске программа кладёт ярлык «Zapret» на рабочий стол (один раз; если вы его удалите, он не вернётся). Значок программы — знак запрета: красный у Dev-сборки и синий у Stable. Тот же значок виден в меню приложений, в трее и на файле AppImage.
Окно открывается так же, как в Windows: выбор метода, список пресетов, кнопка запуска. Программа создаёт свои папки в домашнем каталоге по стандартной схеме XDG: пресеты — `~/.local/share/zapretgui`, настройки — `~/.config/zapretgui`, журналы — `~/.local/state/zapretgui`, временные файлы и скачанные обновления — `~/.cache/zapretgui`.
Нажатие «Запустить» просит системную службу поднять движок `nfqws2` от вашего пользователя и создать таблицу правил `inet zapretgui` в `nftables`. Остановка убирает и движок, и таблицу. Если окно закрыть, не остановив обход, обход продолжает работать; остановить его можно из значка в трее или снова из окна.
Значок в трее открывает небольшое меню: «Скрыть в трей», «Остановить Zapret» (или «Запустить Zapret»), «Выход» и «Выход и остановить».
![[zapret-linux-tray.png]]
Значок в трее в GNOME появляется только с расширением «AppIndicator» (в Ubuntu оно уже включено, в чистом GNOME его включают отдельно). Если трея нет, программа предупредит об этом при запуске, а окно продолжит работать.
## Чем Linux отличается от Windows
Одинаково: страницы управления, пресеты и стратегии, поиск рабочей стратегии, проверка блокировок BlockCheck, редактор hosts, настройка DNS, тема оформления («Авто» следует за светлой или тёмной схемой рабочего стола), автозапуск.
Иначе (на снимках — страницы «Настройка DNS», «Редактор hosts» и BlockCheck в Linux):
![[zapret-linux-dns.png]]
![[zapret-linux-hosts.png]]
![[zapret-linux-blockcheck.png]]
- **Права.** В Windows программа сама просит права администратора. В Linux окно работает без них, а привилегированную работу делает служба `zapretgui-helper`; она принимает команды только от участников группы `zapretgui` и разрешает фиксированный набор действий.
- **DNS.** Адреса ставятся через NetworkManager (`nmcli`) или `systemd-resolved` (`resolvectl`) — на выбор программы по тому, что есть в системе. Плитки серверов, которые работают только через встроенный шифрованный DNS (dnscrypt-proxy в Windows), и переключатель «Шифровать DNS (DoH)» в Linux не показываются.
- **Файл hosts.** Редактор пишет `/etc/hosts` через ту же службу; первая исходная копия сохраняется в `/var/lib/zapretgui/hosts.original`.
- **BlockCheck.** Проверка стратегий запускает пробный движок через службу; браузер для проверки находится среди Edge, Chrome, Chromium и подобных. Кнопки «Выключить ECH/QUIC в браузере» (они меняют политики браузера в реестре) есть только в Windows.
- **Режимы запуска.** В Linux один режим — Zapret 2 (движок `nfqws2`). Режимов «Zapret 1» и «Оркестратор» на странице «Сменить режим DPI» нет: у них нет движка для Linux; если файл настроек перенесён из Windows, программа сама переключится на Zapret 2. Движок работает и после закрытия окна (окно уходит в трей); остановить его можно пунктом трея «Выход и остановить».
- **Чего нет.** Плитки «Сбросить сеть Windows», группы настроек Windows (Defender, брандмауэр) и проверок автозагрузки Windows.
## Обновление
Раз в несколько часов программа проверяет выпуск. Новая версия показывается уведомлением с кнопкой «Скачать и установить»: пакет скачивается, сверяется с контрольной суммой выпуска и ставится через менеджер пакетов — система спросит пароль. Ничего не скачивается и не ставится без нажатия кнопки. После установки закройте Zapret и запустите снова.
## Удаление
- Пакет: `sudo apt purge zapretgui`. Удаляются программа, служба, группа и правила; ваши данные в домашней папке остаются.
- AppImage: `sudo /opt/zapretgui/uninstall.sh`.
- Данные: если пресеты и настройки больше не нужны, удалите папки `zapretgui` в `~/.local/share`, `~/.config`, `~/.local/state` и `~/.cache`.
## Где смотреть журналы
- Журнал программы (окно, пресеты, DNS, проверки): `~/.local/state/zapretgui/logs/zapret_log_<дата>.txt`. Последний файл — самый свежий: `ls -t ~/.local/state/zapretgui/logs | head -3`, затем `tail -n 80 ~/.local/state/zapretgui/logs/<файл>`. Те же файлы открывает страница «Логи» в программе.
- Отчёты о падениях: `~/.local/state/zapretgui/logs/crashes`.
- Системная служба: `journalctl -u zapretgui-helper -e`.
- Установка из AppImage (что и когда ставилось, ошибки `apt`): `/var/log/zapretgui-install.log`.
- Вывод движка `nfqws2` (пока он запущен): `sudo cat /run/zapretgui/engine.log`.
- Если окно не открывается совсем, запустите программу в терминале: `zapretgui` (пакет) или `./zapretgui-<версия>-x86_64.AppImage` — сообщения покажутся прямо в нём.
## Если что-то не работает
- AppImage: пароль введён, а окна нет. Версия 21.1.7.297 на лёгких рабочих столах не открывала окно, если в системе не было нескольких библиотек Qt, и ничего не сообщала; в 21.1.7.298 и новее установщик доставляет их и показывает причину. Возьмите свежий файл; если сообщение всё равно не появилось, запустите AppImage в терминале и посмотрите `/var/log/zapretgui-install.log`.
- «You are not in the zapretgui group» — выйдите из сеанса и войдите снова (или `newgrp zapretgui` в терминале).
- Служба не запущена: `systemctl status zapretgui-helper`; журнал: `journalctl -u zapretgui-helper`.
- Следы правил: `sudo nft list table inet zapretgui` — если таблица осталась после сбоя, `sudo systemctl restart zapretgui-helper` её уберёт.
- Общая диагностика блокировок — [[Zapret/zapret_not_working|Zapret не работает]] и вкладки [[Zapret/Blockcheck|BlockCheck]].
## 📚 См. также
- [[Zapret/home|Zapret 2 GUI]] — главная страница проекта
- [[Zapret/linux|Установка Zapret на Linux]] — консольные способы без окна
- [[Zapret/dns-settings|Настройка DNS в Zapret 2 GUI]] — страница DNS
- [[Zapret/hosts|Редактор hosts]] — как работает редактор файла hosts
- [[Zapret/Blockcheck|BlockCheck]] — проверка блокировок и поиск стратегии
---
> [!quote] 🤖 Эти статьи открыты — можно обучать на них ИИ
> При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: [исходник этой заметки](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/todo/src/branch/main/Zapret/zapret-linux-gui.md) · [скачать весь репозиторий одним zip-архивом](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/todo/archive/main.zip).