FASTPANELWIKI

CLI

Användare

På den här sidan

Skapa en ny användare

Kommando

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

Alternativ

  • -u, --username=USERNAME : Ange användarnamnet för den nya användaren.
  • -p, --password=PASSWORD : Ange lösenordet för den nya användaren.
  • -r, --role="USER" : Ange rollen för den nya användaren. Roller som stöds är RESELLER och USER. Standardrollen är USER.

Användningsinformation

För att skapa en ny användare med användarnamnet testuser, lösenordet My$ecretPassword123 och rollen RESELLER, använd följande kommando:

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

Ytterligare anmärkningar

  • Användarnamn måste vara unika och får inte innehålla mellanslag eller punkter.
  • Lösenord måste vara minst 8 tecken långa. Vi rekommenderar att du använder minst en versal, en gemen, en siffra och ett specialtecken.

Databaser

På den här sidan

Hämta en lista över databasservrar

Kommando

mogwai databases servers list

Exempel på utdata

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

Servern IDs används i andra kommandon.

Hämta en lista över databaser

Kommando

mogwai databases list

Exempel på utdata

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

Synkronisera databaslistan

Om du nyligen har lagt till eller tagit bort databaser, och de ännu inte har visats i FASTPANEL, kan du tvinga fram synkronisering av listorna

Kommando

mogwai databases sync

Skapa en ny databas

Kommando

mogwai databases create [flags]

Alternativ

  • -n, --name=NAME : Databasnamn.
  • -o, --owner="fastuser" :  FASTPANEL-användare som databasen ska läggas till för.
  • -s, --site=SITE : Webbplats i FASTPANEL som databasen ska läggas till för.
  • -c, --charset="utf8mb4" : Databaskodning.
  • -u, --username=USERNAME : Databasanvändarnamn.
  • -p, --password=PASSWORD : Lösenord för databasanvändaren.

Exempelkommando

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

Det här kommandot skapar en databas med namnet db1 på standarddatabasservern (--server=1) och "binder" den till webbplatsen example.com.

E-post

På den här sidan

Hämta en lista över e-postdomäner

Kommando

mogwai emails domains list

Exempel på utdata

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

Domänerna IDs används i andra kommandon.

Lägga till en e-postdomän

Kommando

mogwai emails domains create

Alternativ

  • --domain=DOMAIN : Namn på e-postdomän.
  • -o, --owner="fastuser" : FASTPANEL-användaren som e-postdomänen ska läggas till för.

Exempel på att skapa e-postdomänen example1.com under användaren fastuser

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

Hämta en lista över brevlådor

Kommando

mogwai emails boxes list

Alternativ

  • --domain=DOMAIN : Namn på e-postdomän

Exempelkommando

mogwai emails boxes list --domain example.com

Exempel på utdata

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

ID från kommandots utdata används i andra kommandon.

Skapa en brevlåda

Kommando

mogwai emails boxes create

Alternativ

  • --domain=DOMAIN : Namn på e-postdomän.
  • -l, --login=LOGIN : Namnet på brevlådan, utan domänen.
  • -p, --password=PASSWORD : Lösenordet för brevlådan.

Exempelkommando

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

Detta kommando skapar en brevlåda med namnet user@example.com och lösenordet MySecretPassword123.

Ta bort en brevlåda

Kommando

mogwai emails boxes delete

Alternativ

  • -b, --box=BOX : ID för brevlådan..

Exempelkommando

mogwai emails boxes delete -b 1

Detta kommando tar bort brevlådan med ID 1.

Importera brevlådor och e-postmeddelanden

Kommando

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

Alternativ

  • -i, --import_config=IMPORT_CONFIG : Sökväg till importlistfilen
  • --force : Endast för läget import - rensa befintliga brevlådor.

För att importera e-post måste du förbereda en lista över brevlådor på servern i formatet:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Alternativ

  • IMAP_HOST : Adress till IMAP-e-postservern.
  • SOURCE_ADDR : Brevlåda på källservern.
  • SOURCE_PASSWORD : Lösenord för IMAP-anslutning till brevlådan på källservern. Vissa tjänster, till exempel Google, kräver att man skapar ett applikationslösenord för IMAP-åtkomst https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Brevlåda på FASTPANEL-servern som meddelanden överförs till.

Exempel på filinnehåll

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

Två lägen är tillgängliga:

Importläge

mogwai emails boxes import

I detta läge kopieras alla meddelanden i sin helhet, brevlådor på FASTPANEL-servern får inte vara skapade eller måste vara tomma - när kommandot körs skapar FASTPANEL de nödvändiga brevlådorna. Om brevlådor med innehåll redan finns visas ett fel. Du kan använda flaggan --force - då rensas brevlådan.

