Client Plugin Configuration

Detailed configuration description for frp client plugins.

HTTPProxyPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “http_proxy”.Yes
httpUserstringHTTP proxy username.No
httpPasswordstringHTTP proxy password.No

Socks5PluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “socks5”.Yes
usernamestringUsername.No
passwordstringPassword.No

StaticFilePluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “static_file”.Yes
localPathstringLocal path where static files are located.Yes
stripPrefixstringRemove specific prefix from user HTTP request Path.No
httpUserstringHTTP Basic Auth username.No
httpPasswordstringHTTP Basic Auth password.No

UnixDomainSocketPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “unix_domain_socket”.Yes
unixPathstringUNIX domain socket address.Yes

HTTP2HTTPSPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “http2https”.Yes
localAddrstringLocal HTTPS service address.Yes
hostHeaderRewritestringReplace Host header.No
requestHeadersHeaderOperationsRequest Header operation configuration.No

HTTPS2HTTPPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “https2http”.Yes
localAddrstringLocal HTTPS service address.Yes
hostHeaderRewritestringReplace Host header.No
requestHeadersHeaderOperationsRequest Header operation configuration.No
enableHTTP2boolWhether to enable HTTP/2, enabled by default.No
crtPathstringTLS certificate file path.No
keyPathstringTLS key file path.No

HTTPS2HTTPSPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “https2https”.Yes
localAddrstringLocal HTTPS service address.Yes
hostHeaderRewritestringReplace Host header.No
requestHeadersHeaderOperationsRequest Header operation configuration.No
enableHTTP2boolWhether to enable HTTP/2, enabled by default.No
crtPathstringTLS certificate file path.No
keyPathstringTLS key file path.No

TLS2RawPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “tls2raw”.Yes
localAddrstringLocal service address.Yes
crtPathstringTLS certificate file path.No
keyPathstringTLS key file path.No

VirtualNetPluginOptions

FieldTypeDescriptionRequired
typestringPlugin type, set to “virtual_net”.Yes
Last modified January 4, 2026: add docs for v0.66 (#106) (191a9bc)