Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Velocity für Hoster

Wie ein Hosting-Unternehmen Exponential Velocity, die empfohlene Engine, installiert, konfiguriert, betreibt und unterstützt - Anforderungen, Installation, Ports und Worker-Benutzer, ein Dienst beim Systemstart, der…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/hosting/servers/velocity-for-hosts.md

On this page

This page is a translation. Read the English original

Velocity für Hoster

Diese Seite ist für Systemadministratoren und Support-Mitarbeitende bei Hosting-Unternehmen, die Exponential Velocity für Kunden-Websites betreiben. Sie beantwortet: was Velocity von einem Server braucht, wie Sie ihn installieren und konfigurieren, wie er Neustarts und Abstürze übersteht, wie eine Änderung ihn erreicht, wohin er protokolliert, wie Sie ihn beobachten und wie Sie jedem Kunden eine eigene Instanz geben. Die Quellen sind Kapitel 8 und Velocity-Engines; jeder Befehl unten wird aus dem Wurzelverzeichnis der Installation ausgeführt.

Inhalt

  1. Was Velocity für einen Hoster ist
  2. Anforderungen
  3. Installation und erster Start
  4. Einstellungen und wie Sie sie ändern
  5. Ports, Adresse und der Worker-Benutzer
  6. Am Laufen halten: Dienst beim Systemstart und Watchdog
  7. Eine Änderung ausrollen
  8. Logs, Status und Überwachung
  9. Das Dashboard und das Kontrollzentrum
  10. Ein Velocity-Server pro Kunde
  11. Checkliste

Was Velocity für einen Hoster ist

Velocity ist ein für Exponential geschriebener Anwendungsserver. Ein Elternprozess lädt die Anwendung einmal und forkt Worker, die eine Anfrage nach der anderen beantworten; zwischen den Anfragen wird jeder Worker auf den Zustand zurückgesetzt, den er beim Fork hatte. Der Elternprozess nimmt jede Verbindung an, beantwortet statische Dateien, Treffer im Antwort-Cache und seine eigenen Seiten ohne Worker und beendet TLS, sodass eine Velocity-Website kein Apache, nginx, PHP-FPM und keinen eigenen TLS-Terminator braucht (Kapitel 8, Abschnitt 8.3).

Was das für Ihren Betrieb heißt:

Unter VelocityUnter Apache/nginx mit PHP-FPM
Am Leben zu haltender Prozessein langlebiger Server pro Websiteder Webserver und der FPM-Master
Eine geänderte Klasse oder INI-Dateierreicht die Worker erst nach einem Neustart (exp:velocity deploy)erreicht PHP, nachdem OPcache neu prüft, oder nach einem Neuladen von FPM
TLSVelocity selbst, einschließlich ACMEmod_ssl oder nginx, plus certbot oder das Panel
Wiederholte anonyme Seitenvom Elternprozess aus dem Antwort-Cache beantwortetgerendert oder aus den Caches des Kernels ausgeliefert
Zu beurteilender SpeicherPSS von Elternprozess und Workern, nie RSSdie Prozesse des Pools

Der Befehl ist exp:velocity (auch exp:vc oder php bin/php/velocity.php). Er steuert drei Engines mit denselben Verben: qbix (der eigene Server von Velocity, Gegenstand dieser Seite), frankenphp (FrankenPHP) und php (der eingebaute Entwicklungsserver von PHP).

Anforderungen

BedarfDetail
PHP8.0 oder neuer; das Engine-Paket verlangt es ("php": ">=8.0" ab dem Release 0.0.4.54, davor >=8.1); das Standard-PHP 8.0 von RHEL 9 führt es aus (Kapitel 2)
PHP-Erweiterungensockets (vom Paket verlangt), pcntl und posix (Worker forken, ihren Benutzer wechseln), openssl (HTTPS)
Ein langlebiger Prozessvom Tarif erlaubt; Shared Hosting erlaubt meist keinen
Root oder hohe PortsPorts unter 1024 brauchen root; als root gestartet, behält nur der Elternprozess es
BetriebssystemLinux und die BSDs für alles; unter Windows sind Worker Unterprozesse php-cgi (Unterstützung von Betriebssystemen)

Beim Start weigert sich die Engine, ohne Prozesstrennung (pcntl oder eine php-cgi-Binärdatei) und ohne openssl zu laufen, wenn HTTPS konfiguriert ist; für den Rest warnt sie einmal. Fragen Sie die Maschine, was ihr fehlt:

php bin/php/console exp:velocity ext check
php bin/php/console exp:velocity ext install-hint <extension>    # the install command for this operating system

Auf Red Hat Enterprise Linux 9 und seinen Nachbauten ist das Standard-PHP 8.0: Schalten Sie zuerst einen neueren Modul-Stream ein (Kapitel 2, Abschnitt 2.9).

