FASTPANELWIKI

CLI

Benutzer

Auf dieser Seite

Erstellen eines neuen Benutzers

Befehl

mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]

Optionen

  • -u, --username=USERNAME : Geben Sie den Benutzernamen für den neuen Benutzer an.
  • -p, --password=PASSWORD : Geben Sie das Passwort für den neuen Benutzer an.
  • -r, --role="USER" : Geben Sie die Rolle für den neuen Benutzer an. Unterstützte Rollen sind RESELLER und USER. Die Standardrolle ist USER.

Nutzungsinformationen

Um einen neuen Benutzer mit dem Benutzernamen testuser, dem Passwort My$ecretPassword123 und der Rolle RESELLER zu erstellen, verwenden Sie den folgenden Befehl:

mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"

Zusätzliche Hinweise

  • Benutzernamen müssen eindeutig sein und dürfen weder Leerzeichen noch Punkte enthalten.
  • Passwörter müssen mindestens 8 Zeichen lang sein. Wir empfehlen, mindestens einen Großbuchstaben, einen Kleinbuchstaben, eine Zahl und ein Sonderzeichen zu verwenden.

Übertragung von Benutzern zwischen FASTPANEL-Servern

Auf dieser Seite

Einführung

Dieser Artikel beschreibt den Prozess der Übertragung von Benutzerkonten und den damit verbundenen Daten (Websites, Datenbanken, E-Mail usw.) von einem FASTPANEL-Server auf einen anderen mithilfe des integrierten Migrationswerkzeugs.

Wichtige Begriffe

  • Quellserver - Der Server, von dem Daten übertragen werden.
  • Zielserver - Der Server, auf den Daten übertragen werden.

Wichtige Hinweise

  • Standardmäßig funktioniert die Migration nur für Websites mit einer standardmäßigen FASTPANEL-Konfiguration korrekt.

  • Websites mit Änderungen an der manuellen Konfiguration können nur übertragen werden, wenn das Flag -m für die Zuordnung von IP-Adressen verwendet wird.

  • Wenn kein verschlüsseltes Passwort für einen Datenbankbesitzer verfügbar ist, wird die Datenbank nicht übertragen.

  • Wenn eine Website nicht übertragen wird, werden ihre zugehörigen Datenbanken ebenfalls nicht übertragen.

  • Es können nur lokale Datenbanken übertragen werden.

Migrationsprozess

Verbindung

Der Zielserver verbindet sich über SSH mit dem Quellserver. Bei der ersten Verbindung installiert der Zielserver einen SSH-Schlüssel auf dem Quellserver (entweder im Voraus bereitgestellt oder aus einem Passwort generiert).

Migrationsschritte

  • Installation des Moduls
  • Erfassung von Informationen über übertragbare Objekte
  • Erstellen von Benutzern
  • Übertragung von SSL-Zertifikaten
  • Erstellen von Websites, FTP-Konten, E-Mail-Domains und E-Mail-Konten
  • Erstellen von Datenbanken und Datenbankbenutzern
  • Übertragung von Website- und E-Mail-Postfachdateien
  • Übertragung von Cronjobs

Die Dateiübertragung wird mit rsync ausgeführt. Datenbanken werden durch Erstellen eines Dumps über einen SSH-Tunnel übertragen.

Befehl zum Starten der Migration

Der Befehl wird auf dem Zielserver als Benutzer mit Root-Rechten ausgeführt:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Befehlszeilen-Flags

SSH-Verbindung

  • --remote_host="SOURCE_IP" - IP-Adresse des Quellservers.
  • --remote_port="SSH_PORT" - SSH-Port.
  • --remote_username="SSH_USER" - Benutzer (muss root sein).
  • --remote_password="USER_PASSWORD" - Passwort für den angegebenen SSH-Benutzer.
  • --ssh_key_path="PATH_TO_KEY" - Pfad zum privaten SSH-Schlüssel auf dem Zielserver für die Verbindung mit dem Quellserver. Wenn ein Schlüssel verwendet wird, wird das Passwort (--remote_password) nicht benötigt.

IP-Adressen

Sie müssen nur eines der folgenden Flags verwenden, um die IP-Adressen der Websites während der Übertragung zu verwalten. Das Flag -m hat Priorität.

  • -i "IP_ADDRESS_ON_DESTINATION" - Weist allen übertragenen Websites auf dem Zielserver die angegebene IP-Adresse zu. Um mehrere IPs anzugeben (z. B. wenn es auf dem Quellserver mehrere gab), wiederholen Sie das Flag für jede Quell-IP, die übertragen werden muss.

  • -m "SOURCE_IP,DESTINATION_IP" - Empfohlene Methode. Erstellt eine direkte Zuordnung: Alle Websites, die auf dem Quellserver SOURCE_IP verwenden, verwenden auf dem Zielserver DESTINATION_IP. Dieses Flag kann für verschiedene IP-Paare mehrfach angegeben werden. Erforderlich für die Übertragung von Websites mit manuellen Konfigurationsbearbeitungen, da dadurch IP-Adressen in Listen-Direktiven korrekt ersetzt werden können.

