高级设置

所有自定义客户端中的高级设置都在这里涵盖。

设置的权限级别

有四种类型的设置：

1. 覆盖设置，在Web控制台 → 自定义客户端中
2. 默认设置，在Web控制台 → 自定义客户端中
3. 用户设置，在RustDesk客户端中
4. 策略设置，在Web控制台 → 策略中

这些设置的权限层次结构如下：覆盖 > 策略 > 用户 > 默认。

安全设置

access-mode

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

位置：

1. 桌面 设置 → 安全 → 权限
2. 移动端

enable-keyboard

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

位置：

1. 桌面 设置 → 安全 → 权限 → 启用键盘
2. 移动端

enable-clipboard

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

位置：

1. 桌面 设置 → 安全 → 权限 → 启用剪贴板
2. 移动端

enable-file-transfer

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

位置：

1. 桌面 设置 → 安全 → 权限 → 启用文件传输
2. 移动端

enable-camera

启用传入连接的摄像头。

位置：

1. 桌面 设置 → 安全 → 权限 → 启用摄像头
2. 移动端

enable-remote-printer

启用传入连接的远程打印机。

位置：

1. Windows 设置 → 安全 → 权限 → 启用远程打印机

enable-audio

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

位置：

1. 桌面 设置 → 安全 → 权限 → 启用音频
2. 移动端

enable-tunnel

启用TCP隧道。

位置：

1. 桌面 设置 → 安全 → 权限 → 启用TCP隧道
2. 移动端

enable-remote-restart

启用控制端重启。

位置：

1. 桌面 设置 → 安全 → 权限 → 启用远程重启
2. 移动端

enable-record-session

启用会话录制。

位置：

1. 桌面 设置 → 安全 → 权限 → 启用录制会话
2. 移动端 设置 → 屏幕共享 → 启用录制会话

enable-block-input

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

位置：

1. 桌面 设置 → 安全 → 权限 → 启用阻止用户输入（仅Windows）
2. 移动端

allow-remote-config-modification

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

位置：

1. 桌面 设置 → 安全 → 权限 → 启用远程配置修改
2. 移动端

enable-lan-discovery

允许局域网对等端发现我。

启用局域网发现后，如果本地支持，WOL可以工作。

位置：

1. 桌面 设置 → 安全 → 安全 → 拒绝局域网发现
2. 移动端 设置 → 屏幕共享 → 拒绝局域网发现

direct-server

启用直接IP访问。

位置：

1. 桌面 设置 → 安全 → 安全 → 启用直接IP访问
2. 移动端 设置 → 屏幕共享 → 直接IP访问

direct-access-port

直接IP访问端口。

位置：

1. 桌面 设置 → 安全 → 安全 → 直接IP访问端口（勾选"启用直接IP访问"时显示）
2. 移动端 设置 → 屏幕共享 → 直接IP访问

whitelist

使用IP白名单。

位置：

1. 桌面 设置 → 安全 → 安全 → 使用IP白名单
2. 移动端 设置 → 屏幕共享 → 使用IP白名单

allow-auto-disconnect & auto-disconnect-timeout

在用户不活动一段时间后自动关闭传入会话。

位置：

1. 桌面 设置 → 安全 → 安全 → 用户不活动时自动关闭传入会话
2. 移动端 设置 → 屏幕共享 → 用户不活动时自动关闭传入会话

allow-only-conn-window-open

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

位置：

1. 桌面 设置 → 安全 → 安全 → 仅在RustDesk窗口打开时允许连接
2. 移动端

approve-mode

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

位置：

1. 桌面 设置 → 安全 → 密码 → 下拉框
2. 移动端 屏幕共享 → 右上角下拉菜单

verification-method

可以使用什么类型的密码，临时密码是指一次性随机密码。

proxy-url

代理URL。

目前支持http和socks5。

位置：

1. 桌面 设置 → 网络 → 代理 → Socks5/Http(s)代理
2. 移动端

示例：

1. http proxy-url=http://192.168.0.2:12345
2. https proxy-url=https://192.168.0.2:12345
3. socks5 proxy-url=socks5://192.168.0.2:1080

proxy-username & proxy-password

代理用户名和密码。

位置：

1. 桌面 设置 → 网络 → 代理 → Socks5/Http(s)代理
2. 移动端

常规设置

theme

控制RustDesk客户端的UI主题。

