Zum Inhalt

auth-radius: HTTP-Authentifizierung über das RADIUS-Protokoll

Installation

Sie können dieses Modul in jeder RHEL-basierten Distribution installieren, einschließlich, aber nicht beschränkt auf:

  • RedHat Enterprise Linux 7, 8, 9 und 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 und 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

Aktivieren Sie das Modul, indem Sie Folgendes an den Anfang von /etc/nginx/nginx.conf hinzufügen:

load_module modules/ngx_http_auth_radius_module.so;

Dieses Dokument beschreibt nginx-module-auth-radius v0.1.1, veröffentlicht am 29. April 2026.

Fast vollständig neu geschriebene Version von https://github.com/lexelby/nginx-radius mit
Konfiguration inspiriert von https://github.com/timchengx/nginx-http-radius-module.
Siehe Konfigurationsbeispiel unter https://gitflic.ru/project/ten0s/nginx-radius.

Build:

  1. Holen Sie sich den nginx-Quellcode:
$ make getsrc && make src
  1. Quellcode bauen:
$ make build_all
  1. Lokaler Betrieb:
$ make run
  1. Lokale Fehlersuche:
$ make gdb
  1. Konfiguration:

Beispielkonfigurationsdatei: conf/nginx.conf:

# Hauptdirektive zum Hinzufügen eines RADIUS-Servers.
# Es kann mehrere "radius_server"-Direktiven geben.
radius_server "radius_server_1" {
    # RADIUS-Server-URL
    url "127.0.0.1:1812";

    # Gemeinsames Geheimnis des RADIUS-Servers
    secret "secret";

    # NAS-Identifikator, optional
    nas_identifier "nas-identifier";

    # Timeout für RADIUS-Authentifizierungsanfragen, optional, Standard: 5s
    auth_timeout   5s;

    # Anzahl der Wiederholungen für RADIUS-Authentifizierungsanfragen, optional, Standard: 3
    auth_retries   3;

    # Timeout für RADIUS-Gesundheitsanfragen, optional, Standard: 5s
    health_timeout 5s;

    # Anzahl der Wiederholungen für RADIUS-Gesundheitsanfragen, optional, Standard: 1
    health_retries 1;

    # Größe der Warteschlange für RADIUS-Auth/Gesundheitsanfragen, optional, Standard: 10
    # Effektiv die Anzahl der gleichzeitigen Anfragen, die ohne
    # Neuplanung verarbeitet werden können.
    queue_size     10;
}

# Standortdirektive zur Auswahl des RADIUS-Servers.
# Es kann mehrere "radius_servers"-Direktiven pro Standort geben.
radius_servers "radius_server_1";

# Standortdirektive zur Aktivierung des Moduls und zur Durchführung der Auth-Anfrage.
auth_radius              "realm" | off;
radius_auth              "realm" | off;

# Standortdirektive zur Aktivierung des Moduls und zur Durchführung der Gesundheitsanfrage.
radius_health            ["user"] ["passwd"];
  1. Installation (optional):
$ make install

GitHub

Sie finden möglicherweise zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub-Repository für nginx-module-auth-radius.