# frp | fatedier | Knowledge Base | Instagit

A fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.

GitHub Stars: 105k

Repository: https://github.com/fatedier/frp

---

## Articles

### [How frp's Feature Gate System Enables Experimental Features: A Deep Dive](/fatedier/frp/how-does-frps-feature-gate-system-work-for-enabling-experimental-features)

Learn how frp's thread-safe feature gate system enables runtime experimental features via configuration maps. Keep alpha code inaccessible until explicitly activated.

- Tags: deep-dive
- Published: 2026-02-26

### [How to Secure frp with Token Authentication and Scope Validation](/fatedier/frp/how-to-secure-frp-with-token-authentication-and-scope-validation)

Secure frp with token authentication and scope validation. Learn how frp uses hashed tokens and timestamps for privilege key generation enhancing login heartbeat and connection security.

- Tags: how-to-guide
- Published: 2026-02-26

### [How TCP Port Multiplexing in frp Enables Multiple Services on a Single Port](/fatedier/frp/how-does-tcp-port-multiplexing-tcpmux-allow-multiple-services-on-one-port-in-frp)

Discover how frp's TCP port multiplexing lets you run multiple services on a single port. Learn how tcpmux routes traffic efficiently using HTTP CONNECT requests.

- Tags: internals
- Published: 2026-02-26

### [How to Configure HTTP Header Rewriting and Custom Headers in frp Proxies](/fatedier/frp/how-to-configure-http-header-rewriting-and-custom-headers-in-frp-proxies)

Learn to configure HTTP header rewriting and custom headers in frp proxies using hostHeaderRewrite, requestHeaders.set, and responseHeaders.set for effective request modification.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Set Up Prometheus Monitoring with frp: Enabling the Metrics Endpoint](/fatedier/frp/how-to-set-up-prometheus-monitoring-with-frps-metrics-endpoint)

Learn how to set up Prometheus monitoring with frp. Enable the metrics endpoint in frps.toml and scrape frp server stats for powerful insights.

- Tags: how-to-guide
- Published: 2026-02-26

### [How FRP Hot Reload Works Without Dropping Active Connections](/fatedier/frp/how-does-frps-hot-reloading-work-without-disrupting-active-connections)

Learn how FRP hot reload maintains active connections during zero-downtime configuration updates by diffing changes and incrementally updating proxies.

- Tags: internals
- Published: 2026-02-26

### [How to Configure Custom Subdomain Routing with frp's vhost HTTP Support](/fatedier/frp/how-to-configure-custom-subdomain-routing-with-frps-vhost-http-support)

Configure custom subdomain routing with frp vhost HTTP support Easily set up subdomain routing by adjusting frp server and client configs and resolving DNS to your frps instance

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Use frp's Visitor Mode for P2P Connections with NAT Traversal](/fatedier/frp/how-to-use-frps-visitor-mode-for-p2p-connections-with-nat-traversal)

Learn how to use frp visitor mode for seamless P2P connections with NAT traversal. This guide explains STUN-based NAT hole punching to bypass servers for direct client communication.

- Tags: how-to-guide
- Published: 2026-02-26

### [How frp Virtual Network (VirtualNet) Enables Full Layer-3 Connectivity](/fatedier/frp/how-does-frps-virtual-network-virtualnet-feature-enable-full-network-connectivity)

Discover how frp's Virtual Network provides full Layer-3 connectivity. frp VirtualNet uses a TUN interface and IP routing to enable seamless LAN-like traffic for TCP, UDP, and ICMP.

- Tags: deep-dive
- Published: 2026-02-26

### [How to Configure Port Range Mapping Using Go Template Syntax in frp](/fatedier/frp/how-to-configure-port-range-mapping-using-go-template-syntax-in-frp)

Learn how to configure port range mapping in frp using Go template syntax. Discover functions like parseNumberRange to expand range strings for efficient proxy definitions.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Set Up frp with QUIC Protocol for Modern Transport Optimization](/fatedier/frp/how-to-set-up-frp-with-quic-protocol-for-modern-transport-optimization)

Optimize transport with frp and QUIC. Learn how to easily set up frp with QUIC protocol for faster, more reliable connections. Guide includes server and client configurations.

- Tags: tutorial
- Published: 2026-02-26

