doc.rustdesk.com/content/self-host/client-configuration/advanced-settings/_index.zh-cn.md
fufesou 529993bb27 fix: redundant white space
Signed-off-by: fufesou <shuanglongchen@yeah.net>
2024-05-19 23:09:14 +08:00

26 KiB
Raw Blame History

title weight
高级设置 49

设置项的优先级

一共有 4 中类型的设置项:

  1. 覆盖设置, 在 "Web Console -> Custom Clients" 中。
  2. 默认设置, 在 "Web Console -> Custom Clients" 中。
  3. 用户设置, 在 RustDesk 客户端中。
  4. 策略设置, 在 "Web Console -> Strategies" 中。

这些设置的优先级是:覆盖 > 策略 > 用户 > 默认

安全设置

access-mode

设置传入连接的访问模式(权限)。

位置:

  1. 桌面端 设置 -> 安全 -> 权限
  2. 移动端
是否需要安装 可设值 默认值 示例
N custom, full, view custom access-mode=custom

enable-keyboard

允许传入连接控制键盘/鼠标。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许控制键盘/鼠标
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-keyboard=Y

enable-clipboard

允许使用粘贴板。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许同步粘贴板
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-clipboard=Y

enable-file-transfer

允许文件复制和粘贴或文件传输(会话)。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许传输文件
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-file-transfer=Y

enable-audio

允许音频录制并传输给控制端。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许传输音频
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-audio=Y

enable-tunnel

允许建立 TCP 隧道。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许建立 TCP 隧道
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-tunnel=Y

enable-remote-restart

允许远程重启。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许远程重启
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-remote-restart=Y

enable-record-session

允许录制会话。

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许录制会话
  2. 移动端 设置 -> 共享屏幕 -> 允许录制会话
是否需要安装 可设值 默认值 示例
N Y, N Y enable-record-session=Y

enable-block-input

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

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许阻止用户输入 (仅支持 Windows)
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-block-input=Y

allow-remote-config-modification

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

位置:

  1. 桌面端 设置 -> 安全 -> 权限 -> 允许远程修改配置
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y allow-remote-config-modification=Y

enable-lan-discovery

允许局域网发现。

局域网法相后, 如果支持 WOL , 则可使用 WOL 。

位置:

  1. 桌面端 设置 -> 安全 -> 安全 -> 拒绝局域网发现
  2. 移动端 设置 -> 共享屏幕 -> 拒绝局域网发现
是否需要安装 可设值 默认值 示例
Y Y, N Y enable-lan-discovery=Y

direct-server

允许 IP 直接访问。

位置:

  1. 桌面端 设置 -> 安全 -> 安全 -> 允许 IP 直接访问
  2. 移动端 设置 -> 共享屏幕 -> IP 直接访问
是否需要安装 可设值 默认值 示例
N Y, N N direct-server=Y

direct-access-port

IP 直接访问的端口。

位置:

  1. 桌面端 设置 -> 安全 -> 安全 -> "允许 IP 直接访问" 后显示
  2. 移动端 设置 -> 共享屏幕 -> IP 直接访问项中的 编辑 按钮
是否需要安装 可设值 默认值 示例
N 21118 direct-access-port=21118

whitelist

只允许白名单上的 IP 访问。

位置:

  1. 桌面端 设置 -> 安全 -> 安全 -> 只允许白名单上的 IP 访问
  2. 移动端 设置 -> 共享屏幕 -> 只允许白名单上的 IP 访问
是否需要安装 可设值 默认值 示例
N , 或者 <ip1>,<ip2>,<ip3> , 表示不过滤 whitelist=,

allow-auto-disconnect & auto-disconnect-timeout

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

位置:

  1. 桌面端 设置 -> 安全 -> 安全 -> 自动关闭不活跃的会话
  2. 移动端 设置 -> 共享屏幕 -> 自动关闭不活跃的会话
设置项 是否需要安装 可设值 默认值 示例
allow-auto-disconnect N Y, N N allow-auto-disconnect=Y
auto-disconnect-timeout N 按分钟计的超时时间 10 auto-disconnect-timeout=10

allow-only-conn-window-open

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

位置:

  1. 桌面端 设置 -> 安全 -> 安全 -> 仅当 RustDesk 窗口打开时允许连接
  2. 移动端
是否需要安装 可设值 默认值 示例
Y Y, N N allow-only-conn-window-open=N

