@ailuntz/minibridge

Small lifecycle manager for official frp binaries. It downloads the pinned release for the current platform, verifies SHA-256, validates TOML with frps verify or frpc verify, and owns only the service files it created.

npm install -g @ailuntz/minibridge

sudo ailuntz-minibridge server install
sudo ailuntz-minibridge server apply --config-file ./frps.toml
sudo ailuntz-minibridge server status

sudo ailuntz-minibridge client install --instance relay-a
sudo ailuntz-minibridge client apply --instance relay-a --config-file ./frpc.toml
sudo ailuntz-minibridge client status --instance relay-a

Linux uses systemd, macOS uses a system LaunchDaemon, and Windows clients use a SYSTEM scheduled task. Server mode is intentionally unavailable on Windows. Commands return one JSON object on stdout; diagnostics go to stderr. status reports enabled separately from active; healthy is true only when the managed service is installed, configured, running, and enabled for the next system startup.

stop ends the current FRP process but intentionally leaves startup enabled, so the service can return after a reboot. Use the role's uninstall command for durable removal. A successful stop, configuration replacement, or uninstall confirms the managed process has stopped before destructive cleanup; if the operating-system service state cannot be confirmed, the command fails and retains the managed files for a safe retry. Removing this npm package (or a separate controller app) by itself does not uninstall FRP services on managed hosts.

The package does not bundle a modified FRP binary. It downloads the pinned official release from GitHub and rejects checksum mismatches.

The executable is deliberately named ailuntz-minibridge; Linux already ships an unrelated /usr/sbin/bridge command with iproute2, so this package does not install a conflicting bridge alias.

Licensed under Apache-2.0.

新包只安装 ailuntz-minibridge，可与旧 @ailuntz/bridge 包及其 ailuntz-bridge 命令共存，避免全局命令冲突。现有机器上的 bridge 安装目录、系统服务标识和所有权元数据沿用原格式。可用 MINIBRIDGE_SYSTEM_ROOT 指定测试根目录，也兼容 BRIDGE_SYSTEM_ROOT。