Fixes

• Fixed a configuration-dependent authentication bypass in type = "http" proxies when routeByHTTPUser is used together with httpUser / httpPassword. This affected proxy-style requests. Proxy-style authentication failures now return 407 Proxy Authentication Required.

Features

• Added a built-in store capability for frpc, including persisted store source ([store] path = "..."), Store CRUD admin APIs (/api/store/proxies*, /api/store/visitors*) with runtime reload, and Store management pages in the frpc web dashboard.

Improvements

• Kept proxy/visitor names as raw config names during completion; moved user-prefix handling to explicit wire-level naming logic.
• Added noweb build tag to allow compiling without frontend assets. make build now auto-detects missing web/*/dist directories and skips embedding, so a fresh clone can build without running make web first. The dashboard gracefully returns 404 when assets are not embedded.
• Improved config parsing errors: for .toml files, syntax errors now return immediately with parser position details (line/column when available) instead of falling through to YAML/JSON parsing, and TOML type mismatches report field-level errors without misleading line numbers.
• OIDC auth now caches the access token and refreshes it before expiry, avoiding a new token request on every heartbeat. Falls back to per-request fetch when the provider omits expires_in.

Features

• frpc now supports a clientID option to uniquely identify client instances. The server dashboard displays all connected clients with their online/offline status, connection history, and metadata, making it easier to monitor and manage multiple frpc deployments.
• Redesigned the frp web dashboard with a modern UI, dark mode support, and improved navigation.

Fixes

• Fixed UDP proxy protocol sending header on every packet instead of only the first packet of each session.

Features

• HTTPS proxies now support load balancing groups. Multiple HTTPS proxies can be configured with the same loadBalancer.group and loadBalancer.groupKey to share the same custom domain and distribute traffic across multiple backend services, similar to the existing TCP and HTTP load balancing capabilities.
• Individual frpc proxies and visitors now accept an enabled flag (defaults to true), letting you disable specific entries without relying on the global start list—disabled blocks are skipped when client configs load.
• OIDC authentication now supports a tokenSource field to dynamically obtain tokens from external sources. You can use type = "file" to read a token from a file, or type = "exec" to run an external command (e.g., a cloud CLI or secrets manager) and capture its stdout as the token. The exec type requires the --allow-unsafe=TokenSourceExec CLI flag for security reasons.

Improvements

• VirtualNet: Implemented intelligent reconnection with exponential backoff. When connection errors occur repeatedly, the reconnect interval increases from 60s to 300s (max), reducing unnecessary reconnection attempts. Normal disconnections still reconnect quickly at 10s intervals.

Fixes

• Fix deadlock issue when TCP connection is closed. Previously, sending messages could block forever if the connection handler had already stopped.

Features

• Add NAT traversal configuration options for XTCP proxies and visitors. Support disabling assisted addresses to avoid using slow VPN connections during NAT hole punching.
• Enhanced OIDC client configuration with support for custom TLS certificate verification and proxy settings. Added trustedCaFile, insecureSkipVerify, and proxyURL options for OIDC token endpoint connections.
• Added detailed Prometheus metrics with proxy_counts_detailed metric that includes both proxy type and proxy name labels, enabling monitoring of individual proxy connections instead of just aggregate counts.

Features

• Support tokenSource for loading authentication tokens from files.

Fixes

• Fix SSH tunnel gateway incorrectly binding to proxyBindAddr instead of bindAddr, which caused external connections to fail when proxyBindAddr was set to 127.0.0.1.

Features

• Support for YAML merge functionality (anchors and references with dot-prefixed fields) in strict configuration mode without requiring --strict-config=false parameter.
• Support for proxy protocol in UDP proxies to preserve real client IP addresses.

Bug Fixes

• VirtualNet: Resolved various issues related to connection handling, TUN device management, and stability in the virtual network feature.

Notes

• Feature Gates Introduced: This version introduces a new experimental mechanism called Feature Gates. This allows users to enable or disable specific experimental features before they become generally available. Feature gates can be configured in the featureGates map within the configuration file.
• VirtualNet Feature Gate: The first available feature gate is VirtualNet, which enables the experimental Virtual Network functionality (currently in Alpha stage).

Features

• Virtual Network (VirtualNet): Introduce experimental virtual network capabilities (Alpha). This allows creating a TUN device managed by frp, enabling Layer 3 connectivity between different clients within the frp network. Requires root/admin privileges and is currently supported on Linux and macOS. Configuration is done via the virtualNet section and the virtual_net plugin. Enable with feature gate VirtualNet. Note: As an Alpha feature, configuration details may change in future releases.

Features

• Support metadatas and annotations in frpc proxy commands.

Fixes

• Properly release resources in service.Close() to prevent resource leaks when used as a library.