fatedier/frp · error

not support health check type: %s

Error message

not support health check type: %s

What it means

Error "not support health check type: %s" thrown in fatedier/frp.

Source

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

	if err := ValidateAnnotations(c.Annotations); err != nil {
		return err
	}
	if !slices.Contains([]string{"", "v1", "v2"}, c.Transport.ProxyProtocolVersion) {
		return fmt.Errorf("not support proxy protocol version: %s", c.Transport.ProxyProtocolVersion)
	}
	if !slices.Contains([]string{"client", "server"}, c.Transport.BandwidthLimitMode) {
		return fmt.Errorf("bandwidth limit mode should be client or server")
	}

	if c.Plugin.Type == "" {
		if err := ValidatePort(c.LocalPort, "localPort"); err != nil {
			return fmt.Errorf("localPort: %v", err)
		}
	}

	if !slices.Contains([]string{"", "tcp", "http"}, c.HealthCheck.Type) {
		return fmt.Errorf("not support health check type: %s", c.HealthCheck.Type)
	}
	if c.HealthCheck.Type != "" {
		if c.HealthCheck.Type == "http" &&
			c.HealthCheck.Path == "" {
			return fmt.Errorf("health check path should not be empty")
		}
	}

	if c.Plugin.Type != "" {
		if err := ValidateClientPluginOptions(c.Plugin.ClientPluginOptions); err != nil {
			return fmt.Errorf("plugin %s: %v", c.Plugin.Type, err)
		}
	}
	return nil
}

func validateProxyBaseConfigForServer(c *v1.ProxyBaseConfig) error {
	if err := ValidateAnnotations(c.Annotations); err != nil {

View on GitHub (pinned to 6c8a8d0a97)

Solutions

1. Set healthCheck.type to 'tcp' or 'http', or remove it to disable the health check.
2. Check the spelling of healthCheck.type in the proxy configuration.

When it happens

Trigger: Raised by validateProxyBaseConfigForClient in pkg/config/v1/validation/proxy.go when healthCheck.type is set to an unsupported value (supported types are "tcp" and "http").

Common situations: Typo or unsupported value in healthCheck.type. Fix by setting healthCheck.type to "tcp" or "http", or removing the healthCheck block.

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