Zum Inhalt springen

Dokumentation

Webmin und Virtualmin

Webmin ist die Controlpanel-Integration für Server, auf denen Virtualmin läuft. Sie legt Webhosting-Konten auf einer Maschine an, die bereits läuft, und verwaltet sie. Es gibt kein Betriebssystem zu installieren und keine Maschine zu starten. Ein Konto wird angelegt, bekommt einen Plan und wird später stillgelegt, auf einen anderen Plan gesetzt oder entfernt.

Webmin ist das Panel, Virtualmin macht das Hosting

Sie kennen das Produkt als Webmin, und so heißt auch diese Seite. Was Provibr tatsächlich ansteuert, ist Virtualmin: das Modul, das Domains, Pläne und Kontingente kennt. Reines Webmin verwaltet eine Linux-Maschine und kennt den Begriff Hosting-Konto überhaupt nicht.

Auf einem Server ohne dieses Modul ist die Remote-API schlicht nicht vorhanden: Sie antwortet genau wie ein Modul, das es nicht gibt. Provibr kann also nicht auf reines Webmin ausweichen und tut auch nicht so: Die Verbindung wird mit einer Begründung abgelehnt statt halb angelegt.

Was Sie brauchen

Die Remote-API von Webmin spricht HTTP Basic, das Geheimnis ist hier also ein Passwort und kein Token. Das ist eine Eigenschaft von Webmin und keine Entscheidung von uns, und es ist der Grund, warum die beiden Regeln unten strenger sind als bei den anderen Controlpanels.

  • Host: die Adresse des Panels. Sie muss https sein, und Port 10000 wird ergänzt, wenn Sie ihn weglassen.
  • Webmin-Benutzer: root funktioniert, aber ein Benutzer, der nur das Virtualmin-Modul hat, ist besser.
  • Passwort: das Passwort dieses Benutzers. Es gibt nichts einzugrenzen, wählen Sie den Benutzer also mit Bedacht.
  • TLS-Fingerabdruck: Pflicht, denn der Installer von Webmin hinterlässt ein selbstsigniertes Zertifikat.
Weisen Sie das Virtualmin-Modul einem Webmin-Benutzer zu, den Sie dafür angelegt haben. Er kann alles, was Virtualmin kann, und das ist viel, aber nicht alles, was Webmin kann.

https und der Fingerabdruck sind beide Pflicht

Die anderen Controlpanel-Integrationen akzeptieren eine reine http-Adresse und sagen Ihnen, was das kostet. Diese nicht, und der Unterschied liegt im Geheimnis: Ein DirectAdmin-Login-Key lässt sich auf eine Handvoll Befehle begrenzen, ein Webmin-Passwort überhaupt nicht.

Dieses Passwort unverschlüsselt zu senden oder an ein Zertifikat, das niemand geprüft hat, ist keine Abwägung, die wir für Sie treffen. Also wird http abgelehnt, und das Fingerabdruck-Feld darf nicht leer bleiben.

Lesen Sie den Fingerabdruck von jeder Maschine aus, die das Panel erreicht, und fügen Sie ihn so ein, wie Sie ihn bekommen haben, mit oder ohne Doppelpunkte, und das Präfix Ihres Werkzeugs darf stehen bleiben.

shell
openssl s_client -connect <host>:10000 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Befehle und Terminal-Ausgaben sind überall auf Englisch, im Panel und auf diesen Seiten. Ein Text, eine Wahrheit: Was Sie hier lesen, ist wörtlich das, was Ihr Host zurückschreibt.

Die Remote-API

Provibr benutzt die Weboberfläche von Webmin nicht. Es ruft die Remote-API des Virtualmin-Moduls auf, die maschinenlesbare Antworten statt Seiten liefert. Auf manchen Installationen ist dieser Weg abgeschaltet; einschalten lässt er sich unter Webmin, Webmin Configuration, Advanced Options.

Antwortet das Panel mit einer Anmeldeseite statt mit der API, sagt der Agent das ausdrücklich. Meist zeigt die Adresse dann auf eine Seite statt auf das Panel, oder die Remote-API ist aus.

Einstellungen

Es gibt keine. Ein Webmin-Server entscheidet selbst, wo ein Konto liegt und welche Adresse es bekommt, also bleibt für Sie nichts zu wählen. Den Tab Einstellungen gibt es trotzdem, denn dort senden Sie auch die Zugangsdaten erneut.

Pläne

Ein Virtualmin-Plan ist die eigene Beschreibung, die das Panel von einem Konto hat: Speicherkontingent, monatlicher Datenverkehr, wie viele Domains und Postfächer, welche Funktionen an sind. Es ist kein Provibr-Plan und kein Betriebssystem. Es ist ein Name, auf den wir verweisen, und sein Inhalt kann sich auf Ihrem Server ändern, ohne dass wir es merken.

Die Integrationsseite kann die Liste der Pläne samt Inhalt auslesen, sodass Sie sehen, was Sie wählen, statt einen Namen aus dem Gedächtnis zu tippen.

Ein Webplan legt einen Virtualmin-Plan auf einer Integration fest und gibt ihm einen eigenen Namen. Bestellen mit einem Plan gewinnt gegen eine lose Auswahl, und die lose Auswahl bleibt für die Fälle, die ein Plan nicht abdeckt.

Wie ein Konto in Provibr aussieht

Ein Hosting-Konto ist eine gewöhnliche Serverzeile vom Typ Webserver. Seine Kennung ist die interne Nummer, die Virtualmin der Domain gibt; Domain, Benutzer, Plan und Funktionen kommen bei jeder Abfrage mit.

  • Zum Anlegen eines Kontos gehören eine Domain, eine E-Mail-Adresse, ein Plan und ein Passwort.
  • Der Unix-Benutzer wird aus der Domain abgeleitet, Bindestriche sind hier also normal, anders als bei DirectAdmin, das eine eigene Namensregel hat.
  • Das Passwort wird nirgends festgehalten. Nur die Tatsache, dass Sie eines mitgegeben haben; der Wert reist getrennt.
  • Danach können Sie stilllegen, fortsetzen, den Plan wechseln und löschen. Eine Konsole gibt es nicht, denn ein Hosting-Konto hat keine.
Die Kennung ist die Nummer und nicht der Name, denn Virtualmin kann eine Domain umbenennen. Ein Schlüssel auf den Namen würde sich beim ersten Mal, wenn das jemand tut, von seiner Zeile lösen.

Kontingente und Auslastung

Speicherkontingent und Datenverkehr fahren bei der regulären Abfrage mit, ein Konto bekommt also eine Auslastungsgrafik, ohne dass etwas zusätzlich eingeschaltet werden muss, sofern der Server sie messen kann.

Virtualmin meldet Kontingent und Verbrauch nur, wenn die Dateisystem-Kontingente eingeschaltet sind, und eine frische Installation hat sie aus. Solange sie niemand einschaltet, sind diese Felder schlicht nicht da. Provibr zeigt dann nichts statt einer Null: keine Messung und kein Verbrauch sind nicht dasselbe.

Bestehende Konten übernehmen

Der Import-Tab listet die Konten auf dem Panel und lässt Sie die gewünschten in Provibr übernehmen. Bereits bekannte Konten werden angezeigt, sind aber nicht erneut auswählbar, sodass Sie das ganze Bild sehen und nicht ein gefiltertes.

Importierte Konten zählen genauso auf Ihre Kapazität wie bestellte. Importieren Sie mehr, als Sie Platz haben, öffnet sich eine Überschreitung mit der üblichen Karenzzeit.