Najnowsza stabilna wersja — v1.8.2

Download Fluxheim

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

Pełny Zalecane

Pełny production build

Wszystkie stabilne moduły production: proxy, web, cache, compression, load balancing, raw TCP stream proxying, TLS (rustls), PHP-FPM, ACME client, GeoIP/Geo-Context, security hardening, metrics i OpenTelemetry.

Static serving + reverse proxy + PHP-FPM pakiet
Backendy cache (memory, disk, tiered)
kompresja gzip, zstd i Brotli
TLS + zarządzany ACME renewal
Lokalny GeoIP country/ASN context
Tryb hardened TCP stream proxying
Prometheus + OpenTelemetry observability
~10.3 MB binary
Load balancer Nowe

Load balancer edge

Skupiony HTTP/TCP load-balancer build bez cache, static web, PHP, GeoIP, stream proxying lub traffic mirroring.

Advanced pool selection
Drain, disable i force-down
Moduł hardened LB core
TLS + zarządzany ACME renewal
PHP Tryb managed PHP-FPM

PHP application build

Static web + reverse proxy + PHP-FPM FastCGI bridge. Idealny dla WordPress i aplikacji PHP front-controller. Bez skompilowanego modułu cache.

Moduł PHP-FPM FastCGI bridge
Static asset serving z tego samego root
TLS + zarządzany ACME renewal
~8.9 MB binary
Cache build

Cache edge build

Skupiony cache edge bez local static web serving. Zawiera proxy, cache, compression, TLS i ACME. Idealny dla deploymentów CDN-style.

Pakiet reverse proxy + cache
Kontrole cache-safe compression
TLS + zarządzany ACME renewal
Bez skompilowanego modułu static web
~6.8 MB binary
Proxy build

Proxy edge build

Skupiony reverse proxy bez cache, static web lub dedykowanego modułu load-balancer. Zaprojektowany dla czystych reverse-proxy deploymentów z TLS, ACME, compression i upstream resilience.

Tylko reverse proxy
ACLs, rate limits, retries i health checks
TLS + zarządzany ACME renewal
Bez skompilowanego modułu cache lub web
~5.8 MB binary
Wasm Nowe

Produkcyjna kompilacja Wasm

Dedykowana kompilacja Wasm oparta na pełnym profilu produkcyjnym, z ograniczonymi punktami polityk, ACME, metrykami i OpenTelemetry.

Static serving + reverse proxy + PHP-FPM pakiet
Backendy cache (memory, disk, tiered)
Rozszerzenia WASM
TLS + zarządzany ACME renewal
Prometheus + OpenTelemetry observability

Platform Downloads

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

Obsługiwane platformy

Instalacja

bash — instalacja tarball
# 1. Pobierz pełny tarball build Linux
# Użyj aarch64-linux zamiast x86_64-linux na serwerach ARM64.
curl -fLO https://github.com/valkyoth/fluxheim/releases/download/v1.8.2/fluxheim-1.8.2-full-x86_64-linux.tar.gz

# 2. Zweryfikuj i rozpakuj
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. Przenieś binary i helper tools do system path
cd fluxheim-1.8.2-full-x86_64-linux
sudo install -m 0755 fluxheim fluxheim-acme /usr/local/bin/

# 4. Utwórz config directory i dodaj swój config
sudo mkdir -p /etc/fluxheim /srv/fluxheim
sudo cp packaging/default/fluxheim.toml /etc/fluxheim/fluxheim.toml

# 5. Zweryfikuj config
fluxheim --check-config --config /etc/fluxheim/fluxheim.toml

# 6. Uruchom bezpośrednio (albo zobacz tab Systemd dla service setup)
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"

Niepodpisana wersja zapoznawcza: To niepodpisana przenośna wersja zapoznawcza. Pozostaw zabezpieczenia SmartScreen i PowerShell włączone; podpis Authenticode i instalator usługi Windows nie są jeszcze dostępne. Zarządzany nadzór PHP-FPM jest dostępny tylko w systemach Unix; Windows obsługuje zewnętrzne pule TCP FastCGI.

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"

Niepodpisana wersja zapoznawcza: To niepodpisana wersja zapoznawcza dla wiersza poleceń. Pozostaw Gatekeeper włączony; podpis Developer ID, notaryzacja i integracja z launchd nie są jeszcze dostępne.

bash — uruchomienie rootless Podman
# Pull GHCR images (Wasm, full, load-balancer, cache, proxy i warianty PHP)
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2         # pełny image
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-wasm
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-load-balancer # wariant load balancer
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-cache   # wariant cache edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-proxy   # wariant proxy edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-php     # wariant managed PHP-FPM

# Ten sam build set jest dostępny na 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

# Uruchom rootless — porty wewnętrzne 8080 i 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

# Sprawdź logi
podman logs -f fluxheim
bash — usługa systemd
# Tarball zawiera hardened systemd unit
sudo cp packaging/systemd/fluxheim.service /etc/systemd/system/

# Utwórz system user fluxheim
sudo useradd -r -s /sbin/nologin -d /var/lib/fluxheim fluxheim

# Skonfiguruj directory
sudo mkdir -p /etc/fluxheim /srv/fluxheim /var/log/fluxheim
sudo chown fluxheim:fluxheim /srv/fluxheim /var/log/fluxheim

# Reload systemd i enable service
sudo systemctl daemon-reload
sudo systemctl enable --now fluxheim

# Sprawdź status
sudo systemctl status fluxheim
sudo journalctl -u fluxheim -f

