Documentation
¶
Overview ¶
Package clientopts holds the RustDesk client options the panel pushes to every device through the heartbeat "strategy" (config_options), currently the WebRTC ones: ice-servers (STUN/TURN for the WebRTC transport of RustDesk 1.5+) and allow-webrtc-congestion-control. See docs/webrtc.md and docs/research/client-api.md §7.4.
The value is one JSON document in the settings table; the ICE server list is AEAD-sealed because TURN URLs carry credentials. Nothing is pushed until an admin saves the options once; from then on the panel owns these keys on the clients ("" removes a key, which restores the client default).
Index ¶
Constants ¶
const ( OptionICEServers = "ice-servers" OptionWebRTCCongestion = "allow-webrtc-congestion-control" )
RustDesk option names pushed in config_options.
const ( MaxICEServers = 16 MaxICEServerLen = 512 )
Limits of the ICE server list.
const DefaultPublicSTUNSource = "https://raw.githubusercontent.com/pradt2/always-online-stun/master/valid_hosts.txt"
DefaultPublicSTUNSource is the community-maintained repository of verified STUN servers.
const DefaultSTUNPort = 3478
DefaultSTUNPort is the standard UDP port for STUN/TURN.
const DefaultSTUNSPort = 5349
DefaultSTUNSPort is the standard TLS port for STUNS/TURNS.
const SettingKey = "client.options"
SettingKey is the settings row holding the options.
Variables ¶
var CuratedFallbackSTUNs = []string{
"stun:stun.cloudflare.com:3478",
"stun:stun.l.google.com:19302",
"stun:stun1.l.google.com:19302",
"stun:stun2.l.google.com:19302",
"stun:stun.qq.com:3478",
"stun:stun.syncthing.net:3478",
"stun:stun.miwifi.com:3478",
"stun:stun.nextcloud.com:443",
"stun:stun.sipgate.net:3478",
"stun:stun.framasoft.org:3478",
"stun:stun.freeswitch.org:3478",
"stun:stun.voip.blackberry.com:3478",
}
CuratedFallbackSTUNs provides high-availability worldwide STUN servers when remote fetch is unavailable.
var ErrInvalidICEServer = errors.New("invalid ICE server")
ErrInvalidICEServer is wrapped by NormalizeICEServers' errors.
var Presets = []Preset{
{
ID: "global",
Servers: "stun:stun.cloudflare.com:3478\n" +
"stun:stun.l.google.com:19302\n" +
"stun:stun1.l.google.com:19302",
},
{
ID: "ru",
Servers: "stun:stun.cloudflare.com:3478\n" +
"stun:stun.qq.com:3478\n" +
"stun:stun.syncthing.net:3478",
},
{
ID: "cloudflare",
Servers: "stun:stun.cloudflare.com:3478",
},
{
ID: "google",
Servers: "stun:stun.l.google.com:19302\n" +
"stun:stun1.l.google.com:19302",
},
{
ID: "default",
Servers: "",
},
}
Built-in presets for WebRTC ICE servers.
Functions ¶
func ConfigOptions ¶
ConfigOptions is the config_options map pushed to clients. Every managed key is present; "" removes it on the client.
func NormalizeICEServers ¶
NormalizeICEServers validates a comma- or newline-separated ICE server list the way RustDesk parses it (hbb_common webrtc.rs get_ice_server_from_url) and returns it comma-joined. TURN URLs without credentials are rejected because the client drops them silently.
Types ¶
type Options ¶
type Options struct {
// ICEServers is a comma-separated list of stun:/stuns:/turn:/turns: URLs;
// TURN entries must carry credentials (turn://user:pass@host:port). ""
// removes the option from clients (they use RustDesk's default STUN).
ICEServers string
// WebRTCCongestion sets allow-webrtc-congestion-control; nil removes it.
WebRTCCongestion *bool
// ModifiedAt (unix ms) is the strategy version clients echo back.
ModifiedAt int64
UpdatedAt time.Time
}
Options are the client options as the admin API sees them.
type ProbeResult ¶ added in v0.5.7
type ProbeResult struct {
Server string `json:"server"`
Scheme string `json:"scheme"`
Reachable bool `json:"reachable"`
RTTMs float64 `json:"rtt_ms,omitempty"`
Error string `json:"error,omitempty"`
}
ProbeResult holds reachability and latency for one ICE server.
func ProbeICEServers ¶ added in v0.5.7
func ProbeICEServers(ctx context.Context, iceServers string, allowPrivate bool) []ProbeResult
ProbeICEServers probes every server in iceServers in parallel (max MaxICEServers).
type PublicSTUNResult ¶ added in v0.5.9
type PublicSTUNResult struct {
Source string `json:"source"`
FetchedCount int `json:"fetched_count"`
WorkingCount int `json:"working_count"`
Items []ProbeResult `json:"items"`
}
PublicSTUNResult contains discovered, probed, and ranked STUN servers.
func FetchPublicSTUN ¶ added in v0.5.9
func FetchPublicSTUN(ctx context.Context, sourceURL string, limit int, allowPrivate bool) (*PublicSTUNResult, error)
FetchPublicSTUN downloads a list of public STUN servers, tests reachability concurrently, and returns the fastest working servers sorted by latency.
type Service ¶
type Service struct {
// contains filtered or unexported fields
}
Service reads and writes the options and serves them as a heartbeat strategy (clientapi.StrategyProvider). The decoded value is cached; Set refreshes it, so the heartbeat path costs no database read.
func (*Service) Set ¶
func (s *Service) Set(ctx context.Context, iceServers string, congestion *bool, actor *int64) (*Options, error)
Set validates and stores the options (a new strategy version) and returns them as saved. actor may be nil.
func (*Service) StrategyFor ¶
StrategyFor implements clientapi.StrategyProvider: resolves the effective MDM strategy for d (device -> group -> default) and merges global client options (such as ICE servers).
Source Files