Hoppa till huvudinnehåll

Överföra användare mellan FASTPANEL

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

Mö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 -m inte 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.