FASTPANELWIKI

CLI

Databases

Op deze pagina

Een lijst met databaseservers ophalen

Opdracht

mogwai databases servers list

Voorbeelduitvoer

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

De server IDs wordt gebruikt in andere opdrachten.

Een lijst met databases ophalen

Opdracht

mogwai databases list

Voorbeelduitvoer

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

De databaselijst synchroniseren

Als je onlangs databases hebt toegevoegd of verwijderd en deze nog niet in FASTPANEL zijn verschenen, kun je de synchronisatie van de lijsten forceren

Opdracht

mogwai databases sync

Een nieuwe database aanmaken

Opdracht

mogwai databases create [flags]

Opties

  • -n, --name=NAME : Databasenaam.
  • -o, --owner="fastuser" :  FASTPANEL-gebruiker aan wie de database wordt toegevoegd.
  • -s, --site=SITE : Website in FASTPANEL waaraan de database wordt toegevoegd.
  • -c, --charset="utf8mb4" : Databasecodering.
  • -u, --username=USERNAME : Databasegebruikersnaam.
  • -p, --password=PASSWORD : Wachtwoord van databasegebruiker.

Voorbeeldopdracht

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

Deze opdracht maakt een database met de naam db1 aan op de standaard databaseserver (--server=1) en "koppelt" deze aan de site example.com.

E-mail

Op deze pagina

Een lijst met e-maildomeinen ophalen

Opdracht

mogwai emails domains list

Voorbeelduitvoer

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

Het domein IDs wordt gebruikt in andere opdrachten.

Een e-maildomein toevoegen

Opdracht

mogwai emails domains create

Opties

  • --domain=DOMAIN : Naam van het e-maildomein.
  • -o, --owner="fastuser" : De FASTPANEL-gebruiker waaraan het e-maildomein wordt toegevoegd.

Voorbeeld van het aanmaken van een e-maildomein example1.com onder de gebruiker fastuser

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

Een lijst met mailboxen ophalen

Opdracht

mogwai emails boxes list

Opties

  • --domain=DOMAIN : Naam van het maildomein

Voorbeeldopdracht

mogwai emails boxes list --domain example.com

Voorbeelduitvoer

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

De ID uit de opdrachtuitvoer wordt gebruikt in andere opdrachten.

Een mailbox aanmaken

Opdracht

mogwai emails boxes create

Opties

  • --domain=DOMAIN : Naam van het e-maildomein.
  • -l, --login=LOGIN : De naam van de mailbox, zonder het domein.
  • -p, --password=PASSWORD : Het wachtwoord voor de mailbox.

Voorbeeldopdracht

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

Met deze opdracht wordt een mailbox met de naam user@example.com aangemaakt met het wachtwoord MySecretPassword123.

Een mailbox verwijderen

Opdracht

mogwai emails boxes delete

Opties

  • -b, --box=BOX : De ID van de mailbox..

Voorbeeldopdracht

mogwai emails boxes delete -b 1

Met deze opdracht wordt de mailbox met ID 1 verwijderd.

Mailboxen en e-mails importeren

Opdracht

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

Opties

  • -i, --import_config=IMPORT_CONFIG : Pad naar het importlijstbestand
  • --force : Alleen voor de modus import - bestaande mailboxen wissen.

Om e-mail te importeren, moet u een lijst met mailboxen op de server voorbereiden in de indeling:

IMAP_HOST;SOURCE_ADDR;SOURCE_PASSWORD;DEST_ADDR

Opties

  • IMAP_HOST : Adres van de IMAP-mailserver.
  • SOURCE_ADDR : Mailbox op de bronserver.
  • SOURCE_PASSWORD : Wachtwoord voor de IMAP-verbinding met de mailbox op de bronserver. Sommige diensten, zoals Google, vereisen het aanmaken van een applicatiewachtwoord voor IMAP-toegang https://support.google.com/accounts/answer/185833?hl=en
  • DEST_ADDR : Mailbox op de FASTPANEL-server waarnaar berichten worden overgezet.

Voorbeeld van bestandsinhoud

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

