Download Fluxheim
Linux x86_64 · Linux aarch64 · Windows x86_64 · macOS Apple Silicon 2026-09-13.
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.
Load balancer edge
Skupiony HTTP/TCP load-balancer build bez cache, static web, PHP, GeoIP, stream proxying lub traffic mirroring.
PHP application build
Static web + reverse proxy + PHP-FPM FastCGI bridge. Idealny dla WordPress i aplikacji PHP front-controller. Bez skompilowanego modułu cache.
Cache edge build
Skupiony cache edge bez local static web serving. Zawiera proxy, cache, compression, TLS i ACME. Idealny dla deploymentów CDN-style.
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.
Produkcyjna kompilacja Wasm
Dedykowana kompilacja Wasm oparta na pełnym profilu produkcyjnym, z ograniczonymi punktami polityk, ACME, metrykami i OpenTelemetry.
Platform Downloads
Linux x86_64 · Linux aarch64 · Windows x86_64 · macOS Apple Silicon
| Profil build | Linux x86_64 | Linux aarch64 | Windows x86_64 | macOS Apple Silicon |
|---|---|---|---|---|
| Pełny | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
| Wasm | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
| PHP | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
| Load balancer | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
| Cache build | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
| Proxy build | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
| Tester konfiguracji | x86_64-linux | aarch64-linux | x86_64-windows | aarch64-macos |
Instalacja
# 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
$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.
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.
# 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
# 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.
# 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
[[vhosts]]
name = "site"
hosts = ["example.com", "www.example.com"]
[vhosts.tls]
enabled = true
[vhosts.tls.acme]
enabled = true
# przykład: issuer = "letsencrypt"
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
All Releases
Zobacz wszystko na GitHub →| 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.