Installation und erster Start

composer require se7enxweb/exponential-velocity:~0.0.4.44
php bin/php/console exp:velocity config set --apply ServerSettings Engine qbix
php bin/php/console exp:velocity start
php bin/php/console exp:velocity status
curl -sI http://127.0.0.1:8088/ | head -1
  • Das Paket landet in vendor/se7enxweb/exponential-velocity. Die Tilde-Bedingung akzeptiert spätere Releases 0.0.4.x; 0.0.4.44 ist die Version, die die composer.json von Exponential vorschlägt, und die erste, die weitergeleitete Protokoll-Header nur von vertrauenswürdigen Proxys liest (Kapitel 8, Abschnitt 8.8).
  • settings/velocity.ini wird mit Engine=php ausgeliefert, weil der eingebaute Server von PHP immer funktioniert; jede echte Website setzt qbix.
  • start schreibt die Konfiguration, startet den Server im Hintergrund, wartet, bis der Port antwortet, und gibt den Status aus.
  • Die Engine gibt es auch als deb- und rpm-Pakete und Docker-Images (Pakete und Binärdateien von Velocity), aber für eine Installation von Exponential ist das Composer-Paket das, was exp:velocity steuert.

Was beim ersten Start schiefgehen kann (Kapitel 8): kein Serverskript (Paket nicht installiert), der Port ist schon belegt (exp:velocity status --all), keine Antwort von einer anderen Maschine (Host ist noch 127.0.0.1), eine Warnung, dass Worker als root laufen (kein Worker-Benutzer und ein Document Root, der root gehört), oder eine Wartungsseite, die ein Installationslauf eingeschaltet gelassen hat (php bin/php/maintenance.php status, dann off).

Einstellungen und wie Sie sie ändern

DateiWas sie ist
settings/velocity.inidie mitgelieferten Standards, jede Einstellung kommentiert; nie bearbeiten
settings/override/velocity.ini.append.phpdie Werte dieser Installation, von exp:velocity config set geschrieben
/etc/vc/... (oder var/vc/qbix/etc/ ohne root)der Konfigurationsbaum der Engine, bei jedem Start aus den zwei Dateien oben erzeugt
php bin/php/console exp:velocity config list                    # every setting; * marks the ones you set
php bin/php/console exp:velocity config get ServerSettings Workers
php bin/php/console exp:velocity config set --apply ServerSettings Workers 16
php bin/php/console exp:velocity config unset --apply ServerSettings Workers
php bin/php/console exp:velocity config paths

Eine geänderte Einstellung erreicht den Server beim nächsten restart oder graceful. Der Baum /etc/vc ist wie /etc/apache2 von Debian aufgebaut (vc.conf, ports.conf, envvars, conf-, mods- und sites-available mit Symlinks in -enabled), mit exp:velocity site|conf|mod enable|disable <name> als Familie von a2ensite (Aufbau von Velocity auf der Festplatte). Erzeugte Dateien tragen "_generated": "exp:velocity"; entfernen Sie diese Markierung aus einer Datei, und sie wird nie wieder überschrieben.

Ports, Adresse und der Worker-Benutzer

Einstellung ([ServerSettings])AusgeliefertBedeutung
Host127.0.0.1Bindeadresse; nur lokal, über einen Tunnel oder einen Proxy erreichbar
Port8088einfaches HTTP
HTTPSPort8080HTTPS, wenn HTTPS an ist
User, Groupleerals wer die Worker laufen, wenn der Server als root gestartet wird
AllowRootWorkersdisabledroot als Worker-Benutzer wird verweigert, außer bei enabled
FollowSymlinksdisabledein symbolischer Link aus dem Document Root hinaus wird verweigert
Nice5die Priorität des Servers und seiner Worker, egal mit welcher der Aufrufer läuft

Um Besuchern direkt auf den Standardports gegenüberzustehen:

php bin/php/console exp:velocity config set --apply ServerSettings Host 0.0.0.0 --allow-root-user
php bin/php/console exp:velocity config set --apply ServerSettings Port 80 --allow-root-user
php bin/php/console exp:velocity config set --apply ServerSettings HTTPSPort 443 --allow-root-user
php bin/php/console exp:velocity config set --apply ServerSettings User <customer> --allow-root-user
php bin/php/console exp:velocity config set --apply ServerSettings Group <customer> --allow-root-user
php bin/php/console exp:velocity restart --allow-root-user

