VBVNBilling Wiki Демо-биллинг ↗

Если что-то не работает

Ниже — самые частые проблемы и порядок действий. Начинайте с простого: статус, баланс, MAC, lease, RADIUS, OLT.

Быстрая таблица

СимптомЧто проверить
Абонент не авторизуетсяMAC, тип доступа, статус, баланс, RADIUS, NAS.
Получил не тот IPMAC в биллинге, 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, логи.

Абонент не авторизуется

  1. Откройте карточку. Проверьте статус: active/overdue, не deleted.
  2. Проверьте баланс: минус без обещанного платежа = отказ.
  3. Проверьте тип доступа: для VLAN с DHCP должен быть IPoE DHCP.
  4. Проверьте MAC: он должен совпадать с фактическим MAC клиента.
  5. Проверьте RADIUS: тест по MAC должен давать Access-Accept.
  6. Проверьте NAS: доступен ли Mikrotik, тот ли адрес-лист.
Важно. Если MAC в биллинге — это MAC ONU, а DHCP-клиент — роутер с другим MAC, авторизация не пройдёт. Нужен MAC клиента.

Нет интернета, но баланс положительный

  1. Проверьте lease на Mikrotik: статус должен быть bound.
  2. Проверьте ARP: виден ли MAC/IP.
  3. Проверьте адрес-лист OFF-LINE: абонента там быть не должно.
  4. Проверьте firewall: нет ли лишнего drop.
  5. Проверьте NAT/masquerade.
  6. Проверьте очередь: не стоит ли скорость 0 или слишком низкая.

Должник не блокируется

OLT не опрашивается

  1. Проверьте ping до OLT.
  2. Проверьте SNMP community и версию.
  3. Проверьте UDP 161 в firewall.
  4. Проверьте профиль OID и offsets.
  5. Посмотрите last_poll_error в карточке OLT.

Платёж не зачислился

  1. Найдите платёж в ЮKassa по ID/сумме.
  2. Проверьте статус: succeeded/pending/canceled.
  3. Проверьте, что metadata содержит абонента.
  4. Проверьте webhook и логи.
  5. Если платёж 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/
Осторожно. Перед любыми массовыми действиями делайте бэкап. Если не уверены — остановитесь и позовите администратора.