Zusätzliche Einstellungen

  • --users="USER_LIST" - Überträgt nur die angegebenen Benutzer (durch Kommas getrennt). Wenn nichts angegeben ist, werden alle Benutzer übertragen.
  • --disable_disk_quota - Deaktiviert die Übertragung von Festplattenkontingenten der Benutzer.
  • --with_user_data - Schließt das Kopieren des gesamten Inhalts der Home-Verzeichnisse der Benutzer ein (außer dem Unterverzeichnis logs/). Mit Vorsicht verwenden, da dies die Übertragungszeit und die Menge der übertragenen Daten erheblich erhöhen kann.
  • --only_data - Überträgt nur Daten (Website-Dateien, Mail-Dateien, Datenbank-Dumps). Nützlich, wenn die anfängliche Strukturmigration (Benutzer, Websites, DBs usw.) erfolgreich war, aber während der Phase des Kopierens von Dateien oder Dumps Fehler auftraten. Ermöglicht das erneute Ausführen nur des Teils zum Kopieren der Daten.
  • --transfer_timeout - Legt das Zeitlimit für den Vorgang fest (Standard ist 60 Minuten).

Beispielbefehl

Übertragen Sie alle Benutzer vom Server 11.22.33.44 auf den aktuellen Server. Auf dem alten Server verwendeten die Websites die IPs 11.22.33.44 und 11.22.33.55; auf dem neuen Server sollten sie jeweils 99.88.77.66 und 99.88.77.67 verwenden. Verbindung über SSH mit einem Passwort.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Mögliche Probleme und Fehlertypen

Ein Fehler im Migrationsprotokoll weist nicht immer auf ein kritisches Problem hin, sondern kann auf den Grund hinweisen, warum ein bestimmtes Objekt nicht übertragen wurde.

  • Konflikte: Treten auf, wenn die Übertragung eines Objekts aufgrund der aktuellen Konfiguration des Zielservers unmöglich ist (z. B. wenn ein Benutzer oder eine Website mit demselben Namen bereits existiert) oder wenn die Konfiguration der Website auf dem Quellserver dem Panel unbekannt ist (z. B. aufgrund umfangreicher manueller Bearbeitungen).

  • Fehlendes gespeichertes Passwort: Wie bereits erwähnt, können MySQL-Datenbankbenutzer ohne ein in FASTPANEL auf dem Quellserver gespeichertes Passwort nicht übertragen werden.

  • Manuelle Einstellungen und IP-Adressen: Wenn eine Website auf dem Quellserver manuelle Bearbeitungen der Webserver-Konfiguration aufweist und das Flag -m während der Migration nicht verwendet wird, um ihre IP-Adresse zuzuordnen, wird eine solche Website nicht übertragen, weil das Panel nicht weiß, welche IP in der Konfiguration auf dem Zielserver angegeben werden soll.

Datenbanken

Auf dieser Seite

Abrufen einer Liste von Datenbankservern

Befehl

mogwai databases servers list

Beispielausgabe

ID      NAME                    TYPE            LOCAL   HOST    USERNAME        AVAIL
1       mysql(localhost)        mysql           true            fastuser        true
2       postgresql(localhost)   postgresql      true            fastuser        true

Der Server IDs wird in anderen Befehlen verwendet.

Abrufen einer Liste von Datenbanken

Befehl

mogwai databases list

Beispielausgabe

ID      NAME            SERVER_NAME             LOCAL           HOST    CHARSET OWNER   SIZE    CREATE_AT                              
1       db1             mysql(localhost)        localhost       true    utf8mb4 user    0       2024-05-28 10:03:03.227413266 +0000 UTC
2       database43s     mysql(localhost)        localhost       true    utf8mb4 user82  0       2024-05-28 10:07:15.001640584 +0000 UTC

Synchronisieren der Datenbankliste

Wenn Sie kürzlich Datenbanken hinzugefügt oder entfernt haben und diese noch nicht in FASTPANEL angezeigt werden, können Sie die Synchronisierung der Listen erzwingen

Befehl

mogwai databases sync

Erstellen einer neuen Datenbank

Befehl

mogwai databases create [flags]