Als root gestartet, behält der Elternprozess root (Ports, Zertifikat, Neuladen), und jeder Worker gibt es direkt nach dem Fork auf, bevor irgendein Code der Anwendung läuft. Der Worker-Benutzer wird in dieser Reihenfolge bestimmt: [ServerSettings] User und Group; dann VC_RUN_USER und VC_RUN_GROUP aus der Umgebung oder /etc/vc/envvars; dann der Eigentümer des Document Root. Ein Benutzer, der nicht existiert, stoppt den Start. Prüfen Sie die Startzeile Workers as: ... in var/vc/qbix/run/console.log. HTTPS steht auf HTTPS-Zertifikate in Velocity; die Poolgröße auf Velocity-Worker und Pools.

Am Laufen halten: Dienst beim Systemstart und Watchdog

exp:velocity hat keinen Befehl, der einen Dienst beim Systemstart installiert. Zwei Wege (Kapitel 8, Abschnitt 8.3.11):

  • die eigenen Units der Engine (vendor/se7enxweb/exponential-velocity/service/qbixserver.service und exponential-velocity.service des Betriebssystempakets), die die Engine direkt starten und deshalb umgehen, was exp:velocity hinzufügt (die erzeugte Site-Datei, KeepGlobals, [PHPSettings] IniOptions[], den Worker-Benutzer, Instanzen);
  • eine eigene Unit, die exp:velocity start, stop und graceful ausführt (Type=forking, PIDFile= die Datei var/vc/qbix/run/server.pid der Installation). Kapitel 8 gibt ein abgeleitetes Beispiel; es wird nicht ausgeliefert.

Der Watchdog ist ein zweites Sicherheitsnetz für einen Absturz, einen Abbruch wegen Speichermangels oder ein Stoppen durch ein anderes Werkzeug. Er ist aus, bis er installiert wird (root, systemd), und er startet die Engine nur, wenn kein Prozess von ihr läuft, niemand sie absichtlich gestoppt hat, kein Neustart im Gange ist und er nicht gerade zurückweicht. Er stoppt oder startet nie einen laufenden Server neu (Velocity-Engines, Der Watchdog):

php bin/php/console exp:velocity watchdog install --apply --allow-root-user   # vc-watchdog.service + .timer
php bin/php/console exp:velocity watchdog status --allow-root-user
php bin/php/console exp:velocity watchdog remove --apply --allow-root-user
Einstellung ([WatchdogSettings])AusgeliefertBedeutung
Interval45Sekunden zwischen Prüfungen (15 bis 3600)
RestartTimeout300wie lange eine Neustart-Markierung oder eine gehaltene Sperre ihn zurückhalten darf
Backoff600die Wartezeit nach drei gescheiterten Starts in Folge
LockFileleereine Sperre, die „Ausrollen läuft, warten“ bedeutet
UnitNamevc-watchdoggeben Sie jeder Installation auf einem Host eine eigene

Jede Prüfung, die mehr tut, als den Server laufend vorzufinden, schreibt eine Zeile nach var/log/velocity-watchdog.log, und ein Start oder ein Zurückweichen wird im Prüfprotokoll als system.velocity.watchdog.* festgehalten.

Eine Änderung ausrollen

Worker halten Klassen, INI-Werte und kompilierte Templates im Speicher. Ein Befehl bringt eine Website in der Reihenfolge auf den neuesten Stand, die funktioniert (Kapitel 8, Abschnitt 8.3.14):

php bin/php/console exp:velocity deploy --dry-run --allow-root-user   # what it would do
php bin/php/console exp:velocity deploy --allow-root-user             # the usual case
php bin/php/console exp:velocity deploy --kernel --allow-root-user    # a kernel class was added or renamed

Er erzeugt die Autoloads neu, leert die INI- und Template-Caches, baut das Engine-Archiv neu, wenn eines genutzt wird, lädt PHP-FPM neu, wenn nötig, startet Velocity neu, leert die Caches der gerenderten Ausgabe und den Antwort-Cache und fragt die Seiten aus [DeploySettings] WarmUpURL[] an. Jeder Schritt gibt PASS, FAIL oder SKIP aus; der erste Fehlschlag stoppt den Lauf. Setzen Sie [DeploySettings] PhpFpmService=disabled, wenn Velocity die Website allein ausliefert. Für eine Änderung an einem Template oder Stylesheet ist kein Neustart nötig: Leeren Sie die Template-Caches und führen Sie exp:velocity cache clear aus. exp:velocity graceful führt den Server neu aus und behält dabei den lauschenden Socket, sodass keine Anfrage verloren geht.

Logs, Status und Überwachung

WasWo
Zugriffs- und Fehlerlogsvar/vc/qbix/log/<siteaccess>-access.log, -error.log ([LogSettings] Dir), Format combined plus Antwortzeit
Prozessausgabe und Startzeilenvar/vc/qbix/run/console.log
PID-Dateivar/vc/qbix/run/server.pid (server.1.pid ... bei Instances über 1)
Die eigenen Logs des Kernelsvar/<site>/log/, wie unter jedem Server

