CLI
Databases
Op deze pagina
Een lijst met databaseservers ophalen
Opdracht
mogwai databases servers listVoorbeelduitvoer
ID NAME TYPE LOCAL HOST USERNAME AVAIL
1 mysql(localhost) mysql true fastuser true
2 postgresql(localhost) postgresql true fastuser trueDe server IDs wordt gebruikt in andere opdrachten.
Een lijst met databases ophalen
Opdracht
mogwai databases listVoorbeelduitvoer
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 UTCDe 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 syncEen 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 dbpassword1Deze opdracht maakt een database met de naam db1 aan op de standaard databaseserver (--server=1) en "koppelt" deze aan de site example.com.
Op deze pagina
Een lijst met e-maildomeinen ophalen
Opdracht
mogwai emails domains listVoorbeelduitvoer
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:00Het domein IDs wordt gebruikt in andere opdrachten.
Een e-maildomein toevoegen
Opdracht
mogwai emails domains createOpties
--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 fastuserEen lijst met mailboxen ophalen
Opdracht
mogwai emails boxes listOpties
--domain=DOMAIN: Naam van het maildomein
Voorbeeldopdracht
mogwai emails boxes list --domain example.comVoorbeelduitvoer
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:00De ID uit de opdrachtuitvoer wordt gebruikt in andere opdrachten.
Een mailbox aanmaken
Opdracht
mogwai emails boxes createOpties
--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=MySecretPassword123Met deze opdracht wordt een mailbox met de naam user@example.com aangemaakt met het wachtwoord MySecretPassword123.
Een mailbox verwijderen
Opdracht
mogwai emails boxes deleteOpties
-b,--box=BOX: De ID van de mailbox..
Voorbeeldopdracht
mogwai emails boxes delete -b 1Met 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 modusimport- 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_ADDROpties
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=enDEST_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.comEr zijn twee modi beschikbaar:
Importmodus
mogwai emails boxes importIn 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 --forceSynchronisatiemodus
mogwai emails boxes syncIn 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.txtGebruikers
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
-mwordt 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 subdirectorylogs/). 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.67Mogelijke 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
-mniet 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 --helpGebruik het volgende om meer te weten te komen over een specifieke opdracht:
mogwai command --helpGebruik het volgende om een lijst met opdrachten en beschrijvingen te zien:
mogwai --help-longWebsites
Op deze pagina
Sites op een server weergeven
Commando
mogwai sites listVoorbeelduitvoer
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.comOpmerking: 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.
- PHP:
--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.3Een site verwijderen
Commando
mogwai sites delete --id=IDDe site ID kan worden verkregen met het commando mogwai sites list.
Voorbeeldcommando
mogwai sites delete --id=987Dit 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.
- PHP:
--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
-aom de instellingen voor alle sites te wijzigen. - Om de instellingen voor geselecteerde sites te wijzigen, geeft u meerdere vlaggen
--idop met hunIDs.
Voorbeeldcommando
mogwai sites update --id=1 -a www1.example.com -h cgi --handler_version=5.6Met 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 2Dit commando wijzigt de PHP-handler voor sites met ID 2 en 3
FASTPANEL