rustdesk

• rustdesk/rustdesk
  • AGPLv3, Rust
• rustdesk/rustdesk#3565
  • sciter -> flutter_desktop
• 21115: TCP
  • Relay, Session
  • hbbs
• 21116: TCP
  • hbbr
  • 文件、流量中继
  • rendezvous server

Awesome

• kingmo888/rustdesk-api-server
  • Python
  • 基于Django的RustDesk Api&Web Server，除了支持api所有功能，还支持web注册、管理、展示等。
• v5star/rustdesk-api
  • PHP
• lejianwen/rustdesk-api
  • MIT, Go
  • Api Server, web admin ,web client, web client v2
• API Server
  • xiaoyi510/rustdesk-api-server
    • Go 语言实现，可以参考 API
  • lantongxue/rustdesk-api-server-pro
    • AGPLv3, TS, Vue, Go
  • lantongxue/rustdesk-api-server
    • PHP
• danbai225/go-rustdesk-server
  • Golang 实现的 Rustdesk Server

Client

• ID Server
• Relay Server
• API Server
• Key
• hbbs - 中继
• hbbr - 反向
• ~/Library/Preferences/com.carriez.RustDesk
  • RustDesk.toml
  • RustDesk2.toml
  • RustDesk_lan_peers.toml
  • RustDesk_local.toml
  • peers.toml
  • peers/*.toml

rendezvous_server = 'hbbs.example.com:21116'
nat_type = 1
serial = 0

[options]
local-ip-addr = '192.168.1.2'
custom-rendezvous-server = 'hbbs.example.com'
key = 'HBBS-KEY'
relay-server = 'hbbs.example.com'
audio-input = 'MacBook Pro Microphone'

Conf

• ~/Library/Preferences/com.carriez.RustDesk/RustDesk.toml
• ~/Library/Preferences/com.carriez.RustDesk/RustDesk2.toml
• %AppData%\RustDesk\config\RustDesk.toml
• ~/.config/rustdesk/RustDesk.toml

# macOS key
ioreg -rd1 -c IOPlatformExpertDevice | grep IOPlatformUUID

• crypto_secretbox_open_easy

CLI

• /Applications/RustDesk.app/Contents/MacOS/RustDesk

# macOS
alias rustdesk='/Applications/RustDesk.app/Contents/MacOS/RustDesk'

rustdesk --connect 123456789
rustdesk --connect '[email protected]:21116?key=YOUR_KEY'

# macOS Open URL
open 'rustdesk://connect/123?password=xxx&relay=true'

rustdesk://connect/123?password=xxx&relay=true
# /r force relay
123456789/r@public

rustdesk://terminal/<ID>

• rendezvous Server 21116
• 附加参数可以作为 ID query
  • --password PASS
  • --relay
  • --switch_uuid UUID - 内部会话切换参数
• 如果只有 --password，那么是修改本地的 Password

管理

• --get-id
• --set-id
• --password PASS - 设置密码
• --set-unlock-pin PIN
• --config CONFIG
• --import-config RustDesk.toml
• --option KEY VALUE
• --server
• --tray
• --cm - Connection Manager
• --whiteboard
• --update DMG

Service

--service
--install-service
--uninstall-service
--check-hwcodec-config
--terminal-helper
--remove

Terminal

• rust portable_pty
• Windows pwsh.exe, Windows PowerShell, cmd.exe
• 持久化 terminal-persistent=Y

# Guest
rustdesk --option enable-terminal Y
# Host
rustdesk --terminal 123456789

Web

• 官方
  • rustdesk.com/web
  • Web Client V1
  • Web Client V2
• marcpope/cortendesk
  • AGPL-3.0-only, PHP, TypeScript, Laravel, Livewire
  • RustDesk OSS 的自托管管理控制台，提供设备、用户、地址簿管理及浏览器远程桌面客户端。
  • RustDesk 客户端的 API Server 指向控制台 URL；项目独立于 RustDesk 官方。
  • 内置管理主题单独授权，不在 AGPL 范围内，见仓库 NOTICE。
• UNITRONIX/BetterDesk
  • JS Web Client + Go
  • Server
  • Console
  • Web Client
  • API
  • Agent
• MonsieurBiche/rustdesk-web-client
  • Web v1 Fork
  • docker-rustdesk-web-client

rd.example.com:443

/ws/id     -> hbbs:21118
/ws/relay  -> hbbr:21119

• rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq

FAQ

Unsupported Display server, X11 or Wayland expected

• 使用 flatpak 时出现
• rustdesk/rustdesk#670
• 新版本支持了 Wayland
• 不支持情况
  • /etc/gdm3/custom.conf
    • WaylandEnable=false
• 不支持 xwayland
• rustdesk/rustdesk#5949
  • flatpak/xdg-desktop-portal
  • flatpak.github.io/xdg-desktop-portal/docs/doc-org.freedesktop.portal.RemoteDesktop.html

# systemd?
apk add elogind
loginctl

No Display

• 当前没有显示器
• Windows 使用 MSI 安装
  • 使用管理员，允许无用户的情况下运行
• 其他解决方案
  • Headless Ghost HDMI 转接头
  • 虚拟显示驱动