Fluxheim/Dokumentation/Fluxheim starten

Fluxheim starten

Nutze diese Seite, wenn du schnell einen lokalen Server starten willst. Sie hält die Konfiguration klein und prüft sie, bevor Traffic bedient wird.

Installation

Prüfe vor dem Entpacken eines Archivs die veröffentlichte SHA-256-Prüfsumme.

Linux x86_64

VERSION="1.8.2"
ARCHIVE="fluxheim-${VERSION}-full-x86_64-linux.tar.gz"
BASE_URL="https://github.com/valkyoth/fluxheim/releases/download/v${VERSION}"
curl -fLO "${BASE_URL}/${ARCHIVE}"
echo "1a323dcd5632e25acf2e4463e549f20cdd3d568f445f9d923b1be312ec7f9839  ${ARCHIVE}" | sha256sum -c -
tar -xzf "$ARCHIVE"
sudo install -m 0755 "fluxheim-${VERSION}-full-x86_64-linux/fluxheim" /usr/local/bin/fluxheim

macOS Apple Silicon

VERSION="1.8.2"
ARCHIVE="fluxheim-${VERSION}-full-aarch64-macos.tar.gz"
BASE_URL="https://github.com/valkyoth/fluxheim/releases/download/v${VERSION}"
curl -fLO "${BASE_URL}/${ARCHIVE}"
echo "a725ebcccac259af6640da57ce12e7a3944c5bd0d9e7869d4001196a0c394031  ${ARCHIVE}" | shasum -a 256 -c -
tar -xzf "$ARCHIVE"
install -d "$HOME/.local/bin"
install -m 0755 "fluxheim-${VERSION}-full-aarch64-macos/fluxheim" "$HOME/.local/bin/fluxheim"

Dies ist eine nicht signierte Kommandozeilenvorschau. Lass Gatekeeper aktiviert; Developer-ID-Signierung, Notarisierung und launchd-Integration werden noch nicht bereitgestellt.

Windows x86_64

$Version = "1.8.2"
$Archive = "fluxheim-$Version-full-x86_64-windows.zip"
$BaseUrl = "https://github.com/valkyoth/fluxheim/releases/download/v$Version"
Invoke-WebRequest "$BaseUrl/$Archive" -OutFile $Archive
$Expected = "a72b84720083406f318bf3fc87555eb62fd76dbd1506dbf2cd368e7364726b44"
if ((Get-FileHash $Archive -Algorithm SHA256).Hash.ToLowerInvariant() -cne $Expected) { throw "Archive checksum verification failed" }
Expand-Archive -LiteralPath $Archive -DestinationPath "$env:LOCALAPPDATA\Fluxheim" -Force

Dies ist eine nicht signierte portable Vorschau. Lass die Sicherheitsfunktionen von SmartScreen und PowerShell aktiviert; Authenticode-Signierung und ein Windows-Dienstinstaller werden noch nicht bereitgestellt.

Die verwaltete PHP-FPM-Überwachung ist nur unter Unix verfügbar; Windows unterstützt externe TCP-FastCGI-Pools.

Minimale statische Site

[server]
listen = ["0.0.0.0:8080"]
default_vhost = "site"

[[vhosts]]
name = "site"
hosts = ["example.com"]

[vhosts.web]
root = "/srv/example"
index_files = ["index.html"]
deny_dotfiles = true

Was die erste Konfiguration macht

Option im Config	Zweck
`server.listen`	Steuert den Plain-HTTP-Socket, den Fluxheim offnet.
`server.default_vhost`	Wahlt die Fallback-Site, wenn kein Host passt.
`vhosts.hosts`	Listet die Hostnamen auf, die die Site akzeptiert.
`vhosts.web.root`	Zeigt auf das Verzeichnis, das Besuchern ausgeliefert wird.

Prüfen und starten

fluxheim --config /etc/fluxheim/fluxheim.toml --check-config
fluxheim --config /etc/fluxheim/fluxheim.toml

Nutze den Config-Check in Deployment-Skripten. Er findet unbekannte Felder, unsichere Pfade, ungultige Listener und Feature/Config-Konflikte, bevor Traffic wechselt.

Nachste sinnvolle Entscheidungen

Fuge TLS erst hinzu, nachdem DNS auf den Host zeigt.
Add cache only for routes that are safe to share between visitors.
Add metrics only when the listener is private or behind a trusted proxy.