Amnezia. Modulverwaltung

Dieser Artikel knüpft an Amnezia. Schnellstart an. Wenn Sie das Modul noch nicht installiert und den ersten Nutzer noch nicht angelegt haben, beginnen Sie dort. Hier finden Sie Operationen am Modul selbst: Dienst starten und stoppen, UDP-Port wechseln, aktualisieren, neu installieren und entfernen. Die VPN-Nutzerverwaltung ist in einem eigenen Artikel beschrieben — Amnezia. Nutzerverwaltung.

Seitenkopf und Aktionsmenü

Im Seitenkopf stehen die Hauptaktionen des Moduls zur Verfügung — Dienst starten, stoppen und neu starten. Der Dienststatus wird durch eine Statusanzeige und einen Chip mit der AmneziaWG-Version dargestellt. Im Drei-Punkte-Menü daneben liegen die übrigen Aktionen: Protokoll öffnen, zu den Moduleinstellungen wechseln, Aktualisierung suchen und ausführen, Modul neu installieren oder entfernen.

Dienst verwalten

• «Starten» — bringt den AmneziaWG-Dienst aus dem gestoppten Zustand hoch.
• «Stoppen» — schaltet den Dienst ab. Alle aktiven VPN-Verbindungen werden getrennt, neue lassen sich nicht aufbauen.
• «Neu starten» — stoppt den Dienst und startet ihn sofort wieder. Offene Verbindungen werden zurückgesetzt.

Änderungen an der Nutzerliste übernimmt der Server im laufenden Betrieb, ohne Neustart des Dienstes: Nutzer hinzufügen, deaktivieren oder entfernen — die neue Konfiguration greift sofort. Werden allerdings DNS oder Persistent Keepalive in der Nutzerkarte geändert, muss die .conf-Datei auf dem Gerät neu importiert werden — Details im Artikel Amnezia. Nutzerverwaltung.

⚠️ Das Stoppen des Dienstes trennt alle VPN-Verbindungen

Solange der Dienst aus ist, kann sich kein Nutzer verbinden. Planen Sie Stopps und Neustarts in ein Wartungsfenster oder informieren Sie die Nutzer im Voraus.

Während das Modul aktualisiert, neu installiert oder entfernt wird, sind die Dienststeuerung und das Aktionsmenü vorübergehend nicht verfügbar.

Modulprotokoll

Im Aktionsmenü wählen Sie «Protokoll» — das Journal der Modul-Lebenszyklusoperationen öffnet sich: Installation, Aktualisierung, Neuinstallation, Entfernung, Portwechsel. Jeder Eintrag zeigt den Status und die vollständige Ausgabe der Ausführung. Hilfreich, wenn eine Aktion mit einem Fehler endet und Sie die Ursache verstehen müssen.

Moduleinstellungen

Die Serverseite des Moduls wird auf einer eigenen Seite konfiguriert. Öffnen Sie diese über das Aktionsmenü → «Moduleinstellungen». Derzeit ist ein Reiter verfügbar — «Allgemein» — mit einem Abschnitt «Verbindung» und einem einzigen Parameter: dem UDP-Port, auf dem AmneziaWG eingehende Verbindungen entgegennimmt. Standard — 51720.

UDP-Port wechseln

1. Im Aktionsmenü wählen Sie «Moduleinstellungen» und wechseln Sie auf den Reiter «Allgemein».
2. Im Feld «Port» des Abschnitts «Verbindung» geben Sie eine neue Nummer an. Zur zusätzlichen Tarnung werden häufig 80, 443 oder 8443 verwendet, ein Konflikt mit anderen BeAdmin-Modulen ist jedoch möglich — das Panel weist unter dem Feld darauf hin.
3. Klicken Sie auf «Speichern». Das Panel bittet im Dialog «Änderung der Moduleinstellungen bestätigen» um Bestätigung; nach der Bestätigung wird der neue Port gespeichert und der Dienst automatisch neu gestartet.

⚠️ Ein Portwechsel unterbricht aktive Verbindungen

