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
-mfü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 Unterverzeichnislogs/). 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.67Mö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
-mwä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 listBeispielausgabe
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueDer Server IDs wird in anderen Befehlen verwendet.
Abrufen einer Liste von Datenbanken
Befehl
mogwai databases listBeispielausgabe
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 UTCSynchronisieren 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 syncErstellen 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 dbpassword1Dieser Befehl erstellt eine Datenbank mit dem Namen db1 auf dem Standard-Datenbankserver (--server=1) und "bindet" sie an die Website example.com.
Auf dieser Seite
Abrufen einer Liste von E-Mail-Domains
Befehl
mogwai emails domains listBeispielausgabe
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:00Die Domain IDs wird in anderen Befehlen verwendet.
Hinzufügen einer E-Mail-Domain
Befehl
mogwai emails domains createOptionen
--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 fastuserAbrufen einer Liste von Postfächern
Befehl
mogwai emails boxes listOptionen
--domain=DOMAIN: Name der Mail-Domain
Beispielbefehl
mogwai emails boxes list --domain example.comBeispielausgabe
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:00Die ID aus der Befehlsausgabe wird in anderen Befehlen verwendet.
Erstellen eines Postfachs
Befehl
mogwai emails boxes createOptionen
--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=MySecretPassword123Dieser Befehl erstellt ein Postfach mit dem Namen user@example.com und dem Passwort MySecretPassword123.
Löschen eines Postfachs
Befehl
mogwai emails boxes deleteOptionen
-b,--box=BOX: Die ID des Postfachs..
Beispielbefehl
mogwai emails boxes delete -b 1Dieser 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 Modusimport- 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_ADDROptionen
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=enDEST_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.comEs sind zwei Modi verfügbar:
Importmodus
mogwai emails boxes importIn 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 --forceSynchronisierungsmodus
mogwai emails boxes syncIn 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.txtBeschreibung
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 --helpUm mehr über einen bestimmten Befehl zu erfahren, verwenden Sie:
mogwai command --helpUm eine Liste der Befehle mit Beschreibungen anzuzeigen, verwenden Sie:
mogwai --help-longWebsites
Auf dieser Seite
Sites auf einem Server auflisten
Befehl
mogwai sites listBeispielausgabe
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.comHinweis: 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.
- PHP:
--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.3Eine Site löschen
Befehl
mogwai sites delete --id=IDDie Site ID kann mit dem Befehl mogwai sites list ermittelt werden.
Beispielbefehl
mogwai sites delete --id=987Dieser 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.
- PHP:
--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
--idmit ihrenIDsan.
Beispielbefehl
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Dieser 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 2Dieser Befehl ändert den PHP-Handler für Sites mit den IDs 2 und 3
FASTPANEL