Ùrdema stabile — v1.8.2

Download Fluxheim

Linux x86_64 · Linux aarch64 · Windows x86_64 · macOS Apple Silicon 2026-09-13.

Cumpleta Cunsigliato

Build production cumpleta

Tutte 'e moddule production stabili: proxy, web, cache, compression, load balancing, raw TCP stream proxying, TLS (rustls), PHP-FPM, client ACME, GeoIP/Geo-contesto, hardening sicurezza, metrics e OpenTelemetry.

Serving statico + reverse proxy + PHP-FPM
Backend cache (memory, disk, tiered)
compressione gzip, zstd e Brotli
TLS + rinnovamiento ACME gestito
Contesto lucale GeoIP paese/ASN
TCP stream proxying hardened
Prometheus e OpenTelemetry
~10.3 MB binary
Bilanciatore 'e carico Nnnuovo

Edge load balancer

Build load-balancer HTTP/TCP mirata senza cache, web statico, PHP, GeoIP, stream proxying o traffic mirroring.

Advanced pool selection
Drain, disable, force-down operativi
Core LB hardened
TLS + rinnovamiento ACME gestito
PHP PHP-FPM gestito

Build applicazioni PHP

Web statico + reverse proxy + bridge PHP-FPM FastCGI. Ideale pe WordPress e app PHP front-controller. Nisciun modulo cache compilato.

Bridge PHP-FPM FastCGI
Serving asset statici d'a stessa root
TLS + rinnovamiento ACME gestito
~8.9 MB binary
Cache edge

Build Cache Edge

Cache edge mirata senza serving web statico lucale. Include proxy, cache, compression, TLS e ACME. Ideale pe deployment stile CDN.

Reverse proxy cu cache
Cuntrolle compression cache-safe
TLS + rinnovamiento ACME gestito
Nisciun modulo web statico compilato
~6.8 MB binary
Proxy edge

Build Proxy Edge

Reverse proxy mirato senza cache, web statico o modulo load-balancer dedicato. Progettato pe deployment reverse-proxy puri cu TLS, ACME, compression e resilienza upstream.

Sulo reverse proxy
ACL, rate limit, retry, health check
TLS + rinnovamiento ACME gestito
Nisciun modulo cache o web compilato
~5.8 MB binary
Wasm Nnnuovo

Build Wasm pe produzione

Build Wasm apposta, basato ncopp'ô profilo completo 'e produzione, cu hook 'e policy limitate, ACME, metriche e OpenTelemetry.

Serving statico + reverse proxy + PHP-FPM
Backend cache (memory, disk, tiered)
Estensioni WASM
TLS + rinnovamiento ACME gestito
Prometheus e OpenTelemetry

Platform Downloads

Linux x86_64 · Linux aarch64 · Windows x86_64 · macOS Apple Silicon

Piattaforme supportate

Installazione

bash — installazione tarball
# 1. Scarrica 'o tarball d'a build Linux cumpleta
# Usa aarch64-linux invece 'e x86_64-linux sui server ARM64.
curl -fLO https://github.com/valkyoth/fluxheim/releases/download/v1.8.2/fluxheim-1.8.2-full-x86_64-linux.tar.gz

# 2. Verifica e scumpatta
echo '1a323dcd5632e25acf2e4463e549f20cdd3d568f445f9d923b1be312ec7f9839  fluxheim-1.8.2-full-x86_64-linux.tar.gz' | sha256sum -c -
tar xzf fluxheim-1.8.2-full-x86_64-linux.tar.gz

# 3. Sposta binario e strumenti helper dint' 'o percorso 'e sistema
cd fluxheim-1.8.2-full-x86_64-linux
sudo install -m 0755 fluxheim fluxheim-acme /usr/local/bin/

# 4. Crea 'a directory 'e cunfigurazione e aggiungi 'o tuo config
sudo mkdir -p /etc/fluxheim /srv/fluxheim
sudo cp packaging/default/fluxheim.toml /etc/fluxheim/fluxheim.toml

# 5. Valida 'a cunfigurazione
fluxheim --check-config --config /etc/fluxheim/fluxheim.toml

# 6. Esegui direttamente (o vedi 'a scheda Systemd pe 'o servizio)
sudo fluxheim --config /etc/fluxheim/fluxheim.toml
PowerShell — 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"
$InstallDir = Join-Path $env:LOCALAPPDATA "Fluxheim"

Invoke-WebRequest "$BaseUrl/$Archive" -OutFile $Archive
$Expected = "a72b84720083406f318bf3fc87555eb62fd76dbd1506dbf2cd368e7364726b44"
$Actual = (Get-FileHash $Archive -Algorithm SHA256).Hash.ToLowerInvariant()
if ($Actual -cne $Expected) { throw "Archive checksum verification failed" }

New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
Expand-Archive -LiteralPath $Archive -DestinationPath $InstallDir -Force
$Bundle = Join-Path $InstallDir "fluxheim-$Version-full-x86_64-windows"

