fatedier/frp · error

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

Error message

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

What it means

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

Source

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

	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 {
	return nil
}

func validateSUDPProxyConfigForServer(c *v1.SUDPProxyConfig, s *v1.ServerConfig) error {
	return nil
}

// ValidateAnnotations validates that a set of annotations are correctly defined.

View on GitHub (pinned to 6c8a8d0a97)

Solutions

1. Set vhostHTTPSPort in the frps configuration so HTTPS proxies can be served.
2. Use a different proxy type if the server has no vhost HTTPS port.

When it happens

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

Common situations: A proxy of type https is declared while the server's vhostHTTPSPort is 0/unset. Fix by setting vhostHTTPSPort 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/c2d7ffcd93ad5938. Report an issue: GitHub.