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 listExempel på utdata
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServern IDs används i andra kommandon.
Hämta en lista över databaser
Kommando
mogwai databases listExempel 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 UTCSynkronisera 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 syncSkapa 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 dbpassword1Det 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 listExempel 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:00Domänerna IDs används i andra kommandon.
Lägga till en e-postdomän
Kommando
mogwai emails domains createAlternativ
--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 fastuserHämta en lista över brevlådor
Kommando
mogwai emails boxes listAlternativ
--domain=DOMAIN: Namn på e-postdomän
Exempelkommando
mogwai emails boxes list --domain example.comExempel 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:00ID från kommandots utdata används i andra kommandon.
Skapa en brevlåda
Kommando
mogwai emails boxes createAlternativ
--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=MySecretPassword123Detta kommando skapar en brevlåda med namnet user@example.com och lösenordet MySecretPassword123.
Ta bort en brevlåda
Kommando
mogwai emails boxes deleteAlternativ
-b,--box=BOX: ID för brevlådan..
Exempelkommando
mogwai emails boxes delete -b 1Detta 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ägetimport- 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_ADDRAlternativ
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=enDEST_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.comTvå lägen är tillgängliga:
Importläge
mogwai emails boxes importI 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 --forceSynkroniseringsläge
mogwai emails boxes syncI 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.txtBeskrivning
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 --helpAnvänd följande för att läsa mer om ett specifikt kommando:
mogwai command --helpAnvänd följande för att se en lista över kommandon med beskrivningar:
mogwai --help-longWebbplatser
Lista sajter på en server
Kommando
mogwai sites listExempel 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.comObs: 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.
- PHP:
--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.3Ta bort en sajt
Kommando
mogwai sites delete --id=IDSajten ID kan hämtas från kommandot mogwai sites list.
Exempel på kommando
mogwai sites delete --id=987Det 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.
- PHP:
--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
--idmed derasIDs.
Exempel på kommando
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Det 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 2Det 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
-manvä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 underkatalogenlogs/). 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.67Mö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
-minte 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.
FASTPANEL