RustDesk客户端高级设置教程

本教程将详细介绍RustDesk自定义客户端中的所有高级设置，包括设置的权限级别、安全设置、常规设置和显示设置等。

一、RustDesk设置的权限级别

RustDesk共有四种类型的设置：

1、覆盖设置，位于“Web 控制台→自定义客户端”中

2、“Web 控制台→自定义客户端”中的默认设置

3、用户设置，位于 RustDesk 客户端中

4、策略设置，位于“Web 控制台→策略”中

这些设置的权限层次结构如下：Override > Strategy > User > Default。

二、RustDesk安全设置

1、访问模式

设置传入连接的访问模式（权限）。

设置路径：

桌面设置→安全性→权限

Install required	Values	Default	Example
N	custom, full, view	custom	`access-mode=custom`

2、启用键盘

为传入连接启用键盘/鼠标输入。

设置路径：

桌面设置→“安全”→权限→启用键盘

Install required	Values	Default	Example
N	Y, N	Y	`enable-keyboard=Y`

3、启用剪贴板

为传入连接启用复制和粘贴。

设置路径：

桌面设置→“启用剪贴板”→“安全→权限”

Install required	Values	Default	Example
N	Y, N	Y	`enable-clipboard=Y`

4、启用文件传输

为传入连接启用文件复制和粘贴或文件传输（会话）。

设置路径：

桌面设置→“安全”→“权限”→“启用文件传输”

Install required	Values	Default	Example
N	Y, N	Y	`enable-file-transfer=Y`

5、启用音频

启用音频录制并传输到对等。

设置路径：

桌面设置→“安全”→权限→“启用音频”

Install required	Values	Default	Example
N	Y, N	Y	`enable-audio=Y`

6、启用隧道

启用 TCP 隧道。

设置路径：

桌面设置→启用 TCP 隧道→安全→权限

Install required	Values	Default	Example
N	Y, N	Y	`enable-tunnel=Y`

7、启用远程重启

启用控制端的重新启动。

设置路径：

桌面设置→“安全”→权限→“启用远程重启”

Install required	Values	Default	Example
N	Y, N	Y	`enable-remote-restart=Y`

8、启用记录会话

启用要录制的会话。

设置路径：

桌面设置→“安全”→权限→启用录制会话“共享屏幕”→“启用录制会话”→设置

Install required	Values	Default	Example
N	Y, N	Y	`enable-record-session=Y`

9、启用阻止输入

启用控制端以阻止其他用户的输入。

设置路径：

桌面设置→“安全”→“权限”→“启用阻止用户输入”（仅限 Windows）

Install required	Values	Default	Example
N	Y, N	Y	`enable-block-input=Y`

10、允许远程配置修改

允许控制端更改受控 RustDesk UI 中的设置。

设置路径：

桌面设置→安全→权限→启用远程配置修改

Install required	Values	Default	Example
N	Y, N	Y	`allow-remote-config-modification=Y`

11、启用LAN发现

允许局域网内的对等方发现我。

在 LAN 发现后，如果本地支持，WOL（Wake on LAN）可以工作。

设置路径：

桌面设置 → 安全 → 安全→拒绝 LAN 发现“共享”屏幕→“→”拒绝 LAN 发现“的设置

Install required	Values	Default	Example
Y	Y, N	Y	`enable-lan-discovery=Y`

12、直接服务器

启用直接 IP 访问。

设置路径：

桌面设置→“安全”→“安全→启用直接 IP 访问设置→共享屏幕→直接 IP 访问

Install required	Values	Default	Example
Y	Y, N	Y	`enable-lan-discovery=Y`

13、直接访问端口

直接 IP 访问端口。

设置路径：

桌面设置→安全→安全→直接 IP 访问端口（显示是否选中“启用直接 IP 访问”）设置→共享屏幕→直接 IP 访问

Install required	Values	Default	Example
N		21118	`direct-access-port=21118`

14、白名单

使用 IP 白名单。

设置路径：

桌面设置→安全→安全→使用 IP 白名单“共享”屏幕→“设置→使用 IP 白名单

