🧭 Portainer auf TerraMaster (TOS 6): Installation, Einrichtung & Updates – Schritt für Schritt

Portainer macht die Docker-Verwaltung auf der NAS komfortabel. Hier zeige ich zwei Wege: App-Center (schnell) und manuell per SSH (flexibel & backup-freundlich) – inkl. sicherer Ordnerstruktur, Erstlogin, Templates und Updates.

1) Voraussetzungen

• TerraMaster mit TOS 6
• Docker Manager installiert (App Center)
• Admin-Zugang zur NAS

2) Weg A – Portainer über das App-Center (One-Click)

1. App Center öffnen → nach Portainer suchen → installieren.
2. Starten, beim ersten Aufruf Admin-Passwort (12+ Zeichen) setzen.
3. Vorteil: sehr schnell.
   Nachteil: App-Daten liegen tief im /app/-Pfad – schwerer zu sichern/migrieren.

3) Weg B – Manuelle Installation (empfohlen: Daten unter /volume1/docker/portainer)

Warum? Klare Ordnerstruktur, einfache Backups/Restore, Updates per Neu-Deploy.

3.1 SSH aktivieren
Systemsteuerung → Terminal & SNMP → SSH erlauben (Port 22).
Tipp: Zugriff auf LAN beschränken.

3.2 Datenordner anlegen
Im File Manager (oder SMB) z. B.:
/volume1/docker/portainer

3.3 Docker-Run ausführen (Konsole/Terminal-App auf der NAS)

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

• Port 9443 = HTTPS-GUI. Falls belegt, links anpassen (z. B. -p 8457:9443).
• :lts lädt die stabile Long-Term-Support-Version.

3.4 Erster Login
Browser: https://<NAS-IP>:9443 → Admin-Passwort setzen → Umgebung „local“ öffnen.
Optional in Portainer: unter Settings → Environments → local die NAS-IP eintragen (saubere Endpunkte/URLs).

4) Ordner, Netzwerke & Stacks – Best Practices

• Volumes sauber unter /volume1/docker/<appname> ablegen.
• Standard-Netzwerk: bridge (Ports explizit mappen).
• Stacks nutzen (docker-compose YAML) statt Einzel-Container – besser versionierbar & update-freundlich.

Beispiel-Stack (OpenSpeedTest):

version: "3.8" services:
  openspeedtest:
    image: openspeedtest/latest
    container_name: openspeedtest
    restart: unless-stopped
    ports:
      - "3310:3000" 

In Portainer: Stacks → Add stack → Web editor → YAML einfügen → Deploy.

5) Templates & Repositories

• Standard-Templates unter App Templates verfügbar.
• Alternativ eigene Template-URL hinterlegen (Settings → App Templates), um mehr Vorlagen zu sehen.
• Images kommen i. d. R. aus Docker Hub; weitere Registries können hinzugefügt werden (Settings → Registries).

6) Updates & Wartung

Portainer selbst aktualisieren (manuell):

# 1) Neues Image holen
docker pull portainer/portainer-ce:lts

# 2) Alten Container stoppen & entfernen
docker stop portainer && docker rm portainer

# 3) Neu starten mit gleichem Befehl (Daten bleiben in /data erhalten)
docker run -d \
  --name portainer \
  --restart=always \
  -p 8000:8000 -p 9443:9443 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /volume1/docker/portainer:/data \
  portainer/portainer-ce:lts

Container deiner Apps aktualisieren:

• Entweder via Watchtower (automatisch) oder gezielt pro Stack: neues Image ziehen → Stack Re-deploy.

Aufräumen (optional):

# Ungenutzte Images/Container/Netzwerke/Volumes aufräumen
docker system prune -a

7) Sicherheit

• Starkes Admin-Passwort & 2FA (falls via Proxy/SSO möglich).
• Portainer-GUI nur im LAN freigeben (Firewall/Reverse-Proxy).
• Backups: /volume1/docker/portainer regelmäßig sichern (Snapshot/Double Backup).
• Keine unnötigen Privilegien; nur benötigte Ports öffnen.

Troubleshooting

• GUI nicht erreichbar: Prüfen ob Container läuft (docker ps), Port-Konflikte, Browser via https://…:9443.
• „Bind mount“ Fehler: Ordnerpfad/Schreibrechte von /volume1/docker/portainer prüfen.
• Stacks schlagen fehl: YAML-Syntax (Einrückungen!), Portkollisionen, fehlende Volumes/Env-Variablen.

Fazit
Mit Portainer wird Docker auf der TerraMaster übersichtlich und updatefest. Für saubere Backups & einfache Migration empfiehlt sich die manuelle Installation mit bind-Mount auf /volume1/docker/portainer. Danach kannst du deine Container per Stacks strukturiert verwalten.