Última estable — v1.8.2

Download Fluxheim

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

Completo Recomendado

Build completo de producción

Todos los módulos estables de producción: proxy, web, caché, compresión, load balancing, raw TCP stream proxying, TLS (rustls), PHP-FPM, ACME client, GeoIP/Geo-Context, security hardening, métricas y OpenTelemetry.

Static serving, reverse proxy y PHP-FPM
Backends de caché (memoria, disco, tiered)
Compresión gzip, zstd y Brotli
TLS + renovación ACME gestionada
Contexto local GeoIP país/ASN
TCP stream proxying endurecido
Prometheus y OpenTelemetry
~10.3 MB binary
Load balancer Nuevo

Load balancer edge

Build enfocado HTTP/TCP load-balancer sin caché, static web, PHP, GeoIP, stream proxying ni traffic mirroring.

Advanced pool selection
Drain, desactivar, force-down
Núcleo LB endurecido
TLS + renovación ACME gestionada
PHP PHP-FPM gestionado

Build de aplicación PHP

Static web + reverse proxy + puente PHP-FPM FastCGI. Ideal para WordPress y apps PHP front-controller. No compila módulo de caché.

Puente PHP-FPM FastCGI
Servicio de assets estáticos desde el mismo root
TLS + renovación ACME gestionada
~8.9 MB binary
Caché

Build cache edge

Cache edge enfocado sin servicio web estático local. Incluye proxy, caché, compresión, TLS y ACME. Ideal para despliegues estilo CDN.

Reverse proxy y caché
Controles de compresión seguros para caché
TLS + renovación ACME gestionada
No compila módulo static web
~6.8 MB binary
Proxy edge

Build proxy edge

Reverse proxy enfocado sin caché, static web ni el módulo dedicado de load-balancer. Diseñado para despliegues reverse-proxy puros con TLS, ACME, compresión y resiliencia upstream.

Solo reverse proxy
ACLs, rate limits, reintentos y health checks
TLS + renovación ACME gestionada
No compila módulo caché ni web
~5.8 MB binary
Wasm Nuevo

Compilación Wasm de producción

Compilación Wasm dedicada basada en el perfil de producción completo, con hooks de políticas acotados, ACME, métricas y OpenTelemetry.

Static serving, reverse proxy y PHP-FPM
Backends de caché (memoria, disco, tiered)
Extensiones WASM
TLS + renovación ACME gestionada
Prometheus y OpenTelemetry

Platform Downloads

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

Plataformas soportadas

Instalación

bash - instalación por tarball
# 1. Descargar el tarball del build Linux completo
# Usa aarch64-linux en lugar de x86_64-linux en servidores ARM64.
curl -fLO https://github.com/valkyoth/fluxheim/releases/download/v1.8.2/fluxheim-1.8.2-full-x86_64-linux.tar.gz

# 2. Verificar y extraer
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. Mover binario y herramientas auxiliares al system path
cd fluxheim-1.8.2-full-x86_64-linux
sudo install -m 0755 fluxheim fluxheim-acme /usr/local/bin/

# 4. Crear directorio de config y añadir tu config
sudo mkdir -p /etc/fluxheim /srv/fluxheim
sudo cp packaging/default/fluxheim.toml /etc/fluxheim/fluxheim.toml

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

# 6. Ejecutar directamente (o ver la pestaña Systemd para 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"

Versión preliminar sin firmar: Esta es una versión preliminar portátil sin firmar. Mantén activada la seguridad de SmartScreen y PowerShell; todavía no se proporcionan firma Authenticode ni instalador de servicio de Windows. La supervisión administrada de PHP-FPM solo está disponible en Unix; Windows admite grupos FastCGI TCP externos.

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"

Versión preliminar sin firmar: Esta es una versión preliminar de línea de comandos sin firmar. Mantén Gatekeeper activado; todavía no se proporcionan firma con Developer ID, notarización ni integración con launchd.

bash - Podman rootless
# Pull de imágenes GHCR (Wasm, full, load-balancer, cache, proxy y variantes PHP)
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2         # build completo
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-wasm
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-load-balancer # balanceador de carga
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-cache   # cache-edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-proxy   # proxy-edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.2-php     # PHP-FPM gestionado

# El mismo conjunto de builds está disponible en 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

# Ejecutar rootless - puertos internos 8080 y 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

# Comprobar logs
podman logs -f fluxheim
bash - servicio systemd
# El tarball incluye una systemd unit endurecida
sudo cp packaging/systemd/fluxheim.service /etc/systemd/system/

# Crear el usuario de sistema fluxheim
sudo useradd -r -s /sbin/nologin -d /var/lib/fluxheim fluxheim

# Preparar directorios
sudo mkdir -p /etc/fluxheim /srv/fluxheim /var/log/fluxheim
sudo chown fluxheim:fluxheim /srv/fluxheim /var/log/fluxheim

# Recargar systemd y habilitar el servicio
sudo systemctl daemon-reload
sudo systemctl enable --now fluxheim

# Comprobar estado
sudo systemctl status fluxheim
sudo journalctl -u fluxheim -f

