Última estável — v1.8.2

Download Fluxheim

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

Completo Recomendado

Build completo de produção

Todos os módulos estáveis de produção: proxy, web, cache, compressão, load balancing, raw TCP stream proxying, TLS (rustls), PHP-FPM, ACME client, GeoIP/Geo-Context, security hardening, métricas e OpenTelemetry.

Static serving, reverse proxy e PHP-FPM
Backends de cache (memória, disco, tiered)
Compressão gzip, zstd e Brotli
TLS + renovação ACME gerida
Contexto local GeoIP país/ASN
TCP stream proxying endurecido
Prometheus e OpenTelemetry
~10.3 MB binary
Load balancer Novo

Load balancer edge

Build focado HTTP/TCP load-balancer sem cache, static web, PHP, GeoIP, stream proxying ou traffic mirroring.

Advanced pool selection
Drain, desativar, force-down
Núcleo LB endurecido
TLS + renovação ACME gerida
PHP PHP-FPM gerido

Build de aplicação PHP

Static web + reverse proxy + ponte PHP-FPM FastCGI. Ideal para WordPress e apps PHP front-controller. Não compila módulo de cache.

Ponte PHP-FPM FastCGI
Serviço de assets estáticos a partir do mesmo root
TLS + renovação ACME gerida
~8.9 MB binary
Cache edge

Build cache edge

Cache edge focado sem serviço web estático local. Inclui proxy, cache, compressão, TLS e ACME. Ideal para deployments estilo CDN.

Reverse proxy e cache
Controlos de compressão seguros para cache
TLS + renovação ACME gerida
Não compila módulo static web
~6.8 MB binary
Proxy edge

Build proxy edge

Reverse proxy focado sem cache, static web ou o módulo dedicado de load-balancer. Desenhado para deployments reverse-proxy puros com TLS, ACME, compressão e resiliência upstream.

Apenas reverse proxy
ACLs, rate limits, retries e health checks
TLS + renovação ACME gerida
Não compila módulo cache nem web
~5.8 MB binary
Wasm Novo

Compilação Wasm de produção

Compilação Wasm dedicada baseada no perfil de produção completo, com hooks de política limitados, ACME, métricas e OpenTelemetry.

Static serving, reverse proxy e PHP-FPM
Backends de cache (memória, disco, tiered)
Extensões WASM
TLS + renovação ACME gerida
Prometheus e OpenTelemetry

Platform Downloads

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

Plataformas suportadas

Instalação

bash - instalação por tarball
# 1. Transferir o tarball do build Linux completo
# Use aarch64-linux em vez de x86_64-linux em 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 e extrair
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 binário e ferramentas auxiliares para system path
cd fluxheim-1.8.2-full-x86_64-linux
sudo install -m 0755 fluxheim fluxheim-acme /usr/local/bin/

# 4. Criar diretório de config e adicionar a sua 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. Executar diretamente (ou ver o separador 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"

Pré-visualização não assinada: Esta é uma pré-visualização portátil não assinada. Mantenha a segurança do SmartScreen e do PowerShell ativada; a assinatura Authenticode e um instalador de serviço do Windows ainda não são fornecidos. A supervisão gerida do PHP-FPM está disponível apenas em Unix; o Windows suporta 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"

Pré-visualização não assinada: Esta é uma pré-visualização de linha de comandos não assinada. Mantenha o Gatekeeper ativado; a assinatura Developer ID, a notarização e a integração com o launchd ainda não são fornecidas.

bash - Podman rootless
# Pull de imagens GHCR (Wasm, full, load-balancer, cache, proxy e 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 gerido

# O mesmo conjunto de builds está disponível no 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

# Executar rootless - portas internas 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

# Verificar logs
podman logs -f fluxheim
bash - serviço systemd
# O tarball inclui uma systemd unit endurecida
sudo cp packaging/systemd/fluxheim.service /etc/systemd/system/

# Criar o utilizador de sistema fluxheim
sudo useradd -r -s /sbin/nologin -d /var/lib/fluxheim fluxheim

# Preparar diretórios
sudo mkdir -p /etc/fluxheim /srv/fluxheim /var/log/fluxheim
sudo chown fluxheim:fluxheim /srv/fluxheim /var/log/fluxheim

# Recarregar systemd e ativar o serviço
sudo systemctl daemon-reload
sudo systemctl enable --now fluxheim

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

Nota: A systemd unit empacotada usa CAP_NET_BIND_SERVICE para que o Fluxheim possa ligar às portas 80 e 443 sem correr como root. O unit file inclui opções de security hardening.