& "$Bundle\fluxheim.exe" --config "$InstallDir\fluxheim.toml" --check-config
& "$Bundle\fluxheim.exe" --config "$InstallDir\fluxheim.toml"

Anteprima senza firma: Chesta è n'anteprima portatile senza firma. Lassa appicciata 'a sicurezza 'e SmartScreen e PowerShell; 'a firma Authenticode e n'installatore pe nu servizio Windows nun songo ancora dispunibbele. 'A supervisione gestita 'e PHP-FPM è sulo pe Unix; Windows supporta pool TCP FastCGI esterne.

bash — macOS Apple Silicon
VERSION="1.8.2"
PROFILE="full"
ARCHIVE="fluxheim-${VERSION}-${PROFILE}-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}-${PROFILE}-aarch64-macos/fluxheim" "$HOME/.local/bin/fluxheim"
install -m 0755 "fluxheim-${VERSION}-${PROFILE}-aarch64-macos/fluxheim-acme" "$HOME/.local/bin/fluxheim-acme"

fluxheim --config "$HOME/.config/fluxheim/fluxheim.toml" --check-config
fluxheim --config "$HOME/.config/fluxheim/fluxheim.toml"

Anteprima senza firma: Chesta è n'anteprima pe linea 'e cumanno senza firma. Lassa Gatekeeper appicciato; 'a firma Developer ID, 'a notarizzazione e ll'integrazione cu launchd nun songo ancora dispunibbele.

bash — Podman rootless
# Scarrica image GHCR (Wasm, varianti full, load-balancer, cache, proxy e PHP)
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2         # cumpleta
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-wasm
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-load-balancer # bilanciatore 'e carico
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-cache   # profilo cache edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-proxy   # profilo proxy edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-php     # PHP-FPM gestito

# Lo stesso set 'e build è disponibile su Quay
podman pull quay.io/valkyoth/fluxheim:v1.8.2
podman pull quay.io/valkyoth/fluxheim:v1.8.2-wasm
podman pull quay.io/valkyoth/fluxheim:v1.8.2-load-balancer
podman pull quay.io/valkyoth/fluxheim:v1.8.2-cache
podman pull quay.io/valkyoth/fluxheim:v1.8.2-proxy
podman pull quay.io/valkyoth/fluxheim:v1.8.2-php

# Esegue rootless — porte interne 8080 e 8443
podman run -d \
  --name fluxheim \
  --restart unless-stopped \
  -p 8080:8080 \
  -p 8443:8443 \
  -v /srv/sites:/srv/sites:ro \
  -v /srv/fluxheim/certs:/etc/fluxheim/certs:rw \
  -v ./fluxheim.toml:/etc/fluxheim/fluxheim.toml:ro \
  ghcr.io/valkyoth/fluxheim:v1.8.2

# Controlla 'e log
podman logs -f fluxheim
bash — servizio systemd
# Il tarball include un'unità systemd hardened
sudo cp packaging/systemd/fluxheim.service /etc/systemd/system/

# Crea l'utente 'e sistema fluxheim
sudo useradd -r -s /sbin/nologin -d /var/lib/fluxheim fluxheim

# Prepara 'e directory
sudo mkdir -p /etc/fluxheim /srv/fluxheim /var/log/fluxheim
sudo chown fluxheim:fluxheim /srv/fluxheim /var/log/fluxheim

# Ricarica systemd e abilita 'o servizio
sudo systemctl daemon-reload
sudo systemctl enable --now fluxheim

# Controlla 'o stato
sudo systemctl status fluxheim
sudo journalctl -u fluxheim -f

Nota: L'unità systemd pacchettizzata usa CAP_NET_BIND_SERVICE così Fluxheim può fare bind ê porte 80 e 443 senza girare comme root. L'unit file include opzioni 'e hardening sicurezza.

bash — emissione certificate ACME gestita
# Fluxheim include acme-init pe configurare 'e certificate guidati
# Issuer Let's Encrypt (HTTP-01)
sudo fluxheim acme-init letsencrypt

# Actalis (issuer gratuito cu EAB)
sudo fluxheim acme-init actalis

# Lo strumento companion fluxheim-acme gestisce 'o rinnovamiento per
# deployment container e service manager esterni
fluxheim-acme status
fluxheim-acme renew
fluxheim-acme reload
fluxheim.toml — config ACME
[[vhosts]]
name = "site"
hosts = ["example.com", "www.example.com"]

[vhosts.tls]
enabled = true

[vhosts.tls.acme]
enabled = true
# issuer configurato: issuer = "letsencrypt"
Ducumentazione TLS e ACME cumpleta →

Requisiti 'e sistema

Piattaforme supportate

  • Linux x86_64 (kernel 4.14+)
  • Linux ARM64 / aarch64
  • macOS Apple Silicon / aarch64
  • Windows x86_64

Image container