位置：

1. 桌面 设置 → 常规 → 主题
2. 移动端 设置 → 设置 → 主题

lang

控制RustDesk客户端的语言。

位置：

1. 桌面 设置 → 常规 → 语言
2. 移动端 设置 → 设置 → 语言

目前可用的语言有：

ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko, kz, lt, lv, nb, nl, pl, pt, ro, ru, sk, sl, sq, sr, sv, th, tr, uk, vn, zh-cn, zh-tw

您可以查看代码中的LANGS获取最新的语言列表。

allow-auto-record-incoming

自动录制传入会话。

位置：

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

allow-auto-record-outgoing

自动录制传出会话。

位置：

1. 桌面 设置 → 常规 → 录制 → 自动录制传出会话
2. 移动端 设置 → 录制 → 自动录制传出会话

video-save-directory

保存录制视频的目录。

位置：

1. 桌面 设置 → 常规 → 录制 → 视频保存目录
2. 移动端 设置 → 录制

默认值：

1. macOS ~/Movies/app_name
2. Linux ~/Videos/app_name
3. Windows %USERPROFILE%\Videos\app_name
4. Android /Storage/emulated/0/app_name/ScreenRecord

注意：替换app_name表示当前应用名称。

enable-confirm-closing-tabs

控制是否在关闭所有远程标签之前显示确认对话框。

位置：

1. 桌面 设置 → 常规 → 其他 → 关闭多个标签前确认
2. 移动端

enable-abr

启用自适应比特率。

位置：

1. 桌面 设置 → 常规 → 其他 → 自适应比特率
2. 移动端 设置 → 屏幕共享 → 自适应比特率（测试版）

allow-remove-wallpaper

在传入会话期间移除壁纸。

位置：

1. 桌面 设置 → 常规 → 其他 → 传入会话期间移除壁纸
2. 移动端

enable-open-new-connections-in-tabs

控制是否使用新标签或新窗口打开新连接。

位置：

1. 桌面 设置 → 常规 → 其他 → 在新标签中打开连接
2. 移动端

allow-always-software-render

始终使用软件渲染。

位置：

1. 桌面 设置 → 常规 → 其他 → 始终使用软件渲染
2. 移动端

allow-linux-headless

如果没有显示器，允许传入连接。

此选项需要桌面环境、Xorg服务器和GDM，请参阅PR 3902。

位置：

1. 桌面 设置 → 常规 → 其他 → 允许Linux无头模式
2. 移动端

enable-hwcodec

启用硬件编码以使画面更流畅。

位置：

1. 桌面
2. 移动端 设置 → 硬件编解码器

peer-card-ui-type

控制对等端卡片的视图，包括"大磁贴"、“小磁贴"和"列表”。

位置：

1. 桌面 首页 → 对等端面板 → 右上角网格图标
2. 移动端

0 大磁贴
1 小磁贴
2 列表

peer-sorting

控制对等端卡片的排序。

位置：

1. 桌面 首页 → 对等端面板 → 右上角排序图标
2. 移动端

sync-ab-with-recent-sessions

控制是否将通讯录与最近会话同步。

位置：

1. 桌面 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 与最近会话同步
2. 移动端 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 与最近会话同步

sync-ab-tags

控制是否对通讯录标签进行排序。

位置：

1. 桌面 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 标签排序
2. 移动端 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 标签排序

filter-ab-by-intersection

按标签交集过滤通讯录。

预览：PR #5985

位置：

1. 桌面 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 按交集过滤
2. 移动端 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 按交集过滤

显示设置

view-only

此选项将为每个对等端在首次连接后设置"仅查看"选项。

然后每个对等端设置中的"仅查看"选项将控制连接是否为仅查看模式。

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 查看模式
2. 移动端 设置 → 显示设置 → 其他默认选项 → 查看模式

show-monitors-toolbar

控制是否在工具栏中显示监视器。

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 显示监视器工具栏
2. 移动端

collapse-toolbar

控制连接后远程工具栏是否折叠。

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 折叠工具栏
2. 移动端

show-remote-cursor

此选项将为每个对等端在首次连接后设置"显示远程光标"选项。

然后每个对等端设置中的"显示远程光标"选项将控制是否在远程控制页面中显示远程光标。

位置：

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

follow-remote-cursor

此选项将为每个对等端在首次连接后设置"跟随远程光标"选项。

