Amnezia. Modul verwalten

Dieser Artikel ist die Fortsetzung von Amnezia-Schnellstart. Falls Sie das Modul noch nicht installiert und den ersten Benutzer noch nicht angelegt haben, beginnen Sie dort. Hier sind Operationen am Modul selbst zusammengefasst: Service starten und stoppen, UDP-Port wechseln, aktualisieren und deinstallieren. Die Verwaltung von VPN-Benutzern ist in einen separaten Artikel ausgelagert — Amnezia. Benutzer verwalten.

Service verwalten

Oben rechts auf der Modulseite stehen drei Schaltflächen zur Verwaltung des Amnezia-Service zur Verfügung: «Start», «Stopp» und «Neustart».

• «Start» — startet den Service aus dem gestoppten Zustand. Die Schaltfläche ist nur aktiv, wenn der Service derzeit ausgeschaltet ist.
• «Stopp» — schaltet den Service ab. Alle aktiven VPN-Verbindungen werden getrennt, neue können nicht aufgebaut werden.
• «Neustart» — stoppt den Service und startet ihn sofort wieder. Offene Verbindungen werden getrennt.

Änderungen an der Benutzerliste übernimmt der Server im laufenden Betrieb, ohne den Service neu zu starten: Hinzufügen, Deaktivieren oder Löschen wird sofort wirksam. Wurden jedoch im Benutzerprofil der Client-DNS oder Persistent Keepalive geändert, muss die .conf-Datei auf dem Gerät erneut importiert werden — Details unter Amnezia. Benutzer verwalten.

⚠️ Das Stoppen des Service trennt alle VPN-Verbindungen

Solange der Service ausgeschaltet ist, kann sich kein Benutzer verbinden. Planen Sie Stopps und Neustarts in einem Wartungsfenster oder informieren Sie die Benutzer rechtzeitig.

Während das Modul aktualisiert oder deinstalliert wird, sind die Service-Schaltflächen vorübergehend nicht verfügbar.

ℹ️ Port

Standardmäßig läuft AmneziaWG auf UDP-Port 51720. Der Port lässt sich über den Tab «Einstellungen» auf der Modulseite ändern.

⚠️ Einschränkungen durch Provider

Die Verschlüsselung des Datenverkehrs macht ein VPN zu einem zuverlässigen Mittel zum Schutz der Verbindung. In einigen Ländern und Regionen setzen Internetanbieter jedoch technische Maßnahmen gegen VPN-Protokolle ein. Eine vollständige Verfügbarkeit des Dienstes kann deshalb nicht garantiert werden — unabhängig von der Art der Verbindung. Wenn ein Protokoll bei Ihnen nicht funktioniert, probieren Sie ein anderes VPN-Modul aus dem Panel. Funktioniert keines davon in Ihrem Netzwerk, wenden Sie sich an den Support — wir erstatten die Lizenzgebühr.

Hinweis auf nicht konfiguriertes SMTP

Im Header der Modulseite kann ein Banner «E-Mail-Versand nicht konfiguriert» mit einem Link zu den SMTP-Einstellungen erscheinen. Das bedeutet, dass die .conf-Datei derzeit nicht per E-Mail an Benutzer gesendet werden kann. Das VPN selbst funktioniert weiterhin: Das Banner betrifft nur den E-Mail-Versand, das Herunterladen der .conf und die QR-Codes im Dialog «Verbindungseinstellungen» bleiben verfügbar. Die SMTP-Einrichtung ist im Artikel SMTP-Relay für den E-Mail-Versand einrichten beschrieben.

Moduleinstellungen

Im Header der Modulseite gibt es neben dem Titel den Tab «Einstellungen», der den Bereich «Verbindung» mit den Parametern der Serverseite öffnet. Derzeit ist eine Einstellung verfügbar — der UDP-Port-Wechsel.

UDP-Port

1. Wechseln Sie auf den Tab «Einstellungen».
2. Geben Sie im Feld «Port» die neue Nummer ein. Für zusätzliche Tarnung sind 80, 443 oder 8443 gängige Wahlmöglichkeiten, jedoch ist ein Konflikt mit anderen Modulen möglich — das Panel weist unter dem Feld darauf hin.
3. Klicken Sie auf «Speichern». Das Panel bittet Sie, den Portwechsel zu bestätigen; nach der Bestätigung wird der neue Wert gespeichert und der Service automatisch neu gestartet.

⚠️ Ein Portwechsel trennt aktive Verbindungen

Sobald der neue Port wirksam wird, funktionieren bestehende Client-Konfigurationen nicht mehr: In der .conf-Datei steckt der alte Endpoint. Die Konfigurationen müssen neu generiert und auf den Geräten erneut importiert werden. Kehren Sie später zum vorherigen Port zurück, funktionieren die alten Konfigurationen wieder, ohne dass die Schlüssel neu ausgestellt werden müssen.

