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
- Was Velocity für einen Hoster ist
- Anforderungen
- Installation und erster Start
- Einstellungen und wie Sie sie ändern
- Ports, Adresse und der Worker-Benutzer
- Am Laufen halten: Dienst beim Systemstart und Watchdog
- Eine Änderung ausrollen
- Logs, Status und Überwachung
- Das Dashboard und das Kontrollzentrum
- Ein Velocity-Server pro Kunde
- 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 Velocity | Unter Apache/nginx mit PHP-FPM | |
|---|---|---|
| Am Leben zu haltender Prozess | ein langlebiger Server pro Website | der Webserver und der FPM-Master |
| Eine geänderte Klasse oder INI-Datei | erreicht die Worker erst nach einem Neustart (exp:velocity deploy) | erreicht PHP, nachdem OPcache neu prüft, oder nach einem Neuladen von FPM |
| TLS | Velocity selbst, einschließlich ACME | mod_ssl oder nginx, plus certbot oder das Panel |
| Wiederholte anonyme Seiten | vom Elternprozess aus dem Antwort-Cache beantwortet | gerendert oder aus den Caches des Kernels ausgeliefert |
| Zu beurteilender Speicher | PSS von Elternprozess und Workern, nie RSS | die 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
| Bedarf | Detail |
|---|---|
| PHP | 8.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-Erweiterungen | sockets (vom Paket verlangt), pcntl und posix (Worker forken, ihren Benutzer wechseln), openssl (HTTPS) |
| Ein langlebiger Prozess | vom Tarif erlaubt; Shared Hosting erlaubt meist keinen |
| Root oder hohe Ports | Ports unter 1024 brauchen root; als root gestartet, behält nur der Elternprozess es |
| Betriebssystem | Linux 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 systemAuf 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 Releases0.0.4.x; 0.0.4.44 ist die Version, die diecomposer.jsonvon Exponential vorschlägt, und die erste, die weitergeleitete Protokoll-Header nur von vertrauenswürdigen Proxys liest (Kapitel 8, Abschnitt 8.8). settings/velocity.iniwird mitEngine=phpausgeliefert, weil der eingebaute Server von PHP immer funktioniert; jede echte Website setztqbix.startschreibt 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:velocitysteuert.
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
| Datei | Was sie ist |
|---|---|
settings/velocity.ini | die mitgelieferten Standards, jede Einstellung kommentiert; nie bearbeiten |
settings/override/velocity.ini.append.php | die 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 pathsEine 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]) | Ausgeliefert | Bedeutung |
|---|---|---|
Host | 127.0.0.1 | Bindeadresse; nur lokal, über einen Tunnel oder einen Proxy erreichbar |
Port | 8088 | einfaches HTTP |
HTTPSPort | 8080 | HTTPS, wenn HTTPS an ist |
User, Group | leer | als wer die Worker laufen, wenn der Server als root gestartet wird |
AllowRootWorkers | disabled | root als Worker-Benutzer wird verweigert, außer bei enabled |
FollowSymlinks | disabled | ein symbolischer Link aus dem Document Root hinaus wird verweigert |
Nice | 5 | die 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-userAls 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.serviceundexponential-velocity.servicedes Betriebssystempakets), die die Engine direkt starten und deshalb umgehen, wasexp:velocityhinzufügt (die erzeugte Site-Datei,KeepGlobals,[PHPSettings] IniOptions[], den Worker-Benutzer, Instanzen); - eine eigene Unit, die
exp:velocity start,stopundgracefulausführt (Type=forking,PIDFile=die Dateivar/vc/qbix/run/server.pidder 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-userEinstellung ([WatchdogSettings]) | Ausgeliefert | Bedeutung |
|---|---|---|
Interval | 45 | Sekunden zwischen Prüfungen (15 bis 3600) |
RestartTimeout | 300 | wie lange eine Neustart-Markierung oder eine gehaltene Sperre ihn zurückhalten darf |
Backoff | 600 | die Wartezeit nach drei gescheiterten Starts in Folge |
LockFile | leer | eine Sperre, die „Ausrollen läuft, warten“ bedeutet |
UnitName | vc-watchdog | geben 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 renamedEr 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
| Was | Wo |
|---|---|
| Zugriffs- und Fehlerlogs | var/vc/qbix/log/<siteaccess>-access.log, -error.log ([LogSettings] Dir), Format combined plus Antwortzeit |
| Prozessausgabe und Startzeilen | var/vc/qbix/run/console.log |
| PID-Datei | var/vc/qbix/run/server.pid (server.1.pid ... bei Instances über 1) |
| Die eigenen Logs des Kernels | var/<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
| Ansicht | Wer sie öffnen darf |
|---|---|
/Q/dashboard (laufende Anfragen, Worker, Speicher) | diese Maschine; anderswo mit [DashboardSettings] Token |
/Q/phpinfo | diese 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] UserundGroup), nie als der eines anderen Kunden; - jede auf eigenen Ports (
Port,HTTPSPort), mitHost=127.0.0.1hinter einem Proxy oder auf einer eigenen Adresse; - jede mit eigener Unit für den Systemstart und eigenem
UnitNamedes 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=qbixgesetzt,exp:velocity statuszeigt den Server laufend, die Website antwortet. - To do:
Host,Port,HTTPSPortwie beabsichtigt; Firewall offen, wo Velocity Besuchern gegenübersteht. - To do: Worker laufen als Benutzer der Website (
Workers as: ...inconsole.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-runzeigt die erwarteten Schritte. - To do: Das Passwort des Kontrollzentrums gesetzt,
Remoteausgeschaltet gelassen, ein Dashboard-Token in Ihrem Geheimnisspeicher abgelegt. - To do:
var/undsettings/für den einen Benutzer beschreibbar, der PHP ausführt; keine Dateien invar/, 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
- Velocity-Worker und Pools
- HTTPS-Zertifikate in Velocity
- Antwort-Cache von Velocity
- Velocity startet nicht
- Velocity: Exponential in einem Webserver mit persistenten Workern betreiben
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
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.