auth-radius: HTTP-аутентификация через протокол RADIUS
Установка
Вы можете установить этот модуль в любом дистрибутиве на базе RHEL, включая, но не ограничиваясь:
- RedHat Enterprise Linux 7, 8, 9 и 10
- CentOS 7, 8, 9
- AlmaLinux 8, 9
- Rocky Linux 8, 9
- Amazon Linux 2 и Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-auth-radius
yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-auth-radius
Включите модуль, добавив следующее в начало /etc/nginx/nginx.conf:
load_module modules/ngx_http_auth_radius_module.so;
В этом документе описан nginx-module-auth-radius v0.1.3, выпущенный 14 сентября 2026 г.
Почти полностью переписанная версия https://github.com/lexelby/nginx-radius с
конфигурацией, вдохновлённой https://github.com/timchengx/nginx-http-radius-module.
Пример конфигурации см. на https://gitflic.ru/project/ten0s/nginx-radius.
Пакеты Access-Request включают атрибут Message-Authenticator из RFC 3579, а Message-Authenticator проверяется в ответах, если он присутствует. Это поддерживает строгие конфигурации RADIUS-серверов после BlastRADIUS без отключения аутентификации сообщений для этого клиента.
Тесты
make test
make test-asan
make lint
Сборка:
- Получите исходный код nginx:
$ make getsrc && make src
- Соберите исходный код:
$ make build_all
- Локальный запуск:
$ make run
- Локальная отладка:
$ make gdb
- Конфигурация:
Пример файла конфигурации: conf/nginx.conf:
# Main directive to add a Radius server.
# Can be several "radius_server" directives.
radius_server "radius_server_1" {
# Radius server URL
url "127.0.0.1:1812";
# Radius server shared secret
secret "secret";
# NAS identifier, optional
nas_identifier "nas-identifier";
# Timeout for Radius auth requests, optional, default: 5s
auth_timeout 5s;
# Retries count for Radius auth requests, optional, default: 3
auth_retries 3;
# Timeout for Radius health requests, optional, default: 5s
health_timeout 5s;
# Retries count for Radius health requests, optional, default: 1
health_retries 1;
# Radius auth/health requests queue size, optional, default: 10
# Effectively, the number of concurrent requests that can be
# processed without rescheduling.
queue_size 10;
}
# Location directive to select Radius server.
# Can be several "radius_servers" directives per location.
radius_servers "radius_server_1";
# Location directive to enable module and make auth request.
auth_radius "realm" | off;
radius_auth "realm" | off;
# Location directive to enable module and make health request.
radius_health ["user"] ["passwd"];
- Установка (необязательно):
$ make install
GitHub
Дополнительные советы по конфигурации и документацию для этого модуля вы можете найти в GitHub репозитории nginx-module-auth-radius.