approve-mode

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

位置:

  1. 桌面端 设置 -> 安全 -> 密码 -> 下拉框
  2. 移动端 共享屏幕 -> 右上角的下拉菜单
是否需要安装 可设值 默认值 示例
N password, click, password-click password-click approve-mode=password-click

proxy-url

代理的 url 。

目前支持 httpsocks5

位置:

  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. 移动端
设置项 是否需要安装 可设值 默认值 示例
proxy-username N proxy-username=user
proxy-password N proxy-password=pass

常规设置

theme

控制 RustDesk 客户端的 UI 主题。

位置:

  1. 桌面端 设置 -> 常规 -> 主题
  2. 移动端 设置 -> 设置 -> 主题
是否需要安装 可设值 默认值 示例
N dark, light, system system theme=system

lang

控制 RustDesk 客户端的语言。

位置:

  1. 桌面端 设置 -> 常规 -> 语言
  2. 移动端 设置 -> 设置 -> 语言
是否需要安装 可设值 默认值 示例
N default, ar, bg, ... default lang=default

当前可用的语言有:

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, ua, vn, zh-cn, zh-tw

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

allow-auto-record-incoming

自动录制来访会话。

位置:

  1. 桌面端 设置 -> 常规 -> 录屏 -> 自动录制来访会话
  2. 移动端 设置 -> 录屏 -> 自动录制来访会话
是否需要安装 可设值 默认值 示例
N Y, N N allow-auto-record-incoming=N

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

Note: app_name 代表当前的 app 名。

enable-confirm-closing-tabs

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

位置:

  1. 桌面端 设置 -> 常规 -> 其他 -> 关闭多个标签时向您确认
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-confirm-closing-tabs=Y

enable-abr

启用自适应码率。

位置:

  1. 桌面端 设置 -> 常规 -> 其他 -> 自适应码率
  2. 移动端 设置 -> 共享屏幕 -> 自适应码率 (beta)
是否需要安装 可设值 默认值 示例
N Y, N Y enable-abr=Y

allow-remove-wallpaper

接受会话时移除桌面壁纸。

位置:

  1. 桌面端 设置 -> 常规 -> 其他 -> 接受会话时移除桌面壁纸
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N allow-remove-wallpaper=N

enable-open-new-connections-in-tabs

控制是否使用新选项卡或新窗口来打开新连接。

位置:

  1. 桌面端 设置 -> 常规 -> 其他 -> 在选项卡中打开新连接
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N Y enable-open-new-connections-in-tabs=Y

allow-always-software-render

始终使用软渲染。

位置:

  1. 桌面端 设置 -> 常规 -> 其他 -> 始终使用软渲染
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N allow-always-software-render=N

allow-linux-headless

在没有显示器的时候, 允许传入会话。

启用次选项, 需要桌面环境, xorg 服务 和 gdm, 参考 PR 3902.

位置:

  1. 桌面端 设置 -> 常规 -> 其他 -> Allow linux headless
  2. 移动端
是否需要安装 可设值 默认值 示例
Y Y, N N allow-linux-headless=N

enable-hwcodec

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

位置:

  1. 桌面端
  2. 移动端 设置 -> 硬件编解码
是否需要安装 可设值 默认值 示例
N Y, N Y enable-hwcodec=Y

peer-card-ui-type

控制 peer 卡片 的视图, 包括 "大磁贴"、"小磁贴" 和 "列表"。

Location:

  1. Desktop 主页 -> Peer 面板 -> 右上角的网格图标
  2. Mobile
是否需要安装 可设值 默认值 示例
N 0, 1, 2 0 peer-card-ui-type=0

0 "大磁贴"
1 "小磁贴"
2 "列表"

peer-sorting

控制 peer 卡片 的顺序。

Location:

  1. Desktop 主页 -> Peer 面板 -> 右上角的排序图标
  2. Mobile
是否需要安装 可设值 默认值 示例
N Remote ID, Remote Host, Username Remote ID peer-sorting=Remote ID

sync-ab-with-recent-sessions

控制是否将地址簿与最近的会话同步。

位置:

  1. 桌面端 主页 -> Peer 面板 -> 地址簿 -> 标签 -> 下拉菜单 -> 同步最近会话
  2. 移动端 主页 -> Peer 面板 -> 地址簿 -> 标签 -> 下拉菜单 -> 同步最近会话
