概览
快速了解 Fluxheim 在生产部署中的形态。
模块化反向代理、缓存、负载均衡器和静态站点托管， 使用 Rust 编写。默认安全，内置 TLS、ACME、压缩、Edge 策略、 动态 upstream 发现和安全流量镜像。
include_conf_d = false
[server]
listen = ["0.0.0.0:80"]
tls_listen = ["0.0.0.0:443"]
default_vhost = "fluxheim.eu"
[tls]
enabled = true
backend = "rustls"
profile = "intermediate"
min_protocol = "tls1.2"
alpn = "http1-and-http2"
curve_preferences = ["X25519", "CurveP256", "CurveP384"]
[[vhosts]]
name = "fluxheim.eu"
hosts = ["fluxheim.eu"]
[vhosts.tls]
enabled = true
[vhosts.tls.certificate]
cert_path = "/etc/fluxheim/tls/fluxheim.eu/fullchain.pem"
key_path = "/etc/fluxheim/tls/fluxheim.eu/privkey.pem"
[vhosts.web]
root = "/srv/sites/fluxheim.eu"
index_files = ["index.html"]Fluxheim 以聚焦的模块化构建发布——只启用部署真正需要的内容。
使用 Rust 编写，并固定稳定工具链。按语言设计避免 buffer overflow、use-after-free 和 data race。
Rust-native Edge runtime，支持连接池、upstream retry、主动 health check、HTTP/2、WebSocket upgrade 和 gRPC pass-through。
基于完整生产配置的专用 Wasm 构建，提供受限的策略钩子，并支持 ACME、指标和 OpenTelemetry.
聚焦的 1.5 load-balancer binary 和 image，支持高级选择、本地持久化、health/ejection 策略、有界队列和运行时成员控制。
只编译你需要的内容。提供静态站点、cache edge、反向代理、负载均衡、TCP stream proxy、PHP-FPM、GeoIP、traffic mirroring 以及启用压缩的生产 bundle 等聚焦配置。
rustls-first，并提供受支持的 OpenSSL 与 FIPS/ISO 证明构建路径、客户端证书认证、upstream mTLS、自动 ACME 证书签发和 multi-cert SNI。
支持内存、磁盘、分层和加密缓存 backend，并提供 cache-safe gzip、Zstandard、Brotli 压缩，以及大对象 range caching。
面向 Wolfi、Alpine、SUSE Micro 和 Debian 的 rootless Podman image。原生部署支持 systemd/RPM。启动时不依赖外部资源。
可选 Prometheus metrics listener、OTLP metrics export、trace context propagation 和 OTLP trace export，用于完整 observability。
可选本地 MMDB 查询，用 MaxMind GeoIP2/GeoLite2 或 CIRCL Geo Open 数据集实现国家和 ASN 策略。请求路径中没有远程查询或下载器。
面向原始 L4 TCP 服务，支持专用 stream route、真实 idle/lifetime/byte 限制、upstream TLS/mTLS 控制、weighted/drain/backup 策略和 route-local PROXY protocol。
可选 PHP-FPM FastCGI bridge，适用于 WordPress 风格 front-controller 应用。脚本解析严格，请求处理有界。
支持 trusted-proxy-aware ACL、rate limit、auth subrequest、traffic mirroring、regex rewrite、有界队列、严格配置验证和加固请求处理。
Download a pre-built binary, drop in a config file, and start serving. Native systemd units and container images included.
# 下载并解压完整构建
curl -L https://github.com/valkyoth/fluxheim/releases/download/v1.8.0/fluxheim-1.8.0-full-x86_64-linux.tar.gz \
| tar xz
# 将二进制文件移动到系统路径
sudo mv fluxheim /usr/local/bin/
# 启动前验证配置
fluxheim --check-config --config /etc/fluxheim/fluxheim.toml
# 使用 systemd 运行（包含单元文件）
sudo systemctl enable --now fluxheim# 从 GHCR 或 Quay 拉取
podman pull ghcr.io/valkyoth/fluxheim:v1.8.0
podman pull quay.io/valkyoth/fluxheim:v1.8.0
# 挂载你的配置并以 rootless 方式运行
podman run -d \
--name fluxheim \
-p 8080:8080 -p 8443:8443 \
-v /srv/sites:/srv/sites:ro \
-v ./fluxheim.toml:/etc/fluxheim/fluxheim.toml:ro \
ghcr.io/valkyoth/fluxheim:v1.8.0
# 可用镜像变体：full、load-balancer、cache、proxy、wasm、php# 克隆并构建默认配置
git clone https://github.com/valkyoth/fluxheim
cd fluxheim
# 默认构建（proxy + web + cache + tls-rustls + security）
cargo build --release
# 或构建专用配置
cargo build --release --no-default-features \
--features profile-proxy-edge,acme-client
# 验证配置并运行
cargo run --release -- \
--check-config --config examples/fluxheim.toml为需要现代、可审计栈且不想要隐藏 legacy 行为的运维人员构建。
配置验证严格。含糊或不安全的选项会被拒绝，而不是被静默接受。
可复现构建。每个依赖都被固定。 cargo audit and cargo deny run in CI.
无需 root 运行。内部端口默认 8080/8443。为不同运维策略提供明确 runtime image。
Copyleft 许可证，兼容多种 OSS 许可证。源自欧盟，适合政府和企业使用，法律边界清晰。
快速了解 Fluxheim 在生产部署中的形态。