FASTPANELWIKI

Szybki start

Jak zaktualizować FASTPANEL®

Na tej stronie

Domyślnie FASTPANEL® jest aktualizowany automatycznie zgodnie z harmonogramem ustawionym przez harmonogram Cron. Nie musisz wykonywać żadnych dodatkowych działań, aby panel został zaktualizowany.

Aktualizacja ręczna

Jeśli z jakiegoś powodu konieczne jest wymuszenie aktualizacji, wykonaj następujące polecenie w konsoli przez SSH:

/usr/local/fastpanel2/app/updater

Zostanie uruchomiony plik wykonywalny, który zaktualizuje FASTPANEL® do najnowszej wersji.

Jak zainstalować FASTPANEL®

ważne

Panel można zainstalować tylko na czystym systemie operacyjnym bez żadnego preinstalowanego oprogramowania. Instalacja na serwerze ze wstępnie skonfigurowanym oprogramowaniem nie jest możliwa!

Aby zainstalować FASTPANEL®, wymagany jest serwer wirtualny (VPS) lub dedykowany z dostępem root.

Sprzęt serwera musi spełniać minimalne wymagania systemowe:

RAM: 1G
Wolne miejsce: 5Gb
CPU: 1 rdzeń, 1 Ghz

Obsługiwane systemy operacyjne są następujące (tylko architektura 64-bitowa):

Debian: 9, 10, 11, 12

Ubuntu: 18.04, 20.04, 22.04, 24.04

CentOS: 7

AlmaLinux: 8

Rocky Linux: 8


Po zainstalowaniu jednego z obsługiwanych systemów operacyjnych należy wykonać następujące czynności:

  1. Połącz się z serwerem przez SSH, używając hasła root:

    ssh root@your.server
  2. Zainstaluj najnowsze aktualizacje systemu operacyjnego oraz narzędzie wget, które jest wymagane do uruchomienia skryptu instalacyjnego panelu sterowania. Następnie uruchom ponownie serwer:

    Debian / Ubuntu:

    apt-get update && apt-get upgrade && apt-get install ca-certificates wget && reboot

    CentOS / AlmaLinux / Rocky Linux:

    yum makecache && yum update && yum install ca-certificates wget && reboot
  3. Po ponownym uruchomieniu serwera uruchom proces instalacji FASTPANEL®, wykonując następujące polecenie:

    wskazówka

    Podczas instalacji panelu możesz wybrać wersję MySQL. Więcej informacji znajdziesz w tym artykule.

    wget https://repo.fastpanel.direct/install_fastpanel.sh -O - | bash -
  4. Po zainstalowaniu FASTPANEL® otrzymasz wiadomość z danymi dostępowymi:

    Gratulacje! FASTPANEL został pomyślnie zainstalowany i jest dostępny pod adresem https://1.2.3.4:8888
    Login: fastuser
    Hasło: password

FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.

Konfiguracja NAT

Na tej stronie

NAT to mechanizm translacji adresów sieciowych, który tłumaczy adresy IP pakietów. NAT umożliwia serwerom w sieci lokalnej współpracę z serwerami w sieci zewnętrznej.

Jeśli serwer z FASTPANEL® ma prywatny adres IP, a w sieci lokalnej skonfigurowano NAT, aby zapewnić poprawne działanie domen DNS, witryn internetowych i usług pocztowych, musisz skonfigurować mapowanie prywatnych i publicznych adresów IP serwera.

Aby skonfigurować mapowanie adresów IP:

  1. Otwórz menu po lewej stronie → "Zarządzanie IP" → "Mapowanie IP"

  2. Kliknij "Dodaj"

  3. Dla lokalnych adresów IP wprowadź odpowiadający im publiczny adres IP

  4. Kliknij "Zapisz"

Po skonfigurowaniu mapowania adresów wewnętrzne adresy IP będą konwertowane na zewnętrzne adresy IP podczas tworzenia domen DNS.

Lista portów do przekierowania

Aby zapewnić poprawne działanie głównych usług, musisz skonfigurować przekierowanie następujących portów:

  • FASTPANEL: 8888, 7777

  • FTP: 21, 65000-65500

  • SSH: 22

  • SFTP: 2222

  • HTTP, HTTPS: 80, 443

  • IMAP, IMAPS: 143, 993

  • POP3, POP3S: 110, 995

  • SMTP, SMTPS: 25, 587, 465

  • DNS(jeśli używany jest bind9): 53

Inne usługi, takie jak MySQL, zazwyczaj działają tylko na lokalnych adresach IP i nie wymagają publicznego dostępu.

Jak odinstalować FASTPANEL®

ważne