然后每个对等端设置中的"跟随远程光标"选项将控制是否跟随远程光标。

预览：PR 7717

位置：

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

follow-remote-window

此选项将为每个对等端在首次连接后设置"跟随远程窗口"选项。

然后每个对等端设置中的"跟随远程窗口"选项将控制是否跟随远程窗口。

预览：PR 7717

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 跟随远程窗口焦点
2. 移动端 设置 → 显示设置 → 其他默认选项 → 跟随远程窗口焦点

zoom-cursor

此选项将为每个对等端在首次连接后设置"缩放光标"选项。

每个对等端设置中的"缩放光标"选项将控制光标是否根据当前图像缩放进行缩放。

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 缩放光标
2. 移动端

show-quality-monitor

此选项将为每个对等端在首次连接后设置"显示质量监视器"选项。

每个对等端设置中的"显示质量监视器"选项将控制是否显示质量监视器。

位置：

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

disable-audio

此选项将为每个对等端在首次连接后设置"禁用音频"选项。

每个对等端设置中的"禁用音频"选项将控制是否播放声音。

位置：

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

enable-file-copy-paste

此选项将为每个对等端在首次连接后设置"启用文件复制粘贴"选项。

每个对等端设置中的"启用文件复制粘贴"选项将控制是否在连接中启用文件复制粘贴。

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 启用文件复制粘贴（仅Windows）
2. 移动端

disable-clipboard

此选项将为每个对等端在首次连接后设置"禁用剪贴板"选项。

每个对等端设置中的"禁用剪贴板"选项将控制是否启用文本复制粘贴。

位置：

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

lock-after-session-end

此选项将为每个对等端在首次连接后设置"会话结束后锁定"选项。

每个对等端设置中的"会话结束后锁定"选项将控制会话结束后是否锁定对等机器。

位置：

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

privacy-mode

此选项将为每个对等端在首次连接后设置"隐私模式"选项。

每个对等端设置中的"隐私模式"选项将控制连接后是否使用隐私模式。

位置：

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

touch-mode

此选项将为每个对等端在首次连接后设置"触控模式"选项。

每个对等端设置中的"触控模式"选项将控制是否使用触控模式或鼠标模式。

位置：

1. 桌面
2. 移动端 设置 → 显示设置 → 其他默认选项 → 触控模式

i444

此选项将为每个对等端在首次连接后设置"i444"选项。

每个对等端设置中的"i444"选项将控制是否使用真彩色。

位置：

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

reverse-mouse-wheel

此选项将为每个对等端在首次连接后设置"反转鼠标滚轮"选项。

每个对等端设置中的"反转鼠标滚轮"选项将控制是否反转鼠标滚轮。

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 反转鼠标滚轮
2. 移动端 设置 → 显示设置 → 其他默认选项 → 反转鼠标滚轮

swap-left-right-mouse

此选项将为每个对等端在首次连接后设置"交换左右鼠标按钮"选项。

每个对等端设置中的"交换左右鼠标按钮"选项将控制是否交换左右鼠标按钮。

位置：

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

displays-as-individual-windows

此选项将为每个对等端在首次连接后设置"显示为单独窗口"选项。

每个对等端设置中的"显示为单独窗口"选项将控制是否将显示器显示为单独的窗口。

预览：PR 5945

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 将显示器显示为单独窗口
2. 移动端

use-all-my-displays-for-the-remote_session

此选项将为每个对等端在首次连接后设置"为远程会话使用我的所有显示器"选项。

每个对等端设置中的"为远程会话使用我的所有显示器"选项将控制是否为远程会话使用我的所有显示器。

预览：PR 6064

位置：

1. 桌面 设置 → 显示 → 其他默认选项 → 为远程会话使用我的所有显示器
2. 移动端

view-style

此选项将为每个对等端在首次连接后设置"查看样式"选项。

每个对等端设置中的"查看样式"选项将控制查看样式。

位置：

1. 桌面 设置 → 显示 → 默认查看样式
2. 移动端 设置 → 显示设置 → 默认查看样式

scroll-style

此选项将为每个对等端在首次连接后设置"滚动样式"选项。

每个对等端设置中的"滚动样式"选项将控制滚动样式。

位置：

1. 桌面 设置 → 显示 → 默认滚动样式
2. 移动端

image-quality

