v1.8.0 — 最新穩定版本

記憶體安全
Edge 伺服器
使用 Rust 建構

模組化反向代理、快取、負載均衡器和靜態站點託管, 使用 Rust 編寫。預設安全,內建 TLS、ACME、壓縮、Edge 策略、 動態 upstream 發現和安全流量映像。

Rust Fluxheim 核心 EUPL-1.2 x86_64 Linux ARM64 Linux macOS 開發版 Rootless 容器
/etc/fluxheim/fluxheim.toml
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"]

Edge 所需的一切

Fluxheim 以聚焦的模組化建構發布——只啟用部署真正需要的內容。

從設計上記憶體安全

使用 Rust 編寫,並固定穩定工具鏈。按語言設計避免 buffer overflow、use-after-free 和 data race。

Fluxheim HTTP 核心

Rust-native Edge runtime,支援連線池、upstream retry、主動 health check、HTTP/2、WebSocket upgrade 和 gRPC pass-through。

WASM 擴充套件

以完整生產設定檔為基礎的專用 Wasm 組建,提供受限的政策掛鉤,並支援 ACME、指標與 OpenTelemetry.

負載均衡控制面

聚焦的 1.5 load-balancer binary 和 image,支援高階選擇、本地持久化、health/ejection 策略、有界佇列和執行時成員控制。

模組化建構設定

只編譯你需要的內容。提供靜態站點、cache edge、反向代理、負載均衡、TCP stream proxy、PHP-FPM、GeoIP、traffic mirroring 以及啟用壓縮的生產 bundle 等聚焦設定。

TLS 與託管 ACME

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 與 OpenTelemetry

可選 Prometheus metrics listener、OTLP metrics export、trace context propagation 和 OTLP trace export,用於完整 observability。

GeoIP / Geo-Context 上下文

可選本地 MMDB 查詢,用 MaxMind GeoIP2/GeoLite2 或 CIRCL Geo Open 資料集實現國家和 ASN 策略。請求路徑中沒有遠端查詢或下載器。

TCP 流代理

面向原始 L4 TCP 服務,支援專用 stream route、真實 idle/lifetime/byte 限制、upstream TLS/mTLS 控制、weighted/drain/backup 策略和 route-local PROXY protocol。

PHP-FPM 支援

可選 PHP-FPM FastCGI bridge,適用於 WordPress 風格 front-controller 應用。指令碼解析嚴格,請求處理有界。

Edge 策略控制

支援 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.

bash
# 下載並解壓完整建構
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
bash
# 從 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
bash
# 克隆並建構預設設定
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

為什麼選擇 Fluxheim?

為需要現代、可審計棧且不想要隱藏 legacy 行為的運維人員建構。

沒有隱藏的 legacy 協議 fallback

設定驗證嚴格。含糊或不安全的選項會被拒絕,而不是被靜默接受。

提交的 Cargo.lock

可復現建構。每個依賴都被固定。 cargo audit and cargo deny run in CI.

Rootless 優先容器

無需 root 執行。內部埠預設 8080/8443。為不同運維策略提供明確 runtime image。

EUPL-1.2 開源

Copyleft 授權條款,相容多種 OSS 授權條款。源自歐盟,適合政府和企業使用,法律邊界清晰。

概覽

快速瞭解 Fluxheim 在生產部署中的形態。

Fluxheim 架構概覽
繁體中文