是否需要安装 可设值 默认值 示例
N Y, N N sync-ab-with-recent-sessions=N

sync-ab-tags

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

位置:

  1. 桌面端 主页 -> Peer 面板 -> 地址簿 -> 标签 -> 下拉菜单 -> 对标签进行排序
  2. 移动端 主页 -> Peer 面板 -> 地址簿 -> 标签 -> 下拉菜单 -> 对标签进行排序
是否需要安装 可设值 默认值 示例
N Y, N N sync-ab-tags=N

filter-ab-by-intersection

按标签交集过滤地址簿。

预览: PR #5985

位置:

  1. 桌面端 主页 -> Peer 面板 -> 地址簿 -> 标签 -> 下拉菜单 -> 按交集过滤
  2. 移动端 主页 -> Peer 面板 -> 地址簿 -> 标签 -> 下拉菜单 -> 按交集过滤
是否需要安装 可设值 默认值 示例
N Y, N N filter-ab-by-intersection=N

显示设置

view-only

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "view-only"。

被控端设置中的 "view-only" 会控制连接是否为浏览模式。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 浏览模式
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 浏览模式
是否需要安装 可设值 默认值 示例
N Y, N N view-only=Y

show-monitors-toolbar

控制是否在工具栏上显示监视器列表。

show-monitors-toolbar

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 在工具栏上显示监视器。
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N show-monitors-toolbar=Y

collapse-toolbar

控制连接建立后, 是否折叠工具栏。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 折叠工具栏
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N collapse-toolbar=Y

show-remote-cursor

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "show-remote-cursor"。

被控端设置中的 "show-remote-cursor" 会控制是否显示被控端的光标。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 显示远程光标
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 显示远程光标
是否需要安装 可设值 默认值 示例
N Y, N N show-remote-cursor=N

follow-remote-cursor

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "follow-remote-cursor"。

被控端设置中的 "follow-remote-cursor" 控制画面是否跟随远程光标。

预览 PR 7717

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 跟随远程光标
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 跟随远程光标
是否需要安装 可设值 默认值 示例
N Y, N N follow-remote-cursor=Y

follow-remote-window

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "follow-remote-window"。

被控端设置中的 "follow-remote-window" 控制画面是否跟随远程窗口焦点。

预览 PR 7717

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 跟随远程窗口焦点
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 跟随远程窗口焦点
是否需要安装 可设值 默认值 示例
N Y, N N follow-remote-window=Y

zoom-cursor

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "zoom-cursor"。

被控端设置中的 "zoom-cursor" 控制画面中的光标按照画面的比例进行缩放。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 缩放光标
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N zoom-cursor=Y

show-quality-monitor

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "show-quality-monitor"。

被控端设置中的 "show-quality-monitor" 控制是否显示质量监测。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 显示质量监测
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 显示质量监测
是否需要安装 可设值 默认值 示例
N Y, N N show-quality-monitor=Y

disable-audio

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "disable-audio"。

被控端设置中的 "disable-audio" 控制是否播放声音。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 静音
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 静音
是否需要安装 可设值 默认值 示例
N Y, N N disable-audio=Y

enable-file-copy-paste

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "enable-file-copy-paste"。

被控端设置中的 "enable-file-copy-paste" 控制连接中, 是否可以复制粘贴文件。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 静音允许复制粘贴文件 (仅支持 Windows)
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N enable-file-copy-paste=Y

disable-clipboard

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "disable-clipboard"。

被控端设置中的 "disable-clipboard" 控制是否允许文本复制粘贴。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 禁用粘贴板
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 禁用粘贴板
是否需要安装 可设值 默认值 示例
N Y, N N disable-clipboard=Y

lock-after-session-end

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "lock-after-session-end"。

被控端设置中的 "lock-after-session-end" 控制是否在连接结束后, 锁定被控端电脑。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 会话结束后锁定远程电脑
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 会话结束后锁定远程电脑
是否需要安装 可设值 默认值 示例
N Y, N N lock-after-session-end=Y

privacy-mode

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "privacy-mode"。

被控端设置中的 "privacy-mode" 控制是否在连接后, 启用隐私模式。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 隐私模式
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 隐私模式
是否需要安装 可设值 默认值 示例
N Y, N N privacy-mode=Y

touch-mode

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "touch-mode"。

被控端设置中的 "touch-mode" 控制是否在连接后, 使用触屏模式还是鼠标模式。

