Последний Stable — v1.6.30

Download Fluxheim

Pre-built Linux binaries for x86_64 and ARM64, plus macOS developer builds. Выпущено 23 июня 2026.

Full сборка сборка Рекомендуется

Полная production-сборка

Все стабильные production modules: proxy, web, cache, compression, load balancing, raw TCP stream proxying, TLS (rustls), PHP-FPM, ACME client, GeoIP/Geo-Context, security hardening, metrics и OpenTelemetry.

Static serving + reverse proxy + PHP-FPM сборка сборка
Cache backends: memory, disk и tiered
gzip, zstd и Brotli compression
TLS + managed ACME renewal поток поток
Локальный GeoIP country/ASN context
Усиленный TCP stream proxying
Prometheus + OpenTelemetry экспорт экспорт
~10.3 MB binary
Load Balancer Новое

Load Balancer Edge сборка сборка

Целевая HTTP/TCP load-balancer build без cache, static web, PHP, GeoIP, stream proxying или traffic mirroring.

Advanced pool selection
Drain, disable и force-down
Усиленное LB core
TLS + managed ACME renewal поток поток
PHP Managed PHP-FPM режим режим

PHP Application Build сборка сборка

Static web + reverse proxy + PHP-FPM FastCGI bridge модуль модуль. Идеально для WordPress и PHP front-controller apps. Cache module не компилируется.

PHP-FPM FastCGI bridge модуль модуль
Static asset serving из того же root
TLS + managed ACME renewal поток поток
~8.9 MB binary
Кеш

Cache Edge Build сборка сборка

Целевая cache edge без local static web serving. Включает proxy, cache, compression, TLS и ACME. Подходит для CDN-style deployments.

Reverse proxy + кеш
Cache-safe compression controls для кеша для кеша
TLS + managed ACME renewal поток поток
Static web module не компилируется
~6.8 MB binary
Прокси

Proxy Edge Build сборка сборка

Целевой reverse proxy без cache, static web или dedicated load-balancer module. Создан для pure reverse-proxy deployments с TLS, ACME, compression и upstream resilience.

Только reverse proxy
ACLs, rate limits, retries и health checks
TLS + managed ACME renewal поток поток
Cache или web module не компилируется
~5.8 MB binary

Platform Downloads

Production Linux builds plus Level 1 macOS developer tarballs.

macOS только для developer testing
Сборка Linux x86_64 Linux ARM64 macOS dev
Full сборка сборка x86_64-linux aarch64-linux Apple Silicon
PHP x86_64-linux aarch64-linux -
Load Balancer x86_64-linux aarch64-linux -
Кеш x86_64-linux aarch64-linux -
Прокси x86_64-linux aarch64-linux -
Проверка config x86_64-linux aarch64-linux -

Установка

bash — установка из tarball
# 1. Скачать full Linux build tarball
# На ARM64 servers используйте aarch64-linux вместо x86_64-linux.
curl -L https://github.com/valkyoth/fluxheim/releases/download/v1.6.30/fluxheim-1.6.30-full-x86_64-linux.tar.gz \
  -o fluxheim-1.6.30.tar.gz

# 2. Проверить и распаковать
tar xzf fluxheim-1.6.30.tar.gz

# 3. Переместить binary и helper tools в системный path
sudo mv fluxheim /usr/local/bin/
sudo mv fluxheim-acme /usr/local/bin/            # ACME companion tool tool
sudo mv fluxheim-config-tester /usr/local/bin/   # Config validator tool tool

# 4. Создать config directory и добавить config
sudo mkdir -p /etc/fluxheim /srv/fluxheim
sudo cp packaging/default/fluxheim.toml /etc/fluxheim/fluxheim.toml

# 5. Проверить config
fluxheim --check-config --config /etc/fluxheim/fluxheim.toml

# 6. Запустить напрямую (или см. вкладку Systemd для service setup)
sudo fluxheim --config /etc/fluxheim/fluxheim.toml
bash — запуск rootless Podman
# Скачать GHCR images (full, load-balancer, cache, proxy и PHP variants)
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30         # full image image
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-load-balancer # load balancer image image
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-cache   # cache edge image image
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-proxy   # proxy edge image image
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-php     # managed PHP-FPM image image

# Такой же набор builds доступен на Quay
podman pull quay.io/valkyoth/fluxheim:v1.6.30
podman pull quay.io/valkyoth/fluxheim:v1.6.30-load-balancer
podman pull quay.io/valkyoth/fluxheim:v1.6.30-cache
podman pull quay.io/valkyoth/fluxheim:v1.6.30-proxy
podman pull quay.io/valkyoth/fluxheim:v1.6.30-php

