Přejít na hlavní obsah

Přenos uživatelů mezi FASTPANEL

Úvod​

Tento článek popisuje proces přenosu uživatelských účtů a jejich přidružených dat (webové stránky, databáze, e-mail atd.) z jednoho serveru FASTPANEL na jiný pomocí vestavěného migračního nástroje.

Klíčové pojmy​

  • Zdrojový server - Server, ze kterého se přenášejí data.
  • Cílový server - Server, na který se data přenášejí.

Důležité poznámky​

  • Ve výchozím nastavení funguje migrace správně pouze pro weby se standardní konfigurací FASTPANEL.

  • Weby s ručními změnami konfigurace lze přenést pouze při použití příznaku -m pro mapování IP adres.

  • Pokud není k dispozici šifrované heslo vlastníka databáze, databáze nebude přenesena.

  • Pokud není přenesena webová stránka, nebudou přeneseny ani její přidružené databáze.

  • Přenášet lze pouze lokální databáze.

Proces migrace​

Připojení​

Cílový server se ke zdrojovému serveru připojuje přes SSH. Při prvním připojení cílový server nainstaluje na zdrojový server klíč SSH (buď předem poskytnutý, nebo vygenerovaný z hesla).

Kroky migrace​

  • Instalace modulu
  • Shromažďování informací o přenositelných objektech
  • Vytváření uživatelů
  • Přenos certifikátů SSL
  • Vytváření webových stránek, FTP účtů, e-mailových domén a e-mailových účtů
  • Vytváření databází a uživatelů databází
  • Přenos souborů webových stránek a e-mailových schránek
  • Přenos úloh cron

Přenos souborů se provádí pomocí rsync. Databáze se přenášejí vytvořením dumpu přes SSH tunel.

Příkaz pro spuštění migrace​

Příkaz se spouští na cílovém serveru jako uživatel s právy root:

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

Příznaky příkazového řádku​

Připojení SSH​

  • --remote_host="SOURCE_IP" - IP adresa zdrojového serveru.
  • --remote_port="SSH_PORT" - Port SSH.
  • --remote_username="SSH_USER" - Uživatel (musí být root).
  • --remote_password="USER_PASSWORD" - Heslo pro zadaného uživatele SSH.
  • --ssh_key_path="PATH_TO_KEY" - Cesta k privátnímu klíči SSH na cílovém serveru pro připojení ke zdrojovému serveru. Pokud se použije klíč, heslo (--remote_password) není potřeba.

IP adresy​

Pro správu IP adres webů během přenosu musíte použít pouze jeden z následujících příznaků. Příznak -m má prioritu.

  • -i "IP_ADDRESS_ON_DESTINATION" - Přiřadí zadanou IP adresu všem přenášeným webům na cílovém serveru. Chcete-li zadat více IP adres (např. pokud jich na zdrojovém serveru bylo několik), opakujte příznak pro každou zdrojovou IP adresu, kterou je třeba přenést.

  • -m "SOURCE_IP,DESTINATION_IP" - Doporučená metoda. Vytvoří přímé mapování: všechny weby používající SOURCE_IP na zdrojovém serveru budou používat DESTINATION_IP na cílovém serveru. Tento příznak lze zadat vícekrát pro různé dvojice IP. Povinné pro přenos webů s ručními úpravami konfigurace, protože umožňuje správné nahrazení IP adres v direktivách listen.

Další nastavení​

  • --users="USER_LIST" - Přenese pouze zadané uživatele (oddělené čárkami). Pokud není zadáno, přenesou se všichni uživatelé.
  • --disable_disk_quota - Zakáže přenos diskových kvót uživatelů.
  • --with_user_data - Zahrnuje kopírování celého obsahu domovských adresářů uživatelů (kromě podadresáře logs/). Používejte opatrně, protože to může výrazně prodloužit dobu přenosu a zvýšit objem přenášených dat.
  • --only_data - Přenese pouze data (soubory webových stránek, poštovní soubory, dumpy databází). Užitečné, pokud byla počáteční migrace struktury (uživatelé, weby, DB atd.) úspěšná, ale během fáze kopírování souborů nebo dumpů došlo k chybám. Umožňuje znovu spustit pouze část kopírování dat.
  • --transfer_timeout - Nastaví časový limit operace (výchozí hodnota je 60 minut).

Ukázkový příkaz​

Přenese všechny uživatele ze serveru 11.22.33.44 na aktuální server. Na starém serveru weby používaly IP adresy 11.22.33.44 a 11.22.33.55; na novém serveru by měly používat postupně 99.88.77.66 a 99.88.77.67. Připojení přes SSH pomocí hesla.

/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

Možné problémy a typy chyb​

Chyba v migračním protokolu neznamená vždy kritický problém, ale může poukazovat na důvod, proč nebyl konkrétní objekt přenesen.

  • Konflikty: Nastávají, když je přenos objektu nemožný kvůli aktuální konfiguraci cílového serveru (např. uživatel nebo web se stejným názvem již existuje) nebo pokud je konfigurace webu na zdrojovém serveru panelu neznámá (např. kvůli rozsáhlým ručním úpravám).

  • Chybějící uložené heslo: Jak bylo uvedeno dříve, uživatele databáze MySQL bez uloženého hesla ve FASTPANEL na zdrojovém serveru nelze přenést.

  • Ruční nastavení a IP adresy: Pokud má web na zdrojovém serveru ruční úpravy konfigurace webového serveru a během migrace se nepoužije příznak -m k namapování jeho IP adresy, takový web nebude přenesen, protože panel neví, kterou IP adresu má v konfiguraci na cílovém serveru zadat.