Install required	Values	Default	Example
N	`,` or `<ip1>,<ip2>,<ip3>`	`,` means no filter	`whitelist=,`

15、自动断开连接和超时

在用户处于非活动状态一段时间后自动关闭传入会话。

设置路径：

桌面设置→安全→安全→在用户不活动时自动关闭传入会话“共享”屏幕→→设置在用户不活动时自动关闭传入会话

Option	Install required	Values	Default	Example
allow-auto-disconnect	N	Y, N	N	`allow-auto-disconnect=Y`
auto-disconnect-timeout	N	Timeout in minutes	10	`auto-disconnect-timeout=10`

16、仅在窗口打开时允许连接

仅当 RustDesk 窗口打开时才允许连接。

设置路径：

桌面设置→安全→安全→仅当 RustDesk 窗口打开时才允许连接

Install required	Values	Default	Example
Y	Y, N	N	`allow-only-conn-window-open=N`

18、批准模式

通过密码或手动单击接受传入连接。

设置路径：

桌面“安全→密码→下拉框→设置共享屏幕→右上角的下拉菜单

Install required	Values	Default	Example
N	password, click, password-click	password-click	`approve-mode=password-click`

18、代理网址

代理 URL目前支持 http 和 httpsocks5。

设置路径：

桌面设置→网络→代理→Socks5/Http（s）代理

Option	Install required	Values	Default	Example
proxy-username	N			`proxy-username=user`
proxy-password	N			`proxy-password=pass`

三、RustDesk常规设置

1、主题

功能：控制RustDesk客户端的UI主题。

设置路径：

桌面设置→常规→主题
移动设置→设置→主题

Install required	Values	Default	Example
N	dark, light, system	system	`theme=system`

2、语言

功能：控制RustDesk客户端的语言。

设置路径：
桌面设置→常规→语言
移动设置→设置→语言

Install required	Values	Default	Example
N	default, ar, bg, …	default	`lang=default`

3、允许自动录制传入

功能：自动记录传入的会话。

设置路径：

桌面设置→常规→录制→自动录制传入会话
移动设置→录制→自动录制传入会话

Install required	Values	Default	Example
N	Y, N	N	`allow-auto-record-incoming=N`

4、视频保存目录

功能：设置录制视频的保存目录。

设置路径：

桌面设置→常规→录制→视频保存目录
移动设置→录制
默认路径：
MacOS: ~/Movies/app_name
Linux: ~/Videos/app_name
Windows: %USERPROFILE%\Videos\app_name
Android: /storage/emulated/0/app_name/screenrecords

5、启用确认关闭多个选项卡

功能：在关闭所有远程选项卡之前显示确认对话框。

设置路径：桌面设置→常规→其他→关闭多个选项卡前确认

Install required	Values	Default	Example
N	Y, N	Y	`enable-confirm-closing-tabs=Y`

6、启用自适应比特率 (ABR)

功能：启用自适应比特率，优化流传输。

设置路径：

桌面设置→常规→其他→自适应比特率
移动设置→共享屏幕→自适应比特率（beta）

Install required	Values	Default	Example
N	Y, N	Y	`enable-abr=Y`

7、允许删除墙纸

功能：在传入会话期间移除墙纸。

设置路径：桌面设置→常规→其他→在传入会话期间删除墙纸

Install required	Values	Default	Example
N	Y, N	N	`allow-remove-wallpaper=N`

8、在新标签页中打开新连接

功能：控制是使用新标签页还是新窗口打开新连接。

设置路径：桌面设置→常规→其他→在新标签页中打开连接

Install required	Values	Default	Example
N	Y, N	Y	`enable-open-new-connections-in-tabs=Y`

9、始终使用软件渲染

功能：强制使用软件渲染。

设置路径：桌面设置→常规→其他→始终使用软件渲染

Install required	Values	Default	Example
N	Y, N	N	`allow-always-software-render=N`

10、允许Linux无头模式

功能：如果没有显示器，则允许传入连接。

设置路径：桌面设置→常规→其他→允许Linux无头

Install required	Values	Default	Example
Y	Y, N	N	`allow-linux-headless=N`

11、启用硬件编码

