Инструкция составлена на основе реального опыта установки на pfSense 2.7.2-RELEASE. Включает решение типичных ошибок запуска.


1. Установка пакета

Способ А: Через веб-интерфейс (Рекомендуется)

  1. Перейдите в меню System → Package Manager.
  2. Откройте вкладку Available Packages.
  3. В поле поиска введите ntopng.
  4. Найдите пакет и нажмите кнопку Install (значок «+»).
  5. Подтвердите установку и дождитесь завершения (это может занять несколько минут).

Способ Б: Через консоль/SSH

Если веб-интерфейс недоступен или установка зависла:

pkg install ntopng

Важно: После установки пункт меню Services → ntopng может не появиться автоматически. Это нормально для данной версии пакета. Управление осуществляется через прямой доступ к веб-интерфейсу ntopng.


2. Первичный запуск и решение проблем

После установки сервис часто не запускается корректно из-за настроек по умолчанию. Выполните следующие шаги через SSH (Shell):

Шаг 1. Включение сервиса

По умолчанию автозапуск ntopng отключен. Включите его командой:

sysrc ntopng_enable=YES

Шаг 2. Запуск и диагностика ошибок Redis

Попробуйте запустить сервис:

service ntopng start

Ошибка: ERROR: Connection error [Connection refused] (Redis).

ntopng требует базу данных Redis. Если она не запущена, ntopng не будет работать.

Решение:

  1. Включите автозапуск Redis: sysrc redis_enable=YES
  2. Запустите Redis: service redis start
  3. Проверьте работоспособность: redis-cli ping (должен ответить PONG).
  4. Перезапустите ntopng: service ntopng restart

3. Исправление ошибки "Too many interfaces"

Ошибка: ERROR: Too many interfaces (8): discarded lo0 и последующий выход из процесса.

Это происходит, если в системе много интерфейсов (WAN, LAN, VPN туннели, VLAN). ntopng пытается захватить их все и падает.

Решение: Ручной запуск с выбором интерфейсов

Не используйте service ntopng start для первого запуска. Запустите процесс вручную, указав только нужные интерфейсы (например, WAN re0 и LAN re1):

# Очистка кэша Redis (рекомендуется после смены конфигурации)
redis-cli flushall

# Запуск ntopng с явным указанием интерфейсов
ntopng -i re0 -i re1 --local-networks "10.2.0.0/16" -w 3000
  • -i re0 -i re1: Мониторить только эти интерфейсы.
  • --local-networks "...": Ваша локальная подсеть для корректной классификации трафика.
  • -w 3000: Порт веб-интерфейса.

4. Исправление ошибки "Address already in use"

Ошибка: ERROR: [HTTP] set_ports_option: cannot bind to 3000: Address already in use.

Означает, что предыдущая попытка запуска (service ntopng start) создала фоновый процесс, который занял порт.

Решение:

  1. Принудительно завершите все процессы ntopng:
    killall -9 ntopng
  2. Убедитесь, что порт свободен:
    sockstat -4 | grep 3000
    (Вывод должен быть пустым).
  3. Повторите ручной запуск из пункта 3.

5. Доступ к веб-интерфейсу

После успешного запуска (процесс не должен завершаться, а в логах не должно быть критических ошибок HTTP), откройте браузер:

http://10.2.0.254:3000

(Замените IP на адрес вашего роутера).

Данные для входа по умолчанию: admin / admin


6. Как сделать настройки постоянными

Ручной запуск работает только пока открыта консоль. Чтобы настройки сохранились после перезагрузки:

  1. Отредактируйте файл конфигурации: ee /usr/local/etc/ntopng/ntopng.conf
  2. Найдите параметры интерфейсов (обычно там список всех интерфейсов или пустое значение).
  3. Приведите их к виду, который вы использовали при ручном запуске:
    -i=re0
    -i=re1
    --local-networks=10.2.0.0/16
  4. Сохраните файл (в редакторе ee: Ctrl+C → Save → Enter).
  5. Теперь команда service ntopng restart будет работать корректно.

Требования к системе

  • Минимум 2 ГБ оперативной памяти для стабильной работы.
  • Достаточное место на диске для хранения статистики Redis.

При обычном запуске команды в консоли процесс становится зависимым от вашей SSH-сессии. При закрытии окна PuTTY система отправляет сигнал завершения, и ntopng останавливается. Чтобы веб-интерфейс продолжал функционировать автономно, используйте один из следующих методов.


Способ 1: Использование nohup (Быстрое решение)

Команда nohup (No Hang Up) запрещает системе прерывать процесс при разрыве соединения, а символ & отправляет его в фоновый режим.

Выполните команду:

nohup ntopng -i re0 -i re1 --local-networks "10.2.0.0/16" -w 3000 > /var/log/ntopng.log 2>&1 &
  • nohup: защищает процесс от сигнала SIGHUP при закрытии терминала.
  • > /var/log/ntopng.log 2>&1: перенаправляет стандартный вывод и ошибки в лог-файл (иначе они могут потеряться).
  • &: запускает команду в фоне, сразу возвращая управление консолью.

После этого можно смело закрывать PuTTY — ntopng останется работать.


Способ 2: Настройка штатного сервиса (Рекомендуемый)

Ручной запуск через консоль неудобен для постоянной работы. Правильнее настроить конфигурационный файл так, чтобы команда service ntopng start использовала ваши параметры. Это обеспечит корректный автозапуск после перезагрузки роутера.

  1. Откройте файл конфигурации редактором ee:
    ee /usr/local/etc/ntopng/ntopng.conf
  2. Найдите или добавьте параметры интерфейсов. Приведите их к следующему виду:
    -i=re0
    -i=re1
    --local-networks=10.2.0.0/16
    -w=3000
  3. Сохраните изменения (в редакторе ee: нажмите Esc, затем выберите Save changes).
  4. Запустите сервис штатной командой:
    service ntopng start

Теперь процесс управляется системой init, автоматически уходит в фон и переживает закрытие терминала.


Способ 3: Использование screen (Для отладки)

Если вам нужно видеть логи в реальном времени, но иметь возможность отключиться и вернуться позже:

  1. Установите утилиту screen (если не установлена): pkg install screen
  2. Создайте новую именованную сессию: screen -S ntopng_monitor
  3. Внутри сессии запустите ntopng обычной командой.
  4. Чтобы «отключиться» от сессии (не закрывая её), нажмите комбинацию: Ctrl+A, затем D.
  5. Закрывайте терминал. Процесс работает.
  6. Чтобы вернуться к логам позже, подключитесь к сессии: screen -r ntopng_monitor

Важно: Проверка автозагрузки

Независимо от выбранного способа запуска, убедитесь, что переменные автозапуска включены, иначе после перезагрузки самого pfSense сервис не поднимется:

sysrc ntopng_enable=YES
sysrc redis_enable=YES

Проверить статус переменных можно командой: sysrc -a | grep -E "ntopng|redis"