Server-Verwaltung¶

enconf unterstützt Multi-Server-Betrieb. Hosting-Accounts können auf verschiedene Server verteilt werden, die jeweils einen Management-Agent ausführen.

Architektur¶

Das Panel besteht aus zwei Komponenten:

Panel — Die zentrale Verwaltungsoberfläche, über die Sie alle Server steuern
Agent — Ein Dienst auf jedem verwalteten Server, der die Systemoperationen ausführt (Webserver, PHP, Benutzer, etc.)

Das Panel kommuniziert mit dem Agent auf jedem Server. Auch im Single-Server-Betrieb läuft der Agent als eigenständiger Dienst.

┌──────────┐                    ┌──────────────┐
│  Panel   │ ──────────────────▸│    Agent     │
│          │                    │ (Server 1)   │
└──────────┘                    └──────────────┘
       │                   ┌──────────────┐
       └──────────────────▸│    Agent     │
                           │ (Server 2)   │
                           └──────────────┘

Server-Übersicht¶

Die Server-Tabelle unter Einstellungen > Server zeigt alle konfigurierten Server:

Spalte	Beschreibung
Name	Server-Bezeichnung
Hostname	FQDN des Servers
Agent-URL	URL des Management-Agents
Rollen	Zugewiesene Server-Rollen
Max. Accounts	Maximale Anzahl Hosting-Accounts
Agent-Version	Installierte Agent-Version
Erreichbar	Online/Offline-Status
Update	Verfügbares Agent-Update
Aktiv	Server aktiv (nimmt neue Accounts an)

Server hinzufügen¶

Navigieren Sie zu Einstellungen > Server
Klicken Sie auf Server hinzufügen
Füllen Sie das Formular aus:

Feld	Pflicht	Beschreibung
Name	Ja	Anzeigename des Servers
Hostname	Ja	FQDN des Servers (z. B. `web1.beispiel.de`)
Mail-Hostname	Nein	Hostname für E-Mail (z. B. `mail.beispiel.de`)
Agent-URL	Ja	URL des Agents (z. B. `http://localhost:50000` oder `https://web1.beispiel.de:50000`)
Agent-Token	Ja	Shared Secret für die Authentifizierung
Rollen	Ja	Server-Rollen (siehe unten)
Max. Accounts	Nein	Obergrenze für Hosting-Accounts
Panel-URL	Nein	URL des Panels auf diesem Server
phpMyAdmin-Pfad	Nein	Pfad zu phpMyAdmin (z. B. `/phpmyadmin`)
Roundcube-Pfad	Nein	Pfad zu Roundcube (z. B. `/webmail`)
Aktiv	Ja	Server nimmt neue Accounts an

Klicken Sie auf Erstellen

Server-Rollen¶

Jeder Server kann eine oder mehrere Rollen haben:

Rolle	Beschreibung
web	Webserver (Nginx + PHP-FPM)
mail	E-Mail-Server (Postfix + Dovecot)
dns	DNS-Server (PowerDNS)
db	Datenbank-Server (MariaDB)
backup	Backup-Server

Single-Server¶

Im Single-Server-Betrieb hat der einzige Server alle Rollen: web,mail,dns,db,backup.

Multi-Server¶

Im Multi-Server-Betrieb können Rollen aufgeteilt werden:

Server 1: web,db — Webserver mit Datenbanken
Server 2: mail,dns — E-Mail und DNS
Server 3: backup — Dedizierter Backup-Server

Agent-Installation¶

Auf einem neuen Server¶

Installieren Sie das Agent-Paket:

apt install netcell-webpanel-agent

Konfigurieren Sie den Agent in /etc/netcell-webpanel-agent/config.env:

AGENT_TOKEN=IhrGeheimerToken
AGENT_PORT=50000

Starten Sie den Agent:

systemctl enable --now netcell-webpanel-agent

Fügen Sie den Server im Panel hinzu (siehe oben)

Installationsskript¶

Alternativ kann ein Installationsskript über das Panel generiert werden:

Klicken Sie auf Installationsskript generieren
Kopieren Sie das Skript
Führen Sie es auf dem neuen Server aus

Server bearbeiten¶

Klicken Sie auf das Bearbeiten-Symbol in der Server-Tabelle
Ändern Sie die gewünschten Einstellungen
Klicken Sie auf Speichern

Server löschen¶

Klicken Sie auf das Löschen-Symbol
Bestätigen Sie die Löschung

Hosting-Accounts

Ein Server kann nicht gelöscht werden, solange Hosting-Accounts darauf laufen. Migrieren Sie alle Accounts zuerst auf einen anderen Server.

Online/Offline-Status¶

Der Agent-Status wird regelmäßig geprüft:

Grüner Indikator — Agent erreichbar und funktionsfähig
Roter Indikator — Agent nicht erreichbar

Agent offline

Wenn ein Agent offline ist, können keine Systemoperationen auf diesem Server ausgeführt werden (keine neuen Sites, keine Konfigurationsänderungen, keine Backups).

SSL-Konfiguration¶

Für jeden Server können SSL-Zertifikate konfiguriert werden:

Panel-SSL¶

Modus	Beschreibung
letsencrypt	Automatisches Let's Encrypt-Zertifikat
custom	Eigenes Zertifikat hochladen
selfsigned	Selbstsigniert (nur für Tests)

Mail-SSL¶

Eigenes SSL-Zertifikat für den Mail-Server (IMAP/SMTP):

Gleiche Optionen wie Panel-SSL
Sollte den Mail-Hostnamen enthalten

Agent-Updates¶

Wenn eine neuere Agent-Version verfügbar ist:

Ein Update-Badge wird in der Server-Tabelle angezeigt
Aktualisieren Sie den Agent auf dem betreffenden Server:

apt update && apt upgrade netcell-webpanel-agent

Der Agent startet automatisch mit der neuen Version neu