Optionen

  • -n, --name=NAME : Name der Datenbank.
  • -o, --owner="fastuser" :  FASTPANEL-Benutzer, dem die Datenbank hinzugefügt wird.
  • -s, --site=SITE : Website in FASTPANEL, der die Datenbank hinzugefügt wird.
  • -c, --charset="utf8mb4" : Kodierung der Datenbank.
  • -u, --username=USERNAME : Benutzername der Datenbank.
  • -p, --password=PASSWORD : Passwort des Datenbankbenutzers.

Beispielbefehl

mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1

Dieser Befehl erstellt eine Datenbank mit dem Namen db1 auf dem Standard-Datenbankserver (--server=1) und "bindet" sie an die Website example.com.

E-Mail

Auf dieser Seite

Abrufen einer Liste von E-Mail-Domains

Befehl

mogwai emails domains list

Beispielausgabe

ID      NAME            FALLBACK        DKIM    ENABLED OWNER_ID        OWNER           CREATE_AT
1       example.com                     true    true    1               example_com_usr 2024-01-04 15:46:02+03:00

Die Domain IDs wird in anderen Befehlen verwendet.

Hinzufügen einer E-Mail-Domain

Befehl

mogwai emails domains create

Optionen

  • --domain=DOMAIN : Name der E-Mail-Domain.
  • -o, --owner="fastuser" : Der FASTPANEL-Benutzer, dem die E-Mail-Domain hinzugefügt wird.

Beispiel für das Erstellen einer E-Mail-Domain example1.com unter dem Benutzer fastuser

mogwai emails domains create --domain=example1.com -o fastuser

Abrufen einer Liste von Postfächern

Befehl

mogwai emails boxes list

Optionen

  • --domain=DOMAIN : Name der Mail-Domain

Beispielbefehl

mogwai emails boxes list --domain example.com

Beispielausgabe

ID      ADDRESS                 ALIASES REDIRECTS       SIZE    QUOTA   ENABLED OWNER_ID        OWNER           CREATE_AT
1       user@example.com                                0       0       true    4               example_com_usr 2024-02-08 11:13:01+03:00

Die ID aus der Befehlsausgabe wird in anderen Befehlen verwendet.

Erstellen eines Postfachs

Befehl

mogwai emails boxes create

Optionen

  • --domain=DOMAIN : Name der E-Mail-Domain.
  • -l, --login=LOGIN : Der Name des Postfachs, ohne die Domain.
  • -p, --password=PASSWORD : Das Passwort für das Postfach.

Beispielbefehl

mogwai emails boxes create  --domain=example.com --login=user --password=MySecretPassword123

Dieser Befehl erstellt ein Postfach mit dem Namen user@example.com und dem Passwort MySecretPassword123.

Löschen eines Postfachs

Befehl

mogwai emails boxes delete

Optionen

  • -b, --box=BOX : Die ID des Postfachs..

Beispielbefehl

mogwai emails boxes delete -b 1

Dieser Befehl löscht das Postfach mit der ID 1.

Importieren von Postfächern und E-Mails

Befehl

mogwai emails boxes import[sync] [<flags>]

Optionen

  • -i, --import_config=IMPORT_CONFIG : Pfad zur Datei mit der Importliste
  • --force : Nur für den Modus import - vorhandene Postfächer leeren.

Um E-Mails zu importieren, müssen Sie eine Liste von Postfächern auf dem Server in folgendem Format vorbereiten:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Optionen

  • IMAP_HOST : Adresse des IMAP-Mailservers.
  • SOURCE_ADDR : Postfach auf dem Quellserver.
  • SOURCE_PASSWORD : Passwort für die IMAP-Verbindung zum Postfach auf dem Quellserver. Einige Dienste, wie z. B. Google, erfordern die Erstellung eines Anwendungspassworts für den IMAP-Zugriff https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Postfach auf dem FASTPANEL-Server, in das Nachrichten übertragen werden.

Beispielinhalt der Datei

imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.com

Es sind zwei Modi verfügbar:

Importmodus

mogwai emails boxes import

In diesem Modus werden alle Nachrichten vollständig kopiert, Postfächer auf dem FASTPANEL-Server dürfen nicht erstellt worden sein oder leer sein - wenn der Befehl ausgeführt wird, erstellt FASTPANEL die erforderlichen Postfächer. Wenn bereits Postfächer mit Inhalt vorhanden sind, wird ein Fehler angezeigt. Sie können das Flag --force verwenden - dann wird das Postfach geleert.

Beispiel für das Ausführen des Befehls mit einer Liste von Postfächern, die in der Datei /root/import.txt gespeichert ist, und unter Verwendung des Schlüssels --force

mogwai emails boxes import --import_config=/root/import.txt --force

Synchronisierungsmodus

mogwai emails boxes sync