Jeśli chcesz przejść z FASTPANEL® na inny panel sterowania, jedynym sposobem jest ponowna instalacja systemu operacyjnego (OS). Przed wykonaniem tej operacji koniecznie utwórz kopię zapasową wszystkich ważnych danych na zewnętrznym nośniku. Dzięki temu będzie można przywrócić projekty po ponownej instalacji.

FASTPANEL® można odinstalować bez zakłócania działania stron. Spowoduje to jednak takie konsekwencje, jak:

  • Zatrzymanie automatycznego odnawiania certyfikatów SSL z Let's Encrypt wydanych przez FASTPANEL®.
  • Wyłączenie zadań tworzenia kopii zapasowych wcześniej skonfigurowanych w FASTPANEL®.
  • Zmiana ustawień witryn, tworzenie i edytowanie użytkowników, skrzynek pocztowych, kont FTP/SFTP itp. będą możliwe wyłącznie poprzez ręczną konfigurację.

Jeśli masz pewność, że chcesz odinstalować FASTPANEL® i w pełni rozumiesz konsekwencje, możesz to zrobić, wykonując następujące polecenia w konsoli serwera jako root:

Debian/Ubuntu:

apt-get remove fastpanel2 fastpanel2-nginx

CentOS/AlmaLinux/RockyLinux:

yum remove fastpanel2 fastpanel2-nginx

Jeśli w przyszłości będziesz potrzebować przywrócić działanie FASTPANEL®, możesz ponownie zainstalować wcześniej odinstalowane pakiety. Nie ma jednak gwarancji, że po tym panel sterowania wznowi prawidłowe działanie.
Aby zainstalować pakiety FASTPANEL®, użyj poleceń:

Debian/Ubuntu:

apt-get update
apt-get install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

CentOS/AlmaLinux/RockyLinux:

yum makecache
yum install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

Jak zresetować hasło

Na tej stronie

Wprowadzenie

FASTPANEL® oferuje dwa różne sposoby zmiany hasła dowolnego użytkownika:

Zmiana hasła przez sam FASTPANEL

Ta metoda jest odpowiednia, jeśli poprzednie hasło jest znane (dostęp do panelu nie został utracony).

Aby skorzystać z tej opcji, musisz zalogować się do FASTPANEL® i przejść do menu "Management" → "Users", a następnie kliknąć "Change Password"

W otwartym oknie modalnym wprowadź stare hasło, następnie dwukrotnie wprowadź nowe hasło, a potem kliknij przycisk "Save"

Zmiana hasła przez SSH

Ta metoda jest odpowiednia, jeśli poprzednie hasło jest nieznane (dostęp do panelu został utracony). Do zmiany hasła przez SSH stare hasło nie jest wymagane.

Aby skorzystać z tej opcji, musisz:

  1. Połącz się z serwerem przez SSH, używając hasła root:

    ssh root@your.server
  2. Użyj polecenia passwd user_name

    Na przykład, aby zmienić hasło użytkownika o nazwie fastuser, polecenie powinno wyglądać tak:

    passwd fastuser

    Po uruchomieniu polecenia zostaniesz poproszony o wprowadzenie i potwierdzenie nowego hasła

    uwaga

    podczas wprowadzania i potwierdzania nowego hasła na ekranie nie będą wyświetlane żadne znaki.

  3. Jeśli zmiana hasła zakończyła się pomyślnie, otrzymasz następujący komunikat:

    passwd: password updated successfully

Następnie możesz zalogować się do panelu przy użyciu nowego hasła

Skonfiguruj klucze SSH

Na tej stronie

W FASTPANEL® możesz dodać klucze SSH dla użytkowników, aby uprościć i zabezpieczyć dostęp do serwera.

Klucze SSH (Public Key Authentication) zapewniają bezpieczny i wygodny sposób dostępu do serwera bez używania haseł, oparty na parze kluczy prywatnego i publicznego. Zamiast wpisywać hasło za każdym razem, klient używa klucza prywatnego, a serwer weryfikuje go względem klucza publicznego, co zwiększa zarówno bezpieczeństwo, jak i wygodę użytkowania.

Tworzenie pary kluczy

ostrzeżenie

Chroń swój klucz prywatny i nigdy nikomu go nie udostępniaj.

Najpierw musisz wygenerować parę kluczy: prywatny i publiczny.

macOS / Linux

Otwórz terminal i uruchom:

ssh-keygen

Naciśnij Enter, aby zaakceptować domyślną lokalizację pliku, i ustaw hasło, jeśli jest potrzebne.
Twoje klucze zostaną zapisane w ~/.ssh/id_ed25519 (prywatny) i ~/.ssh/id_ed25519.pub (publiczny).

Windows

OpenSSH

