최신 Stable — v1.6.30

Download Fluxheim

Pre-built Linux binaries for x86_64 and ARM64, plus macOS developer builds. 2026년 6월 23일 릴리스.

Full 권장

전체 프로덕션 빌드

모든 안정 프로덕션 모듈: proxy, web, cache, compression, load balancing, raw TCP stream proxying, TLS (rustls), PHP-FPM, ACME client, GeoIP/Geo-Context, security hardening, metrics, OpenTelemetry.

정적 serving + 리버스 프록시 + PHP-FPM
캐시 백엔드(메모리, 디스크, 계층형)
gzip, zstd, Brotli 압축
TLS + 관리형 ACME 갱신
로컬 GeoIP 국가/ASN context
강화된 TCP 스트림 프록시
Prometheus + OpenTelemetry
~10.3 MB binary
Load Balancer 신규

로드 밸런서 엣지

cache, static web, PHP, GeoIP, stream proxying, traffic mirroring을 제외한 전용 HTTP/TCP 로드 밸런서 빌드입니다.

Advanced pool selection
Drain, disable, force-down
강화된 LB core
TLS + 관리형 ACME 갱신
PHP 관리형 PHP-FPM

PHP 애플리케이션 빌드

정적 웹 + 리버스 프록시 + PHP-FPM FastCGI 브리지입니다. WordPress와 PHP front-controller 앱에 적합합니다. cache 모듈은 컴파일되지 않습니다.

PHP-FPM FastCGI 브리지
같은 root에서 정적 asset serving
TLS + 관리형 ACME 갱신
~8.9 MB binary
Cache

Cache Edge 빌드

로컬 정적 웹 serving을 제외한 전용 cache edge입니다. proxy, cache, compression, TLS, ACME를 포함합니다. CDN 스타일 배포에 적합합니다.

리버스 프록시 + cache
캐시 안전 압축 제어
TLS + 관리형 ACME 갱신
static web 모듈은 컴파일되지 않음
~6.8 MB binary
Proxy

Proxy Edge 빌드

cache, static web, 전용 load-balancer 모듈을 제외한 전용 리버스 프록시입니다. TLS, ACME, compression, upstream resilience를 갖춘 순수 리버스 프록시 배포용입니다.

리버스 프록시 전용
ACL, rate limit, retry, health check
TLS + 관리형 ACME 갱신
cache 또는 web 모듈은 컴파일되지 않음
~5.8 MB binary

Platform Downloads

Production Linux builds plus Level 1 macOS developer tarballs.

macOS는 개발자 테스트 전용입니다
빌드 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 -
Cache x86_64-linux aarch64-linux -
Proxy x86_64-linux aarch64-linux -
Config tester x86_64-linux aarch64-linux -

설치

bash — tarball 설치
# 1. full Linux build tarball 다운로드
# ARM64 server에서는 x86_64-linux 대신 aarch64-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 tool을 system path로 이동
sudo mv fluxheim /usr/local/bin/
sudo mv fluxheim-acme /usr/local/bin/            # ACME companion
sudo mv fluxheim-config-tester /usr/local/bin/   # config validator

# 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. 직접 실행(또는 service setup은 Systemd tab 참고)
sudo fluxheim --config /etc/fluxheim/fluxheim.toml
bash — rootless Podman
# GHCR image pull (full, load-balancer, cache, proxy, PHP variant)
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30         # full
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-load-balancer # load balancer
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-cache   # cache edge
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-proxy   # proxy edge
podman pull ghcr.io/valkyoth/fluxheim:v1.6.30-php     # managed PHP-FPM

# 같은 build set은 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 port 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

# log 확인
podman logs -f fluxheim
bash — systemd 서비스
# tarball에는 hardened systemd unit이 포함됨
sudo cp packaging/systemd/fluxheim.service /etc/systemd/system/

# fluxheim system user 생성
sudo useradd -r -s /sbin/nologin -d /var/lib/fluxheim fluxheim

# directory 설정
sudo mkdir -p /etc/fluxheim /srv/fluxheim /var/log/fluxheim
sudo chown fluxheim:fluxheim /srv/fluxheim /var/log/fluxheim

# systemd reload 및 service enable
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이 root로 실행되지 않고도 80 및 443 포트에 바인딩할 수 있습니다. unit file에는 보안 강화 옵션이 포함됩니다.

bash — 관리형 ACME 인증서 발급
# Fluxheim은 guided certificate setup용 acme-init을 포함함
# Let's Encrypt (HTTP-01)
sudo fluxheim acme-init letsencrypt

# Actalis (무료 EAB 지원 issuer)
sudo fluxheim acme-init actalis

# companion tool fluxheim-acme가 다음의 renewal 처리
# container 및 external service-manager deployment
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 개발자 바이너리 전용

컨테이너 이미지

모든 릴리스 이미지 빌드는 GHCR 및 Quay.

  • Wolfi(최소, 강화)
  • Full, load-balancer, cache, proxy, PHP 이미지 프로필
  • Alpine Linux
  • SUSE Micro
  • Debian
  • GHCR 및 Quay에 게시됨
버전 날짜 하이라이트 다운로드
v1.6.0 – v1.6.30 최신 시리즈
2026년 6월 네이티브 런타임 전환 라인: Pingora 이탈 기반, Fluxheim 소유 HTTP/1 및 HTTP/2 경로, native TLS/listener preview, route proxy/static-web 동등성, compression 및 error page, forwarded-header 정책, auth-request, traffic mirroring, rate limit, gRPC 검증, pooled upstream HTTP/2, 강화된 런타임 증거입니다. GitHub에서 모두 보기
v1.5.0 - v1.5.23 2026년 6월 Enterprise load-balancer 및 runtime-ownership line: focused load-balancer binary/image, runtime member와 weight control, managed affinity cookie, stream 및 HTTP boundary work, active/protocol-aware health check, service discovery, background task ownership, cache crate boundary, UDP beta guardrail, origin-protection budget, ARM/macOS asset, 폭넓은 security hardening. GitHub에서 모두 보기
v1.4.0 – v1.4.7 2026년 5월 production proxy parity, 더 풍부한 route policy, traffic mirroring, dynamic upstream discovery, modular runtime/config split, Apple Silicon 및 Linux ARM64 release asset, GeoIP/Geo-Context, config-tester archive, hardened TCP stream proxying을 갖춘 proxy operations line GitHub에서 모두 보기
v1.3.0 – v1.3.7 2026년 5월 PHP-FPM production line, managed php-fpm supervision, config tester와 ACME companion binary, FIPS/ISO validation track, focused cache/proxy profile, security hardening GitHub에서 모두 보기
v1.2.0 – v1.2.6 2026년 5월 route-scoped cache policy, memory/disk/tiered backend, encrypted disk cache, peer fill, range caching, Prometheus, OpenTelemetry export를 갖춘 cache 및 observability baseline GitHub에서 모두 보기
v1.1.x 2026 TLS policy profile, multi-certificate rustls SNI, managed ACME issuance 및 renewal, EAB-capable issuer, file-backed TLS secret, renewal unit을 갖춘 certificate operations line GitHub에서 모두 보기
v1.0.0 2026 vhost routing, route-level static/proxy/redirect action, static file serving, reverse proxying, rustls TLS, admin control-plane, secure header, systemd packaging, rootless container를 갖춘 gateway foundation GitHub
v0.5.0 사전 릴리스 stable 1.x gateway line 이전 첫 public pre-release milestone GitHub

자세한 내용은 변경 기록 의 상세 릴리스 노트를 보세요.

한국어