Fluxheim/Документация/Запустить Fluxheim

Запустить Fluxheim

Используйте эту страницу, когда нужно быстро поднять локальный server. Конфигурация остается небольшой и проверяется до обслуживания трафика.

Установка

Перед распаковкой архива проверьте опубликованную контрольную сумму SHA-256.

Linux x86_64

VERSION="1.8.2"
ARCHIVE="fluxheim-${VERSION}-full-x86_64-linux.tar.gz"
BASE_URL="https://github.com/valkyoth/fluxheim/releases/download/v${VERSION}"
curl -fLO "${BASE_URL}/${ARCHIVE}"
echo "1a323dcd5632e25acf2e4463e549f20cdd3d568f445f9d923b1be312ec7f9839  ${ARCHIVE}" | sha256sum -c -
tar -xzf "$ARCHIVE"
sudo install -m 0755 "fluxheim-${VERSION}-full-x86_64-linux/fluxheim" /usr/local/bin/fluxheim

macOS Apple Silicon

VERSION="1.8.2"
ARCHIVE="fluxheim-${VERSION}-full-aarch64-macos.tar.gz"
BASE_URL="https://github.com/valkyoth/fluxheim/releases/download/v${VERSION}"
curl -fLO "${BASE_URL}/${ARCHIVE}"
echo "a725ebcccac259af6640da57ce12e7a3944c5bd0d9e7869d4001196a0c394031  ${ARCHIVE}" | shasum -a 256 -c -
tar -xzf "$ARCHIVE"
install -d "$HOME/.local/bin"
install -m 0755 "fluxheim-${VERSION}-full-aarch64-macos/fluxheim" "$HOME/.local/bin/fluxheim"

Это неподписанная предварительная версия для командной строки. Не отключайте Gatekeeper; подпись Developer ID, нотариальное заверение и интеграция с launchd пока не предоставляются.

Windows x86_64

$Version = "1.8.2"
$Archive = "fluxheim-$Version-full-x86_64-windows.zip"
$BaseUrl = "https://github.com/valkyoth/fluxheim/releases/download/v$Version"
Invoke-WebRequest "$BaseUrl/$Archive" -OutFile $Archive
$Expected = "a72b84720083406f318bf3fc87555eb62fd76dbd1506dbf2cd368e7364726b44"
if ((Get-FileHash $Archive -Algorithm SHA256).Hash.ToLowerInvariant() -cne $Expected) { throw "Archive checksum verification failed" }
Expand-Archive -LiteralPath $Archive -DestinationPath "$env:LOCALAPPDATA\Fluxheim" -Force

Это неподписанная переносимая предварительная версия. Не отключайте защиту SmartScreen и PowerShell; подпись Authenticode и установщик службы Windows пока не предоставляются.

Управляемый надзор за PHP-FPM доступен только в Unix; Windows поддерживает внешние пулы TCP FastCGI.

Минимальный static site

[server]
listen = ["0.0.0.0:8080"]
default_vhost = "site"

[[vhosts]]
name = "site"
hosts = ["example.com"]

[vhosts.web]
root = "/srv/example"
index_files = ["index.html"]
deny_dotfiles = true

Что делает первая config

Параметр	Назначение
`server.listen`	Управляет plain HTTP socket, который открывает Fluxheim.
`server.default_vhost`	Выбирает fallback site, когда host не совпал.
`vhosts.hosts`	Перечисляет hostnames, принимаемые сайтом.
`vhosts.web.root`	Указывает directory, отдаваемую visitors.

Проверить и запустить

fluxheim --config /etc/fluxheim/fluxheim.toml --check-config
fluxheim --config /etc/fluxheim/fluxheim.toml

Используйте config check в deployment scripts. Он ловит unknown fields, unsafe paths, invalid listeners и feature/config mismatches до переключения traffic.

Следующие полезные choices

Добавляйте TLS только после того, как DNS указывает на host.
Add cache only for routes that are safe to share between visitors.
Add metrics only when the listener is private or behind a trusted proxy.