You are here

Встроенный HTTP-сервер

В программе имеется встроенный HTTP-сервер, который используется для управления программой.

Конфигурация HTTP-сервера содержит всего три параметра:

<http_server bind_to="127.0.0.1" port="7777" onHttpServerRequest="OnHttpServerRequest"/>
bind_to
IP-адрес, на котором принимать входящие соединения. 0.0.0.0 = принимать соединения на всех доступных IP-адресах.
port
порт, на котором принимать входящие соединения. 0 = не принимать соединения вообще. При запуске нескольких копий программы на одном компьютере необходимо указывать разные порты.
onHttpServerRequest
имя функции из файла со скриптами, которую нужно вызвать перед обработкой запроса. Данная функция может использоваться в качестве фильтра запросов к встроенному серверу, через неё можно организовать ограничение доступа к HTTP-серверу (проверку логина-пароля, IP-адреса и т.д.). Отсутствующий или пустой параметр = не вызывать функцию.

Параметр bind_to по умолчанию в целях безопасности имеет значение "127.0.0.1", что позволяет подключаться к встроенному HTTP-серверу только с того компьютера, на котором запущена программа CheckParams.

Сервер содержит следующие встроенные команды (ссылки указаны для конфигурации адреса и порта по умолчанию):

http://127.0.0.1:7777/debug
выдаёт разобранный HTTP-запрос со всеми интерпретированными параметрами, служит для проверки работы модуля управления.
http://127.0.0.1:7777/stats
выдаёт статистику работы программы.
http://127.0.0.1:7777/logs
выдаёт последние 16 килобайт логов программы.
http://127.0.0.1:7777/close
закрывает программу.
http://127.0.0.1:7777/status
выдаёт состояние (запущен/остановлен) модуля проверки параметров и модуля проверки прокси.
http://127.0.0.1:7777/checkengine/start
запускает проверку параметров.
http://127.0.0.1:7777/checkengine/stop
останавливает проверку параметров.
http://127.0.0.1:7777/checkengine/add-urls
принимает POST-запросом список ссылок, которые добавляет в очередь проверки.
http://127.0.0.1:7777/proxies/recheck-sources
принудительно скачивает прокси со всех источников.
http://127.0.0.1:7777/proxies/add-source
добавляет новый источник прокси в программу.
http://127.0.0.1:7777/proxies/get-proxies
возвращает список рабочих прокси или его часть.
http://127.0.0.1:7777/scripts/reload
перезагружает файл со скриптом, указанный в конфигурации. Сама конфигурация (xml-файл) при этом не перечитывается.
http://127.0.0.1:7777/scripts/call/OnHTTPRequest?test=12345
вызывает функцию OnHTTPRequest из файла со скриптами. Функций может быть неограниченное количество.