Exempel på att köra kommandot med en lista över brevlådor lagrad i filen /root/import.txt och med nyckeln --force

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

Synkroniseringsläge

mogwai emails boxes sync

I detta läge hämtar kontrollpanelen meddelanden från källservern utan att ta bort något. Det bör användas om nya meddelanden har dykt upp i den ursprungliga brevlådan efter den första importen, som också behöver överföras.

Exempelkommando

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

Beskrivning

På den här sidan

FASTPANEL tillhandahåller ett kommandoradsgränssnitt (CLI) som implementeras genom verktyget mogwai (/usr/local/bin/mogwai). Verktyget fungerar endast när det körs som root.

Hjälp

Använd följande för att se en lista över tillgängliga kommandon:

mogwai --help

Använd följande för att läsa mer om ett specifikt kommando:

mogwai command --help

Använd följande för att se en lista över kommandon med beskrivningar:

mogwai --help-long

Webbplatser

På den här sidan

Lista sajter på en server

Kommando

mogwai sites list

Exempel på utdata

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

Obs: Sajt IDs från den här listan används i andra kommandon.

Skapa en ny sajt

Kommando

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

Alternativ

  • --owner : Användare i FASTPANEL-systemet som ska äga sajten.
  • --server-name=SERVER-NAME : Domännamn för sajten.
  • -a, --alias=ALIAS : Alias för sajten, till exempel www-underdomäner. Flera alias kan anges.
  • --ip=IP : IP-adress för servern där sajten ska köras. Flera IP-adresser kan anges.
  • -h, --handler=HANDLER : Backend-hanterare. Kan vara:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- eller Node.js-version (t.ex. 8.2, 8.3, 20.15.1).
  • --create-user : Skapa en användare för sajten.

Exempel på kommando

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

Ta bort en sajt

Kommando

mogwai sites delete --id=ID

Sajten ID kan hämtas från kommandot mogwai sites list.

Exempel på kommando

mogwai sites delete --id=987

Det här kommandot tar bort sajten med ID 987

Ändra sajtinställningar

Kommando

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

Sajten ID kan hämtas från kommandot mogwai sites list.

Alternativ

  • -i, --id=ID : ID för sajten.
  • -a, --add-alias=ADD-ALIAS : Lägg till ett alias, flera alias kan anges.
  • --del-alias=DEL-ALIAS : Ta bort ett alias, flera alias kan anges.
  • --add-ip=ADD-IP : Lägg till en IP-adress från sajtinställningarna, flera IP-adresser kan anges.
  • --del-ip=DEL-IP : Ta bort en IP-adress från sajtinställningarna, flera IP-adresser kan anges.
  • -h, --handler=HANDLER : Backend-hanterare. Kan vara:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- eller Node.js-version (t.ex. 8.2, 8.3, 20.15.1).
  • --gzip : Aktivera komprimering.
  • --no-gzip : Inaktivera komprimering.
  • --gzip-comp-level=LEVEL : Ange komprimeringsnivån, 1-9.
  • --expires=EXPIRES : Ange cachetiden för statiskt innehåll.
  • --worker-count=WORKER-COUNT : Ange antalet workers för PHP-FPM

Du kan också uppdatera inställningar för flera sajter på en server med kommandot

mogwai sites batch-update
  • För att ändra inställningarna för alla sajter, använd flaggan -a.
  • För att ändra inställningarna för valda sajter, ange flera flaggor --id med deras IDs.

Exempel på kommando

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

Det här kommandot lägger till ett alias www1.example.com, ändrar handler till cgi och PHP-versionen till 5.6 för sajten med ID 3

Exempel på kommando

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

Det här kommandot ändrar PHP-hanteraren för sajter med ID 2 och 3

Överföra användare mellan FASTPANEL

På den här sidan

Introduktion

Den här artikeln beskriver processen för att överföra användarkonton och tillhörande data (webbplatser, databaser, e-post osv.) från en FASTPANEL-server till en annan med hjälp av det inbyggda migreringsverktyget.

Viktiga termer

  • Källserver - Servern från vilken data överförs.
  • Målserver - Servern till vilken data överförs.

Viktiga anmärkningar

  • Som standard fungerar migreringen korrekt endast för webbplatser med en standardkonfiguration i FASTPANEL.

  • Webbplatser med ändringar i manuell konfiguration kan endast överföras om flaggan -m används för mappning av IP-adresser.

  • Om ett krypterat lösenord för en databasägare inte är tillgängligt kommer databasen inte att överföras.

  • Om en webbplats inte överförs kommer dess tillhörande databaser inte heller att överföras.

  • Endast lokala databaser kan överföras.