此选项将为每个对等端在首次连接后设置"图像质量"选项。

每个对等端设置中的"图像质量"选项将控制图像质量。

位置：

1. 桌面 设置 → 显示 → 默认图像质量
2. 移动端 设置 → 显示设置 → 默认图像质量

custom-image-quality

此选项将为每个对等端在首次连接后设置"自定义图像质量"选项。

如果"图像质量"设置为自定义，每个对等端设置中的"自定义图像质量"选项将控制图像质量。

位置：

1. 桌面 设置 → 显示 → 默认图像质量 → 自定义
2. 移动端 设置 → 显示设置 → 默认图像质量 → 自定义

custom-fps

此选项将为每个对等端在首次连接后设置"自定义帧率"选项。

如果"图像质量"设置为自定义，每个对等端设置中的"自定义帧率"选项将控制帧率。

位置：

1. 桌面 设置 → 显示 → 默认图像质量 → 自定义
2. 移动端 设置 → 显示设置 → 默认图像质量 → 自定义

codec-preference

此选项将为每个对等端在首次连接后设置"编解码器偏好"选项。

每个对等端设置中的"编解码器偏好"选项将控制图像的编解码器。

位置：

1. 桌面 设置 → 显示 → 默认编解码器
2. 移动端 设置 → 显示设置 → 默认编解码器

注意：除了"vp8"和"vp9"之外的选项可能无法工作。这取决于你的机器支持什么。

其他

preset-address-book-name & preset-address-book-tag

预设通讯录名称和标签，https://github.com/rustdesk/rustdesk-server-pro/issues/257。 如果不想设置标签，可以仅设置preset-address-book-name。 请在Web控制台的通讯录页面上使用有效的通讯录名称和标签。

disable-group-panel

在RustDesk客户端上禁用组面板（在通讯录面板旁边，自1.3.8版本起命名为"可访问设备"），https://github.com/rustdesk/rustdesk-server-pro/issues/250。

pre-elevate-service

Windows便携版运行时自动提升权限，https://github.com/rustdesk/rustdesk-server-pro/issues/252。

disable-floating-window

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

floating-window-size

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

floating-window-untouchable

默认情况下，点击浮动窗口会弹出菜单。设置为"不可触摸"后，点击或滑动将穿过浮动窗口并传输到底层窗口。设置为"不可触摸"后，浮动窗口的位置无法更改，系统可能会自动将浮动窗口设置为半透明。但是，此功能可能在少数应用程序中不起作用，例如GitHub应用。

floating-window-transparency

Android浮动窗口具有可调节的透明度。如果要启用但隐藏浮动窗口，可以将透明度设置为0，浮动窗口将自动设置为"不可触摸"以穿透点击事件。

floating-window-svg

如果没有为Android浮动窗口设置图标，它将默认显示RustDesk图标。 设置时，请将SVG的文本内容写成一行，并注意SVG支持限制。

keep-screen-on

这是针对Android受控端的。请注意，保持屏幕开启依赖于浮动窗口。

enable-directx-capture

这是针对Windows受控端的。如果没有遇到任何问题，建议使用默认设置，优先使用DirectX进行截图而不是直接使用GDI。

enable-android-software-encoding-half-scale

这是针对Android受控端的。默认情况下，当分辨率大于1200时，硬件编码使用原始分辨率，而软件编码使用一半分辨率，因为软件编码较慢。此选项用于设置软件编码是否应缩放到一半分辨率。

allow-remote-cm-modification

控制是否允许控制端点击连接管理窗口来接受连接、更改权限等。

https://github.com/rustdesk/rustdesk/issues/7425

remove-preset-password-warning

控制当自定义客户端中有预设密码时是否移除GUI上的安全警告。

https://github.com/rustdesk/rustdesk-server-pro/discussions/286

https://github.com/rustdesk/rustdesk/discussions/7956

hide-security-settings / hide-network-settings / hide-server-settings / hide-proxy-settings / hide-websocket-settings / hide-remote-printer-settings

控制是否隐藏某些设置。请确保禁用设置已关闭，否则这些不会生效。

https://github.com/rustdesk/rustdesk-server-pro/issues/263

https://github.com/rustdesk/rustdesk-server-pro/issues/276

hide-username-on-card

控制是否在设备列表中显示用户名。因为有时用户名太长，会隐藏其他信息。

