Управляйте интернетом клуба
через EveryCafe.

Заранее соберите необходимые сведения:

• Доступ к pfSense Community Edition (CE) и номер установленной версии.
• Связь главного компьютера EveryCafe с адресом управления pfSense.
• Назначение интернет-каналов для игр и обычного использования.
• Резервная копия конфигурации pfSense и подходящее время для изменений.
• Для Wi-Fi: IP главного компьютера и интерфейс беспроводной сети.

EveryCafe выбирает политику для каждого места, а pfSense применяет интернет-шлюз, скорость и правила доступа. Трафик управляемых устройств должен проходить через pfSense.

Если нужны только компьютеры, выполните шаги 03–07, затем перейдите к проверке в шаге 12.

В pfSense откройте System → REST API. Если пункт есть, переходите к шагу 04.

1. Уточните версию pfSense CE.
2. Найдите совместимый с ней пакет pfrest и проверьте совместимость с вашей версией EveryCafe.
3. При необходимости откройте 8 · Shell в консоли pfSense и запустите команду установки именно для этой версии.
4. Обновите веб-интерфейс и проверьте меню REST API.

В System → REST API → Settings включите API. В Allowed Interfaces оставьте только локальный интерфейс, через который главный ПК обращается к pfSense (например LAN). Отключите Read Only и включите аутентификацию Key. Никогда не открывайте API на WAN.

1. Сохраните настройки и откройте Keys.
2. Введите понятное имя, например EveryCafe Integration.
3. Создайте и безопасно скопируйте ключ.

В EveryCafe откройте Настройки → Интеграции → Интеграция pfSense.

1. Включите интеграцию.
2. Укажите адрес управления, например https://192.168.10.1, с правильным протоколом и портом.
3. Вставьте ключ API из шага 04.
4. Нажмите Проверить подключение и сохраните настройки после успешного теста.

Если тест не проходит, проверьте адрес, порт, сертификат, ключ и разрешённый интерфейс.

Запустите Мастер настройки в том же окне. Он формирует алиасы EC, ограничители скорости и правила брандмауэра для EveryCafe.

1. Проверка: убедитесь в правильности URL и ключа, выполните тест.
2. Интернет-каналы: выберите шлюзы, назовите их, например EC_OYUN и EC_INTERNET; тщательно проверьте соответствие WAN и каналов, назначьте канал по умолчанию.
3. Игровая линия: проверьте сети и порты игровых сервисов; не вводите незнакомые адреса наугад.
4. Применение: проверьте сводку, завершите настройку и дождитесь применения в pfSense.

Опцию отключения интернета после сеанса выбирайте в соответствии с правилами клуба. Сначала проверьте работу на тестовом ПК.

Откройте EveryCafe → Настройки → Тарифы и измените нужный тариф.

1. Выберите канал, например EC_INTERNET.
2. Включите автоматическое применение при начале сеанса или смене тарифа.
3. Сохраните и повторите для других тарифов.
4. На главном экране выберите ПК и примените или отмените быстрый лимит скорости.
5. Проверьте Интернет-канал и Лимит скорости в сводке сеанса.

«Без ограничений» означает отсутствие лимита EveryCafe, а не увеличение пропускной способности провайдера.

Для входа в Wi-Fi по учётной записи откройте pfSense → System → User Manager → Authentication Servers → Add.

• Имя: EveryCafe; тип: RADIUS / PAP.
• IP сервера: главный ПК, например 192.168.10.10, а не IP pfSense.
• Придумайте надёжный Shared Secret. Точно такой же пароль укажите в EveryCafe на шаге 10; это не ключ API.
• Включите Authentication and Accounting на UDP-портах 1812 и 1813.

Сохраните, закрепите IP главного ПК и разрешите пакеты от pfSense в его Windows Firewall.

Откройте pfSense → Services → Captive Portal и добавьте зону, например everycafe_wifi.