Migreringsprocess

Anslutning

Målservern ansluter till källservern via SSH. Vid den första anslutningen installerar målservern en SSH-nyckel på källservern (antingen förhandsangiven eller genererad från ett lösenord).

Migreringssteg

  • Installation av moduler
  • Insamling av information om objekt som kan överföras
  • Skapande av användare
  • Överföring av SSL-certifikat
  • Skapande av webbplatser, FTP-konton, e-postdomäner och e-postkonton
  • Skapande av databaser och databasanvändare
  • Överföring av filer för webbplatser och e-postbrevlådor
  • Överföring av cron-jobb

Filöverföring utförs med rsync. Databaser överförs genom att skapa en dump via en SSH-tunnel.

Kommando för att starta migrering

Kommandot körs på målservern som en användare med root-behörighet:

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

Kommandoradsflaggor

SSH-anslutning

  • --remote_host="SOURCE_IP" - IP-adress för källservern.
  • --remote_port="SSH_PORT" - SSH-port.
  • --remote_username="SSH_USER" - Användare (måste vara root).
  • --remote_password="USER_PASSWORD" - Lösenord för den angivna SSH-användaren.
  • --ssh_key_path="PATH_TO_KEY" - Sökväg till den privata SSH-nyckeln på målservern för anslutning till källservern. Om en nyckel används behövs inte lösenordet (--remote_password).

IP-adresser

Du får endast använda en av följande flaggor för att hantera webbplatsers IP-adresser under överföringen. Flaggan -m har prioritet.

  • -i "IP_ADDRESS_ON_DESTINATION" - Tilldelar den angivna IP-adressen till alla överförda webbplatser på målservern. För att ange flera IP-adresser (t.ex. om det fanns flera på källan) upprepar du flaggan för varje käll-IP som behöver överföras.

  • -m "SOURCE_IP,DESTINATION_IP" - Rekommenderad metod. Upprättar en direkt mappning: alla webbplatser som använder SOURCE_IP på källservern kommer att använda DESTINATION_IP på målservern. Den här flaggan kan anges flera gånger för olika IP-par. Obligatorisk för överföring av webbplatser med manuella konfigurationsändringar, eftersom den möjliggör korrekt ersättning av IP-adresser i listen-direktiv.

Ytterligare inställningar

  • --users="USER_LIST" - Överför endast de angivna användarna (kommaseparerade). Om den inte anges överförs alla användare.
  • --disable_disk_quota - Inaktiverar överföringen av användarnas diskkvoter.
  • --with_user_data - Inkluderar kopiering av hela innehållet i användarnas hemkataloger (förutom underkatalogen logs/). Använd med försiktighet, eftersom detta kan öka överföringstiden och mängden överförd data avsevärt.
  • --only_data - Överför endast data (webbplatsfiler, e-postfiler, databasdumpar). Användbart om den inledande strukturmigreringen (användare, webbplatser, databaser osv.) lyckades, men fel uppstod under steget för kopiering av filer eller dumpar. Gör det möjligt att köra om endast datakopieringsdelen.
  • --transfer_timeout - Ange tidsgräns för operationen (standard är 60 minuter).

Exempelkommando

Överför alla användare från servern 11.22.33.44 till den aktuella servern. På den gamla servern använde webbplatser IP-adresserna 11.22.33.44 och 11.22.33.55; på den nya servern ska de använda 99.88.77.66 respektive 99.88.77.67. Anslutning via SSH med ett lösenord.

/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öjliga problem och feltyper

Ett fel i migreringsloggen indikerar inte alltid ett kritiskt problem, men kan peka på orsaken till att ett visst objekt inte överfördes.

  • Konflikter: Uppstår när det är omöjligt att överföra ett objekt på grund av målserverns aktuella konfiguration (t.ex. att en användare eller webbplats med samma namn redan finns) eller om webbplatsens konfiguration på källservern är okänd för panelen (t.ex. på grund av omfattande manuella ändringar).

  • Sparat lösenord saknas: Som nämnts tidigare kan MySQL-databasanvändare utan ett sparat lösenord i FASTPANEL på källservern inte överföras.

  • Manuella inställningar och IP-adresser: Om en webbplats på källservern har manuella ändringar i webbserverkonfigurationen och flaggan -m inte används under migreringen för att mappa dess IP-adress, kommer en sådan webbplats inte att överföras eftersom panelen inte vet vilken IP-adress som ska anges i konfigurationen på målservern.