Er zijn twee modi beschikbaar:

Importmodus

mogwai emails boxes import

In deze modus worden alle berichten volledig gekopieerd, mailboxen op de FASTPANEL-server mogen niet zijn aangemaakt of moeten leeg zijn - wanneer de opdracht wordt uitgevoerd, maakt FASTPANEL de benodigde mailboxen aan. Als er al mailboxen met inhoud bestaan, wordt een fout weergegeven. U kunt de vlag --force gebruiken - dan wordt de mailbox leeggemaakt.

Voorbeeld van het uitvoeren van de opdracht met een lijst met mailboxen opgeslagen in het bestand /root/import.txt en met gebruik van de sleutel --force

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

Synchronisatiemodus

mogwai emails boxes sync

In deze modus downloadt het Configuratiescherm berichten van de bronserver zonder iets te verwijderen. Deze modus moet worden gebruikt als er na de eerste import nieuwe berichten in de oorspronkelijke mailbox zijn verschenen die ook moeten worden overgezet.

Voorbeeldopdracht

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

Gebruikers

Op deze pagina

Een nieuwe gebruiker aanmaken

Opdracht

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

Opties

  • -u, --username=USERNAME : Geef de gebruikersnaam voor de nieuwe gebruiker op.
  • -p, --password=PASSWORD : Geef het wachtwoord voor de nieuwe gebruiker op.
  • -r, --role="USER" : Geef de rol voor de nieuwe gebruiker op. Ondersteunde rollen zijn RESELLER en USER. De standaardrol is USER.

Gebruiksinformatie

Gebruik de volgende opdracht om een nieuwe gebruiker aan te maken met de gebruikersnaam testuser, het wachtwoord My$ecretPassword123 en de rol RESELLER:

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

Aanvullende opmerkingen

  • Gebruikersnamen moeten uniek zijn en mogen geen spaties of punten bevatten.
  • Wachtwoorden moeten minimaal 8 tekens lang zijn. We raden aan om ten minste één hoofdletter, één kleine letter, één cijfer en één speciaal teken te gebruiken.

Gebruikers overdragen tussen FASTPANEL-servers

Op deze pagina

Inleiding

Dit artikel beschrijft het proces van het overdragen van gebruikersaccounts en de bijbehorende gegevens (websites, databases, e-mail, enz.) van de ene FASTPANEL-server naar de andere met behulp van het ingebouwde migratiehulpprogramma.

Belangrijke termen

  • Bronserver - De server waarvan gegevens worden overgedragen.
  • Doelserver - De server waarnaar gegevens worden overgedragen.

Belangrijke opmerkingen

  • Migratie werkt standaard alleen correct voor sites met een standaard FASTPANEL-configuratie.

  • Sites met wijzigingen in de handmatige configuratie kunnen alleen worden overgedragen als de vlag -m wordt gebruikt voor IP-adrestoewijzing.

  • Als een versleuteld wachtwoord voor een database-eigenaar niet beschikbaar is, wordt de database niet overgedragen.

  • Als een website niet wordt overgedragen, worden de bijbehorende databases ook niet overgedragen.

  • Alleen lokale databases kunnen worden overgedragen.

Migratieproces

Verbinding

De doelserver maakt via SSH verbinding met de bronserver. Tijdens de eerste verbinding installeert de doelserver een SSH-sleutel op de bronserver (ofwel vooraf verstrekt of gegenereerd op basis van een wachtwoord).

Migratiestappen

  • Module-installatie
  • Informatie verzamelen over overdraagbare objecten
  • Gebruikers aanmaken
  • SSL-certificaten overdragen
  • Websites, FTP-accounts, e-maildomeinen en e-mailaccounts aanmaken
  • Databases en databasegebruikers aanmaken
  • Websitebestanden en e-mailpostvakbestanden overdragen
  • Cronjobs overdragen

Bestandsoverdracht wordt uitgevoerd met rsync. Databases worden overgedragen door een dump te maken via een SSH-tunnel.

Opdracht om migratie te starten

De opdracht wordt uitgevoerd op de doelserver als een gebruiker met rootrechten:

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