功能：启用硬件编码以优化性能。

设置路径：

桌面设置→硬件编解码器

Install required	Values	Default	Example
N	Y, N	Y	`enable-hwcodec=Y`

12、对等卡UI类型

功能：控制对等卡的视图样式。

设置路径：桌面主页→对等面板→右上角网格图标

Install required	Values	Default	Example
N	0, 1, 2	0	`peer-card-ui-type=0`

13、对等排序

功能：控制对等卡的排序方式。

设置路径：桌面主页→对等面板→右上角排序图标

Install required	Values	Default	Example
N	Remote ID, Remote Host, Username	Remote ID	`peer-sorting=Remote ID`

14、同步地址簿与最近的会话

功能：控制是否将通讯簿与最近的会话同步。

设置路径：桌面首页→对等面板→通讯录→标签→下拉菜单→与最近的会话同步

Install required	Values	Default	Example
N	Y, N	N	`sync-ab-with-recent-sessions=N`

15、同步地址簿标签

功能：控制是否对通讯簿标签进行排序。

设置路径：桌面首页→对等面板→通讯录→标签→下拉菜单→对标签进行排序

Install required	Values	Default	Example
N	Y, N	N	`sync-ab-tags=N`

16、按标签交叉点筛选地址簿

功能：根据标签交叉点筛选通讯录。

设置路径：桌面首页→对等面板→通讯录→标签→下拉菜单→按交叉点筛选

Install required	Values	Default	Example
N	Y, N	N	`filter-ab-by-intersection=N`

四、RustDesk显示设置

1、仅供查看

功能：此选项将在第一次连接后为每个对等体设置“仅查看”模式。

设置路径：

桌面设置→显示→查看模式→其他默认选项
移动设置→显示设置→其他默认选项→视图模式

Install required	Values	Default	Example
N	Y, N	N	`view-only=Y`

2、显示监视器工具栏

功能：控制是否在工具栏中显示监视器选项。

设置路径：桌面设置→显示→其他默认选项→显示监视器工具栏

Install required	Values	Default	Example
N	Y, N	N	`show-monitors-toolbar=Y`

3、折叠工具栏

功能：控制连接后远程工具栏是否自动折叠。

设置路径：桌面设置→显示→折叠工具栏→其他默认选项

Install required	Values	Default	Example
N	Y, N	N	`collapse-toolbar=Y`

4、显示远程光标

功能：控制是否在远程控制页面中显示远程光标。

设置路径：

桌面设置→显示→其他默认选项→显示远程光标
移动设置→显示设置→其他默认选项→显示远程光标

Install required	Values	Default	Example
N	Y, N	N	`show-remote-cursor=N`

5、跟随远程光标

功能：控制是否自动跟随远程光标的移动。

设置路径：

桌面设置→显示→其他默认选项→跟随远程光标
移动设置→显示设置→其他默认选项→跟随远程光标

Install required	Values	Default	Example
N	Y, N	N	`follow-remote-cursor=Y`

6、关注远程窗口焦点

功能：控制是否自动跟随远程窗口的焦点切换。

设置路径：

桌面设置→显示→其他默认选项→关注远程窗口焦点
移动设置→显示设置→其他默认选项→关注远程窗口焦点

Install required	Values	Default	Example
N	Y, N	N	`follow-remote-window=Y`

7、缩放光标

功能：控制光标是否根据当前图像比例进行缩放。

设置路径：桌面设置→显示→缩放光标→其他默认选项

Install required	Values	Default	Example
N	Y, N	N	`zoom-cursor=Y`

8、显示质量监视器

功能：控制是否显示连接的质量监视器。

设置路径：

桌面设置→显示→其他默认选项→显示质量监视器
移动设置→显示设置→其他默认选项→显示质量监视器

Install required	Values	Default	Example
N	Y, N	N	`show-quality-monitor=Y`

9、禁用音频

功能：控制是否在连接中播放声音。

设置路径：

桌面设置→显示→静音→其他默认选项
移动设置→显示设置→静音→其他默认选项

Install required	Values	Default	Example
N	Y, N	N	`disable-audio=Y`