Uwaga: Spakowany systemd unit używa CAP_NET_BIND_SERVICE aby Fluxheim mógł bind do portów 80 i 443 bez działania jako root. Unit file zawiera opcje security hardening.

bash — zarządzane wydawanie certyfikatu ACME
# Fluxheim dostarcza acme-init dla prowadzonego setup certyfikatów
# Let's Encrypt issuer (HTTP-01)
sudo fluxheim acme-init letsencrypt

# Actalis (darmowy EAB-capable issuer)
sudo fluxheim acme-init actalis

# Companion tool fluxheim-acme obsługuje renewal dla
# deploymentów container i external service-manager
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
# przykład: issuer = "letsencrypt"
Pełna dokumentacja TLS & ACME →

Wymagania systemowe

Obsługiwane platformy

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

Container images

Wszystkie release image buildy są publikowane w GHCR i Quay.

  • Wolfi (minimalny, hardened image)
  • Wasm + Profile image full, load-balancer, cache, proxy i PHP
  • Alpine Linux
  • SUSE Micro (non-PHP profiles)
  • SUSE BCI (PHP: php-suse-bci)
  • Debian
  • Opublikowane w GHCR i Quay
Wersja Data Najważniejsze punkty Pobrania
v1.8.2 Najnowsze
2026-09 Dodaje niepodpisane natywne archiwa ZIP dla Windows x86_64 we wszystkich siedmiu profilach publicznych, zachowuje zabezpieczenia systemu plików i poświadczeń Windows oraz zastępuje obraz PHP SUSE Micro samodzielnym środowiskiem uruchomieniowym php-suse-bci. Wszystko na GitHub
v1.8.1
2026-08 Dodaje natywne archiwa macOS dla Apple Silicon dla wszystkich siedmiu publicznych profili kompilacji, rzeczywiste testy równoważności działania, przenośne narzędzia sum kontrolnych oraz silniejszą ochronę diagnostyki i systemu plików. Wszystko na GitHub
v1.8.0
July 2026 Dedykowana kompilacja Wasm oparta na pełnym profilu produkcyjnym, z ograniczonymi punktami polityk, ACME, metrykami i OpenTelemetry. Dodaje zgodne archiwa tar.gz i ZIP, w tym natywne kompilacje profili full i Wasm dla macOS. Wzmacnia granice wypełniania pamięci podręcznej, pamięci zakresów i przyjmowania Wasm dla każdego hosta wirtualnego. Wszystko na GitHub
v1.7.0 – v1.7.12
July 2026 Seria wydań Fluxheim 1.7: opcjonalna, oparta na standardach metadane pamięci podręcznej, proxy i metadanych podsumowujących odpowiedzi; uwierzytelnione ponowne ładowanie i przywracanie migawek na żywo; powtarzalne dowody FIPS-backend; aktualizacje procesów bez przestojów; niezależnie przetestowane przykłady zasad Wasm; i silniejsza pamięć podręczna, TLS, buforowanie, strumienie i granice protokołów. Wszystko na GitHub
v1.6.0 – v1.6.37
czerwiec 2026 Linia przejścia i czyszczenia native-runtime: fundamenty odejścia od Pingora, ścieżki HTTP/1 i HTTP/2 należące do Fluxheim, podglądy native TLS/listener, parytet route proxy/static-web, kompresja i strony błędów, polityka forwarded-header, auth-request, mirroring ruchu, rate limits, walidacja gRPC, pulowane upstream HTTP/2, czyszczenie native proxy po cutoverze, finalne czyszczenie granic crate przed Wasm, Rust 1.96.1, wzmocnione OpenSSL stream TLS, zeroizacja konta ACME i mniejsze ukierunkowane moduły runtime. Wszystko na GitHub
v1.5.0 - v1.5.23 czerwiec 2026 Linia enterprise load-balancer i runtime-ownership: focused load-balancer binaries/images, runtime member i weight controls, managed affinity cookies, stream i HTTP boundary work, active i protocol-aware health checks, service discovery, background task ownership, cache crate boundaries, UDP beta guardrails, origin-protection budgets, ARM/macOS assets i szeroki security hardening. Wszystko na GitHub
v1.4.0 – v1.4.7 maj 2026 Linia proxy operations z production proxy parity, richer route policy, traffic mirroring, dynamic upstream discovery, modular runtime/config split, Apple Silicon i Linux ARM64 release assets, GeoIP/Geo-Context, config-tester archives i hardened TCP stream proxying Wszystko na GitHub
v1.3.0 – v1.3.7 maj 2026 Linia production PHP-FPM, managed php-fpm supervision, config tester i ACME companion binaries, FIPS/ISO validation tracks, focused cache/proxy profiles i security hardening Wszystko na GitHub
v1.2.0 – v1.2.6 maj 2026 Baseline cache i observability z route-scoped cache policy, backendami memory/disk/tiered, encrypted disk cache, peer fill, range caching, Prometheus i OpenTelemetry export Wszystko na GitHub
v1.1.x 2026 Linia certificate operations z TLS policy profiles, multi-certificate rustls SNI, managed ACME issuance i renewal, EAB-capable issuers, file-backed TLS secrets i renewal units Wszystko na GitHub
v1.0.0 2026 Gateway foundation z vhost routing, route-level static/proxy/redirect actions, static file serving, reverse proxying, rustls TLS, admin control-plane, secure headers, systemd packaging i rootless containers GitHub
v0.5.0 Publiczny pre-release Pierwszy publiczny pre-release milestone przed stabilną linią gateway 1.x GitHub

See Dziennik zmian dla szczegółowych release notes.

Polski