Download Fluxheim
Binários Linux pré-compilados para x86_64 e ARM64, mais builds de desenvolvimento para macOS. Lançado em 23 de julho de 2026.
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.
Load balancer edge
Build focado HTTP/TCP load-balancer sem cache, static web, PHP, GeoIP, stream proxying ou traffic mirroring.
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.
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.
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.
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.
Platform Downloads
Production Linux builds plus Level 1 macOS developer tarballs.
| Tipo de build | Linux x86_64 | Linux ARM64 | macOS dev |
|---|---|---|---|
| Completo | x86_64-linux | aarch64-linux | Apple Silicon |
| Wasm | x86_64-linux | aarch64-linux | Apple Silicon |
| PHP | x86_64-linux | aarch64-linux | - |
| Load balancer | x86_64-linux | aarch64-linux | - |
| Cache edge | x86_64-linux | aarch64-linux | - |
| Proxy edge | x86_64-linux | aarch64-linux | - |
| Tester de config | x86_64-linux | aarch64-linux | - |
Instalação
# 1. Transferir o tarball do build Linux completo
# Use aarch64-linux em vez de x86_64-linux em servidores ARM64.
curl -L https://github.com/valkyoth/fluxheim/releases/download/v1.8.0/fluxheim-1.8.0-full-x86_64-linux.tar.gz \
-o fluxheim-1.8.0.tar.gz
# 2. Verificar e extrair
tar xzf fluxheim-1.8.0.tar.gz
# 3. Mover binário e ferramentas auxiliares para system path
sudo mv fluxheim /usr/local/bin/
sudo mv fluxheim-acme /usr/local/bin/ # Ferramenta auxiliar ACME
sudo mv fluxheim-config-tester /usr/local/bin/ # Validador de config
# 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
# Pull de imagens GHCR (Wasm, full, load-balancer, cache, proxy e variantes PHP)
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0 # build completo
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-wasm
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-load-balancer # balanceador de carga
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-cache # cache-edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-proxy # proxy-edge
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-php # PHP-FPM gerido
# O mesmo conjunto de builds está disponível no Quay
podman pull quay.io/valkyoth/fluxheim:v1.8.0
podman pull quay.io/valkyoth/fluxheim:v1.8.0-wasm
podman pull quay.io/valkyoth/fluxheim:v1.8.0-load-balancer
podman pull quay.io/valkyoth/fluxheim:v1.8.0-cache
podman pull quay.io/valkyoth/fluxheim:v1.8.0-proxy
podman pull quay.io/valkyoth/fluxheim:v1.8.0-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.0
# Verificar logs
podman logs -f fluxheim
# 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.
# 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
[[vhosts]]
name = "site"
hosts = ["example.com", "www.example.com"]
[vhosts.tls]
enabled = true
[vhosts.tls.acme]
enabled = true
# issuer = "letsencrypt" # emissor
Requisitos do sistema
Plataformas suportadas
- Linux x86_64 (kernel 4.14+)
- Linux ARM64 / aarch64
- Apenas binários macOS para desenvolvimento
Imagens de contentor
Todos os builds de imagens release são publicados em GHCR e Quay.
- Wolfi (mínimo, endurecido)
- Perfis de imagem full, load-balancer, cache, proxy e PHP
- Alpine Linux
- SUSE Micro
- Debian
- Publicado em GHCR e Quay
All Releases
Ver tudo no GitHub →| Versão | Data | Destaques | Transferências |
|---|---|---|---|
|
v1.8.0
Mais recente
|
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.