10、启用文件复制粘贴

功能：控制是否在连接中启用文件的复制与粘贴功能（仅限Windows）。

设置路径：桌面设置→显示→其他默认选项→启用文件复制和粘贴

Install required	Values	Default	Example
N	Y, N	N	`enable-file-copy-paste=Y`

11、禁用剪贴板

功能：控制是否启用文本的复制与粘贴功能。

设置路径：

桌面设置→显示→其他默认选项→禁用剪贴板
移动设置→显示设置→其他默认选项→禁用剪贴板

Install required	Values	Default	Example
N	Y, N	N	`disable-clipboard=Y`

12、会话结束后锁定

功能：控制是否在会话结束后锁定远程计算机。

设置路径：

桌面设置→显示→其他默认选项→会话结束后锁定
移动设置→显示设置→其他默认选项→会话结束后锁定

Install required	Values	Default	Example
N	Y, N	N	`lock-after-session-end=Y`

13、隐私模式

功能：控制连接后是否使用隐私模式。

设置路径：

桌面设置→显示→隐私模式→其他默认选项
移动设置→显示设置→其他默认选项→隐私模式

Install required	Values	Default	Example
N	Y, N	N	`privacy-mode=Y`

14、触摸模式

功能：控制是使用触摸模式还是鼠标模式。

设置路径：移动设置→显示设置→触摸模式→其他默认选项

Install required	Values	Default	Example
N	Y, N	N	`touch-mode=Y`

15、i444（真彩色）

功能：控制是否使用真彩色（4:4:4）模式。

设置路径：

桌面设置→显示→其他默认选项→真彩色（4:4:4）
移动设置→显示设置→其他默认选项→真彩色（4:4:4）

Install required	Values	Default	Example
N	Y, N	N	`i444=Y`

16、反向鼠标滚轮

功能：控制是否反转鼠标滚轮的方向。

设置路径：

桌面设置→显示→其他默认选项→鼠标滚轮倒转
移动设置→显示设置→其他默认选项→鼠标滚轮倒转

Install required	Values	Default	Example
N	Y, N	N	`reverse-mouse-wheel=Y`

17、交换鼠标左右键

功能：控制是否交换鼠标左右键的功能。

设置路径：

桌面设置→显示→其他默认选项→交换鼠标左右按钮
移动设置→显示设置→其他默认选项→交换鼠标左右按钮

Install required	Values	Default	Example
N	Y, N	N	`swap-left-right-mouse=Y`

18、显示为单个窗口

功能：控制是否将多个显示器内容显示为一个单独的窗口。
设置路径：桌面设置→显示→其他默认选项→显示为单个窗口 (预览 PR 5945)

Install required	Values	Default	Example
N	Y, N	N	`displays-as-individual-windows=Y`

19、使用所有显示器进行远程会话

功能：控制是否将本地所有显示器用于远程会话。

设置路径：桌面设置→显示→其他默认选项→将我的所有显示器用于远程会话 (预览 PR 6064)

Install required	Values	Default	Example
N	Y, N	N	`use-all-my-displays-for-the-remote_session=Y`

20、视图样式

功能：控制远程会话的视图样式。

设置路径：

桌面设置→显示→默认视图样式
移动设置→显示设置→默认视图样式

Install required	Values	Default	Example
N	original, adaptive	original	`view-style=original`

21、滚动样式

功能：控制远程会话中的滚动样式。

设置路径：桌面设置→显示→默认滚动样式

Install required	Values	Default	Example
N	scrollauto, scrollbar	scrollauto	`scroll-style=scrollauto`

22、图像质量

功能：控制远程会话的图像质量。

设置路径：

桌面设置→显示→默认图像质量
移动设置→显示设置→默认图像质量

Install required	Values	Default	Example
N	best, balanced, low, custom	balanced	`image-quality=balanced`

23、自定义图像质量

功能：此选项将在第一次连接后为每个对等体设置“自定义图像质量”选项。如果将“image-quality”设置为自定义，则每个对等方设置中的“custom-image-quality”选项将控制图像质量。

设置路径：

