Builds & Features

Fluxheim 按 feature set 编译。选择包含部署所需内容的最小构建。

常见构建

Build	用于
full	General production server with web, proxy, cache, TLS, ACME, PHP-FPM, metrics, and tracing.
wasm	基于完整生产配置的专用 Wasm 构建，提供受限的策略钩子，并支持 ACME、指标和 OpenTelemetry.
proxy	Reverse proxy without local static hosting or cache.
cache	Cache edge in front of another origin.
load-balancer	聚焦的 upstream balancing 和 health checks。
php	静态 Web 加 PHP-FPM 应用，例如 WordPress。

Profile 示例

cargo build --release --no-default-features --features profile-full,acme-client,metrics,metrics-otlp,otel-tracing,otel-otlp
cargo build --release --no-default-features --features profile-wasm,acme-client,metrics,metrics-otlp,otel-tracing,otel-otlp
cargo build --release --no-default-features --features profile-cache-edge,acme-client
cargo build --release --no-default-features --features profile-proxy-edge,acme-client
cargo build --release --no-default-features --features profile-web-server,php-fpm,acme-client
cargo build --release --no-default-features --features profile-load-balancer-edge,acme-client

不使用 Pingora 的普通构建

从 1.6.34 开始，普通 Fluxheim 发布配置使用 Fluxheim 自有的原生 runtime，不再编译 Pingora crate。

基于完整生产配置的专用 Wasm 构建，提供受限的策略钩子，并支持 ACME、指标和 OpenTelemetry.

不受支持的原生 runtime 形态仍会通过明确 blocker fail-closed，而不会回退到旧适配器。

Feature 家族

家族	增加什么
`web`	静态文件服务和本地 web routes。
`proxy`	Reverse proxy routes and upstream handling.
`cache`	Shared cache policy, memory and disk tiers, purge, and cache tooling.
`php-fpm`	FastCGI bridge 和可选托管 PHP-FPM supervision。
`metrics`	Prometheus metrics and optional OTLP metrics export.
`wasm`	可选的 WebAssembly 策略运行时环境，具有受限访问权限，支持头部、路由和缓存钩子；默认禁用

不能同时使用的内容

只选择一个 TLS backend。
Privacy 构建不包含 cache、metrics、tracing、OTLP export 或 Wasm 功能。
聚焦的 edge image 会有意省略其职责之外的模块。
Run the feature validator before packaging custom feature strings.

FIPS 后端验证证据

Fluxheim 为 OpenSSL-FIPS 和 rustls/AWS-LC-FIPS 配置分别提供依赖项固定的 CI 验证环境。环境会构建并运行对应配置的二进制文件，测试下游 TLS 和经过证书验证的上游 TLS，拒绝不兼容策略，并记录编译器、加密提供程序、依赖项、二进制文件及镜像的标识。

这是可重现的后端验证证据，并不代表产品整体获得 FIPS 认证。请将验证容器与常规发布镜像分开，并核对证据是否与实际部署的构建完全一致。

阅读 FIPS 证据指南