Portainer ist eine leichte Benutzeroberfläche für Docker, die den Prozess der Verwaltung von Docker -Containern vereinfacht. Es bietet eine intuitive Weboberfläche zum Bereitstellen, Konfigurieren und Überwachen von Containern. Dieser Leitfaden führt Sie durch die Installation und Einrichtung von Portainer auf einem Raspberry Pi, sodass Sie die Docker -Container problemlos verwalten können.
Was Sie brauchen werden
- Raspberry Pi (Jedes Modell mit Docker -Unterstützung, z. B. PI 3, PI 4)
- Raspberry Pi OS Installiert auf Ihrem Raspberry Pi
- Internetverbindung zum Herunterladen von Portainer
- Docker Installiert auf Ihrem Raspberry Pi (Portainer verlangt Docker, um auszuführen)
Schritt 1: Installieren Sie Docker am Raspberry Pi
Wenn Docker nicht bereits auf Ihrem Raspberry PI installiert ist, befolgen Sie diese Schritte, um diese zu installieren:
-
Aktualisieren Sie die Paketliste:
sudo apt update sudo apt upgrade -y
-
Installieren Sie Docker mit dem offiziellen Skript:
curl -sSL https://get.docker.com | sh
-
Fügen Sie nach der Installation den aktuellen Benutzer zur Docker -Gruppe hinzu, damit das Ausführen von Docker -Befehlen ohne zu ermöglichen
sudo
:sudo usermod -aG docker ${USER}
-
Starten Sie den Raspberry Pi neu, um die Änderungen anzuwenden:
sudo reboot
-
Stellen Sie sicher, dass Docker korrekt installiert ist:
docker --version
Schritt 2: Portainer installieren
Nachdem Docker installiert ist, können Sie Portainer als Docker -Container installieren.
-
Ziehen Sie das Portainer -Bild von Docker Hub:
docker pull portainer/portainer-ce
-
Erstellen und führen Sie einen Portainer -Container aus:
docker volume create portainer_data docker run -d -p 9000:9000 -p 9443:9443 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
Hier ist, was der Befehl tut:
-
-d
: Führen Sie den Container im abgetrennten Modus aus. -
-p 9000:9000
: Entdecken Sie die Web -Benutzeroberfläche auf Port 9000. -
-p 9443:9443
: Stellen Sie die Web -Benutzeroberfläche mit HTTPS auf Port 9443 aus. -
--name portainer
: Setzen Sie den Containernamen als "Portainer". -
--restart always
: Starten Sie Portainer automatisch im Start oder wenn der Container abstürzt. -
-v /var/run/docker.sock:/var/run/docker.sock
: Bind Mount Docker Socket zum Verwalten von Docker -Containern. -
-v portainer_data:/data
: Räumen Sie ein Volumen an, um Portainer -Daten zu bestehen.
-
-
Warten Sie, bis Portainer startet, dann öffnen Sie Ihren Webbrowser und gehen Sie zu:
http://<raspberry_pi_ip>:9000
Ersetzen
<raspberry_pi_ip>
Mit der IP -Adresse Ihres Raspberry Pi.
Schritt 3: Portainer einrichten
Wenn Sie zum ersten Mal auf die Portainer -Weboberfläche zugreifen, werden Sie aufgefordert, ein Administratorkonto zu erstellen.
-
Erstellen Sie ein Administratorkonto:
- Legen Sie einen Benutzernamen und ein Passwort für das Admin -Konto fest.
- Klicken Sie auf "Benutzer erstellen", um fortzufahren.
-
Verbindung zu Docker herstellen:
- Wählen Lokal Um die lokale Docker -Umgebung auf Ihrem Raspberry Pi zu verwalten.
- Klicken Verbinden.
Schritt 4: Verwenden von Portainerer
Sobald Sie angeschlossen sind, werden Sie in das Portainer -Dashboard gebracht, wo Sie mit der Verwaltung Ihrer Docker -Container beginnen können. Du kannst:
- Laufen Behälter anzeigen: Überwachen Sie den Status aller aktiven Behälter.
- Neue Container einsetzen: Erstellen Sie neue Docker -Container von der Portainer -Schnittstelle.
- Bände und Netzwerke verwalten: Zeigen und Konfigurieren von Docker -Volumes und -Netzwerken.
- Protokolle und Statistiken anzeigen: Überwachen Sie die Protokolle und Statistiken für laufende Container.
Schritt 5: Portainer verwalten
-
Zugriff auf Portainer aus der Ferne:
- Um den sicheren Zugriff auf Portainer remote zugreifen zu können, können Sie SSL mit einem Reverse -Proxy (z. B. Nginx oder Traefik) konfigurieren oder Port 9443 für HTTPS verwenden (aktiviert durch die
docker run
Befehl oben).
- Um den sicheren Zugriff auf Portainer remote zugreifen zu können, können Sie SSL mit einem Reverse -Proxy (z. B. Nginx oder Traefik) konfigurieren oder Port 9443 für HTTPS verwenden (aktiviert durch die
-
Anhalten und Starten Sie Portainer neu: Um Portainer zu stoppen, rennen Sie:
docker stop portainer
Um Portainer neu zu starten, rennen Sie:
docker restart portainer
-
Portainer entfernen: Wenn Sie Portainer entfernen möchten, stoppen Sie und entfernen Sie den Behälter:
docker stop portainer docker rm portainer
Optional können Sie auch das Docker -Volumen entfernen:
docker volume rm portainer_data
Fehlerbehebung
- Portainer nicht zugänglich: Stellen Sie sicher, dass die Firewall Ihres Raspberry Pi den Zugriff auf Ports 9000 und 9443 ermöglicht. Wenn Sie HTTPS verwenden, stellen Sie sicher, dass SSL -Zertifikate korrekt eingerichtet werden.
-
Docker -Container stürzt: Überprüfen Sie die Containerprotokolle auf Fehler:
docker logs portainer
-
Kein Zugriff auf Docker: Stellen Sie sicher, dass Ihr Benutzer Teil der Docker -Gruppe ist:
sudo usermod -aG docker ${USER} sudo reboot
Abschluss
Portainer vereinfacht das Docker-Containermanagement auf dem Raspberry Pi, indem sie eine benutzerfreundliche Weboberfläche bereitstellt. Mit nur wenigen Befehlen können Sie mit Docker und Portainer einrichten, um Ihre Container zu verwalten und zu überwachen. Unabhängig davon, ob Sie Home -Automatisierungssysteme, Webserver oder andere Docker -Dienste ausführen, ist Portainer ein unschätzbares Tool, um die Docker -Umgebung Ihres Raspberry Pi zu verwalten.