Blog / Baza Wiedzy

Jak zainstalować Portainer CE na Ubuntu i Debian

5 min czytania
Jak zainstalować Portainer CE na Ubuntu i Debian

Wstęp

Docker to wspaniałe narzędzie, ale wpisywanie komend w czarnej konsoli może być przytłaczające dla początkujących. Z pomocą przychodzi Portainer - panel z graficznym interfejsem (GUI), który pozwala zarządzać wszystkim z poziomu przeglądarki internetowej.

W tym poradniku pokażemy Ci, krok po kroku, jak zainstalować Portainera na Twoim serwerze w zaledwie kilka minut. Nie musisz być ekspertem od Linuxa - wystarczy, że będziesz kopiować i wklejać poniższe komendy!

Wymagania wstępne: Będziesz potrzebować serwera Premium VPS z systemem Ubuntu lub Debian oraz klienta SSH (np. PuTTY lub systemowy Terminal). Jeśli jeszcze nie masz serwera, VoxiHost oferuje Premium VPS i Budget VPS z preinstalowanym Ubuntu i Debianem.


Krok 1: Połączenie z serwerem i instalacja Dockera

Najpierw połącz się ze swoim serwerem przez SSH. Następnie upewnijmy się, że na serwerze zainstalowany jest Docker. Jeśli jeszcze go nie masz, wystarczy wkleić poniższą komendę, która zrobi wszystko za Ciebie:

Terminal podczas instalacji środowiska Docker na Ubuntu

curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh

Zaczekaj chwilę, aż instalacja się zakończy.


Krok 2: Przygotowanie miejsca dla Portainera

Portainer potrzebuje bezpiecznego miejsca na dysku, aby zapisywać Twoje hasła i konfiguracje. Wklej poniższą komendę w konsoli i wciśnij ENTER, aby utworzyć tzw. "wolumen":

Tworzenie wolumenu Docker dla Portainera w terminalu

docker volume create portainer_data

Krok 3: Uruchomienie Portainera

Teraz uruchomimy samego Portainera. Poniższa komenda pobierze najnowszą wersję programu i uruchomi ją w tle. Wklej ją w całości do konsoli i wciśnij ENTER:

Uruchamianie kontenera Portainer CE z wymaganymi portami i wolumenem

docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

I to tyle! Instalacja po stronie serwera jest zakończona.


Krok 4: Pierwsze logowanie w przeglądarce

Możesz już zamknąć konsolę. Teraz otwórz swoją ulubioną przeglądarkę internetową (np. Chrome, Firefox) i wpisz w pasku adresu:

https://ADRES_IP_TWOJEGO_SERWERA:9443
(Zastąp "ADRES_IP_TWOJEGO_SERWERA" rzeczywistym adresem IP swojego VPS, np. https://192.168.1.50:9443)

Wskazówka: Jeśli po wejściu na stronę widzisz błąd Client sent an HTTP request to an HTTPS server., oznacza to, że Twoja przeglądarka spróbowała połączyć się przez zwykłe HTTP. Upewnij się, że adres na samym początku ma wpisane ręcznie https://.

Ważne: Przeglądarka może wyświetlić ostrzeżenie o "Niezaufanym certyfikacie" (ang. Your connection is not private). To całkowicie normalne, ponieważ serwer używa domyślnego certyfikatu własnego podpisu. Kliknij "Zaawansowane", a następnie "Kontynuuj / Przejdź na stronę".

Na ekranie zobaczysz kreator początkowy. Wymyśl dla siebie bezpieczne hasło, wpisz je dwukrotnie i kliknij przycisk tworzenia użytkownika (Create user).

Ważne (Limit 5 minut!): Portainer dba o bezpieczeństwo. Jeśli od momentu uruchomienia (Krok 3) do ustalenia hasła minie ponad 5 minut, instalacja zostanie zablokowana (komunikat Your Portainer instance timed out). Aby ją odblokować, wpisz w konsoli docker restart portainer i odśwież stronę. Zostaniesz wtedy poproszony o Setup Token. Aby go uzyskać, wpisz w konsoli docker logs portainer. W logach znajdziesz napis Use the following token to setup the administrator user: a pod nim swój token. Skopiuj go i wklej na stronie.

Ekran tworzenia konta administratora w Portainer w przeglądarce


Krok 5: Zarządzanie kontenerami

Po zalogowaniu kliknij przycisk "Get Started", a na kolejnym ekranie wybierz środowisko z ikonką wieloryba podpisane jako "Local" (czyli serwer, na którym właśnie jesteśmy).

Gotowe! Teraz widzisz pełny panel kontrolny. Od teraz nie musisz używać komend w czarnej konsoli - możesz zarządzać swoimi aplikacjami klikając myszką.

Panel główny Portainer pokazujący listę aktywnych kontenerów Docker


Podsumowanie

Portainer to niesamowite narzędzie, które sprawia, że technologia Docker jest dostępna nawet dla osób bez dużego doświadczenia z Linuxem. Jeśli szukasz serwera do własnych projektów lub nauki, VoxiHost ma w ofercie Premium VPS oraz Budget VPS z systemem Ubuntu i Debian gotowym do działania.

Najczęściej zadawane pytania

Portainer CE (Community Edition) jest darmowy i open-source - obejmuje wszystkie podstawowe funkcje zarządzania Dockerem. Portainer Business Edition (BE) dodaje funkcje korporacyjne, takie jak kontrola dostępu oparta na rolach (RBAC), integracja OAuth/LDAP i rozszerzony support.
Portainer używa HTTPS na porcie 9443, ale publiczne wystawianie go bez dodatkowej ochrony nie jest zalecane. Rozważ umieszczenie go za odwrotnym proxy (np. Nginx Proxy Manager) z uwierzytelnianiem lub ograniczenie dostępu do zaufanych adresów IP przez zaporę sieciową.
Zatrzymaj i usuń istniejący kontener, a następnie pobierz najnowszy obraz i uruchom ponownie tę samą komendę docker run. Twoje dane są zachowane w wolumenie portainer_data: docker stop portainer && docker rm portainer, a następnie ponowne uruchomienie oryginalnej komendy instalacyjnej.
Tak. Portainer nazywa je Stosami (Stacks). Możesz wdrażać pliki Docker Compose i zarządzać nimi bezpośrednio z interfejsu webowego Portainera bez użycia terminala.
Musisz zresetować hasło z poziomu wiersza poleceń. Zatrzymaj kontener, uruchom docker run --rm -v portainer_data:/data portainer/helper-reset-password, skopiuj wygenerowane hasło, a następnie uruchom ponownie Portainer komendą docker start portainer.

Sugeruj poprawki na GitHubie

Zauważyłeś literówkę lub chcesz ulepszyć ten poradnik? Ten wpis jest open-source i możesz go edytować.

Edytuj ten wpis
Wróć do listy wpisów

Języki