Наръчник за терминални команди в Pi-hole v6

Pi-hole v6 донесе значителни промени в командния синтаксис за по-голяма яснота и интуитивност. Този наръчник покрива всички промени и показва как да използваш новите команди ефективно.

---

1. Какво се промени в v6?

Таблица на промените (v5 → v6)

Действие	Стара команда (v5)	Нова команда (v6)	Защо е променено	Пример
Позволяване на домейн	pihole -w <domain>	pihole allow <domain>	По-ясно значение вместо -w	pihole allow ads.google.com
Блокиране на домейн	pihole -b <domain>	pihole deny <domain>	По-ясно значение вместо -b	pihole deny tracker.com
Премахване от списък	pihole -w -d <domain>	pihole allow -d <domain>	-d = delete (изтрий)	pihole deny -d tracker.com
Смяна на парола	pihole -a -p	pihole password	Директна команда, не скрита в admin	pihole password
Wildcard блокиране	pihole -b --regex	pihole deny --regex	Консистентност с новия синтаксис	pihole deny --regex ".*ads\..*"
Търсене на домейн	pihole -q <domain>	pihole query <domain>	По-описателно име	pihole query doubleclick.net
Обновяване на списъци	pihole -g	pihole gravity	Пълното име на функцията	pihole gravity

Ключови принципи на v6:

• Премахнати са криптичните -w, -b, -q флагове
• Командите използват разбираеми английски думи
• По-лесно за запомняне и използване

---

2. Пълен справочник по категории

2.1 Управление на блокиране

Позволяване на домейни (Whitelist)

# Добавяне на единичен домейн
pihole allow example.com

# Добавяне на множество домейни наведнъж
pihole allow facebook.com www.facebook.com m.facebook.com

# Премахване от бял списък
pihole allow -d example.com

# Wildcard позволяване (целия домейн и поддомейни)
pihole allow --regex ".*google\.com$"

Блокиране на домейни (Blacklist)

# Добавяне в черен списък
pihole deny ads.example.com

# Премахване от черен списък
pihole deny -d ads.example.com

# Wildcard блокиране
pihole deny --regex ".*tracker\..*"

Полезен съвет: За да видиш всички опции на командата:

pihole allow -h
pihole deny -h

---

2.2 Поддръжка и обновяване

# Обновяване на Pi-hole до последна версия
pihole updatepihole

# Обновяване на Gravity (adlists)
pihole gravity
# Алтернативно (старият вариант все още работи):
pihole -g

# Ремонт или преинсталация
pihole -r

Препоръка: Обновявай Gravity поне веднъж седмично за актуални блок листи.

---

2.3 Мониторинг и диагностика

Статистика в реално време

# Chronometer - красив панел със статистика
pihole -c

# Tail Log - показва заявки на живо
pihole -t

В Tail Log режим:

• 🟢 Зелен текст = разрешена заявка
• 🔴 Червен текст = блокирана заявка
• Излизане: Ctrl + C

Търсене и проверка

# Провери в кой списък е даден домейн
pihole query doubleclick.net

# Провери дали DNS работи
pihole status

# Виж версията на компонентите
pihole version

---

2.4 Контрол на системата

Временно изключване/включване

# Изключване за постоянно
pihole disable

# Изключване за определено време
pihole disable 5m    # 5 минути
pihole disable 30s   # 30 секунди
pihole disable 2h    # 2 часа

# Включване обратно
pihole enable

Рестартиране на услуги

# Рестарт на DNS услугата
pihole restartdns

Кога да използваш: След ръчни промени в конфигурационни файлове.

Администрация

# Смяна на парола за web интерфейс
pihole password

Системата ще поиска новата парола (скрита, докато пишеш).

---

3. Бързи решения (Copy-Paste решения)

Отблокиране на целия Facebook

pihole allow facebook.com www.facebook.com m.facebook.com static.facebook.com

Проверка дали домейн е блокиран

pihole query ads.google.com

Временно изключване за 10 минути (за тестове)

pihole disable 10m

Обновяване на всичко

pihole updatepihole && pihole gravity

Мониторинг на живо какво се блокира

pihole -t

---

Помощ и допълнителни опции

За всяка команда можеш да видиш всички налични опции с -h:

pihole allow -h
pihole deny -h
pihole gravity -h

---

Важни бележки

⚠️ Обратна съвместимост: Старите команди от v5 (pihole -w, pihole -b, etc.) все още работят, но е препоръчително да преминеш към новия синтаксис.

💡 Групи и коментари: Новите команди поддържат добавяне на коментари към домейни и управление на групи. Използвай -h флага за детайли.

🔍 Gravity съдържа милиони домейни: Командата pihole query претърсва всичките им за секунди.