位置:

  1. 桌面端
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 触屏模式
是否需要安装 可设值 默认值 示例
N Y, N N touch-mode=Y

i444

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "i444"。

被控端设置中的 "i444" 控制是否使用真彩模式 (4:4:4)。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 真彩模式 (4:4:4)
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 真彩模式 (4:4:4)
是否需要安装 可设值 默认值 示例
N Y, N N i444=Y

reverse-mouse-wheel

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "reverse-mouse-wheel"。

被控端设置中的 "reverse-mouse-wheel" 控制是否反转鼠标滚轮方向。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 鼠标滚轮反向
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 鼠标滚轮反向
是否需要安装 可设值 默认值 示例
N Y, N N reverse-mouse-wheel=Y

swap-left-right-mouse

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "swap-left-right-mouse"。

被控端设置中的 "swap-left-right-mouse" 控制是否交换鼠标左右键。

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 交换鼠标左右键
  2. 移动端 设置 -> 显示设置 -> 其他默认选项 -> 交换鼠标左右键
是否需要安装 可设值 默认值 示例
N Y, N N swap-left-right-mouse=Y

displays-as-individual-windows

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "displays-as-individual-windows"。

被控端设置中的 "displays-as-individual-windows" 控制是否在在单个窗口打开显示器。

预览 PR 5945

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 在单个窗口打开显示器
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N displays-as-individual-windows=Y

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

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "use-all-my-displays-for-the-remote_session"。

被控端设置中的 "use-all-my-displays-for-the-remote_session" 控制是否在连接时, 尽量使用所有的本地显示器连接被控所有显示器。

预览 PR 6064

位置:

  1. 桌面端 设置 -> 显示 -> 其他默认选项 -> 将我的所有显示器用于远程会话
  2. 移动端
是否需要安装 可设值 默认值 示例
N Y, N N use-all-my-displays-for-the-remote_session=Y

view-style

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "view-style"。

被控端设置中的 "view-style" 控制是否显示方式。

位置:

  1. 桌面端 设置 -> 显示 -> 默认显示方式
  2. 移动端 设置 -> 显示设置 -> 默认显示方式
是否需要安装 可设值 默认值 示例
N original, adaptive original view-style=original

scroll-style

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "scroll-style"。

被控端设置中的 "scroll-style" 控制是否滚动方式。

位置:

  1. 桌面端 设置 -> 显示 -> 默认滚动方式
  2. 移动端
是否需要安装 可设值 默认值 示例
N scrollauto, scrollbar scrollauto scroll-style=scrollauto

image-quality

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "image-quality"。

被控端设置中的 "image-quality" 控制图像质量。

位置:

  1. 桌面端 设置 -> 显示 -> 默认图像质量
  2. 移动端 设置 -> 显示设置 -> 默认图像质量
是否需要安装 可设值 默认值 示例
N best, balanced, low, custom balanced image-quality=balanced

custom-image-quality

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "custom-image-quality"。

被控端设置中的 "custom-image-quality" 控制图像质量(当 "image-quality" 为 custom 的时候)。

位置:

  1. 桌面端 设置 -> 显示 -> 默认图像质量 -> 自定义
  2. 移动端 设置 -> 显示设置 -> 默认图像质量 -> 自定义
是否需要安装 可设值 默认值 示例
N [10.0, 2000.0] 50.0 custom-image-quality=50

custom-fps

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "custom-fps"。

被控端设置中的 "custom-fps" 控制 fps当 "image-quality" 为 custom 的时候)。

位置:

  1. 桌面端 设置 -> 显示 -> 默认图像质量 -> 自定义
  2. 移动端 设置 -> 显示设置 -> 默认图像质量 -> 自定义
是否需要安装 可设值 默认值 示例
N [5, 120] 30 custom-fps=30

codec-preference

这个选项会在第一次连接每个被控端的后, 设置关于该被控端的 "codec-preference"。

被控端设置中的 "codec-preference" 控制图像的编解码。

Location:

  1. 桌面端 设置 -> 显示 -> 默认编解码
  2. 移动端 设置 -> 显示设置 -> 默认编解码
是否需要安装 可设值 默认值 示例
N auto, vp8, vp9, av1, h264, h265 auto codec-preference=auto

注意: "vp8" 和 "vp9" 以外的选项可能不起作用。 这取决于您的机器支持什么。