RADIUS и NAS — Отчёт по настройке

Дата: 29 марта 2026 г. | Сервер: testbill.smit34.ru | Версия: СмИТ Биллинг v1.0.0 (build 37)

1. Краткая сводка

2. Архитектура RADIUS

3. Конфигурация FreeRADIUS

3.1. Docker-контейнер

freeradius:
  build:
    context: .
    dockerfile: docker/freeradius/Dockerfile
  ports:
    - "1812:1812/udp"   # Internet Auth
    - "1813:1813/udp"   # Internet Acct
    - "2812:2812/udp"   # VoIP Auth
    - "2813:2813/udp"   # VoIP Acct
    - "6812:6812/udp"   # IPTV Auth
    - "6813:6813/udp"   # IPTV Acct
  env_file: .env
  depends_on:
    - db
  restart: unless-stopped

# Примечание: контейнер также указан в docker-compose.prod.yml
# на testbill.smit34.ru с аналогичной конфигурацией

Базовый образ: freeradius/freeradius-server:3.2.3 с Python 3, Django 4.2, psycopg2.

Thread pool пропатчен для однопоточного режима (Python GIL):

start_servers = 1
max_servers = 1
min_spare_servers = 0
max_spare_servers = 0

3.2. Модули и виртуальные серверы

3.3. Клиенты (NAS)

clients.conf генерируется автоматически при старте контейнера скриптом entrypoint.sh:

#!/bin/bash
# entrypoint.sh — generates clients.conf from billing DB
python3 -c "
import django; django.setup()
from billing.models import Nas
for nas in Nas.objects.all():
    # write client block for each NAS
"
exec freeradius -f "$@"

Кириллические имена NAS фильтруются (только ASCII). Добавляется wildcard-клиент 0.0.0.0/0 с секретом smitsecretkey для тестирования.

3.4. Процесс авторизации

Файл: radius_python/internet.py

4. Модели данных

4.1. RADIUS-модели

4.2. Полнота моделей (Carbon 4)

Добавлено 23 модели (миграция 0049) — 22 из оригинального Carbon 4 + SystemSettings:

Итого: 135 моделей (98 из Carbon 4 + 37 новых). 22 добавленные модели Carbon 4 имеют managed=False — таблицы создаются по необходимости. SystemSettings — новая модель (managed=True).

5. Настройки NAS

5.1. Список NAS

5.2. Поля авторизации и аккаунтинга

Для всех MikroTik NAS установлены следующие RADIUS-настройки:

5.3. Вкладка «Развёртывание»

Вертикальные под-вкладки (как в оригинальном Carbon 4):

• Управление — 5 шагов развёртывания (init → fill → download → make → upload → save)
• Настройка — редактирование INI-файлов
• Шаблоны — редактирование .tmplt файлов
• Upload cfg — конфигурации для загрузки
• Download cfg — файлы с оборудования

6. Результаты тестирования

7. Список изменений

8. Известные проблемы

9. Инструкция администратора

9.1. Управление NAS-устройствами

Перейдите в Оборудование → NAS (/admin/equipment/Nas/?object_type=1).

Для редактирования NAS кликните на его имя. Откроется карточка с вкладками:

Ключевые поля NAS для RADIUS:

• IP — IP-адрес NAS-устройства (MikroTik, Cisco и т.д.)
• RADIUS Secret — общий секрет для RADIUS (должен совпадать на NAS и в биллинге)
• Тип NAS — выберите тип оборудования (mikrotik6, common_ssh и т.д.)
• CoA порт — порт Change of Authorization (обычно 3799)

Настройки авторизации (вкладка «Расширенные»):

• auth_login — авторизация по логину (PPPoE/VPN) — обязательно для MikroTik
• reject_block — отклонять заблокированных клиентов при RADIUS-запросе

Настройки аккаунтинга:

• acc_start_sid — учёт начала сессии по Session-ID
• acc_update_sid — промежуточные обновления по Session-ID
• acc_stop_sid — завершение сессии по Session-ID

docker compose -f docker-compose.prod.yml restart freeradius

9.2. Назначение IP клиенту

Чтобы назначить IP-адрес и привязать клиента к NAS:

1. Перейдите в Клиенты, найдите нужного клиента
2. На вкладке Учётные записи откройте карточку пользователя (Users)

3. Заполните поля:
   • IPv4 — статический IP-адрес клиента (например 10.77.0.100)
   • Nas — выберите NAS-устройство из выпадающего списка
   • Тип авторизации — выберите «по vpn pptp, pppoe» (ID=100) или «любая через RADIUS» (ID=6)
   • Маска — маска подсети (обычно 32 для одиночного IP)
4. Нажмите зелёную кнопку «Сохранить» в верхней панели

Пул IP адресов

В правой колонке карточки пользователя можно указать:

• Пул IP адресов — пул для динамической выдачи (если не задан статический IP)
• Host Пул — пул для VPN-хостов
• MAC — MAC-адрес оборудования клиента

9.3. Проверка RADIUS

Для проверки авторизации клиента подключитесь к контейнеру FreeRADIUS и выполните:

# Войти в контейнер
docker compose -f docker-compose.prod.yml exec freeradius bash

# Тест авторизации (логин, пароль, сервер, порт, секрет)
radtest <логин> <пароль> 127.0.0.1 0 testing123

# Пример:
radtest 2105 2243179 127.0.0.1 0 testing123

Ожидаемый результат для валидного клиента:

Received Access-Accept Id 17 from 127.0.0.1:714
    Framed-IP-Address = 10.99.56.101

Для заблокированного или несуществующего:

Received Access-Reject Id 110 from 127.0.0.1:714

9.4. Развёртывание конфигурации на NAS

Вкладка Развёртывание в карточке NAS позволяет управлять конфигурацией MikroTik:

Шаги развёртывания:

1. Шаг 1 — Инициализация: rtsh cfg init → создаёт каталог, rtsh cfg fill → заполняет INI данными из биллинга
2. Шаг 2 — Сохранение текущей: rtsh cfg download → скачивает конфигурацию с оборудования
3. Шаг 3 — Подготовка: rtsh cfg make → генерирует конфигурацию для загрузки
4. Шаг 4 — Загрузка: rtsh cfg upload → загружает конфигурацию в оборудование
5. Шаг 5 — Проверка: rtsh cfg download + rtsh cfg diff cur → сравнивает результат

Редактирование файлов:

Под-вкладки Настройка, Шаблоны, Upload cfg, Download cfg позволяют просматривать и редактировать конфигурационные файлы прямо в браузере:

• Кликните на имя файла в списке слева
• Отредактируйте содержимое в текстовом поле справа
• Нажмите «Сохранить» под текстовым полем
• Для обновления списка файлов нажмите «Обновить»