### [How frp Handles X-Forwarded-For Headers to Preserve Client IP Addresses](/fatedier/frp/how-does-frp-handle-x-forwarded-for-headers-to-preserve-client-ip-addresses)

Learn how frp handles X-Forwarded-For headers to preserve client IP addresses. frp copies inbound headers and appends current client address for accurate tracking.

- Tags: internals
- Published: 2026-02-26

### [How to Configure Bandwidth Limits per Proxy in frp for Traffic Shaping](/fatedier/frp/how-to-configure-bandwidth-limits-per-proxy-in-frp-for-traffic-shaping)

Learn how to configure frp bandwidth limits per proxy for effective traffic shaping. Control client or server traffic with simple settings for optimal performance.

- Tags: how-to-guide
- Published: 2026-02-26

### [How the frp SSH Tunnel Gateway Works Without frpc](/fatedier/frp/how-does-the-frp-ssh-tunnel-gateway-feature-work-without-requiring-frpc)

Discover how the frp SSH tunnel gateway works without frpc. Learn how frps embeds an SSH server to create virtual frpc clients for seamless tunneling with standard OpenSSH.

- Tags: deep-dive
- Published: 2026-02-26

### [How to Use frp Client Plugins for HTTP Proxy and Static File Serving](/fatedier/frp/how-to-use-frps-client-plugins-for-http-proxy-and-static-file-serving)

Learn how to use frp client plugins for HTTP proxy and static file serving. Tunnel traffic and serve local directories without extra software.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Configure TLS/SSL Encryption with Custom Certificates in frp](/fatedier/frp/how-to-configure-tls-ssl-encryption-with-custom-certificates-in-frp)

Secure frp connections by configuring TLS SSL encryption with custom certificates. Learn to set up certFile keyFile and trustedCaFile for enhanced security.

- Tags: how-to-guide
- Published: 2026-02-26

### [How frp Service Health Checking Works with TCP and HTTP Probes](/fatedier/frp/how-does-frps-service-health-checking-work-with-tcp-and-http-probes)

Discover how frp's service health checking uses TCP and HTTP probes to ensure traffic only goes to healthy local services. Learn about active probing for reliable backend connections.

- Tags: internals
- Published: 2026-02-26

### [How to Implement Load Balancing Across Multiple FRP Proxies Using Groups](/fatedier/frp/how-to-implement-load-balancing-across-multiple-frp-proxies-using-groups)

Implement load balancing across multiple frp proxies with identical group and groupKey configurations. Distribute client connections efficiently using server round-robin logic.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Set Up frp with KCP Protocol for Better Performance on Lossy Networks](/fatedier/frp/how-to-set-up-frp-with-kcp-protocol-for-better-performance-on-lossy-networks)

Boost frp performance on lossy networks by enabling KCP protocol. Learn to configure frp server and client to use UDP transport for improved stability and speed.

- Tags: how-to-guide
- Published: 2026-02-26

### [How FRP Connection Pooling Works and When to Enable It](/fatedier/frp/how-does-frps-connection-pooling-work-and-when-should-it-be-enabled)

Discover how frp connection pooling works to reduce latency. Learn when to enable pool_count and max_pool_count for efficient TCP connections between frp client and server.

- Tags: internals
- Published: 2026-02-26

### [How to Configure OIDC Authentication with frp for Single Sign-On](/fatedier/frp/how-to-configure-oidc-authentication-with-frp-for-single-sign-on)

Secure your frp connections with OIDC authentication for seamless single sign-on. Configure both client and server with your IdP details and audience settings.

- Tags: how-to-guide
- Published: 2026-02-26

### [frp STCP vs XTCP: Understanding Secure and NAT-Traversal Proxy Types](/fatedier/frp/difference-between-frps-stcp-and-xtcp-proxy-types)

Understand the difference between frp STCP and XTCP proxy types. Learn how STCP secures TCP connections and XTCP bypasses NAT using UDP tunnels for reliable remote access.

- Tags: deep-dive
- Published: 2026-02-26

### [How frp TCP Stream Multiplexing Improves Performance and Reduces Latency](/fatedier/frp/how-does-frps-tcp-stream-multiplexing-improve-performance-and-reduce-latency)

Discover how frp TCP stream multiplexing boosts performance and slashes latency by consolidating multiple proxy streams on one connection and reusing established sockets. Learn more!

- Tags: performance
- Published: 2026-02-26