Opdrachtregelvlaggen

SSH-verbinding

  • --remote_host="SOURCE_IP" - IP-adres van de bronserver.
  • --remote_port="SSH_PORT" - SSH-poort.
  • --remote_username="SSH_USER" - Gebruiker (moet root zijn).
  • --remote_password="USER_PASSWORD" - Wachtwoord voor de opgegeven SSH-gebruiker.
  • --ssh_key_path="PATH_TO_KEY" - Pad naar de privésleutel voor SSH op de doelserver om verbinding te maken met de bronserver. Als een sleutel wordt gebruikt, is het wachtwoord (--remote_password) niet nodig.

IP-adressen

U moet slechts één van de volgende vlaggen gebruiken om IP-adressen van sites tijdens de overdracht te beheren. De vlag -m heeft prioriteit.

  • -i "IP_ADDRESS_ON_DESTINATION" - Wijst het opgegeven IP-adres toe aan alle overgedragen sites op de doelserver. Om meerdere IP's op te geven (bijvoorbeeld als er meerdere op de bronserver waren), herhaalt u de vlag voor elk bron-IP dat moet worden overgedragen.

  • -m "SOURCE_IP,DESTINATION_IP" - Aanbevolen methode. Stelt een directe toewijzing in: alle sites die SOURCE_IP gebruiken op de bronserver, gebruiken DESTINATION_IP op de doelserver. Deze vlag kan meerdere keren worden opgegeven voor verschillende IP-paren. Verplicht voor het overdragen van sites met handmatige configuratiebewerkingen, omdat hiermee IP-adressen in listen-richtlijnen correct kunnen worden vervangen.

