Starstruk Logo MarkStarstruk

v0.66.0

fatedier/frpv0.66.0Jan 4, 2026by fatedier

AI Summary

This release adds HTTPS load balancing group support, enables granular proxy control with per-proxy enabled flags, and introduces flexible OIDC token sourcing from files or external commands. VirtualNet now includes intelligent reconnection with exponential backoff.

Key Highlights

  • HTTPS proxies now support load balancing groups
  • Individual proxies and visitors accept enabled flag for granular control
  • OIDC authentication supports tokenSource (file/exec types)
  • VirtualNet implements intelligent reconnection with exponential backoff (60s to 300s)
  • Fixed deadlock issue when TCP connection is closed

New Features

  • HTTPS proxies support load balancing groups with custom domain distribution
  • Per-proxy enabled flag for disabling specific entries without global start list
  • OIDC tokenSource supporting file and exec types for dynamic token acquisition
  • VirtualNet intelligent reconnection with exponential backoff

Full Release Notes

## 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.