# Запуск rootless — internal ports 8080 и 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.6.30

# Проверить logs
podman logs -f fluxheim
bash — настройка systemd service
# Tarball архив архив включает hardened systemd unit
sudo cp packaging/systemd/fluxheim.service /etc/systemd/system/

# Создать system user fluxheim
sudo useradd -r -s /sbin/nologin -d /var/lib/fluxheim fluxheim

# Настроить directories
sudo mkdir -p /etc/fluxheim /srv/fluxheim /var/log/fluxheim
sudo chown fluxheim:fluxheim /srv/fluxheim /var/log/fluxheim

# Перезагрузить systemd и включить service
sudo systemctl daemon-reload
sudo systemctl enable --now fluxheim

# Проверить status
sudo systemctl status fluxheim
sudo journalctl -u fluxheim -f

Примечание: Упакованный systemd unit использует CAP_NET_BIND_SERVICE чтобы Fluxheim мог привязываться к ports 80 и 443 без запуска от root. Unit file включает security hardening options.

bash — выдача managed ACME certificate
# Fluxheim поставляется с acme-init для guided certificate setup
# Let's Encrypt issuer (HTTP-01)
sudo fluxheim acme-init letsencrypt

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

# Companion tool fluxheim-acme обрабатывает renewal для
# container и external service-manager deployments
fluxheim-acme status
fluxheim-acme renew
fluxheim-acme reload
fluxheim.toml — конфигурация ACME
[[vhosts]]
name = "site"
hosts = ["example.com", "www.example.com"]

[vhosts.tls]
enabled = true

[vhosts.tls.acme]
enabled = true
# issuer = "letsencrypt" пример
Полная документация TLS и ACME →

Системные требования

Поддерживаемые платформы

  • Linux x86_64 (kernel 4.14+)
  • Linux ARM64 / aarch64
  • Только macOS developer binaries

Container images

Все release image builds публикуются в GHCR и Quay.

  • Wolfi minimal hardened image
  • Full сборка сборка, load-balancer, cache, proxy и PHP image profiles
  • Alpine Linux
  • SUSE Micro
  • Debian
  • Опубликовано в GHCR и Quay
Версия Дата Главное Загрузки
v1.6.0 – v1.6.30 Последняя серия
Июнь 2026 Native-runtime cutover line: Pingora-exit foundations, Fluxheim-owned HTTP/1 and HTTP/2 paths, native TLS/listener previews, route proxy/static-web parity, compression and error pages, forwarded-header policy, auth-request, traffic mirroring, rate limits, gRPC validation, pooled upstream HTTP/2 и hardened runtime evidence. Все на GitHub
v1.5.0 - v1.5.23 Июнь 2026 Enterprise load-balancer и runtime-ownership line: focused load-balancer binaries/images, runtime member and weight controls, managed affinity cookies, stream and HTTP boundary work, active and protocol-aware health checks, service discovery, background task ownership, cache crate boundaries, UDP beta guardrails, origin-protection budgets, ARM/macOS assets и broad security hardening. Все на GitHub
v1.4.0 – v1.4.7 Май 2026 Proxy operations line с production proxy parity, richer route policy, traffic mirroring, dynamic upstream discovery, modular runtime/config split, Apple Silicon and Linux ARM64 release assets, GeoIP/Geo-Context, config-tester archives и hardened TCP stream proxying Все на GitHub
v1.3.0 – v1.3.7 Май 2026 PHP-FPM production line, managed php-fpm supervision, config tester и ACME companion binaries, FIPS/ISO validation tracks, focused cache/proxy profiles и security hardening Все на GitHub
v1.2.0 – v1.2.6 Май 2026 Cache and observability baseline с route-scoped cache policy, memory/disk/tiered backends, encrypted disk cache, peer fill, range caching, Prometheus и OpenTelemetry export Все на GitHub
v1.1.x 2026 Certificate operations line с TLS policy profiles, multi-certificate rustls SNI, managed ACME issuance and renewal, EAB-capable issuers, file-backed TLS secrets и renewal units Все на GitHub
v1.0.0 2026 Gateway foundation с vhost routing, route-level static/proxy/redirect actions, static file serving, reverse proxying, rustls TLS, admin control-plane, secure headers, systemd packaging и rootless containers GitHub
v0.5.0 Pre-release выпуск выпуск Первый public pre-release milestone перед stable 1.x gateway line GitHub

См. Журнал изменений для подробных release notes.

Русский