CLI
Brukere
På denne siden
Opprette en ny bruker
Kommando
mogwai users create --username=USERNAME --password=PASSWORD [--role="USER"]Alternativer
-u,--username=USERNAME: Angi brukernavnet for den nye brukeren.-p,--password=PASSWORD: Angi passordet for den nye brukeren.-r,--role="USER": Angi rollen for den nye brukeren. Støttede roller er RESELLER og USER. Standardrollen er USER.
Bruksinformasjon
For å opprette en ny bruker med brukernavnet testuser, passordet My$ecretPassword123 og rollen RESELLER, bruk følgende kommando:
mogwai users create --username=testuser --password=My$ecretPassword123 --role="RESELLER"Ytterligere merknader
- Brukernavn må være unike og kan ikke inneholde mellomrom eller punktum.
- Passord må være minst 8 tegn lange. Vi anbefaler å bruke minst én stor bokstav, én liten bokstav, ett tall og ett spesialtegn.
Overføring av brukere mellom FASTPANEL-servere
På denne siden
Innledning
Denne artikkelen beskriver prosessen for å overføre brukerkontoer og tilhørende data (nettsteder, databaser, e-post osv.) fra én FASTPANEL-server til en annen ved hjelp av det innebygde migreringsverktøyet.
Nøkkelbegreper
- Kildeserver - Serveren som data overføres fra.
- Destinasjonsserver - Serveren som data overføres til.
Viktige merknader
-
Som standard fungerer migrering korrekt bare for nettsteder med en standard FASTPANEL-konfigurasjon.
-
Nettsteder med endringer i manuell konfigurasjon kan bare overføres hvis flagget
-mbrukes for IP-adressekartlegging. -
Hvis et kryptert passord for en databaseeier ikke er tilgjengelig, blir databasen ikke overført.
-
Hvis et nettsted ikke overføres, blir heller ikke de tilhørende databasene overført.
-
Bare lokale databaser kan overføres.
Migreringsprosess
Tilkobling
Destinasjonsserveren kobler til kildeserveren via SSH. Under den første tilkoblingen installerer destinasjonsserveren en SSH-nøkkel på kildeserveren (enten forhåndsoppgitt eller generert fra et passord).
Migreringstrinn
- Modulinstallasjon
- Innhenting av informasjon om objekter som kan overføres
- Opprettelse av brukere
- Overføring av SSL-sertifikater
- Opprettelse av nettsteder, FTP-kontoer, e-postdomener og e-postkontoer
- Opprettelse av databaser og databasebrukere
- Overføring av filer for nettsteder og e-postpostkasser
- Overføring av cron-jobber
Filoverføring utføres med rsync. Databaser overføres ved å opprette en dump gjennom en SSH-tunnel.
Kommando for å starte migrering
Kommandoen kjøres på destinasjonsserveren som en bruker med root-rettigheter:
/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]Kommandolinjeflagg
SSH-tilkobling
--remote_host="SOURCE_IP" - IP-adressen til kildeserveren.--remote_port="SSH_PORT" - SSH-port.--remote_username="SSH_USER" - Bruker (må være root).--remote_password="USER_PASSWORD" - Passord for den angitte SSH-brukeren.--ssh_key_path="PATH_TO_KEY" - Sti til den private SSH-nøkkelen på destinasjonsserveren for tilkobling til kildeserveren. Hvis en nøkkel brukes, er passordet (--remote_password) ikke nødvendig.
IP-adresser
Du må bruke bare ett av følgende flagg for å administrere nettsteders IP-adresser under overføring. Flagget -m har prioritet.
-
-i"IP_ADDRESS_ON_DESTINATION" - Tildeler den angitte IP-adressen til alle overførte nettsteder på destinasjonsserveren. For å angi flere IP-er (f.eks. hvis det var flere på kildeserveren), gjenta flagget for hver kilde-IP som må overføres. -
-m"SOURCE_IP,DESTINATION_IP" - Anbefalt metode. Oppretter en direkte tilordning: alle nettsteder som bruker SOURCE_IP på kildeserveren, vil bruke DESTINATION_IP på destinasjonsserveren. Dette flagget kan angis flere ganger for ulike IP-par. Obligatorisk for overføring av nettsteder med manuelle konfigurasjonsendringer, siden det muliggjør korrekt erstatning av IP-adresser i listen-direktiver.
Ytterligere innstillinger
--users="USER_LIST" - Overfører bare de angitte brukerne (kommaseparert). Hvis det ikke er angitt, overføres alle brukere.--disable_disk_quota- Deaktiverer overføringen av brukernes diskkvoter.--with_user_data- Inkluderer kopiering av hele innholdet i brukernes hjemmekataloger (unntatt underkatalogenlogs/). Bruk med forsiktighet, da dette kan øke overføringstiden og mengden overførte data betydelig.--only_data- Overfører bare data (nettstedsfiler, e-postfiler, databasedumper). Nyttig hvis den innledende migreringen av strukturen (brukere, nettsteder, DB-er osv.) var vellykket, men det oppstod feil under fasen for kopiering av filer eller dumper. Gjør det mulig å kjøre bare datakopieringsdelen på nytt.--transfer_timeout- Angi tidsavbrudd for operasjonen (standard er 60 minutter).
Eksempel på kommando
Overfør alle brukere fra serveren 11.22.33.44 til den gjeldende serveren. På den gamle serveren brukte nettsteder IP-ene 11.22.33.44 og 11.22.33.55; på den nye serveren skal de bruke henholdsvis 99.88.77.66 og 99.88.77.67. Tilkobling via SSH med passord.
/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.67Mulige problemer og feiltyper
En feil i migreringsloggen indikerer ikke alltid et kritisk problem, men kan peke på årsaken til at et bestemt objekt ikke ble overført.
-
Konflikter: Oppstår når det er umulig å overføre et objekt på grunn av den gjeldende konfigurasjonen på destinasjonsserveren (f.eks. at en bruker eller et nettsted med samme navn allerede finnes) eller hvis nettstedets konfigurasjon på kildeserveren er ukjent for panelet (f.eks. på grunn av omfattende manuelle endringer).
-
Manglende lagret passord: Som nevnt tidligere kan MySQL-databasebrukere uten et lagret passord i FASTPANEL på kildeserveren ikke overføres.
-
Manuelle innstillinger og IP-adresser: Hvis et nettsted på kildeserveren har manuelle endringer i webserverkonfigurasjonen og flagget
-mikke brukes under migreringen for å tilordne IP-adressen, vil et slikt nettsted ikke bli overført fordi panelet ikke vet hvilken IP som skal angis i konfigurasjonen på destinasjonsserveren.
Databaser
På denne siden
Hente en liste over databaseservere
Kommando
mogwai databases servers listEksempel på utdata
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueServeren IDs brukes i andre kommandoer.
Hente en liste over databaser
Kommando
mogwai databases listEksempel 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 UTCSynkronisering av databaselisten
Hvis du nylig har lagt til eller fjernet databaser, og de ennå ikke har dukket opp i FASTPANEL, kan du tvinge synkronisering av listene
Kommando
mogwai databases syncOpprette en ny database
Kommando
mogwai databases create [flags]Alternativer
-n,--name=NAME: Databasenavn.-o,--owner="fastuser": FASTPANEL-bruker som databasen vil bli lagt til for.-s,--site=SITE: Nettsted i FASTPANEL som databasen vil bli lagt til i.-c,--charset="utf8mb4": Databasetegnkoding.-u,--username=USERNAME: Databasebrukernavn.-p,--password=PASSWORD: Passord for databasebruker.
Eksempel på kommando
mogwai databases create --server=1 -n db1 -o fastuser -s example.com -u dbuser -p dbpassword1Denne kommandoen oppretter en database med navnet db1 på standard databaseserver (--server=1) og "kobler" den til nettstedet example.com.
E-post
På denne siden
Hente en liste over e-postdomener
Kommando
mogwai emails domains listEksempel 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:00Domenene IDs brukes i andre kommandoer.
Legge til et e-postdomene
Kommando
mogwai emails domains createAlternativer
--domain=DOMAIN: Navn på e-postdomenet.-o,--owner="fastuser": FASTPANEL-brukeren som e-postdomenet skal legges til for.
Eksempel på opprettelse av e-postdomenet example1.com under brukeren fastuser
mogwai emails domains create --domain=example1.com -o fastuserHente en liste over postbokser
Kommando
mogwai emails boxes listAlternativer
--domain=DOMAIN: Navn på e-postdomenet
Eksempelkommando
mogwai emails boxes list --domain example.comEksempel 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 fra kommandoutdataene brukes i andre kommandoer.
Opprette en postboks
Kommando
mogwai emails boxes createAlternativer
--domain=DOMAIN: Navn på e-postdomenet.-l,--login=LOGIN: Navnet på postboksen, uten domenet.-p,--password=PASSWORD: Passordet for postboksen.
Eksempelkommando
mogwai emails boxes create --domain=example.com --login=user --password=MySecretPassword123Denne kommandoen oppretter en postboks med navnet user@example.com og passordet MySecretPassword123.
Slette en postboks
Kommando
mogwai emails boxes deleteAlternativer
-b,--box=BOX: ID-en til postboksen..
Eksempelkommando
mogwai emails boxes delete -b 1Denne kommandoen sletter postboksen med ID-en 1.
Importere postbokser og e-post
Kommando
mogwai emails boxes import[sync] [<flags>]Alternativer
-i,--import_config=IMPORT_CONFIG: Sti til filen med importlisten--force: Kun forimport-modus - tøm eksisterende postbokser.
For å importere e-post må du forberede en liste over postbokser på serveren i formatet:
IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDRAlternativer
IMAP_HOST: Adressen til IMAP-e-postserveren.SOURCE_ADDR: Postboks på kildeserveren.SOURCE_PASSWORD: Passord for IMAP-tilkobling til postboksen på kildeserveren. Noen tjenester, for eksempel Google, krever at du oppretter et applikasjonspassord for IMAP-tilgang https://support.google.com/accounts/answer/185833?hl=enDEST_ADDR: Postboks på FASTPANEL-serveren som meldinger overføres til.
Eksempel på filinnhold
imap.gmail.com;test@gmail.comu;password;test@example.com
imap.gmail.com;test1@gmail.com;password;test1@example.comTo moduser er tilgjengelige:
Importmodus
mogwai emails boxes importI denne modusen kopieres alle meldinger i sin helhet, postbokser på FASTPANEL-serveren må ikke være opprettet eller være tomme - når kommandoen kjøres, oppretter FASTPANEL de nødvendige postboksene. Hvis postbokser med innhold allerede finnes, vises en feil. Du kan bruke flagget --force - da blir postboksen tømt.
Eksempel på å kjøre kommandoen med en liste over postbokser lagret i filen /root/import.txt og med bruk av nøkkelen --force
mogwai emails boxes import --import_config=/root/import.txt --forceSynkroniseringsmodus
mogwai emails boxes syncI denne modusen laster kontrollpanelet ned meldinger fra kildeserveren uten å slette noe. Den bør brukes hvis nye meldinger har dukket opp i den opprinnelige postboksen etter den første importen, og disse også må overføres.
Eksempelkommando
mogwai emails boxes sync --import_config=/root/import.txtBeskrivelse
På denne siden
FASTPANEL tilbyr et kommandolinjegrensesnitt (CLI) implementert gjennom verktøyet mogwai (/usr/local/bin/mogwai). Verktøyet fungerer bare når det kjøres som root.
Hjelp
For å se en liste over tilgjengelige kommandoer, bruk:
mogwai --helpFor å lære mer om en bestemt kommando, bruk:
mogwai command --helpFor å se en liste over kommandoer med beskrivelser, bruk:
mogwai --help-longNettsteder
På denne siden
Lister opp nettsteder på en server
Kommando
mogwai sites listEksempel 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.comMerk: Nettstedet IDs fra denne listen brukes i andre kommandoer.
Opprette et nytt nettsted
Kommando
mogwai sites create --server-name=SERVER-NAME --owner=OWNER [<flags>]Alternativer
--owner: Bruker på FASTPANEL-systemet som skal eie nettstedet.--server-name=SERVER-NAME: Domenenavn for nettstedet.-a,--alias=ALIAS: Aliaser for nettstedet, for eksempel www-underdomener. Flere aliaser kan angis.--ip=IP: IP-adresse til serveren der nettstedet skal kjøre. Flere IP-adresser kan angis.-h,--handler=HANDLER: Backend-håndterer. Kan være:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: PHP- eller Node.js-versjon (f.eks.8.2,8.3,20.15.1).--create-user: Opprett en bruker for nettstedet.
Eksempel 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.3Slette et nettsted
Kommando
mogwai sites delete --id=IDNettstedet ID kan hentes fra kommandoen mogwai sites list.
Eksempel på kommando
mogwai sites delete --id=987Denne kommandoen vil slette nettstedet med ID 987
Endre nettstedinnstillinger
Kommando
mogwai sites update --id=ID [<flags>]Nettstedet ID kan hentes fra kommandoen mogwai sites list.
Alternativer
-i,--id=ID: ID for nettstedet.-a,--add-alias=ADD-ALIAS: Legg til et alias, flere aliaser kan angis.--del-alias=DEL-ALIAS: Slett et alias, flere aliaser kan angis.--add-ip=ADD-IP: Legg til en IP-adresse fra nettstedinnstillingene, flere IP-adresser kan angis.--del-ip=DEL-IP: Slett en IP-adresse fra nettstedinnstillingene, flere IP-adresser kan angis.-h,--handler=HANDLER: Backend-håndterer. Kan være:- PHP:
cgi,mpm_itk,php_fpm,fcgi; - Node.js:
standalone,pm2; - Systemd:
systemd.
- PHP:
--handler_version=HANDLER_VERSION: PHP- eller Node.js-versjon (f.eks.8.2,8.3,20.15.1).--gzip: Aktiver komprimering.--no-gzip: Deaktiver komprimering.--gzip-comp-level=LEVEL: Angi komprimeringsnivået, 1-9.--expires=EXPIRES: Angi bufretiden for statisk innhold.--worker-count=WORKER-COUNT: Angi antall arbeidere for PHP-FPM
Du kan også oppdatere innstillinger for flere nettsteder på en server ved hjelp av kommandoen
mogwai sites batch-update- For å endre innstillingene for alle nettsteder, bruk flagget
-a. - For å endre innstillingene for utvalgte nettsteder, angi flere
--id-flagg med deresIDs.
Eksempel på kommando
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Denne kommandoen vil legge til et alias www1.example.com, endre handler til cgi og PHP-versjon til 5.6 for nettstedet med ID 3
Eksempel på kommando
mogwai sites batch-update -h cgi --handler_version=5.6 --id 3 --id 2Denne kommandoen vil endre PHP-håndtereren for nettsteder med ID 2 og 3
FASTPANEL