Modul aktualisieren

Wählen Sie im Aktionsmenü des Moduls neben dem Titel «Amnezia» den Punkt «Amnezia aktualisieren». Das Panel lädt die aktuelle AmneziaWG-Version aus dem Repository und installiert sie über die bestehende. Die Benutzerliste und ihre Schlüssel bleiben erhalten.

Eine Bestätigung gibt es bei der Aktualisierung nicht — die Aktion startet sofort. Während sie läuft, erscheint im Header die Anzeige «Amnezia wird aktualisiert», und die Service-Schaltflächen sowie die Menüpunkte sind nicht verfügbar. Die Modulversion wird unter dem Titel als Zeile der Form «AmneziaWG: 1.2.3» angezeigt.

Modul neu installieren

Wählen Sie im Aktionsmenü des Moduls neben dem Titel «Amnezia» den Punkt «Amnezia neu installieren». Das Panel installiert dieselbe AmneziaWG-Version über die bestehende neu und startet den Service neu. Die Benutzerliste und ihre aktiven Verbindungen bleiben erhalten — die .conf-Dateien müssen auf den Geräten nicht erneut importiert werden.

Das Panel bittet Sie, die Neuinstallation zu bestätigen — klicken Sie auf «Bestätigen». Während der Vorgang läuft, erscheint im Header die Anzeige «Amnezia wird neu installiert», und die Service-Schaltflächen sowie die Menüpunkte sind nicht verfügbar.

Verwenden Sie eine Neuinstallation, wenn das Modul instabil läuft und Sie die Installation erneut durchlaufen möchten, ohne Benutzer zu verlieren.

ℹ️ Benutzerdaten bleiben erhalten

Im Gegensatz zur Deinstallation löscht die Neuinstallation weder Benutzer noch ihre Schlüssel. Bereits ausgegebene .conf-Konfigurationen funktionieren nach dem Vorgang weiter — eine erneute Verbindung oder ein erneuter Import der Dateien ist nicht erforderlich.

ℹ️ Port bei der Neuinstallation

Eine Neuinstallation behält den UDP-Port bei — das Modul startet auf demselben Port wie zuvor. Um Neuinstallation und Portwechsel zu kombinieren, führen Sie die beiden Schritte in beliebiger Reihenfolge getrennt aus: den Portwechsel im Tab «Einstellungen» und die Neuinstallation über das Aktionsmenü.

ℹ️ Wenn die Verbindung nicht wiederhergestellt wird

Kann sich ein Benutzer nach der Neuinstallation nicht verbinden, deaktivieren Sie ihn in der Liste, aktivieren ihn erneut und importieren die .conf-Datei oder den QR-Code in der App auf seinem Gerät neu. Bestehen die Fehler weiter, bleibt als letztes Mittel, das Modul vollständig zu deinstallieren und erneut zu installieren.

Modul deinstallieren

Wählen Sie im Aktionsmenü des Moduls «Amnezia deinstallieren». Das Panel bittet Sie, das Löschen zu bestätigen: Zusammen mit dem Modul werden alle Verbindungseinstellungen der Benutzer entfernt; nach einer erneuten Installation startet der Server bei null.

‼️ Beim Deinstallieren des Moduls werden alle VPN-Benutzer gelöscht

Die Aktion ist nicht rückgängig zu machen: Zusammen mit dem Modul gehen alle Amnezia-Benutzer, ihre Schlüssel und die erzeugten .conf-Konfigurationsdateien verloren. Bereits importierte Client-Konfigurationen können sich nach der Deinstallation nicht mehr verbinden. Nach einer erneuten Installation müssen Modul und Benutzer neu angelegt werden; es werden neue Schlüssel ausgestellt, und auf den Clients muss die Konfiguration erneut importiert werden.

Nach der Bestätigung startet das Panel die Deinstallation; der Vorgang wird im Header durch die Anzeige «Amnezia wird deinstalliert» dargestellt. Nach Abschluss kehrt die Modulseite in ihren Ausgangszustand mit der Schaltfläche «Installieren» zurück.

Aufgabenprotokoll

Im Header der Modulseite befindet sich ein Link zum Aufgabenprotokoll des Moduls. Es zeichnet alle Lifecycle-Operationen am Modul auf — Installation, Aktualisierung, Deinstallation, Portwechsel — mit Status und Ausführungs-Logs. Nützlich, wenn Installation oder Aktualisierung mit einem Fehler endet und Sie die Ursache klären müssen.

Nützliche Links

• Amnezia-Schnellstart — Installation des Moduls und erste Verbindung.
• Amnezia. Benutzer verwalten — Anlegen, Bearbeiten und Löschen von Benutzern sowie Plätze hinzukaufen.
• SMTP-Relay für den E-Mail-Versand einrichten — damit die .conf-Datei per E-Mail an Benutzer gesendet werden kann.