Aanvullende instellingen

  • --users="USER_LIST" - Draagt alleen de opgegeven gebruikers over (door komma's gescheiden). Als dit niet is opgegeven, worden alle gebruikers overgedragen.
  • --disable_disk_quota - Schakelt de overdracht van schijfquota van gebruikers uit.
  • --with_user_data - Omvat het kopiëren van de volledige inhoud van de homedirectories van gebruikers (behalve de subdirectory logs/). Wees voorzichtig met het gebruik hiervan, aangezien dit de overdrachtstijd en de hoeveelheid overgedragen gegevens aanzienlijk kan vergroten.
  • --only_data - Draagt alleen gegevens over (websitebestanden, e-mailbestanden, databasedumps). Nuttig als de initiële structuurmigratie (gebruikers, sites, DB's, enz.) succesvol was, maar er fouten optraden tijdens de fase van het kopiëren van bestanden of dumps. Maakt het mogelijk om alleen het deel voor het kopiëren van gegevens opnieuw uit te voeren.
  • --transfer_timeout - Stel de time-out voor de bewerking in (standaard is 60 minuten).

Voorbeeldopdracht

Draag alle gebruikers over van server 11.22.33.44 naar de huidige server. Op de oude server gebruikten sites de IP's 11.22.33.44 en 11.22.33.55; op de nieuwe server moeten ze respectievelijk 99.88.77.66 en 99.88.77.67 gebruiken. Verbinding via SSH met een wachtwoord.

/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

Mogelijke problemen en fouttypen

Een fout in het migratielogboek wijst niet altijd op een kritisch probleem, maar kan de reden aangeven waarom een specifiek object niet is overgedragen.

  • Conflicten: Treden op wanneer het overdragen van een object onmogelijk is vanwege de huidige configuratie van de doelserver (bijv. als een gebruiker of site met dezelfde naam al bestaat) of als de configuratie van de site op de bronserver onbekend is voor het paneel (bijv. door uitgebreide handmatige bewerkingen).

  • Ontbrekend opgeslagen wachtwoord: Zoals eerder vermeld, kunnen MySQL-databasegebruikers zonder een opgeslagen wachtwoord in FASTPANEL op de bronserver niet worden overgedragen.

  • Handmatige instellingen en IP-adressen: Als een site op de bronserver handmatige bewerkingen in de webserverconfiguratie heeft en de vlag -m niet wordt gebruikt tijdens de migratie om het IP-adres toe te wijzen, wordt zo'n site niet overgedragen omdat het paneel niet weet welk IP-adres in de configuratie op de doelserver moet worden opgegeven.

Beschrijving

Op deze pagina

FASTPANEL biedt een opdrachtregelinterface (CLI) die is geïmplementeerd via het hulpprogramma mogwai (/usr/local/bin/mogwai). Het hulpprogramma werkt alleen wanneer het wordt uitgevoerd als root.

Help

Gebruik het volgende om een lijst met beschikbare opdrachten te zien:

mogwai --help

Gebruik het volgende om meer te weten te komen over een specifieke opdracht:

mogwai command --help

Gebruik het volgende om een lijst met opdrachten en beschrijvingen te zien:

mogwai --help-long

Websites

Op deze pagina

Sites op een server weergeven

Commando

mogwai sites list

Voorbeelduitvoer

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

Opmerking: Site IDs uit deze lijst worden in andere commando's gebruikt.

Een nieuwe site aanmaken

Commando

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

Opties

  • --owner : Gebruiker op het FASTPANEL-systeem die eigenaar van de site wordt.
  • --server-name=SERVER-NAME : Domeinnaam voor de site.
  • -a, --alias=ALIAS : Aliassen voor de site, zoals www-subdomeinen. Er kunnen meerdere aliassen worden opgegeven.
  • --ip=IP : IP-adres van de server waarop de site zal draaien. Er kunnen meerdere IP-adressen worden opgegeven.
  • -h, --handler=HANDLER : Backend-handler. Kan zijn:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- of Node.js-versie (bijv. 8.2, 8.3, 20.15.1).
  • --create-user : Maak een gebruiker aan voor de site.

Voorbeeldcommando

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

Een site verwijderen

Commando

mogwai sites delete --id=ID

De site ID kan worden verkregen met het commando mogwai sites list.

Voorbeeldcommando

mogwai sites delete --id=987

Dit commando verwijdert de site met ID 987

Site-instellingen wijzigen

Commando

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

De site ID kan worden verkregen met het commando mogwai sites list.

Opties

  • -i, --id=ID : ID van de site.
  • -a, --add-alias=ADD-ALIAS : Voeg een alias toe; er kunnen meerdere aliassen worden opgegeven.
  • --del-alias=DEL-ALIAS : Verwijder een alias; er kunnen meerdere aliassen worden opgegeven.
  • --add-ip=ADD-IP : Voeg een IP-adres toe vanuit de site-instellingen; er kunnen meerdere IP-adressen worden opgegeven.
  • --del-ip=DEL-IP : Verwijder een IP-adres uit de site-instellingen; er kunnen meerdere IP-adressen worden opgegeven.
  • -h, --handler=HANDLER : Backend-handler. Kan zijn:
    • PHP: cgi,mpm_itk,php_fpm,fcgi;
    • Node.js: standalone,pm2;
    • Systemd: systemd.
  • --handler_version=HANDLER_VERSION : PHP- of Node.js-versie (bijv. 8.2, 8.3, 20.15.1).
  • --gzip : Compressie inschakelen.
  • --no-gzip : Compressie uitschakelen.
  • --gzip-comp-level=LEVEL : Stel het compressieniveau in, 1-9.
  • --expires=EXPIRES : Stel de cachingtijd voor statische inhoud in.
  • --worker-count=WORKER-COUNT : Stel het aantal workers voor PHP-FPM in

U kunt ook instellingen voor meerdere sites op een server bijwerken met het commando

mogwai sites batch-update
  • Gebruik de vlag -a om de instellingen voor alle sites te wijzigen.
  • Om de instellingen voor geselecteerde sites te wijzigen, geeft u meerdere vlaggen --id op met hun IDs.

Voorbeeldcommando

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

Met deze opdracht wordt een alias www1.example.com toegevoegd, wordt de handler gewijzigd naar cgi en wordt de PHP-versie gewijzigd naar 5.6 voor de site met ID 3

Voorbeeldcommando

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

Dit commando wijzigt de PHP-handler voor sites met ID 2 en 3