{"record":{"id":"455b6618b9c0cea7","repo":"fatedier/frp","slug":"tcpmux-with-multiplexer-httpconnect-not-supported","errorCode":null,"errorMessage":"tcpmux with multiplexer httpconnect not supported because this feature is not enabled in server","messagePattern":"tcpmux with multiplexer httpconnect not supported because this feature is not enabled in server","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/config/v1/validation/proxy.go","lineNumber":209,"sourceCode":"\tcase *v1.SUDPProxyConfig:\n\t\treturn validateSUDPProxyConfigForServer(v, s)\n\tdefault:\n\t\treturn errors.New(\"unknown proxy config type\")\n\t}\n}\n\nfunc validateTCPProxyConfigForServer(c *v1.TCPProxyConfig, s *v1.ServerConfig) error {\n\treturn nil\n}\n\nfunc validateUDPProxyConfigForServer(c *v1.UDPProxyConfig, s *v1.ServerConfig) error {\n\treturn nil\n}\n\nfunc validateTCPMuxProxyConfigForServer(c *v1.TCPMuxProxyConfig, s *v1.ServerConfig) error {\n\tif c.Multiplexer == string(v1.TCPMultiplexerHTTPConnect) &&\n\t\ts.TCPMuxHTTPConnectPort == 0 {\n\t\treturn fmt.Errorf(\"tcpmux with multiplexer httpconnect not supported because this feature is not enabled in server\")\n\t}\n\n\treturn validateDomainConfigForServer(&c.DomainConfig, s)\n}\n\nfunc validateHTTPProxyConfigForServer(c *v1.HTTPProxyConfig, s *v1.ServerConfig) error {\n\tif s.VhostHTTPPort == 0 {\n\t\treturn fmt.Errorf(\"type [http] not supported when vhost http port is not set\")\n\t}\n\n\treturn validateDomainConfigForServer(&c.DomainConfig, s)\n}\n\nfunc validateHTTPSProxyConfigForServer(c *v1.HTTPSProxyConfig, s *v1.ServerConfig) error {\n\tif s.VhostHTTPSPort == 0 {\n\t\treturn fmt.Errorf(\"type [https] not supported when vhost https port is not set\")\n\t}\n","sourceCodeStart":191,"sourceCodeEnd":227,"githubUrl":"https://github.com/fatedier/frp/blob/6c8a8d0a97d03b44e9528d30b30c70cb9d61b405/pkg/config/v1/validation/proxy.go#L191-L227","documentation":"Error \"tcpmux with multiplexer httpconnect not supported because this feature is not enabled in server\" thrown in fatedier/frp.","triggerScenarios":"Raised by validateTCPMuxProxyConfigForClient in pkg/config/v1/validation/proxy.go when a tcpmux proxy uses multiplexer httpconnect but the server has not enabled the corresponding feature.","commonSituations":"tcpmux with httpconnect is configured while the server's vhost http/https ports or the feature gate are not enabled. Fix by enabling the feature on the server or using a different proxy type.","solutions":["Set tcpMuxHTTPConnectPort in the frps configuration so the server enables the httpconnect multiplexer.","Change the proxy to not use multiplexer httpconnect, or ask the server administrator to enable the feature."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"6c8a8d0a97d03b44e9528d30b30c70cb9d61b405","analyzedAt":"2026-08-15T06:53:27.215Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}