Tutte 'e build image 'e release songo pubbricate ncopp'a GHCR e Quay.

  • Wolfi (minimale, hardened)
  • Wasm + Profili image full, load-balancer, cache, proxy e PHP
  • Alpine Linux
  • SUSE Micro (non-PHP profiles)
  • SUSE BCI (PHP: php-suse-bci)
  • Debian
  • Pubbricato ncopp'a GHCR e Quay
Versione Data Punte principali Scarricamiento
v1.8.2 Ultima
2026-09 Aggiunge archivie ZIP native senza firma pe Windows x86_64 a tutte e sette 'e profile pubbliche, mantene 'e prutezzione d''o sistema d''e file e d''e credenziale Windows e cagna ll'immaggine PHP SUSE Micro cu ll'ambiente autonomo php-suse-bci. Tutto su GitHub
v1.8.1
2026-08 Aggiunge archivie macOS native pe Apple Silicon a tutte e sette 'e profile pubbliche, prove vere 'e parità d'esecuzione, strumiente portabile pe 'e somme 'e cuntrollo e prutezzione cchiù forte pe diagnostica e sistema d''e file. Tutto su GitHub
v1.8.0
July 2026 Build Wasm apposta, basato ncopp'ô profilo completo 'e produzione, cu hook 'e policy limitate, ACME, metriche e OpenTelemetry. Aggiunge ll'archivie tar.gz e ZIP currispondente, cumpreso build native complete e Wasm pe macOS. Renne cchiù forte 'e cunfine d'ammessione p''o riempimento d''a cache, 'a cache pe intervalli e Wasm pe ogne vhost. Tutto su GitHub
v1.7.0 – v1.7.12
July 2026 Serie Fluxheim 1.7: metadate facoltative basate ncopp''e standard pe cache, proxy e digest d''a risposta; ricaricamento e rollback d''e snapshot live autenticate; prove riproducibile pe backend FIPS; aggiornamente d''e processo senza fermata; esempie 'e policy Wasm pruvate separatamente; e cunfine cchiù forte pe cache, TLS, buffering, stream e protocolle. Tutto su GitHub
v1.6.0 – v1.6.37
giugno 2026 Linea ’e cutover e pulizia d’ ’o native runtime: base pe ascì da Pingora, percorsi HTTP/1 e HTTP/2 ’e Fluxheim, anteprime native TLS/listener, parità route proxy/static-web, compressione e paggene d’errore, forwarded-header policy, auth-request, mirroring d’ ’o traffico, rate limits, validazione gRPC, upstream HTTP/2 cu pool, pulizia native proxy doppo cutover, pulizia finale d’ ’e cunfine crate primma ’e Wasm, Rust 1.96.1, OpenSSL stream TLS rinfurzato, zeroization d’ ’o cunto ACME e moduli runtime cchiù piccerille e mirate. Tutto su GitHub
v1.5.0 - v1.5.23 giugno 2026 Linea enterprise load-balancer e ownership runtime: binari/image load-balancer mirati, cuntrolle membri e pesi runtime, cookie affinity gestiti, lavoro sui boundary stream e HTTP, health check attivi e protocol-aware, service discovery, ownership task in background, boundary crate cache, guardrail UDP beta, budget 'e protezione origin, asset ARM/macOS e ampio hardening. Tutto su GitHub
v1.4.0 – v1.4.7 maggio 2026 Linea operativa proxy cu parità proxy production, policy route cchiù ricca, traffic mirroring, dynamic upstream discovery, split modulare runtime/config, asset Apple Silicon e Linux ARM64, GeoIP/Geo-contesto, archivi config-tester e TCP stream proxy hardened Tutto su GitHub
v1.3.0 – v1.3.7 maggio 2026 Linea production PHP-FPM, supervisione php-fpm gestita, binari config tester e companion ACME, percorsi 'e validazione FIPS/ISO, profili cache/proxy mirati e hardening 'e sicurezza Tutto su GitHub
v1.2.0 – v1.2.6 maggio 2026 Baseline cache e osservabilità cu policy cache route-scoped, backend memory/disk/tiered, cache disco cifrata, peer fill, range caching, Prometheus ed export OpenTelemetry Tutto su GitHub
v1.1.x 2026 Linea operazioni certificate cu profili policy TLS, SNI rustls multi-certificato, emissione e rinnovamiento ACME gestiti, issuer cu EAB, segreti TLS file-backed e unità 'e rinnovamiento Tutto su GitHub
v1.0.0 2026 Fondazione gateway cu vhost routing, azioni static/proxy/redirect a livello route, static file serving, reverse proxy, TLS rustls, admin control-plane, header sicure, packaging systemd e container rootless GitHub
v0.5.0 Pre release pubbleca Primma milestone pubblica pre-release primma d'a linea gateway stabile 1.x GitHub

See Riggistro d'e cagnamiente pe release notes cu 'e dettaglie.

Napulitano