settings

Documentation

Index

• type AdminAPIConfig
• type Config
  • func LoadStatic(configDir string) (*Config, error)
  • func (s *Config) CleanAdminPassword()
  • func (s *Config) ConfigDir() string
  • func (s *Config) Flush() error
  • func (s *Config) GetNetworkAccessPolicy() NetworkAccessPolicy
  • func (s *Config) GetPublicAPIConfig() *PublicAPIConfig
  • func (s *Config) InitialSetupRequired() bool
  • func (s *Config) PublicURL() string
  • func (s *Config) SetAdminPassword(plain string) error
  • func (s *Config) SetPublicIP(newIP xnet.IP) error
  • func (s *Config) VerifyAdminPassword(given string) error
• type HttpConfig
• type NetworkAccessPolicy
• type PublicAPIConfig

Types

type AdminAPIConfig

type AdminAPIConfig struct {
	PasswordHash  string `yaml:"password_hash"`
	StaticRoot    string `yaml:"static_root" valid:"path"`
	TokenLifetime int    `yaml:"token_lifetime" valid:"natural"`
}

type Config

type Config struct {
	InstanceID string           `yaml:"instance_id"`
	LogLevel   string           `yaml:"log_level"`
	SQLitePath string           `yaml:"sqlite_path" valid:"path,required"`
	Rapidoc    bool             `yaml:"rapidoc"`
	Wireguard  wireguard.Config `yaml:"wireguard"`
	HTTP       HttpConfig       `yaml:"http"`

	// optional configuration
	ExternalStats      *extstat.Config         `yaml:"external_stats,omitempty"`
	NetworkPolicy      *NetworkAccessPolicy    `yaml:"network,omitempty"`
	SSL                *xhttp.SSLConfig        `yaml:"ssl,omitempty"`
	Domain             *xhttp.DomainConfig     `yaml:"domain,omitempty"`
	AdminAPI           *AdminAPIConfig         `yaml:"admin_api,omitempty"`
	PublicAPI          *PublicAPIConfig        `yaml:"public_api,omitempty"`
	GRPC               *grpc.Config            `yaml:"grpc,omitempty"`
	Sentry             *sentry.Config          `yaml:"sentry,omitempty"`
	EventLog           *eventlog.StorageConfig `yaml:"event_log,omitempty"`
	ManagementKeystore string                  `yaml:"management_keystore,omitempty" valid:"path"`
	DNSFilter          *xdns.Config            `yaml:"dns_filter"`
	// contains filtered or unexported fields
}

func LoadStatic

func LoadStatic(configDir string) (*Config, error)

func (*Config) CleanAdminPassword

func (s *Config) CleanAdminPassword()

func (*Config) ConfigDir

func (s *Config) ConfigDir() string

func (*Config) Flush

func (s *Config) Flush() error

func (*Config) GetNetworkAccessPolicy

func (s *Config) GetNetworkAccessPolicy() NetworkAccessPolicy

func (*Config) GetPublicAPIConfig

func (s *Config) GetPublicAPIConfig() *PublicAPIConfig

func (*Config) InitialSetupRequired

func (s *Config) InitialSetupRequired() bool

func (*Config) PublicURL

func (s *Config) PublicURL() string

PublicURL returns a URL of this node. Use SSL configuration if given, otherwise it returns http://wireguard_ip:http_listen_port

func (*Config) SetAdminPassword

func (s *Config) SetAdminPassword(plain string) error

func (*Config) SetPublicIP

func (s *Config) SetPublicIP(newIP xnet.IP) error

func (*Config) VerifyAdminPassword

func (s *Config) VerifyAdminPassword(given string) error

type HttpConfig

type HttpConfig struct {
	// ListenAddr for HTTP server, default: ":80"
	ListenAddr string `yaml:"listen_addr" valid:"listen_addr,required"`
	// CORS enables corresponding middleware for the local development
	CORS bool `yaml:"cors"`
	// Enable prometheus metrics on "/metrics" path
	Prometheus bool `yaml:"prometheus"`
}

type NetworkAccessPolicy

type NetworkAccessPolicy struct {
	Access    ipam.NetworkAccess      `yaml:"access"`
	RateLimit *ipam.RateLimiterConfig `yaml:"rate_limit,omitempty"`
}

type PublicAPIConfig

type PublicAPIConfig struct {
	PingInterval int `yaml:"ping_interval" valid:"natural"`
	PeerTTL      int `yaml:"connection_timeout" valid:"natural"`
}