Nota: La systemd unit empaquetada usa CAP_NET_BIND_SERVICE para que Fluxheim pueda enlazar a los puertos 80 y 443 sin ejecutarse como root. El unit file incluye opciones de security hardening.

bash - emisión de certificado ACME gestionado
# Fluxheim incluye acme-init para configuración guiada de certificados
# Let's Encrypt certificado (HTTP-01)
sudo fluxheim acme-init letsencrypt

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

# La herramienta auxiliar fluxheim-acme gestiona la renovación para
# deployments con contenedor y service-manager externo
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 = "letsencrypt" # emisor
Documentación TLS y ACME completa →

Requisitos del sistema

Plataformas soportadas

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

Imágenes de contenedor

Todos los builds de imágenes release se publican en GHCR y Quay.

  • Wolfi (mínimo, endurecido)
  • Wasm + Perfiles de imagen full, load-balancer, cache, proxy y PHP
  • Alpine Linux
  • SUSE Micro (non-PHP profiles)
  • SUSE BCI (PHP: php-suse-bci)
  • Debian
  • Publicado en GHCR y Quay

All Releases

Ver todo en GitHub →
Versión Fecha Destacados Descargas
v1.8.2 Más reciente
2026-09 Añade archivos ZIP nativos sin firmar para Windows x86_64 en los siete perfiles públicos, mantiene las protecciones del sistema de archivos y las credenciales de Windows y sustituye la imagen PHP de SUSE Micro por el entorno autónomo php-suse-bci. Todo en GitHub
v1.8.1
2026-08 Añade paquetes nativos de macOS para Apple Silicon a los siete perfiles públicos de compilación, pruebas de paridad en entornos de ejecución reales, herramientas portátiles de verificación de sumas de comprobación y protecciones reforzadas para los diagnósticos y el sistema de archivos. Todo en GitHub
v1.8.0
July 2026 Compilación Wasm dedicada basada en el perfil de producción completo, con hooks de políticas acotados, ACME, métricas y OpenTelemetry. Añade archivos tar.gz y ZIP equivalentes, incluidas compilaciones nativas completas y Wasm para macOS. Refuerza los límites de llenado de caché, caché por rangos y admisión Wasm por host virtual. Todo en GitHub
v1.7.0 – v1.7.12
July 2026 Serie de versiones Fluxheim 1.7: caché basada en estándares opcionales, proxy y metadatos de resumen de respuesta; recarga y reversión de instantáneas en vivo autenticadas; evidencia reproducible FIPS-backend; actualizaciones de procesos sin tiempo de inactividad; ejemplos de políticas Wasm probados de forma independiente; y caché más fuerte, TLS, almacenamiento en búfer, flujo y límites de protocolo. Todo en GitHub
v1.6.0 – v1.6.37
Junio de 2026 Línea de cutover y limpieza del runtime nativo: bases de salida de Pingora, rutas HTTP/1 y HTTP/2 propias de Fluxheim, vistas previas nativas de TLS/listener, paridad route proxy/static-web, compresión y páginas de error, política de forwarded headers, auth-request, mirroring de tráfico, rate limits, validación gRPC, upstream HTTP/2 con pool, limpieza nativa de proxy posterior al cutover, limpieza final de límites de crates antes de Wasm, Rust 1.96.1, TLS de stream OpenSSL endurecido, zeroización de cuenta ACME y módulos de runtime más pequeños y enfocados. Todo en GitHub
v1.5.0 - v1.5.23 Junio de 2026 Línea enterprise load-balancer y runtime-ownership: binarios/images load-balancer enfocados, controles runtime member y weight, managed affinity cookies, trabajo de frontera stream y HTTP, active y protocol-aware health checks, service discovery, background task ownership, fronteras cache crate, UDP beta guardrails, origin-protection budgets, assets ARM/macOS y amplio security hardening. Todo en GitHub
v1.4.0 – v1.4.7 Mayo de 2026 Línea proxy operations con production proxy parity, route policy más rica, traffic mirroring, dynamic upstream discovery, split modular runtime/config, assets Apple Silicon y Linux ARM64, GeoIP/Geo-Context, archivos config-tester y TCP stream proxying endurecido Todo en GitHub
v1.3.0 – v1.3.7 Mayo de 2026 Línea de producción PHP-FPM, supervisión php-fpm gestionada, binarios config tester y companion ACME, tracks FIPS/ISO validation, perfiles cache/proxy enfocados y security hardening Todo en GitHub
v1.2.0 – v1.2.6 Mayo de 2026 Baseline de cache y observability con route-scoped cache policy, backends memory/disk/tiered, cache de disco cifrada, peer fill, range caching, Prometheus y export OpenTelemetry Todo en GitHub
v1.1.x 2026 Línea certificate operations con TLS policy profiles, rustls SNI multi-certificado, managed ACME issuance y renewal, issuers EAB-capable, file-backed TLS secrets y renewal units Todo en GitHub
v1.0.0 2026 Base gateway con vhost routing, acciones static/proxy/redirect a nivel de route, static file serving, reverse proxying, rustls TLS, admin control-plane, secure headers, systemd packaging y contenedores rootless GitHub
v0.5.0 Versión previa Primer hito público pre-release antes de la línea gateway estable 1.x GitHub

See Registro de cambios para notas de versión detalladas.

Español