Created Записи пользователя в блэклисте (markdown)

Записи-пользователя-в-блэклисте.md

@@ -0,0 +1,37 @@
+Можно добавлять собственные записи к списку блокировок (не заблокированные сайты на которые необходимо всегда ходить через прокси). Включение опции:
+
+    uci set ruantiblock.config.add_user_entries="1"
+
+Нужно создать текстовый файл с записями (IP, CIDR или FQDN, каждая запись в новой строке) `/etc/ruantiblock/user_entries`. В записях FQDN можно задать DNS-сервер для разрешения данного домена (через пробел). Также можно комментировать строки (`#` - первый символ строки).
+
+Пример файла `/etc/ruantiblock/user_entries`:
+
+    # FQDN
+    domain.net
+    # FQDN с DNS-сервером
+    sub.domain.com 8.8.8.8
+    # FQDN с DNS-сервером и портом. #53 - порт, не комментарий
+    sub.domain.com 8.8.8.8#53
+    # ip
+    74.125.131.19
+    # CIDR
+    74.125.0.0/16
+
+Есть возможность задать общий DNS-сервер только для пользовательских записей:
+
+    uci set ruantiblock.config.user_entries_dns="1.1.1.1#53"    # значение в виде пустой строки отключает опцию
+
+Если в какой-либо записи (как в примере выше) указан свой DNS-сервер - то для этого домена используется исключительно он.
+
+Для применения записей необходимо обновить блэклист:
+
+    /usr/bin/ruantiblock update
+
+
+### Конфигурация с использованием только собственных записей.
+
+Если отключить модуль-парсер:
+
+    uci set ruantiblock.config.bllist_module=""
+
+то для создания правил ipset и dnsmasq будут применяться лишь записи пользователя, без загрузки списка блокировок. При этом, благодаря использованию dnsmasq, записи FQDN будут всегда актуальны (ибо резолвятся в IP адреса в момент запроса).