https://github.com/rustdesk/rustdesk-server-pro/issues/284#issuecomment-2216521407

hide-help-cards

控制是否在GUI上显示UAC/权限警告。

https://github.com/rustdesk/rustdesk/issues/8687

display-name

更改将在连接到远程设备时弹出窗口中显示的显示名称。默认情况下，它首先显示登录用户的名称，否则显示您的操作系统用户名。

https://github.com/rustdesk/rustdesk-server-pro/issues/277

disable-udp

控制是否仅使用TCP。它将不再使用UDP 21116，而是使用TCP 21116。

preset-user-name / preset-strategy-name / preset-device-group-name

将用户/策略/设备组分配给设备。您也可以通过命令行执行此操作。

https://github.com/rustdesk/rustdesk-server-pro/discussions/304

设备组在RustDesk客户端>=1.3.8、pro >= 1.5.0中可用

default-connect-password

您使用默认连接密码来建立到远程设备的连接。此密码在控制端配置，不应与受控（仅传入）客户端上找到的任何预设密码混淆。

例如 default-connect-password=abcd1234

enable-trusted-devices

允许受信任的设备跳过2FA验证。

https://github.com/rustdesk/rustdesk/discussions/8513#discussioncomment-10234494

hide-tray

禁用系统托盘中的托盘图标。

https://github.com/rustdesk/rustdesk-server-pro/issues/332

one-way-clipboard-redirection

禁用从受控端到控制端的剪贴板同步，在RustDesk客户端>=1.3.1（受控端）中可用

https://github.com/rustdesk/rustdesk/discussions/7837

one-way-file-transfer

禁用从受控端到控制端的文件传输，在RustDesk客户端>=1.3.1（受控端）中可用

https://github.com/rustdesk/rustdesk/discussions/7837

sync-init-clipboard

建立连接时是否同步初始剪贴板（仅从控制端到受控端），在RustDesk客户端>=1.3.1（控制端）中可用

https://github.com/rustdesk/rustdesk/discussions/9010

allow-logon-screen-password

在使用仅点击批准模式时是否允许在登录屏幕上输入密码，在RustDesk客户端>=1.3.1（受控端）中可用

https://github.com/rustdesk/rustdesk/discussions/9269

allow-https-21114

通常，HTTPS使用端口443。当API服务器的端口错误地设置为21114时，RustDesk客户端默认会移除21114端口设置。将选项设置为Y允许使用21114作为HTTPS端口。在RustDesk客户端>=1.3.9中可用。

https://github.com/rustdesk/rustdesk-server-pro/discussions/570

allow-d3d-render

D3D渲染可以获得高帧率并减少CPU使用率，但在某些设备上远程控制屏幕可能会变黑。在RustDesk客户端>=1.3.9中可用，仅Windows。

allow-hostname-as-id

使用主机名作为ID，主机名中的空格会被替换为’-’。这不是100%保证的，只在第一次运行RustDesk客户端时发生（即在新安装的客户端上）；如果发生冲突，将分配一个随机ID。

在RustDesk客户端版本1.4.0及更高版本中可用。

allow-websocket

使用WebSocket协议连接服务器和客户端。仅在RustDesk客户端>=1.4.0和Pro服务器>= 1.5.7中可用。请注意，WebSocket仅支持中继连接。

要使WebSocket工作，您需要正确配置反向代理， https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#8-add-websocket-secure-wss-support-for-the-id-server-and-relay-server-to-enable-secure-communication-for-all-platforms

allow-numeric-one-time-password

此选项启用或禁用仅数字一次性密码的使用。 仅在RustDesk客户端>=1.4.1和Pro服务器>= 1.5.9中可用。

讨论： https://github.com/rustdesk/rustdesk-server-pro/discussions/685

预览： https://github.com/rustdesk/rustdesk/pull/11846

register-device

不注册设备，您不会在Web控制台的设备页面中看到它。

仅在Pro服务器>= 1.6.0中可用，需要custom2许可证且并发连接数>= 2。

如果register-device=N，以下功能对此设备不起作用。

• 登录
• --assign命令
• preset-address-book-name, --preset-address-book-tag, preset-user-name, preset-strategy-name, preset-device-group-name
• 审计日志
• 策略

讨论： https://github.com/rustdesk/rustdesk-server-pro/discussions/672 和 https://github.com/rustdesk/rustdesk-server-pro/discussions/182