FASTPANELWIKI

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 -m brukes 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 underkatalogen logs/). 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.67

Mulige 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 -m ikke 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 list

Eksempel på utdata

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

Serveren IDs brukes i andre kommandoer.

Hente en liste over databaser

Kommando

mogwai databases list

Eksempel 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

Synkronisering 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 sync

Opprette 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 dbpassword1

Denne 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 list

Eksempel 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

Domenene IDs brukes i andre kommandoer.

Legge til et e-postdomene

Kommando

mogwai emails domains create

Alternativer

  • --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 fastuser

Hente en liste over postbokser

Kommando

mogwai emails boxes list

Alternativer

  • --domain=DOMAIN : Navn på e-postdomenet

Eksempelkommando

mogwai emails boxes list --domain example.com

Eksempel 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 fra kommandoutdataene brukes i andre kommandoer.

Opprette en postboks

Kommando

mogwai emails boxes create

Alternativer

  • --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=MySecretPassword123

Denne kommandoen oppretter en postboks med navnet user@example.com og passordet MySecretPassword123.

Slette en postboks

Kommando

mogwai emails boxes delete

Alternativer

  • -b, --box=BOX : ID-en til postboksen..

Eksempelkommando

mogwai emails boxes delete -b 1

Denne 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 for import-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_ADDR

Alternativer

  • 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=en
  • DEST_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.com

To moduser er tilgjengelige:

Importmodus

mogwai emails boxes import

I 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 --force

Synkroniseringsmodus

mogwai emails boxes sync

I 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.txt

Beskrivelse

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 --help

For å lære mer om en bestemt kommando, bruk:

mogwai command --help

For å se en liste over kommandoer med beskrivelser, bruk:

mogwai --help-long

Nettsteder

På denne siden

Lister opp nettsteder på en server

Kommando

mogwai sites list

Eksempel 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

Merk: 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.
  • --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.3

Slette et nettsted

Kommando

mogwai sites delete --id=ID

Nettstedet ID kan hentes fra kommandoen mogwai sites list.

Eksempel på kommando

mogwai sites delete --id=987

Denne 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.
  • --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 deres IDs.

Eksempel på kommando

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

Denne 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 2

Denne kommandoen vil endre PHP-håndtereren for nettsteder med ID 2 og 3