Files
adguard_blocker/README.md
2025-06-11 18:58:08 +02:00

87 lines
1.4 KiB
Markdown

# AdGuard Rule Scheduler
Skrypt do zarządzania dynamicznymi regułami filtrowania AdGuard na podstawie harmonogramów i konfiguracji klientów.
## 📦 Wymagania
- Python 3.6+
- Biblioteki:
- `requests`
Zainstaluj:
```bash
pip install -r requirements.txt
```
lub:
Debian/Ubuntu
```bash
apt install python3-requests
```
Arch Linux
```bash
pacman -S python-requests
```
OpenSuse Tumbleweed
```bash
zypper in python313-requests
```
## ⚙️ Konfiguracja
Skonfiguruj serwery i klientów w pliku `.ini`. Przykład:
```ini
[server:home]
url = http://192.168.1.1:3000
username = admin
password = haslo
[client:tv]
ip = 192.168.1.101
services = youtube.com, netflix.com
schedule = whole
```
Obsługiwane harmonogramy:
- `whole` — zawsze blokuj
- `custom:HH-HH` — tylko w określonych godzinach (np. `custom:22-6`)
## 🚀 Użycie
### Uruchomienie
```bash
python adguard_scheduler.py
```
### Z własnym plikiem config:
```bash
python adguard_scheduler.py /ścieżka/do/config.ini
```
### Z katalogiem:
```bash
python adguard_scheduler.py --config-dir /etc/adguard_configs
```
### Tryb cron (bez outputu):
```bash
python adguard_scheduler.py --cron
```
### Instalacja zadania cron co godzinę:
```bash
python adguard_scheduler.py --install-cron
```
### Pomoc:
```bash
python adguard_scheduler.py --help
```
## 📁 Przykład konfiguracji
Zobacz plik: [`config.example.ini`](./config.example.ini)