flags.go 9.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217
  1. // Copyright 2023 The frp Authors
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. package config
  15. import (
  16. "fmt"
  17. "strconv"
  18. "github.com/spf13/cobra"
  19. "github.com/fatedier/frp/pkg/config/types"
  20. v1 "github.com/fatedier/frp/pkg/config/v1"
  21. "github.com/fatedier/frp/pkg/config/v1/validation"
  22. )
  23. type BandwidthQuantityFlag struct {
  24. V *types.BandwidthQuantity
  25. }
  26. func (f *BandwidthQuantityFlag) Set(s string) error {
  27. return f.V.UnmarshalString(s)
  28. }
  29. func (f *BandwidthQuantityFlag) String() string {
  30. return f.V.String()
  31. }
  32. func (f *BandwidthQuantityFlag) Type() string {
  33. return "string"
  34. }
  35. func RegisterProxyFlags(cmd *cobra.Command, c v1.ProxyConfigurer) {
  36. registerProxyBaseConfigFlags(cmd, c.GetBaseConfig())
  37. switch cc := c.(type) {
  38. case *v1.TCPProxyConfig:
  39. cmd.Flags().IntVarP(&cc.RemotePort, "remote_port", "r", 0, "remote port")
  40. case *v1.UDPProxyConfig:
  41. cmd.Flags().IntVarP(&cc.RemotePort, "remote_port", "r", 0, "remote port")
  42. case *v1.HTTPProxyConfig:
  43. registerProxyDomainConfigFlags(cmd, &cc.DomainConfig)
  44. cmd.Flags().StringSliceVarP(&cc.Locations, "locations", "", []string{}, "locations")
  45. cmd.Flags().StringVarP(&cc.HTTPUser, "http_user", "", "", "http auth user")
  46. cmd.Flags().StringVarP(&cc.HTTPPassword, "http_pwd", "", "", "http auth password")
  47. cmd.Flags().StringVarP(&cc.HostHeaderRewrite, "host_header_rewrite", "", "", "host header rewrite")
  48. case *v1.HTTPSProxyConfig:
  49. registerProxyDomainConfigFlags(cmd, &cc.DomainConfig)
  50. case *v1.TCPMuxProxyConfig:
  51. registerProxyDomainConfigFlags(cmd, &cc.DomainConfig)
  52. cmd.Flags().StringVarP(&cc.Multiplexer, "mux", "", "", "multiplexer")
  53. cmd.Flags().StringVarP(&cc.HTTPUser, "http_user", "", "", "http auth user")
  54. cmd.Flags().StringVarP(&cc.HTTPPassword, "http_pwd", "", "", "http auth password")
  55. case *v1.STCPProxyConfig:
  56. cmd.Flags().StringVarP(&cc.Secretkey, "sk", "", "", "secret key")
  57. cmd.Flags().StringSliceVarP(&cc.AllowUsers, "allow_users", "", []string{}, "allow visitor users")
  58. case *v1.SUDPProxyConfig:
  59. cmd.Flags().StringVarP(&cc.Secretkey, "sk", "", "", "secret key")
  60. cmd.Flags().StringSliceVarP(&cc.AllowUsers, "allow_users", "", []string{}, "allow visitor users")
  61. case *v1.XTCPProxyConfig:
  62. cmd.Flags().StringVarP(&cc.Secretkey, "sk", "", "", "secret key")
  63. cmd.Flags().StringSliceVarP(&cc.AllowUsers, "allow_users", "", []string{}, "allow visitor users")
  64. }
  65. }
  66. func registerProxyBaseConfigFlags(cmd *cobra.Command, c *v1.ProxyBaseConfig) {
  67. if c == nil {
  68. return
  69. }
  70. cmd.Flags().StringVarP(&c.Name, "proxy_name", "n", "", "proxy name")
  71. cmd.Flags().StringVarP(&c.LocalIP, "local_ip", "i", "127.0.0.1", "local ip")
  72. cmd.Flags().IntVarP(&c.LocalPort, "local_port", "l", 0, "local port")
  73. cmd.Flags().BoolVarP(&c.Transport.UseEncryption, "ue", "", false, "use encryption")
  74. cmd.Flags().BoolVarP(&c.Transport.UseCompression, "uc", "", false, "use compression")
  75. cmd.Flags().StringVarP(&c.Transport.BandwidthLimitMode, "bandwidth_limit_mode", "", types.BandwidthLimitModeClient, "bandwidth limit mode")
  76. cmd.Flags().VarP(&BandwidthQuantityFlag{V: &c.Transport.BandwidthLimit}, "bandwidth_limit", "", "bandwidth limit (e.g. 100KB or 1MB)")
  77. }
  78. func registerProxyDomainConfigFlags(cmd *cobra.Command, c *v1.DomainConfig) {
  79. if c == nil {
  80. return
  81. }
  82. cmd.Flags().StringSliceVarP(&c.CustomDomains, "custom_domain", "d", []string{}, "custom domains")
  83. cmd.Flags().StringVarP(&c.SubDomain, "sd", "", "", "sub domain")
  84. }
  85. func RegisterVisitorFlags(cmd *cobra.Command, c v1.VisitorConfigurer) {
  86. registerVisitorBaseConfigFlags(cmd, c.GetBaseConfig())
  87. // add visitor flags if exist
  88. }
  89. func registerVisitorBaseConfigFlags(cmd *cobra.Command, c *v1.VisitorBaseConfig) {
  90. if c == nil {
  91. return
  92. }
  93. cmd.Flags().StringVarP(&c.Name, "visitor_name", "n", "", "visitor name")
  94. cmd.Flags().BoolVarP(&c.Transport.UseEncryption, "ue", "", false, "use encryption")
  95. cmd.Flags().BoolVarP(&c.Transport.UseCompression, "uc", "", false, "use compression")
  96. cmd.Flags().StringVarP(&c.SecretKey, "sk", "", "", "secret key")
  97. cmd.Flags().StringVarP(&c.ServerName, "server_name", "", "", "server name")
  98. cmd.Flags().StringVarP(&c.BindAddr, "bind_addr", "", "", "bind addr")
  99. cmd.Flags().IntVarP(&c.BindPort, "bind_port", "", 0, "bind port")
  100. }
  101. func RegisterClientCommonConfigFlags(cmd *cobra.Command, c *v1.ClientCommonConfig) {
  102. cmd.PersistentFlags().StringVarP(&c.ServerAddr, "server_addr", "s", "127.0.0.1", "frp server's address")
  103. cmd.PersistentFlags().IntVarP(&c.ServerPort, "server_port", "P", 7000, "frp server's port")
  104. cmd.PersistentFlags().StringVarP(&c.User, "user", "u", "", "user")
  105. cmd.PersistentFlags().StringVarP(&c.Transport.Protocol, "protocol", "p", "tcp",
  106. fmt.Sprintf("optional values are %v", validation.SupportedTransportProtocols))
  107. cmd.PersistentFlags().StringVarP(&c.Auth.Token, "token", "t", "", "auth token")
  108. cmd.PersistentFlags().StringVarP(&c.Log.Level, "log_level", "", "info", "log level")
  109. cmd.PersistentFlags().StringVarP(&c.Log.To, "log_file", "", "console", "console or file path")
  110. cmd.PersistentFlags().Int64VarP(&c.Log.MaxDays, "log_max_days", "", 3, "log file reversed days")
  111. cmd.PersistentFlags().BoolVarP(&c.Log.DisablePrintColor, "disable_log_color", "", false, "disable log color in console")
  112. cmd.PersistentFlags().StringVarP(&c.Transport.TLS.ServerName, "tls_server_name", "", "", "specify the custom server name of tls certificate")
  113. cmd.PersistentFlags().StringVarP(&c.DNSServer, "dns_server", "", "", "specify dns server instead of using system default one")
  114. c.Transport.TLS.Enable = cmd.PersistentFlags().BoolP("tls_enable", "", true, "enable frpc tls")
  115. }
  116. type PortsRangeSliceFlag struct {
  117. V *[]types.PortsRange
  118. }
  119. func (f *PortsRangeSliceFlag) String() string {
  120. if f.V == nil {
  121. return ""
  122. }
  123. return types.PortsRangeSlice(*f.V).String()
  124. }
  125. func (f *PortsRangeSliceFlag) Set(s string) error {
  126. slice, err := types.NewPortsRangeSliceFromString(s)
  127. if err != nil {
  128. return err
  129. }
  130. *f.V = slice
  131. return nil
  132. }
  133. func (f *PortsRangeSliceFlag) Type() string {
  134. return "string"
  135. }
  136. type BoolFuncFlag struct {
  137. TrueFunc func()
  138. FalseFunc func()
  139. v bool
  140. }
  141. func (f *BoolFuncFlag) String() string {
  142. return strconv.FormatBool(f.v)
  143. }
  144. func (f *BoolFuncFlag) Set(s string) error {
  145. f.v = strconv.FormatBool(f.v) == "true"
  146. if !f.v {
  147. if f.FalseFunc != nil {
  148. f.FalseFunc()
  149. }
  150. return nil
  151. }
  152. if f.TrueFunc != nil {
  153. f.TrueFunc()
  154. }
  155. return nil
  156. }
  157. func (f *BoolFuncFlag) Type() string {
  158. return "bool"
  159. }
  160. func RegisterServerConfigFlags(cmd *cobra.Command, c *v1.ServerConfig) {
  161. cmd.PersistentFlags().StringVarP(&c.BindAddr, "bind_addr", "", "0.0.0.0", "bind address")
  162. cmd.PersistentFlags().IntVarP(&c.BindPort, "bind_port", "p", 7000, "bind port")
  163. cmd.PersistentFlags().IntVarP(&c.KCPBindPort, "kcp_bind_port", "", 0, "kcp bind udp port")
  164. cmd.PersistentFlags().StringVarP(&c.ProxyBindAddr, "proxy_bind_addr", "", "0.0.0.0", "proxy bind address")
  165. cmd.PersistentFlags().IntVarP(&c.VhostHTTPPort, "vhost_http_port", "", 0, "vhost http port")
  166. cmd.PersistentFlags().IntVarP(&c.VhostHTTPSPort, "vhost_https_port", "", 0, "vhost https port")
  167. cmd.PersistentFlags().Int64VarP(&c.VhostHTTPTimeout, "vhost_http_timeout", "", 60, "vhost http response header timeout")
  168. cmd.PersistentFlags().StringVarP(&c.WebServer.Addr, "dashboard_addr", "", "0.0.0.0", "dashboard address")
  169. cmd.PersistentFlags().IntVarP(&c.WebServer.Port, "dashboard_port", "", 0, "dashboard port")
  170. cmd.PersistentFlags().StringVarP(&c.WebServer.User, "dashboard_user", "", "admin", "dashboard user")
  171. cmd.PersistentFlags().StringVarP(&c.WebServer.Password, "dashboard_pwd", "", "admin", "dashboard password")
  172. cmd.PersistentFlags().BoolVarP(&c.EnablePrometheus, "enable_prometheus", "", false, "enable prometheus dashboard")
  173. cmd.PersistentFlags().StringVarP(&c.Log.To, "log_file", "", "console", "log file")
  174. cmd.PersistentFlags().StringVarP(&c.Log.Level, "log_level", "", "info", "log level")
  175. cmd.PersistentFlags().Int64VarP(&c.Log.MaxDays, "log_max_days", "", 3, "log max days")
  176. cmd.PersistentFlags().BoolVarP(&c.Log.DisablePrintColor, "disable_log_color", "", false, "disable log color in console")
  177. cmd.PersistentFlags().StringVarP(&c.Auth.Token, "token", "t", "", "auth token")
  178. cmd.PersistentFlags().StringVarP(&c.SubDomainHost, "subdomain_host", "", "", "subdomain host")
  179. cmd.PersistentFlags().VarP(&PortsRangeSliceFlag{V: &c.AllowPorts}, "allow_ports", "", "allow ports")
  180. cmd.PersistentFlags().Int64VarP(&c.MaxPortsPerClient, "max_ports_per_client", "", 0, "max ports per client")
  181. cmd.PersistentFlags().BoolVarP(&c.Transport.TLS.Force, "tls_only", "", false, "frps tls only")
  182. webServerTLS := v1.TLSConfig{}
  183. cmd.PersistentFlags().StringVarP(&webServerTLS.CertFile, "dashboard_tls_cert_file", "", "", "dashboard tls cert file")
  184. cmd.PersistentFlags().StringVarP(&webServerTLS.KeyFile, "dashboard_tls_key_file", "", "", "dashboard tls key file")
  185. cmd.PersistentFlags().VarP(&BoolFuncFlag{
  186. TrueFunc: func() { c.WebServer.TLS = &webServerTLS },
  187. }, "dashboard_tls_mode", "", "if enable dashboard tls mode")
  188. }