bash - emissão de certificado ACME gerido
# Fluxheim inclui acme-init para configuração guiada de certificados
# Certificado Let's Encrypt (HTTP-01)
sudo fluxheim acme-init letsencrypt

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

# A ferramenta auxiliar fluxheim-acme gere a renovação para
# deployments com contentor e 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" # emissor
Documentação TLS e ACME completa →

Requisitos do sistema

Plataformas suportadas

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

Imagens de contentor

Todos os builds de imagens release são publicados em GHCR e Quay.

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

All Releases

Ver tudo no GitHub →
Versão Data Destaques Transferências
v1.8.2 Mais recente
2026-09 Adiciona arquivos ZIP nativos não assinados para Windows x86_64 aos sete perfis públicos, mantém as proteções do sistema de ficheiros e das credenciais do Windows e substitui a imagem PHP SUSE Micro pelo ambiente autónomo php-suse-bci. Tudo no GitHub
v1.8.1
2026-08 Adiciona pacotes macOS nativos para Apple Silicon aos sete perfis públicos de compilação, testes de paridade em ambientes de execução reais, ferramentas portáteis de verificação de somas de controlo e proteções reforçadas para diagnósticos e para o sistema de ficheiros. Tudo no GitHub
v1.8.0
July 2026 Compilação Wasm dedicada baseada no perfil de produção completo, com hooks de política limitados, ACME, métricas e OpenTelemetry. Adiciona ficheiros tar.gz e ZIP correspondentes, incluindo compilações nativas completas e Wasm para macOS. Reforça os limites de preenchimento da cache, cache por intervalos e admissão Wasm por anfitrião virtual. Tudo no GitHub
v1.7.0 – v1.7.12
July 2026 Fluxheim 1.7 série de lançamentos: cache baseado em padrões, proxy e metadados de resumo de resposta opcionais; recarga e reversão de instantâneos ao vivo autenticados; evidência FIPS-backend reproduzível; atualizações de processos com tempo de inatividade zero; exemplos de políticas Wasm testados de forma independente; e cache mais forte, TLS, buffer, fluxo e limites de protocolo. Tudo no GitHub
v1.6.0 – v1.6.37
Junho de 2026 Linha de cutover e limpeza do runtime nativo: bases de saída do Pingora, caminhos HTTP/1 e HTTP/2 próprios do Fluxheim, prévias nativas de TLS/listener, paridade route proxy/static-web, compressão e páginas de erro, política forwarded-header, auth-request, espelhamento de tráfego, rate limits, validação gRPC, upstream HTTP/2 com pool, limpeza nativa do proxy após cutover, limpeza final de fronteiras de crates antes de Wasm, Rust 1.96.1, TLS de stream OpenSSL reforçado, zeroização da conta ACME e módulos de runtime menores e focados. Tudo no GitHub
v1.5.0 - v1.5.23 Junho de 2026 Linha enterprise load-balancer e runtime-ownership: binários/images load-balancer focados, controlos runtime member e weight, managed affinity cookies, trabalho de fronteira stream e HTTP, active e protocol-aware health checks, service discovery, background task ownership, fronteiras cache crate, UDP beta guardrails, origin-protection budgets, assets ARM/macOS e amplo security hardening. Tudo no GitHub
v1.4.0 – v1.4.7 Maio de 2026 Linha proxy operations com production proxy parity, route policy mais rica, traffic mirroring, dynamic upstream discovery, split modular runtime/config, assets Apple Silicon e Linux ARM64, GeoIP/Geo-Context, arquivos config-tester e TCP stream proxying endurecido Tudo no GitHub
v1.3.0 – v1.3.7 Maio de 2026 Linha de produção PHP-FPM, supervisão php-fpm gerida, binários config tester e companion ACME, tracks FIPS/ISO validation, perfis cache/proxy focados e security hardening Tudo no GitHub
v1.2.0 – v1.2.6 Maio de 2026 Baseline de cache e observability com route-scoped cache policy, backends memory/disk/tiered, cache de disco encriptada, peer fill, range caching, Prometheus e export OpenTelemetry Tudo no GitHub
v1.1.x 2026 Linha certificate operations com TLS policy profiles, rustls SNI multi-certificado, managed ACME issuance e renewal, issuers EAB-capable, file-backed TLS secrets e renewal units Tudo no GitHub
v1.0.0 2026 Base gateway com vhost routing, ações static/proxy/redirect ao nível da route, static file serving, reverse proxying, rustls TLS, admin control-plane, secure headers, systemd packaging e contentores rootless GitHub
v0.5.0 Versão prévia Primeiro marco público pre-release antes da linha gateway estável 1.x GitHub

See Registo de alterações para notas de versão detalhadas.

Português