Fluxheim/Documentazione/Avvia Fluxheim

Avvia Fluxheim

Usa questa pagina quando vuoi rapidamente un server locale. Mantiene il config piccolo e lo controlla prima di servire traffico.

Installa

Verifica il checksum SHA-256 pubblicato prima di estrarre un archivio.

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"

Questa è un’anteprima da riga di comando non firmata. Mantieni attivo Gatekeeper; la firma Developer ID, la notarizzazione e l’integrazione con launchd non sono ancora disponibili.

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

Questa è un’anteprima portabile non firmata. Mantieni attive le protezioni di SmartScreen e PowerShell; la firma Authenticode e un programma di installazione del servizio Windows non sono ancora disponibili.

La supervisione gestita di PHP-FPM è disponibile solo su Unix; Windows supporta pool FastCGI TCP esterni.

Sito statico minimo

[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

Cosa fa il primo config

Opzione	Scopo
`server.listen`	Controlla il socket HTTP plaintext aperto da Fluxheim.
`server.default_vhost`	Seleziona il sito fallback quando nessun host combacia.
`vhosts.hosts`	Elenca gli hostname accettati dal sito.
`vhosts.web.root`	Punta alla directory servita ai visitatori.

Controlla e avvia

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

Usa il controllo config negli script di deployment. Cattura campi sconosciuti, path non sicuri, listener invalidi e mismatch feature/config prima che il traffico si sposti.

Scelte utili successive

Aggiungi TLS solo dopo che il DNS punta all'host.
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.