Последняя стабильная — v1.8.0

Download Fluxheim

Предварительно собранные Linux-бинарники для x86_64 и ARM64, а также 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

x86_64 ARM64

Балансировщик нагрузки Новое

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 поток

x86_64 ARM64

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

x86_64 ARM64

Кеш

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

x86_64 ARM64

Прокси

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

x86_64 ARM64

Wasm Новое

Производственная сборка Wasm

Отдельная сборка Wasm на основе полного производственного профиля с ограниченными перехватчиками политик, ACME, метриками и OpenTelemetry.

Static serving + reverse proxy + PHP-FPM сборка

Cache backends: memory, disk и tiered

WASM-расширения

TLS + managed ACME renewal поток

Prometheus + OpenTelemetry экспорт

x86_64 ARM64

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
Wasm	x86_64-linux	aarch64-linux	Apple Silicon
PHP	x86_64-linux	aarch64-linux	-
Балансировщик нагрузки	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.8.0/fluxheim-1.8.0-full-x86_64-linux.tar.gz \
  -o fluxheim-1.8.0.tar.gz

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

# 3. Переместить binary и helper tools в системный path
sudo mv fluxheim /usr/local/bin/
sudo mv fluxheim-acme /usr/local/bin/            # ACME companion tool
sudo mv fluxheim-config-tester /usr/local/bin/   # Config validator 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 (Wasm, full, load-balancer, cache, proxy и PHP variants)
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0         # full image
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-wasm
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-load-balancer # load balancer image
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-cache   # cache edge image
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-proxy   # proxy edge image
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0-php     # managed PHP-FPM image

# Такой же набор builds доступен на 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

# Запуск 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.8.0

# Проверить 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

All Releases

Смотреть все на GitHub →

Версия	Дата	Главное	Загрузки
v1.8.0 Последний	July 2026	Отдельная сборка Wasm на основе полного производственного профиля с ограниченными перехватчиками политик, ACME, метриками и OpenTelemetry. Добавляет согласованные архивы tar.gz и ZIP, включая нативные сборки профилей full и Wasm для macOS. Усиливает границы заполнения кэша, кэширования диапазонов и допуска Wasm для каждого виртуального хоста.	Все на GitHub
v1.7.0 – v1.7.12	July 2026	Fluxheim 1.7: серия выпусков: возможность использования стандартного кэша, прокси-сервера и метаданных дайджеста ответов; перезагрузка и откат аутентифицированного живого снимка; воспроизводимые доказательства FIPS-backend; модернизация процессов без простоев; независимо протестированные примеры политик Wasm; и более сильный кеш, TLS, буферизация, поток и границы протокола.	Все на GitHub
v1.6.0 – v1.6.37	Июнь 2026	Линия перехода и очистки native runtime: основы выхода из Pingora, собственные HTTP/1 и HTTP/2 пути Fluxheim, превью native TLS/listener, паритет route proxy/static-web, сжатие и страницы ошибок, политика forwarded-header, auth-request, зеркалирование трафика, rate limits, gRPC-валидация, pooled upstream HTTP/2, очистка native proxy после cutover, финальная очистка границ crates перед Wasm, Rust 1.96.1, усиленный OpenSSL stream TLS, zeroization учётной записи ACME и меньшие сфокусированные runtime-модули.	Все на 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

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