fatedier/frp · error

type [http] not supported when vhost http port is not set

Error message

type [http] not supported when vhost http port is not set

What it means

Error "type [http] not supported when vhost http port is not set" thrown in fatedier/frp.

Source

Thrown at pkg/config/v1/validation/proxy.go:217

	return nil
}

func validateUDPProxyConfigForServer(c *v1.UDPProxyConfig, s *v1.ServerConfig) error {
	return nil
}

func validateTCPMuxProxyConfigForServer(c *v1.TCPMuxProxyConfig, s *v1.ServerConfig) error {
	if c.Multiplexer == string(v1.TCPMultiplexerHTTPConnect) &&
		s.TCPMuxHTTPConnectPort == 0 {
		return fmt.Errorf("tcpmux with multiplexer httpconnect not supported because this feature is not enabled in server")
	}

	return validateDomainConfigForServer(&c.DomainConfig, s)
}

func validateHTTPProxyConfigForServer(c *v1.HTTPProxyConfig, s *v1.ServerConfig) error {
	if s.VhostHTTPPort == 0 {
		return fmt.Errorf("type [http] not supported when vhost http port is not set")
	}

	return validateDomainConfigForServer(&c.DomainConfig, s)
}

func validateHTTPSProxyConfigForServer(c *v1.HTTPSProxyConfig, s *v1.ServerConfig) error {
	if s.VhostHTTPSPort == 0 {
		return fmt.Errorf("type [https] not supported when vhost https port is not set")
	}

	return validateDomainConfigForServer(&c.DomainConfig, s)
}

func validateSTCPProxyConfigForServer(c *v1.STCPProxyConfig, s *v1.ServerConfig) error {
	return nil
}

func validateXTCPProxyConfigForServer(c *v1.XTCPProxyConfig, s *v1.ServerConfig) error {

View on GitHub (pinned to 6c8a8d0a97)

Solutions

  1. Set vhostHTTPPort in the frps configuration so HTTP proxies can be served.
  2. Use a different proxy type (for example tcp) if the server has no vhost HTTP port.

When it happens

Trigger: Raised by validateProxyConfigForServer in pkg/config/v1/validation/proxy.go when an HTTP proxy is configured but vhostHTTPPort is not set on the server.

Common situations: A proxy of type http is declared while the server's vhostHTTPPort is 0/unset. Fix by setting vhostHTTPPort in the server config or using a tcp proxy instead.


AI-assisted analysis of fatedier/frp@6c8a8d0a97 (2026-08-15). Data as JSON: /api/errors/8135cb3f34aa1287. Report an issue: GitHub.