In diesem Modus lädt das Control Panel Nachrichten vom Quellserver herunter, ohne etwas zu löschen. Er sollte verwendet werden, wenn nach dem ersten Import neue Nachrichten im ursprünglichen Postfach erschienen sind, die ebenfalls übertragen werden müssen.

Beispielbefehl

mogwai emails boxes sync --import_config=/root/import.txt

Beschreibung

Auf dieser Seite

FASTPANEL bietet eine Befehlszeilenschnittstelle (CLI), die über das Dienstprogramm mogwai (/usr/local/bin/mogwai) implementiert ist. Das Dienstprogramm funktioniert nur, wenn es als root ausgeführt wird.

Hilfe

Um eine Liste der verfügbaren Befehle anzuzeigen, verwenden Sie:

mogwai --help

Um mehr über einen bestimmten Befehl zu erfahren, verwenden Sie:

mogwai command --help

Um eine Liste der Befehle mit Beschreibungen anzuzeigen, verwenden Sie:

mogwai --help-long

Websites

Auf dieser Seite

Sites auf einem Server auflisten

Befehl

mogwai sites list

Beispielausgabe

ID      SERVER_NAME             ALIASES                         OWNER                   MODE    PHP_VERSION     IPS             DOCUMENT_ROOT
1       example.com             www.example.com                 example_com_usr         mpm_itk 82              127.0.0.1   /var/www/example_com_usr/data/www/example.com

Hinweis: Site IDs aus dieser Liste werden in anderen Befehlen verwendet.

Eine neue Site erstellen

Befehl

mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]

Optionen

  • --owner : Benutzer im FASTPANEL-System, dem die Site gehören wird.
  • --server-name=SERVER-NAME : Domainname für die Site.
  • -a, --alias=ALIAS : Aliasse für die Site, wie z. B. www-Subdomains. Es können mehrere Aliasse angegeben werden.
  • --ip=IP : IP-Adresse des Servers, auf dem die Site ausgeführt wird. Es können mehrere IP-Adressen angegeben werden.
  • -h, --handler=HANDLER : Backend-Handler. Kann sein:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- oder Node.js-Version (z. B. 8.2, 8.3, 20.15.1).
  • --create-user : Einen Benutzer für die Site erstellen.

Beispielbefehl

mogwai sites create --server-name=example.com --owner=user --create-user --alias=www.example.com --ip=127.0.0.1 --handler=fcgi --handler_version=7.3

Eine Site löschen

Befehl

mogwai sites delete --id=ID

Die Site ID kann mit dem Befehl mogwai sites list ermittelt werden.

Beispielbefehl

mogwai sites delete --id=987

Dieser Befehl löscht die Site mit der ID 987

Site-Einstellungen ändern

Befehl

mogwai sites update --id=ID [<flags>]

Die Site ID kann mit dem Befehl mogwai sites list ermittelt werden.

Optionen

  • -i, --id=ID : ID der Site.
  • -a, --add-alias=ADD-ALIAS : Einen Alias hinzufügen, es können mehrere Aliasse angegeben werden.
  • --del-alias=DEL-ALIAS : Einen Alias löschen, es können mehrere Aliasse angegeben werden.
  • --add-ip=ADD-IP : Eine IP-Adresse aus den Site-Einstellungen hinzufügen, es können mehrere IP-Adressen angegeben werden.
  • --del-ip=DEL-IP : Eine IP-Adresse aus den Site-Einstellungen löschen, es können mehrere IP-Adressen angegeben werden.
  • -h, --handler=HANDLER : Backend-Handler. Kann sein:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- oder Node.js-Version (z. B. 8.2, 8.3, 20.15.1).
  • --gzip : Komprimierung aktivieren.
  • --no-gzip : Komprimierung deaktivieren.
  • --gzip-comp-level=LEVEL : Die Komprimierungsstufe festlegen, 1-9.
  • --expires=EXPIRES : Die Caching-Zeit für statische Inhalte festlegen.
  • --worker-count=WORKER-COUNT : Die Anzahl der Worker für PHP-FPM festlegen

Sie können Einstellungen für mehrere Sites auf einem Server auch mit dem Befehl aktualisieren

mogwai sites batch-update
  • Um die Einstellungen für alle Sites zu ändern, verwenden Sie das Flag -a.
  • Um die Einstellungen für ausgewählte Sites zu ändern, geben Sie mehrere Flags --id mit ihren IDs an.

Beispielbefehl

mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6

Dieser Befehl fügt einen Alias www1.example.com hinzu, ändert den Handler zu cgi und die PHP-Version zu 5.6 für die Website mit der ID 3

Beispielbefehl

mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2

Dieser Befehl ändert den PHP-Handler für Sites mit den IDs 2 und 3