1. Включите портал на локальном интерфейсе беспроводных клиентов, не на WAN.
2. Включите собственную страницу входа и загрузите файлы пакета EveryCafe: portal-giris.html (вход), portal-hata.html (ошибка), portal-cikis.html (выход).
3. Метод проверки: Authentication backend; сервер: EveryCafe.
4. Включите Use RADIUS Session-Timeout attributes.
5. В Accounting включите Send RADIUS accounting packets, сервер EveryCafe, обновления Interim. Инверсию байтов и учёт времени бездействия оставьте выключенными.

Сохраните и примените. HTML этого руководства не является файлом портала; возьмите нужные три файла из установщика EveryCafe или у поддержки.

В EveryCafe → Настройки → Интеграции → pfSense → Беспроводная сеть включите приём запросов на вход.

• Shared Secret: тот же пароль, что на шаге 08.
• Стоимость: сумма списания с баланса; 0 для бесплатного доступа участников.
• Длительность: число минут доступа.
• Адрес прослушивания: локальный IP главного ПК, доступный из pfSense.
• Код безопасности: отдельный код для уполномоченного бесплатного доступа.

Пример: 30 TRY за 60 минут — только иллюстрация, не рекомендация по цене. Проверьте, что RADIUS запустился без конфликтов портов.

pfSense может отправлять DNS-запросы на главный компьютер EveryCafe. Этот метод не записывает полные URL и содержимое HTTPS, а альтернативный или зашифрованный DNS и VPN могут обходить такую регистрацию.

1. В Services → DNS Resolver → General Settings включите DNS Resolver и добавьте log-queries: yes в блок server: пользовательских настроек.
2. Сохраните, примените и перезапустите unbound. Возможен короткий перерыв в разрешении DNS.
3. В Status → System Logs → Settings настройте Remote Logging на главный ПК, например 192.168.10.10:514, по IPv4 и включите DNS Events.
4. Разрешите UDP 514 от pfSense в брандмауэре главного ПК. Не отключайте брандмауэр целиком; оставляйте передачу журналов в локальной сети.

Сделайте тестовый DNS-запрос и проверьте журнал IPLog EveryCafe.

Протестируйте функции до запуска для клиентов.

Проверка ПК

• Подключение EveryCafe к pfSense проходит тест.
• Интернет- и игровой тариф выбирают нужный шлюз.
• Лимиты скорости включаются и снимаются.
• Если опция включена, интернет отключается после завершения сеанса.

Проверка Wi-Fi

• Отключите мобильные данные и подключитесь к Wi-Fi клуба.
• Войдите тестовым участником и проверьте списание баланса.
• Убедитесь, что интернет работает и отключается по истечении времени.
• Если настроены журналы, проверьте DNS-запрос в IPLog.

Нет REST API

Проверьте установку и совместимость пакета с версией pfSense.

Не проходит тест подключения

Проверьте URL, порт, сертификат TLS, Enabled, Key и Allowed Interfaces.

Тариф меняется, канал нет

Проверьте назначение канала, автоматическое применение, IP ПК и мастер настройки.

Телефон обходит портал

Проверьте мобильные данные, DHCP точки доступа и интерфейс pfSense.

Вход участника отклонён

Проверьте RADIUS, PAP, Shared Secret, IP главного ПК, UDP 1812/1813, баланс и статус участника.

Ошибки времени сеанса

Проверьте Session-Timeout, Accounting, Interim и UDP 1813.

Нет DNS-журналов

Проверьте DNS Resolver, перезапуск unbound, DNS Events, адрес сервера и UDP 514.

Для поддержки подготовьте версии программ, описание ошибки и скриншоты без ключей и паролей.

WAN / Gateway

Интернет-канал и соответствующий шлюз.

LAN / Interface

Локальная сеть и интерфейс pfSense.

Alias

Именованный список IP-адресов или подсетей.

Limiter

Правило ограничения скорости соединения.

API-ключ

Секретный ключ доступа EveryCafe к pfSense.

RADIUS / PAP

Служба проверки пользователей и её протокол.

Accounting / Interim

Учёт сеансов и периодические обновления данных.

Shared Secret

Общий пароль для двух сторон RADIUS.

Captive Portal

Страница входа клиента в Wi-Fi.

DHCP / DNS / Syslog

Выдача IP, поиск адреса по домену и передача журналов.