frp/pkg/config/client_common.go

366 lines
12 KiB
Go
Raw Normal View History

2017-03-09 02:03:47 +08:00
// Copyright 2016 fatedier, fatedier@gmail.com
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package config
import (
"fmt"
"os"
"strconv"
"strings"
2017-03-09 02:03:47 +08:00
2020-09-23 13:49:14 +08:00
"github.com/fatedier/frp/pkg/auth"
2020-09-23 13:49:14 +08:00
ini "github.com/vaughan0/go-ini"
2017-03-09 02:03:47 +08:00
)
// ClientCommonConf contains information for a client service. It is
// recommended to use GetDefaultClientConf instead of creating this object
// directly, so that all unspecified fields have reasonable default values.
2017-03-09 02:03:47 +08:00
type ClientCommonConf struct {
2020-05-24 17:48:37 +08:00
auth.ClientConfig
// ServerAddr specifies the address of the server to connect to. By
// default, this value is "0.0.0.0".
ServerAddr string `json:"server_addr"`
// ServerPort specifies the port to connect to the server on. By default,
// this value is 7000.
ServerPort int `json:"server_port"`
2020-05-24 17:48:37 +08:00
// HTTPProxy specifies a proxy address to connect to the server through. If
// this value is "", the server will be connected to directly. By default,
// this value is read from the "http_proxy" environment variable.
2020-05-24 17:48:37 +08:00
HTTPProxy string `json:"http_proxy"`
// LogFile specifies a file where logs will be written to. This value will
// only be used if LogWay is set appropriately. By default, this value is
// "console".
LogFile string `json:"log_file"`
// LogWay specifies the way logging is managed. Valid values are "console"
// or "file". If "console" is used, logs will be printed to stdout. If
// "file" is used, logs will be printed to LogFile. By default, this value
// is "console".
LogWay string `json:"log_way"`
// LogLevel specifies the minimum log level. Valid values are "trace",
// "debug", "info", "warn", and "error". By default, this value is "info".
LogLevel string `json:"log_level"`
// LogMaxDays specifies the maximum number of days to store log information
// before deletion. This is only used if LogWay == "file". By default, this
// value is 0.
LogMaxDays int64 `json:"log_max_days"`
// DisableLogColor disables log colors when LogWay == "console" when set to
// true. By default, this value is false.
DisableLogColor bool `json:"disable_log_color"`
// AdminAddr specifies the address that the admin server binds to. By
// default, this value is "127.0.0.1".
AdminAddr string `json:"admin_addr"`
// AdminPort specifies the port for the admin server to listen on. If this
// value is 0, the admin server will not be started. By default, this value
// is 0.
AdminPort int `json:"admin_port"`
// AdminUser specifies the username that the admin server will use for
// login. By default, this value is "admin".
AdminUser string `json:"admin_user"`
// AdminPwd specifies the password that the admin server will use for
// login. By default, this value is "admin".
AdminPwd string `json:"admin_pwd"`
// AssetsDir specifies the local directory that the admin server will load
// resources from. If this value is "", assets will be loaded from the
// bundled executable using statik. By default, this value is "".
AssetsDir string `json:"assets_dir"`
// PoolCount specifies the number of connections the client will make to
// the server in advance. By default, this value is 0.
PoolCount int `json:"pool_count"`
2020-05-24 17:48:37 +08:00
// TCPMux toggles TCP stream multiplexing. This allows multiple requests
// from a client to share a single TCP connection. If this value is true,
// the server must have TCP multiplexing enabled as well. By default, this
// value is true.
2020-05-24 17:48:37 +08:00
TCPMux bool `json:"tcp_mux"`
// User specifies a prefix for proxy names to distinguish them from other
// clients. If this value is not "", proxy names will automatically be
// changed to "{user}.{proxy_name}". By default, this value is "".
User string `json:"user"`
2020-05-24 17:48:37 +08:00
// DNSServer specifies a DNS server address for FRPC to use. If this value
// is "", the default DNS will be used. By default, this value is "".
2020-05-24 17:48:37 +08:00
DNSServer string `json:"dns_server"`
// LoginFailExit controls whether or not the client should exit after a
// failed login attempt. If false, the client will retry until a login
// attempt succeeds. By default, this value is true.
LoginFailExit bool `json:"login_fail_exit"`
// Start specifies a set of enabled proxies by name. If this set is empty,
// all supplied proxies are enabled. By default, this value is an empty
// set.
Start map[string]struct{} `json:"start"`
// Protocol specifies the protocol to use when interacting with the server.
// Valid values are "tcp", "kcp" and "websocket". By default, this value
// is "tcp".
Protocol string `json:"protocol"`
// TLSEnable specifies whether or not TLS should be used when communicating
// with the server. If "tls_cert_file" and "tls_key_file" are valid,
// client will load the supplied tls configuration.
TLSEnable bool `json:"tls_enable"`
// ClientTLSCertPath specifies the path of the cert file that client will
// load. It only works when "tls_enable" is true and "tls_key_file" is valid.
TLSCertFile string `json:"tls_cert_file"`
// ClientTLSKeyPath specifies the path of the secret key file that client
// will load. It only works when "tls_enable" is true and "tls_cert_file"
// are valid.
TLSKeyFile string `json:"tls_key_file"`
// TrustedCaFile specifies the path of the trusted ca file that will load.
// It only works when "tls_enable" is valid and tls configuration of server
// has been specified.
TLSTrustedCaFile string `json:"tls_trusted_ca_file"`
// HeartBeatInterval specifies at what interval heartbeats are sent to the
// server, in seconds. It is not recommended to change this value. By
// default, this value is 30.
2020-11-23 11:38:21 +08:00
HeartbeatInterval int64 `json:"heartbeat_interval"`
// HeartBeatTimeout specifies the maximum allowed heartbeat response delay
// before the connection is terminated, in seconds. It is not recommended
// to change this value. By default, this value is 90.
2020-11-23 11:38:21 +08:00
HeartbeatTimeout int64 `json:"heartbeat_timeout"`
2019-12-08 21:01:58 +08:00
// Client meta info
Metas map[string]string `json:"metas"`
2020-05-24 17:48:37 +08:00
// UDPPacketSize specifies the udp packet size
// By default, this value is 1500
2020-05-24 17:48:37 +08:00
UDPPacketSize int64 `json:"udp_packet_size"`
2017-03-09 02:03:47 +08:00
}
// GetDefaultClientConf returns a client configuration with default values.
func GetDefaultClientConf() ClientCommonConf {
return ClientCommonConf{
2017-03-09 02:03:47 +08:00
ServerAddr: "0.0.0.0",
ServerPort: 7000,
2020-05-24 17:48:37 +08:00
HTTPProxy: os.Getenv("http_proxy"),
2017-03-09 02:03:47 +08:00
LogFile: "console",
LogWay: "console",
LogLevel: "info",
LogMaxDays: 3,
DisableLogColor: false,
AdminAddr: "127.0.0.1",
AdminPort: 0,
AdminUser: "",
AdminPwd: "",
AssetsDir: "",
2017-03-09 02:03:47 +08:00
PoolCount: 1,
2020-05-24 17:48:37 +08:00
TCPMux: true,
2017-03-09 02:03:47 +08:00
User: "",
2020-05-24 17:48:37 +08:00
DNSServer: "",
LoginFailExit: true,
Start: make(map[string]struct{}),
2017-06-04 19:56:21 +08:00
Protocol: "tcp",
2019-03-11 14:14:31 +08:00
TLSEnable: false,
TLSCertFile: "",
TLSKeyFile: "",
TLSTrustedCaFile: "",
2020-11-23 11:38:21 +08:00
HeartbeatInterval: 30,
HeartbeatTimeout: 90,
2019-12-08 21:01:58 +08:00
Metas: make(map[string]string),
2020-05-24 17:48:37 +08:00
UDPPacketSize: 1500,
2017-03-09 02:03:47 +08:00
}
}
func UnmarshalClientConfFromIni(content string) (cfg ClientCommonConf, err error) {
cfg = GetDefaultClientConf()
2018-04-10 17:46:49 +08:00
conf, err := ini.Load(strings.NewReader(content))
if err != nil {
return ClientCommonConf{}, fmt.Errorf("parse ini conf file error: %v", err)
2018-04-10 17:46:49 +08:00
}
2020-05-24 17:48:37 +08:00
cfg.ClientConfig = auth.UnmarshalClientConfFromIni(conf)
2017-03-09 02:03:47 +08:00
var (
tmpStr string
ok bool
v int64
)
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "server_addr"); ok {
2017-03-09 02:03:47 +08:00
cfg.ServerAddr = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "server_port"); ok {
v, err = strconv.ParseInt(tmpStr, 10, 64)
if err != nil {
err = fmt.Errorf("Parse conf error: invalid server_port")
return
}
cfg.ServerPort = int(v)
2017-03-09 02:03:47 +08:00
}
if tmpStr, ok = conf.Get("common", "disable_log_color"); ok && tmpStr == "true" {
cfg.DisableLogColor = true
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "http_proxy"); ok {
2020-05-24 17:48:37 +08:00
cfg.HTTPProxy = tmpStr
2017-03-09 02:03:47 +08:00
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "log_file"); ok {
2017-03-09 02:03:47 +08:00
cfg.LogFile = tmpStr
if cfg.LogFile == "console" {
cfg.LogWay = "console"
} else {
cfg.LogWay = "file"
}
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "log_level"); ok {
2017-03-09 02:03:47 +08:00
cfg.LogLevel = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "log_max_days"); ok {
if v, err = strconv.ParseInt(tmpStr, 10, 64); err == nil {
cfg.LogMaxDays = v
}
2017-03-09 02:03:47 +08:00
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "admin_addr"); ok {
cfg.AdminAddr = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "admin_port"); ok {
if v, err = strconv.ParseInt(tmpStr, 10, 64); err == nil {
cfg.AdminPort = int(v)
} else {
err = fmt.Errorf("Parse conf error: invalid admin_port")
return
}
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "admin_user"); ok {
cfg.AdminUser = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "admin_pwd"); ok {
cfg.AdminPwd = tmpStr
}
if tmpStr, ok = conf.Get("common", "assets_dir"); ok {
cfg.AssetsDir = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "pool_count"); ok {
if v, err = strconv.ParseInt(tmpStr, 10, 64); err == nil {
2017-03-09 02:03:47 +08:00
cfg.PoolCount = int(v)
}
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "tcp_mux"); ok && tmpStr == "false" {
2020-05-24 17:48:37 +08:00
cfg.TCPMux = false
} else {
2020-05-24 17:48:37 +08:00
cfg.TCPMux = true
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "user"); ok {
2017-03-09 02:03:47 +08:00
cfg.User = tmpStr
}
if tmpStr, ok = conf.Get("common", "dns_server"); ok {
2020-05-24 17:48:37 +08:00
cfg.DNSServer = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "start"); ok {
proxyNames := strings.Split(tmpStr, ",")
for _, name := range proxyNames {
cfg.Start[strings.TrimSpace(name)] = struct{}{}
}
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "login_fail_exit"); ok && tmpStr == "false" {
cfg.LoginFailExit = false
} else {
cfg.LoginFailExit = true
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "protocol"); ok {
2018-08-10 11:43:08 +08:00
// Now it only support tcp and kcp and websocket.
if tmpStr != "tcp" && tmpStr != "kcp" && tmpStr != "websocket" {
err = fmt.Errorf("Parse conf error: invalid protocol")
return
2017-06-04 19:56:21 +08:00
}
cfg.Protocol = tmpStr
}
2019-03-11 14:14:31 +08:00
if tmpStr, ok = conf.Get("common", "tls_enable"); ok && tmpStr == "true" {
cfg.TLSEnable = true
} else {
cfg.TLSEnable = false
}
if tmpStr, ok = conf.Get("common", "tls_cert_file"); ok {
cfg.TLSCertFile = tmpStr
}
if tmpStr, ok := conf.Get("common", "tls_key_file"); ok {
cfg.TLSKeyFile = tmpStr
}
if tmpStr, ok := conf.Get("common", "tls_trusted_ca_file"); ok {
cfg.TLSTrustedCaFile = tmpStr
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "heartbeat_timeout"); ok {
if v, err = strconv.ParseInt(tmpStr, 10, 64); err != nil {
err = fmt.Errorf("Parse conf error: invalid heartbeat_timeout")
2017-03-09 02:03:47 +08:00
return
}
2020-11-23 11:38:21 +08:00
cfg.HeartbeatTimeout = v
2017-03-09 02:03:47 +08:00
}
2018-04-10 17:46:49 +08:00
if tmpStr, ok = conf.Get("common", "heartbeat_interval"); ok {
if v, err = strconv.ParseInt(tmpStr, 10, 64); err != nil {
err = fmt.Errorf("Parse conf error: invalid heartbeat_interval")
2017-03-09 02:03:47 +08:00
return
}
2020-11-23 11:38:21 +08:00
cfg.HeartbeatInterval = v
2017-03-09 02:03:47 +08:00
}
2019-12-08 21:01:58 +08:00
for k, v := range conf.Section("common") {
if strings.HasPrefix(k, "meta_") {
cfg.Metas[strings.TrimPrefix(k, "meta_")] = v
}
}
if tmpStr, ok = conf.Get("common", "udp_packet_size"); ok {
if v, err = strconv.ParseInt(tmpStr, 10, 64); err != nil {
err = fmt.Errorf("Parse conf error: invalid udp_packet_size")
return
}
2020-05-24 17:48:37 +08:00
cfg.UDPPacketSize = v
}
2018-04-10 17:46:49 +08:00
return
}
2017-03-09 02:03:47 +08:00
2018-04-10 17:46:49 +08:00
func (cfg *ClientCommonConf) Check() (err error) {
2020-11-23 11:38:21 +08:00
if cfg.HeartbeatInterval <= 0 {
err = fmt.Errorf("Parse conf error: invalid heartbeat_interval")
2017-03-09 02:03:47 +08:00
return
}
2020-11-23 11:38:21 +08:00
if cfg.HeartbeatTimeout < cfg.HeartbeatInterval {
err = fmt.Errorf("Parse conf error: invalid heartbeat_timeout, heartbeat_timeout is less than heartbeat_interval")
2017-03-09 02:03:47 +08:00
return
}
if cfg.TLSEnable == false {
if cfg.TLSCertFile != "" {
2020-09-18 20:06:09 +08:00
fmt.Println("WARNING! tls_cert_file is invalid when tls_enable is false")
}
if cfg.TLSKeyFile != "" {
2020-09-18 20:06:09 +08:00
fmt.Println("WARNING! tls_key_file is invalid when tls_enable is false")
}
if cfg.TLSTrustedCaFile != "" {
2020-09-18 20:06:09 +08:00
fmt.Println("WARNING! tls_trusted_ca_file is invalid when tls_enable is false")
}
}
2017-03-09 02:03:47 +08:00
return
}