桌面“设置”→“显示”→“默认图像质量”→“自定义”
移动设置 → 显示设置 → 默认图像质量 → 自定义

Install required	Values	Default	Example
N	[10.0, 2000.0]	50.0	`custom-image-quality=50`

24、自定义FPS

功能：在第一次连接后为每个对等体设置“custom-fps”选项。

设置路径：桌面设置→显示→默认图像质量→自定义
移动设置 → 显示设置 → 默认图像质量 → 自定义

Install required	Values	Default	Example
N	[5, 120]	30	`custom-fps=30`

25、编解码器首选项

功能：在第一次连接后为每个对等体设置“codec-preference”选项。

设置路径：桌面设置→显示→默认编解码器
移动设置 → 显示设置 → 默认编解码器

Install required	Values	Default	Example
N	auto, vp8, vp9, av1, h264, h265	auto	`codec-preference=auto`

26、preset-address-book-name & preset-address-book-tag

功能：预设通讯录名称和标签。

设置路径：Web 控制台的通讯录页面上

Option	Install required	Values	Default	Example
preset-address-book-name	N			`preset-address-book-name=<address book name>`
preset-address-book-tag	N			`preset-address-book-tag=<address book tag name>`

27、禁用组面板

功能：在 RustDesk 客户端上禁用组面板（地址簿面板旁边）。

设置路径：https://github.com/rustdesk/rustdesk-server-pro/issues/250

Option	Install required	Values	Default	Example
disable-group-panel	N	Y, N	N	`disable-group-panel=Y`

28、提升前服务

功能：运行时自动提升 Windows 便携式。

设置路径：https://github.com/rustdesk/rustdesk-server-pro/issues/252

Option	Install required	Values	Default	Example
pre-elevate-service	N	Y, N	N	`pre-elevate-service=Y`

29、禁用浮动窗口

功能：当 Android 服务启动时，它会显示一个浮动窗口，这有助于防止系统终止 RustDesk 服务。

设置路径：Android 服务启动时

Values	Default	Example
Y, N	N	`disable-floating-window=Y`

30、浮动窗口大小

功能：当 Android 服务启动时，它会显示一个浮动窗口，这有助于防止系统终止 RustDesk 服务。当大小小于 120 时，浮动窗口将难以点击。非常小的尺寸可能无法在某些设备上保留后台服务。

设置路径：Android 服务启动时

Values	Default	Example
[32, 320]	120	`floating-window-size=120`

31、浮动窗口不可触碰

功能：默认情况下，单击浮动窗口将弹出一个菜单。将其设置为“不可触及”后，单击或滑动将穿过浮动窗口并传输到底层窗口。设置为“不可触及”后，浮动窗口的位置无法更改，系统可能会自动将浮动窗口设置为半透明。但是，此功能可能不适用于少数应用程序，例如 GitHub 应用程序。

设置路径：Android 服务启动时

Values	Default	Example
Y, N	N	`floating-window-untouchable=Y`

32、浮动窗口透明度

功能：Android 浮动窗口具有可调节的透明度。如果要启用但隐藏浮动窗口，则可以将透明度设置为 0，浮动窗口将自动设置为“不可触及”，以便通过点击事件。

设置路径：Android 服务启动时

Values	Default	Example
[0, 10]	10	`floating-window-transparency=5`

33、浮动窗口 svg

功能：如果未为 Android 浮动窗口设置图标，则默认显示 RustDesk 图标。设置时，请将svg的文字内容写成一行，并注意SVG支持限制。

Default Example

RustDesk icon floating-window-svg=<?xml version="1.0" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg t="1717559129252" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="4248" xmlns:xlink="http://www.w3.org/1999/xlink" width="32" height="32"><path d="M950.857143 512c0 242.285714-196.571429 438.857143-438.857143 438.857143S73.142857 754.285714 73.142857 512 269.714286 73.142857 512 73.142857s438.857143 196.571429 438.857143 438.857143z" fill="#1296db" p-id="4249"></path></svg>

34、保持屏幕开启

功能：这是针对 Android 控制端的。请注意，保持屏幕打开取决于浮动窗口。

设置路径：Android 控制端