Otwórz PowerShell i uruchom:

ssh-keygen

Naciśnij Enter, aby zaakceptować domyślną lokalizację pliku, i ustaw hasło, jeśli jest potrzebne.
Twoje klucze zostaną zapisane w C:\Users\YourUser\.ssh\id_ed25519 (prywatny) i C:\Users\YourUser\.ssh\id_ed25519.pub (publiczny).

PuTTYgen
  1. Pobierz i zainstaluj PuTTYgen.
  2. Uruchom PuTTYgen i kliknij "Generate".
  1. Poruszaj kursorem myszy losowo nad oknem PuTTYgen, aż proces generowania zostanie zakończony.
  2. Zapisz klucz prywatny (.ppk) i skopiuj tekst klucza publicznego.

Dodaj klucz publiczny do panelu

Otwórz FASTPANEL® i kliknij swoją nazwę użytkownika w prawym górnym rogu ekranu. Następnie wybierz "Klucze SSH".

Kliknij przycisk "Dodaj klucz SSH".

  • W pierwszym polu wklej swój klucz publiczny (zwykle zaczyna się od ssh-ed25519 lub ssh-rsa, w zależności od wybranego algorytmu) z poprzedniej sekcji.

  • W drugim polu możesz dodać opis, aby łatwiej odróżnić klucz.

Po wykonaniu tych kroków możesz połączyć się ze swoim serwerem przez SSH, używając danych logowania właściciela witryny, bez wpisywania hasła.

Włącz dostęp SSH i zarządzaj istniejącymi kluczami

Jeśli chcesz zarządzać kluczami innych użytkowników lub usunąć klucze bieżącego użytkownika, przejdź do "Zarządzanie" → "Użytkownicy". Kliknij trzy kropki obok użytkownika, którego kluczami chcesz zarządzać.

W otwartej sekcji możesz:

  1. Dodać nowy klucz.
  2. Usunąć istniejący klucz.
  3. Włączyć lub wyłączyć dostęp SSH dla użytkownika.

Ustaw adres panelu

Na tej stronie

Wprowadzenie

Oprócz standardowego dostępu do FASTPANEL® za pomocą adresu IP możesz również ustawić dowolną domenę lub subdomenę skierowaną na serwer z zainstalowanym FASTPANEL® jako adres panelu.

Na początek upewnij się, że dla nazwy domeny, której chcesz używać jako adresu panelu, istnieje prawidłowy rekord A. Możesz to sprawdzić za pomocą poleceń:

Windows:

nslookup example.com

Linux/MacOS:

host example.com

Jeśli rekord A jest poprawny, zobaczysz następujący wynik:

example.com has address $IP_ADDRESS

W miejscu $IP_ADDRESS należy podać adres IP Twojego serwera. Jeśli widnieje inny adres, popraw go na koncie swojego dostawcy DNS i poczekaj na aktualizację pamięci podręcznej DNS. Proces ten zwykle trwa od 20 do 60 minut.

Ustawianie adresu panelu

Aby ustawić jedną ze swoich domen lub subdomen jako adres panelu, przejdź do „Settings” -> „Main” -> „Panel addresses” i kliknij niebieski przycisk „Add address”.

W następnym oknie dodaj domenę, której chcesz używać jako adresu panelu, i kliknij "Save".

Po tym FASTPANEL® będzie dostępny pod adresem:

example.com:8888

Dostęp bezpośredni

Aby skonfigurować dostęp bezpośredni bez podawania portu 8888, kliknij ikonę ołówka obok ustawionego adresu panelu:

Następnie zaznacz pole wyboru "Direct access" i wybierz adresy IP, których chcesz używać dla tej nazwy domeny:

I kliknij "Save".

Certyfikat SSL dla adresu panelu

Dla adresu panelu możesz wydać bezpłatny certyfikat SSL od Let's Encrypt, użyć istniejącego płatnego certyfikatu lub certyfikatu z podpisem własnym. Aby to zrobić, kliknij niebieski tekst "SSL" obok adresu panelu:

Następnie w otwartym oknie wybierz typ certyfikatu:

I kliknij "Save".

Możliwe problemy

Pamiętaj, że lepiej nie używać jako adresu FASTPANEL® domeny znajdującej się za Cloudflare, ponieważ może to powodować problemy z FASTPANEL® podczas dostępu przez nazwę domeny z powodu ograniczeń po stronie Cloudflare.

Jeśli podczas używania takiej domeny pojawią się problemy, sprawdź, czy występują one również podczas uzyskiwania dostępu do panelu przez adres IP. Jeśli nie, wyłącz proxy dla nazwy domeny używanej jako adres FASTPANEL® w sekcji DNS usługi Cloudflare.