Если что-то не работает
Ниже — самые частые проблемы и порядок действий. Начинайте с простого: статус, баланс, MAC, lease, RADIUS, OLT.
Быстрая таблица
| Симптом | Что проверить |
|---|---|
| Абонент не авторизуется | MAC, тип доступа, статус, баланс, RADIUS, NAS. |
| Получил не тот IP | MAC в биллинге, DHCP lease, статический lease, пул. |
| Два абонента с одним IP | Уникальный индекс, старые lease, ошибка сохранения. |
| Нет интернета, но баланс есть | Mikrotik, firewall, адрес-листы, NAT, очередь. |
| Должник не блокируется | OFF-LINE, правило firewall, синхронизация, статус/баланс. |
| RADIUS не отвечает | Listen IP, порт, секрет, клиент NAS, firewall. |
| OLT не опрашивается | Ping, SNMP community, порт 161, профиль OID. |
| Платёж не зачислился | ЮKassa, статус платежа, webhook, история. |
| Не приходит уведомление | Токен, чат, SMTP, логи. |
Абонент не авторизуется
- Откройте карточку. Проверьте статус: active/overdue, не deleted.
- Проверьте баланс: минус без обещанного платежа = отказ.
- Проверьте тип доступа: для VLAN с DHCP должен быть IPoE DHCP.
- Проверьте MAC: он должен совпадать с фактическим MAC клиента.
- Проверьте RADIUS: тест по MAC должен давать Access-Accept.
- Проверьте NAS: доступен ли Mikrotik, тот ли адрес-лист.
Важно. Если MAC в биллинге — это MAC ONU, а DHCP-клиент — роутер с другим MAC, авторизация не пройдёт. Нужен MAC клиента.
Нет интернета, но баланс положительный
- Проверьте lease на Mikrotik: статус должен быть bound.
- Проверьте ARP: виден ли MAC/IP.
- Проверьте адрес-лист OFF-LINE: абонента там быть не должно.
- Проверьте firewall: нет ли лишнего drop.
- Проверьте NAT/masquerade.
- Проверьте очередь: не стоит ли скорость 0 или слишком низкая.
Должник не блокируется
- Проверьте, что должник попадает в OFF-LINE (баланс/статус/кредит).
- Проверьте, что firewall дропает OFF-LINE.
- Проверьте, что синхронизация запускается и не падает.
- Проверьте, что список называется так же, как в настройках NAS.
OLT не опрашивается
- Проверьте ping до OLT.
- Проверьте SNMP community и версию.
- Проверьте UDP 161 в firewall.
- Проверьте профиль OID и offsets.
- Посмотрите last_poll_error в карточке OLT.
Платёж не зачислился
- Найдите платёж в ЮKassa по ID/сумме.
- Проверьте статус: succeeded/pending/canceled.
- Проверьте, что metadata содержит абонента.
- Проверьте webhook и логи.
- Если платёж succeeded, но денег нет — зачислите вручную только после проверки и с комментарием.
Что смотреть в логах
| Лог | Где |
|---|---|
| PHP | /var/log/vnbilling/php_error.log |
| nginx | /var/log/nginx/ |
| Списания | /var/log/vnbilling/cron_subscription_fee.log |
| Синхронизация | /var/log/vnbilling/sync_address_lists.log |
| OLT | /var/log/vnbilling/olt_poll.log |
| RADIUS | /var/log/freeradius/ |
Осторожно. Перед любыми массовыми действиями делайте бэкап. Если не уверены — остановитесь и позовите администратора.