Nach Anwendung des neuen Ports funktionieren bestehende Client-Konfigurationen nicht mehr — in der .conf-Datei sind Adresse und Port des alten Servers eingebrannt. Die Konfigurationen müssen neu erzeugt und auf den Geräten neu importiert werden. Wird der vorherige Port wiederhergestellt, funktionieren die alten Konfigurationen wieder, ohne die Schlüssel neu auszustellen.

Modul aktualisieren

Im Aktionsmenü wählen Sie «Amnezia aktualisieren». Das Panel prüft, ob im Repository eine neuere Version von AmneziaWG vorliegt, installiert sie über die aktuelle und startet den Dienst neu. Die Nutzerliste und ihre Schlüssel bleiben erhalten — die .conf-Dateien müssen auf den Geräten nicht erneut importiert werden.

Eine Bestätigung gibt es für die Aktualisierung nicht — die Aktion startet sofort. Während sie läuft, sind die Dienststeuerung und die Menüpunkte nicht verfügbar; die aktuelle Modulversion ist am AmneziaWG-Chip im Seitenkopf zu sehen. Ist bereits die aktuelle Version installiert, wird die Aktualisierung nicht gestartet — das Panel weist darauf hin.

Modul neu installieren

Im Aktionsmenü wählen Sie «Amnezia neu installieren». Das Panel bittet um Bestätigung der Neuinstallation — klicken Sie auf «Bestätigen». Dieselbe AmneziaWG-Version wird über die aktuelle installiert, der Dienst neu gestartet. Die Nutzerliste, ihre Schlüssel und aktive Verbindungen bleiben erhalten — die .conf-Dateien müssen auf den Geräten nicht erneut importiert werden.

Verwenden Sie die Neuinstallation, wenn das Modul instabil läuft und Sie die Installation noch einmal durchführen möchten, ohne Nutzer zu verlieren. Im Gegensatz zur Entfernung löscht die Neuinstallation keine Nutzer und Schlüssel — bereits ausgestellte .conf-Konfigurationen funktionieren weiter ohne erneutes Verbinden und ohne erneuten Import.

Den Port verändert die Neuinstallation nicht — das Modul kommt auf demselben UDP-Port wieder hoch. Um Port und Neuinstallation gleichzeitig zu wechseln, führen Sie beide Schritte einzeln in beliebiger Reihenfolge aus: den Portwechsel in den «Moduleinstellungen» und die Neuinstallation des Moduls.

Verbinden sich Clients nach der Neuinstallation nicht mehr — laden Sie die .conf-Datei erneut herunter oder erzeugen Sie den QR-Code in der ausgeklappten Nutzerzeile neu. Bleiben die Fehler bestehen, ist der letzte Ausweg, das Modul vollständig zu entfernen und neu zu installieren.

Modul entfernen

Im Aktionsmenü wählen Sie «Amnezia entfernen». Das Panel bittet im Dialog «Entfernen des Amnezia-Moduls bestätigen» um Bestätigung: zusammen mit dem Modul werden alle Einstellungen der Nutzerverbindungen gelöscht; nach einer erneuten Installation entsteht der Server von Grund auf.

‼️ Das Entfernen des Moduls löscht alle VPN-Nutzer

Die Entfernung ist unumkehrbar: zusammen mit dem Modul verschwinden alle Amnezia-Nutzer, ihre Schlüssel und die erzeugten .conf-Konfigurationsdateien. Bereits importierte Client-Konfigurationen können sich nach der Entfernung nicht mehr verbinden. Nach einer erneuten Installation müssen Modul und Nutzer neu angelegt werden; es werden neue Schlüssel ausgestellt, und die Clients müssen die Konfiguration neu importieren. Die Amnezia-Lizenz-Slots werden freigegeben — sie können wiederverwendet oder bis zur nächsten Installation außer Acht gelassen werden.

Nach der Bestätigung startet das Panel die Entfernung. Mit dem Abschluss kehrt die Modulseite in den Ausgangszustand mit der Schaltfläche «Installieren» zurück.

Was kommt als Nächstes

• Amnezia. Schnellstart — Modul installieren und erste Verbindung.
• Amnezia. Nutzerverwaltung — Nutzer anlegen, bearbeiten, entfernen und zusätzliche Slots kaufen.
• SMTP-Relay für den E-Mail-Versand einrichten — damit die .conf-Datei per E-Mail an Nutzer geschickt werden kann.