docs(README): add root requirements + troubleshooting for common errors

- Clarify that ALL scripts require root (not just install.sh)
- Add 'git clone WITHOUT sudo' note to avoid permission issues
- Add troubleshooting section for 'nfqws did not start' / error 0000
- Add checklist for when curl tests fail but nfqws is running
- Emphasize Secure DNS and hosts file as common fixes
This commit is contained in:
OpenCode Agent
2026-05-10 17:35:57 +04:00
parent c6d843bd23
commit 6a1304bcfa

View File

@@ -47,7 +47,7 @@ sudo apt install git # Ubuntu/Debian
sudo pacman -S git # Arch/Manjaro
sudo dnf install git # Fedora
# 2. Клонирование
# 2. Клонирование (БЕЗ sudo — создаёт файлы от текущего пользователя)
cd /opt
git clone https://giteas.stitch505.su/Stitch505/zapret-discord-youtube-linux.git zapret
cd zapret
@@ -58,6 +58,8 @@ sudo ./install.sh
После `install.sh` сервис запущен и будет автозапускаться.
> **Важно:** Все скрипты (`install.sh`, `setup.sh`, `general*.sh`, `service.sh`, `autotest.sh`, `update.sh`) должны запускаться **от root** (через `sudo`). Сами скрипты проверяют это автоматически.
---
## Установка по дистрибутивам
@@ -391,6 +393,21 @@ sudo ./update.sh
sudo ./update.sh --full-auto
```
### Если autotest показывает "nfqws did not start" / ошибка 0000
Это значит `nfqws` не удалось запуститься. Самые частые причины:
1. **Не хватает root-прав** — запускайте ВСЕ скрипты через `sudo`
2. **Отсутствуют fake .bin файлы** — пересоберите: `sudo ./install_nfqws.sh`
3. **nfnetlink_queue не загружен** — `sudo modprobe nfnetlink_queue`
4. **iptables/nftables конфликт** — `sudo ./service.sh → 2. Remove Services`, затем `sudo ./general.sh`
### Если curl-тесты падают, но nfqws запущен
1. Включите **Secure DNS** (DoH/DoT) — провайдер блокирует по DNS
2. Добавьте `.service/hosts` в `/etc/hosts` (`sudo ./service.sh → 8`)
3. Попробуйте стратегии вручную — у разных провайдеров работают разные
---
## Требования
@@ -398,7 +415,7 @@ sudo ./update.sh --full-auto
- Linux с `iptables` или `nftables`
- Ядерный модуль `nfnetlink_queue` (загрузится автоматически)
- `git`, `make`, `gcc`, `curl`
- `sudo` или root
- **Root-доступ** — все скрипты (`install.sh`, `setup.sh`, `general*.sh`, `service.sh`, `autotest.sh`, `update.sh`) проверяют это автоматически и показывают `sudo $0`, если запущены без прав
---