[LogSettings] FileMode und DirMode werden als 0640 und 0750 ausgeliefert: Ein Zugriffslog nennt Besucher. exp:velocity status meldet running nur für einen Server, der eine HTTP-Anfrage beantwortet, und endet sonst mit einem Wert ungleich null; status --json ist für die Überwachung gedacht. /Q/health antwortet jedem mit „ok“; vollständige Zahlen, /Q/stats und /Q/metrics für Prometheus brauchen diese Maschine, das Dashboard-Token oder eine Sitzung im Kontrollzentrum. Siehe Überwachung: Überblick.

Das Dashboard und das Kontrollzentrum

AnsichtWer sie öffnen darf
/Q/dashboard (laufende Anfragen, Worker, Speicher)diese Maschine; anderswo mit [DashboardSettings] Token
/Q/phpinfodiese Maschine oder mit dem Token oder einer Sitzung im Kontrollzentrum; nie über Remote=enabled
/Q/panel (Domains, Zertifikate, Cache, Logs, Worker, Einstellungen)diese Maschine, dann das Passwort des Kontrollzentrums

Der erste Besuch von /Q/panel setzt sein Passwort (mindestens 16 Zeichen). Auf einer Maschine, die aus dem Internet erreichbar ist, setzen Sie es sofort, und erreichen Sie ein entferntes Kontrollzentrum über einen SSH-Tunnel zum eigenen Port des Servers. Ein Token ist eine beliebige lange zufällige Zeichenkette, zum Beispiel aus openssl rand -hex 24. Lassen Sie [DashboardSettings] Remote auf disabled, es sei denn, eine Firewall beschränkt den Port bereits (Kontrollzentrum von Velocity).

Der Reiter Domains des Kontrollzentrums kann eine Domain auf suspended (antwortet 503 mit Retry-After) oder disabled (antwortet 404) setzen; die eigenen Pfade /Q/ und /.well-known/ des Servers funktionieren weiter, sodass Erneuerungen von Zertifikaten weiterlaufen.

Ein Velocity-Server pro Kunde

Ein einzelner Server, der mehrere Websites ausliefert, ist laut README.md eine Bequemlichkeit beim Routing, keine Sicherheitsgrenze. Für mehrere Kunden auf einer Maschine betreiben Sie eine Installation und einen Velocity-Server pro Kunde:

  • jede als eigener Benutzer des Kunden ([ServerSettings] User und Group), nie als der eines anderen Kunden;
  • jede auf eigenen Ports (Port, HTTPSPort), mit Host=127.0.0.1 hinter einem Proxy oder auf einer eigenen Adresse;
  • jede mit eigener Unit für den Systemstart und eigenem UnitName des Watchdogs;
  • dem Proxy wird von Velocity vertraut (Velocity neben Apache oder nginx).

Siehe Trennung von Mandanten.

Checkliste

Aus Kapitel 8, Checkliste, für jede Kunden-Website:

  • To do: Engine=qbix gesetzt, exp:velocity status zeigt den Server laufend, die Website antwortet.
  • To do: Host, Port, HTTPSPort wie beabsichtigt; Firewall offen, wo Velocity Besuchern gegenübersteht.
  • To do: Worker laufen als Benutzer der Website (Workers as: ... in console.log), nie als root.
  • To do: HTTPS: Ein CA-Zertifikat wird ausgeliefert, nicht der selbstsignierte Ersatz; Erneuerung geplant.
  • To do: Ein Dienst beim Systemstart startet Velocity nach einem Neustart; der Watchdog installiert, wenn Sie ihn wollen.
  • To do: [DeploySettings] PhpFpmService=disabled, wenn Velocity die Website allein ausliefert; deploy --dry-run zeigt die erwarteten Schritte.
  • To do: Das Passwort des Kontrollzentrums gesetzt, Remote ausgeschaltet gelassen, ein Dashboard-Token in Ihrem Geheimnisspeicher abgelegt.
  • To do: var/ und settings/ für den einen Benutzer beschreibbar, der PHP ausführt; keine Dateien in var/, die root gehören.

Demomodus unter Velocity. Setzen Sie export EXP_DEMO_MODE=1 in die Site-envvars der Demo, /etc/vc/sites-available/<site>.envvars (<site> zeigt ./console exp:velocity layout); exp:velocity start liest sie nur für den Server dieser Installation, sodass exp:velocity restart und deploy aus jeder Shell sie behalten. Die eigene Unit, die Velocity für diese Installation startet (velocity-demo-mode.conf), funktioniert ebenfalls. Nie in der gemeinsamen /etc/vc/envvars: Sie gilt für jede Installation auf dem Host, und ein Worker lehnt den Wert von dort ab (Zeile demo/refused in var/log/security.log). Demomodus für Hoster.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x