fatedier/frp · error

invalid http plugin ops, optional values are %v

Error message

invalid http plugin ops, optional values are %v

What it means

Error "invalid http plugin ops, optional values are %v" thrown in fatedier/frp.

Source

Thrown at pkg/config/v1/validation/server.go:60

	}

	if err := validateWebServerConfig(&c.WebServer); err != nil {
		errs = AppendError(errs, err)
	}

	errs = AppendError(errs, ValidatePort(c.BindPort, "bindPort"))
	errs = AppendError(errs, ValidatePort(c.KCPBindPort, "kcpBindPort"))
	errs = AppendError(errs, ValidatePort(c.QUICBindPort, "quicBindPort"))
	errs = AppendError(errs, ValidatePort(c.VhostHTTPPort, "vhostHTTPPort"))
	errs = AppendError(errs, ValidatePort(c.VhostHTTPSPort, "vhostHTTPSPort"))
	errs = AppendError(errs, ValidatePort(c.TCPMuxHTTPConnectPort, "tcpMuxHTTPConnectPort"))
	if c.Transport.MaxPoolCount < 0 {
		errs = AppendError(errs, fmt.Errorf("invalid transport.maxPoolCount, must be non-negative"))
	}

	for _, p := range c.HTTPPlugins {
		if !lo.Every(SupportedHTTPPluginOps, p.Ops) {
			errs = AppendError(errs, fmt.Errorf("invalid http plugin ops, optional values are %v", SupportedHTTPPluginOps))
		}
	}
	return warnings, errs
}

View on GitHub (pinned to 6c8a8d0a97)

Solutions

1. Keep only the supported operations in the http plugin ops list, as listed in the error message.
2. Check the spelling of each entry in the ops field of the HTTP plugin configuration.

When it happens

Trigger: Raised by ValidateServerConfig in pkg/config/v1/validation/server.go when an HTTP plugin's ops list contains an unsupported operation name.

Common situations: A misspelled or unsupported op in an httpPlugins entry (e.g. Login, NewProxy, NewWorkConn, etc.). Fix by using only the operation names listed in the error message.

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