.env, Artisan & Terminal
Bearbeiten Sie die .env-Datei direkt im Browser unter Websites → .env. Mit Strg/Cmd+S speichern.
Installation auf einem neuen Server
Der empfohlene Weg, einen brandneuen Herne-Server zu booten, ist das Unified Installer:
curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash
Es installiert den Core-Stack, schreibt die Panel-Umgebung, erstellt den ersten Administrator, installiert sudoers-Regeln, konfiguriert nginx und kann optional auch den Mail-Stack installieren.
.env-Editor
Gehen Sie zu Websites → .env, um die Umgebungsdatei für Ihre Anwendung direkt im Browser zu bearbeiten. Der Herausgeber liest und schreibt {deploy_path}/.env.
- Speichern Sie mit
Ctrl+S(unter macOSCmd+S). - Die Datei wird atomar geschrieben und erhält die Berechtigungen
640. - Klicken Sie auf Load from .env.example, um die Werte aus der Beispieldatei zu übernehmen, sofern diese vorhanden ist.
- Mit Apply Redis defaults übernehmen Sie die von Herne für Redis vorbereiteten Werte für Cache, Sitzungen, Warteschlangen und Verbindungen.
Führen Sie nach dem Bearbeiten von .env die entsprechenden Caches aus dem Artisan-Läufer aus optimize:clear oder bauen Sie sie neu auf, damit die App die neuen Werte liest.
Artisan-Befehle
Führen Sie beliebige php artisan-Befehle unter Websites → Artisan aus. Öffnen Sie Websites → Artisan und geben Sie einen Befehl ohne das Präfix php artisan ein:
migrate --force
queue:restart
storage:link
key:generate
Die Muschel-Metazeichen (&, |, ;, `, $(...),>, <) werden aus Sicherheitsgründen gestrippt. Die Ausgabe wird inline angezeigt.
Die Seite ist besonders nützlich für allgemeine Folgeaktionen wie key:generate, storage:link, Migrationen und Cache-Wiederaufbauten nach dem Bearbeiten .env.
Sicherer Umgang mit APP_KEY
Laravel-Apps benötigen eine nicht leere APP_KEY. Quick Install schützt und generiert es als Teil des Installationsflusses. Für manuell bereitgestellte Apps führen Sie aus:
key:generate
optimize:clear
Ändern Sie APP_KEY in einer bestehenden Produktivanwendung nur, wenn Sie die Auswirkungen auf verschlüsselte Cookies, Sitzungen und gespeicherte verschlüsselte Daten kennen.
Befehl zur Migration der primären Domain
Administratoren können eine temporäre Site-Domain mit dem kanonischen Migrationsbefehl in die reale Produktionsdomäne bewerben. Führen Sie zuerst einen Trockenlauf durch:
herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --dry-run
Führen Sie den Vorgang erst aus, wenn Sie den Plan geprüft haben:
herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --force
Der Befehl aktualisiert die Site-Domäne, Slug, Aliase, App-Metadaten, Umgebungs-URL/Name, aktiven Pfad, pensionierten Backup-Pfad und Nginx-Konfiguration. Es darf die alte Domain nicht als Alias oder server_name verlassen.
Web-Terminal
Das Web-Terminal (Websites → Terminal) fuhrt Befehle als isolierter Benutzer im web_root-Projektverzeichnis der Website aus. Gehen Sie zu Websites → Terminal. Befehle werden als isolierter Shell-Benutzer (shell_domainslug) innerhalb des Projektverzeichnisses der Site web_root ausgeführt.
Sicherheitsbeschränkungen
Ausgabeumleitungen (>, >>), Befehlssubstitution ($(), Backticks) und Piping sind im Terminal blockiert. Folgendes wird blockiert:
- Ausgabeumleitung:
>,>> - Befehlsersetzung:
$(...), Backticks - Pipe-Operator:
|
Das Web-Terminal hat ein Zeitlimit von 30 Sekunden pro Befehl. Länger laufende Befehle wie composer install beim ersten Start können das Limit überschreiten. Verwenden Sie stattdessen Deployment mit aktiviertem Composer-Schritt.
Serverprotokolle
Öffnen Sie Websites → Protokolle → Serverprotokolle, um die aktuellen Webserver-Ausgaben der Website zu prüfen.
- Wechseln Sie zwischen Nginx-Zugriffsprotokoll, Nginx-Fehlerprotokoll und PHP-FPM-Protokoll.
- Die neuesten 200 Zeilen erscheinen zuerst.
- Laden Sie die aktuelle Datei mit Aktualisieren neu.
- Leeren Sie die gewählte Datei mit Leeren, sofern die Serverberechtigungen dies zulassen.
- Das PHP-FPM-Protokoll ist nur für Administratoren verfügbar.