rustdesk/doc.rustdesk.com
1
0
Fork 0
mirror of https://github.com/rustdesk/doc.rustdesk.com.git synced 2025-07-03 00:05:59 +00:00
Code Issues Packages Projects Releases Wiki Activity
doc.rustdesk.com/content/self-host/client-configuration/advanced-settings/_index.zh-cn.md
RustDesk 7446ff2d28
Update _index.zh-cn.md
2025-06-18 17:36:53 +08:00

1244 lines
39 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: 高级设置
weight: 49
---
所有自定义客户端中的高级设置都在这里涵盖。
## 设置的权限级别
有四种类型的设置：
1. 覆盖设置，在`Web控制台` → `自定义客户端`中
2. 默认设置，在`Web控制台` → `自定义客户端`中
3. 用户设置，在RustDesk客户端中
4. 策略设置，在`Web控制台` → `策略`中
这些设置的权限层次结构如下：`覆盖 > 策略 > 用户 > 默认`。
## 安全设置
### access-mode
设置传入连接的访问模式（权限）。
**位置**：
1. **桌面** 设置 → 安全 → 权限
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | custom, full, view | custom | `access-mode=custom` |
### enable-keyboard
启用传入连接的键盘/鼠标输入。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用键盘
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-keyboard=Y` |
### enable-clipboard
启用传入连接的复制和粘贴。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用剪贴板
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-clipboard=Y` |
### enable-file-transfer
启用传入连接的文件复制粘贴或文件传输（会话）。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用文件传输
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-file-transfer=Y` |
### enable-camera
启用传入连接的摄像头。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用摄像头
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-camera=Y` |
### enable-remote-printer
启用传入连接的远程打印机。
**位置**：
1. **Windows** 设置 → 安全 → 权限 → 启用远程打印机
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-remote-printer=Y` |
### enable-audio
启用音频记录并传输到对等端。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用音频
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-audio=Y` |
### enable-tunnel
启用TCP隧道。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用TCP隧道
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-tunnel=Y` |
### enable-remote-restart
启用控制端重启。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用远程重启
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-remote-restart=Y` |
### enable-record-session
启用会话录制。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用录制会话
2. **移动端** 设置 → 屏幕共享 → 启用录制会话
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-record-session=Y` |
### enable-block-input
启用控制端阻止其他用户的输入。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用阻止用户输入（仅Windows）
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-block-input=Y` |
### allow-remote-config-modification
允许控制端更改受控RustDesk UI中的设置。
**位置**：
1. **桌面** 设置 → 安全 → 权限 → 启用远程配置修改
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-remote-config-modification=Y` |
### enable-lan-discovery
允许局域网对等端发现我。
启用局域网发现后，如果本地支持，[WOL](https://en.wikipedia.org/wiki/Wake-on-LAN)可以工作。
**位置**：
1. **桌面** 设置 → 安全 → 安全 → 拒绝局域网发现
2. **移动端** 设置 → 屏幕共享 → 拒绝局域网发现
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 是 | Y, N | Y | `enable-lan-discovery=Y` |
### direct-server
启用直接IP访问。
**位置**：
1. **桌面** 设置 → 安全 → 安全 → 启用直接IP访问
2. **移动端** 设置 → 屏幕共享 → 直接IP访问
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `direct-server=Y` |
### direct-access-port
直接IP访问端口。
**位置**：
1. **桌面** 设置 → 安全 → 安全 → 直接IP访问端口（勾选"启用直接IP访问"时显示）
2. **移动端** 设置 → 屏幕共享 → 直接IP访问
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | | 21118 | `direct-access-port=21118` |
### whitelist
使用IP白名单。
**位置**：
1. **桌面** 设置 → 安全 → 安全 → 使用IP白名单
2. **移动端** 设置 → 屏幕共享 → 使用IP白名单
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | `,` 或 `<ip1>,<ip2>,<ip3>` | `,` 表示无过滤 | `whitelist=,` |
### allow-auto-disconnect & auto-disconnect-timeout
在用户不活动一段时间后自动关闭传入会话。
**位置**：
1. **桌面** 设置 → 安全 → 安全 → 用户不活动时自动关闭传入会话
2. **移动端** 设置 → 屏幕共享 → 用户不活动时自动关闭传入会话
| 选项 | 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: | :------: |
| allow-auto-disconnect | 否 | Y, N | N | `allow-auto-disconnect=Y` |
| auto-disconnect-timeout | 否 | 超时分钟数 | 10 | `auto-disconnect-timeout=10` |
### allow-only-conn-window-open
仅在RustDesk窗口打开时允许连接。
**位置**：
1. **桌面** 设置 → 安全 → 安全 → 仅在RustDesk窗口打开时允许连接
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 是 | Y, N | N | `allow-only-conn-window-open=N` |
### approve-mode
通过密码或手动点击接受传入连接。
**位置**：
1. **桌面** 设置 → 安全 → 密码 → 下拉框
2. **移动端** 屏幕共享 → 右上角下拉菜单
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | password, click, password-click | password-click | `approve-mode=password-click` |
### verification-method
可以使用什么类型的密码，`临时密码`是指一次性随机密码。
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | use-temporary-password, use-permanent-password, use-both-passwords | use-both-passwords | `verification-method=use-permanent-password` |
### 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. **移动端**
| 选项 | 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: | :------: |
| proxy-username | 否 | | | `proxy-username=user` |
| proxy-password | 否 | | | `proxy-password=pass` |
## 常规设置
### theme
控制RustDesk客户端的UI主题。
**位置**：
1. **桌面** 设置 → 常规 → 主题
2. **移动端** 设置 → 设置 → 主题
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | dark, light, system | system | `theme=system` |
### lang
控制RustDesk客户端的语言。
**位置**：
1. **桌面** 设置 → 常规 → 语言
2. **移动端** 设置 → 设置 → 语言
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | 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, uk, vn, zh-cn, zh-tw
您可以查看代码中的[LANGS](https://github.com/rustdesk/rustdesk/blob/master/src/lang.rs#L45)获取最新的语言列表。
### allow-auto-record-incoming
自动录制传入会话。
**位置**：
1. **桌面** 设置 → 常规 → 录制 → 自动录制传入会话
2. **移动端** 设置 → 录制 → 自动录制传入会话
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-auto-record-incoming=Y` |
### allow-auto-record-outgoing
自动录制传出会话。
**位置**：
1. **桌面** 设置 → 常规 → 录制 → 自动录制传出会话
2. **移动端** 设置 → 录制 → 自动录制传出会话
| 安装需要 | 值 | 默认值 | 示例 | 版本 |
| :------: | :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-auto-record-outgoing=Y` | >= 1.3.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. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-confirm-closing-tabs=Y` |
### enable-abr
启用自适应比特率。
**位置**：
1. **桌面** 设置 → 常规 → 其他 → 自适应比特率
2. **移动端** 设置 → 屏幕共享 → 自适应比特率（测试版）
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-abr=Y` |
### allow-remove-wallpaper
在传入会话期间移除壁纸。
**位置**：
1. **桌面** 设置 → 常规 → 其他 → 传入会话期间移除壁纸
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-remove-wallpaper=N` |
### enable-open-new-connections-in-tabs
控制是否使用新标签或新窗口打开新连接。
**位置**：
1. **桌面** 设置 → 常规 → 其他 → 在新标签中打开连接
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-open-new-connections-in-tabs=Y` |
### allow-always-software-render
始终使用软件渲染。
**位置**：
1. **桌面** 设置 → 常规 → 其他 → 始终使用软件渲染
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
如果没有显示器，允许传入连接。
此选项需要桌面环境、Xorg服务器和GDM，请参阅[PR 3902](https://github.com/rustdesk/rustdesk/pull/3902)。
**位置**：
1. **桌面** 设置 → 常规 → 其他 → 允许Linux无头模式
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 是 | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec
启用硬件编码以使画面更流畅。
**位置**：
1. **桌面**
2. **移动端** 设置 → 硬件编解码器
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | Y | `enable-hwcodec=Y` |
### peer-card-ui-type
控制对等端卡片的视图，包括"大磁贴"、"小磁贴"和"列表"。
**位置**：
1. **桌面** 首页 → 对等端面板 → 右上角网格图标
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | 0, 1, 2 | 0 | `peer-card-ui-type=0` |
**0** 大磁贴
**1** 小磁贴
**2** 列表
### peer-sorting
控制对等端卡片的排序。
**位置**：
1. **桌面** 首页 → 对等端面板 → 右上角排序图标
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Remote ID, Remote Host, Username | Remote ID | `peer-sorting=Remote ID` |
### sync-ab-with-recent-sessions
控制是否将通讯录与最近会话同步。
**位置**：
1. **桌面** 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 与最近会话同步
2. **移动端** 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 与最近会话同步
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `sync-ab-with-recent-sessions=N` |
### sync-ab-tags
控制是否对通讯录标签进行排序。
**位置**：
1. **桌面** 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 标签排序
2. **移动端** 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 标签排序
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `sync-ab-tags=N` |
### filter-ab-by-intersection
按标签交集过滤通讯录。
**预览**：[PR #5985](https://github.com/rustdesk/rustdesk/pull/5985)
**位置**：
1. **桌面** 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 按交集过滤
2. **移动端** 首页 → 对等端面板 → 通讯录 → 标签 → 下拉菜单 → 按交集过滤
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `filter-ab-by-intersection=N` |
## 显示设置
### view-only
此选项将为每个对等端在首次连接后设置"仅查看"选项。
然后每个对等端设置中的"仅查看"选项将控制连接是否为仅查看模式。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 查看模式
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 查看模式
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `view-only=Y` |
### show-monitors-toolbar
控制是否在工具栏中显示监视器。
![show-monitors-toolbar](/docs/en/self-host/client-configuration/advanced-settings/images/show-monitors-toolbar.png)
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 显示监视器工具栏
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `show-monitors-toolbar=Y` |
### collapse-toolbar
控制连接后远程工具栏是否折叠。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 折叠工具栏
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `collapse-toolbar=Y` |
### show-remote-cursor
此选项将为每个对等端在首次连接后设置"显示远程光标"选项。
然后每个对等端设置中的"显示远程光标"选项将控制是否在远程控制页面中显示远程光标。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 显示远程光标
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 显示远程光标
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `show-remote-cursor=N` |
### follow-remote-cursor
此选项将为每个对等端在首次连接后设置"跟随远程光标"选项。
然后每个对等端设置中的"跟随远程光标"选项将控制是否跟随远程光标。
**预览**：[PR 7717](https://github.com/rustdesk/rustdesk/pull/7717)
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 跟随远程光标
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 跟随远程光标
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `follow-remote-cursor=Y` |
### follow-remote-window
此选项将为每个对等端在首次连接后设置"跟随远程窗口"选项。
然后每个对等端设置中的"跟随远程窗口"选项将控制是否跟随远程窗口。
**预览**：[PR 7717](https://github.com/rustdesk/rustdesk/pull/7717)
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 跟随远程窗口焦点
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 跟随远程窗口焦点
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `follow-remote-window=Y` |
### zoom-cursor
此选项将为每个对等端在首次连接后设置"缩放光标"选项。
每个对等端设置中的"缩放光标"选项将控制光标是否根据当前图像缩放进行缩放。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 缩放光标
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `zoom-cursor=Y` |
### show-quality-monitor
此选项将为每个对等端在首次连接后设置"显示质量监视器"选项。
每个对等端设置中的"显示质量监视器"选项将控制是否显示质量监视器。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 显示质量监视器
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 显示质量监视器
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `show-quality-monitor=Y` |
### disable-audio
此选项将为每个对等端在首次连接后设置"禁用音频"选项。
每个对等端设置中的"禁用音频"选项将控制是否播放声音。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 静音
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 静音
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `disable-audio=Y` |
### enable-file-copy-paste
此选项将为每个对等端在首次连接后设置"启用文件复制粘贴"选项。
每个对等端设置中的"启用文件复制粘贴"选项将控制是否在连接中启用文件复制粘贴。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 启用文件复制粘贴（仅Windows）
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `enable-file-copy-paste=Y` |
### disable-clipboard
此选项将为每个对等端在首次连接后设置"禁用剪贴板"选项。
每个对等端设置中的"禁用剪贴板"选项将控制是否启用文本复制粘贴。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 禁用剪贴板
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 禁用剪贴板
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `disable-clipboard=Y` |
### lock-after-session-end
此选项将为每个对等端在首次连接后设置"会话结束后锁定"选项。
每个对等端设置中的"会话结束后锁定"选项将控制会话结束后是否锁定对等机器。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 会话结束后锁定
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 会话结束后锁定
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `lock-after-session-end=Y` |
### privacy-mode
此选项将为每个对等端在首次连接后设置"隐私模式"选项。
每个对等端设置中的"隐私模式"选项将控制连接后是否使用隐私模式。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 隐私模式
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 隐私模式
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `privacy-mode=Y` |
### touch-mode
此选项将为每个对等端在首次连接后设置"触控模式"选项。
每个对等端设置中的"触控模式"选项将控制是否使用触控模式或鼠标模式。
**位置**：
1. **桌面**
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 触控模式
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `touch-mode=Y` |
### i444
此选项将为每个对等端在首次连接后设置"i444"选项。
每个对等端设置中的"i444"选项将控制是否使用真彩色。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 真彩色（4:4:4）
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 真彩色（4:4:4）
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `i444=Y` |
### reverse-mouse-wheel
此选项将为每个对等端在首次连接后设置"反转鼠标滚轮"选项。
每个对等端设置中的"反转鼠标滚轮"选项将控制是否反转鼠标滚轮。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 反转鼠标滚轮
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 反转鼠标滚轮
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `reverse-mouse-wheel=Y` |
### swap-left-right-mouse
此选项将为每个对等端在首次连接后设置"交换左右鼠标按钮"选项。
每个对等端设置中的"交换左右鼠标按钮"选项将控制是否交换左右鼠标按钮。
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 交换左右鼠标按钮
2. **移动端** 设置 → 显示设置 → 其他默认选项 → 交换左右鼠标按钮
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `swap-left-right-mouse=Y` |
### displays-as-individual-windows
此选项将为每个对等端在首次连接后设置"显示为单独窗口"选项。
每个对等端设置中的"显示为单独窗口"选项将控制是否将显示器显示为单独的窗口。
**预览**：[PR 5945](https://github.com/rustdesk/rustdesk/pull/5945)
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 将显示器显示为单独窗口
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `displays-as-individual-windows=Y` |
### use-all-my-displays-for-the-remote_session
此选项将为每个对等端在首次连接后设置"为远程会话使用我的所有显示器"选项。
每个对等端设置中的"为远程会话使用我的所有显示器"选项将控制是否为远程会话使用我的所有显示器。
**预览**：[PR 6064](https://github.com/rustdesk/rustdesk/pull/6064)
**位置**：
1. **桌面** 设置 → 显示 → 其他默认选项 → 为远程会话使用我的所有显示器
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `use-all-my-displays-for-the-remote_session=Y` |
### view-style
此选项将为每个对等端在首次连接后设置"查看样式"选项。
每个对等端设置中的"查看样式"选项将控制查看样式。
**位置**：
1. **桌面** 设置 → 显示 → 默认查看样式
2. **移动端** 设置 → 显示设置 → 默认查看样式
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | original, adaptive | original | `view-style=original` |
### scroll-style
此选项将为每个对等端在首次连接后设置"滚动样式"选项。
每个对等端设置中的"滚动样式"选项将控制滚动样式。
**位置**：
1. **桌面** 设置 → 显示 → 默认滚动样式
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | scrollauto, scrollbar | scrollauto | `scroll-style=scrollauto` |
### image-quality
此选项将为每个对等端在首次连接后设置"图像质量"选项。
每个对等端设置中的"图像质量"选项将控制图像质量。
**位置**：
1. **桌面** 设置 → 显示 → 默认图像质量
2. **移动端** 设置 → 显示设置 → 默认图像质量
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | best, balanced, low, custom | balanced | `image-quality=balanced` |
### custom-image-quality
此选项将为每个对等端在首次连接后设置"自定义图像质量"选项。
如果"图像质量"设置为自定义，每个对等端设置中的"自定义图像质量"选项将控制图像质量。
**位置**：
1. **桌面** 设置 → 显示 → 默认图像质量 → 自定义
2. **移动端** 设置 → 显示设置 → 默认图像质量 → 自定义
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | [10.0, 2000.0] | 50.0 | `custom-image-quality=50` |
### custom-fps
此选项将为每个对等端在首次连接后设置"自定义帧率"选项。
如果"图像质量"设置为自定义，每个对等端设置中的"自定义帧率"选项将控制帧率。
**位置**：
1. **桌面** 设置 → 显示 → 默认图像质量 → 自定义
2. **移动端** 设置 → 显示设置 → 默认图像质量 → 自定义
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | [5, 120] | 30 | `custom-fps=30` |
### codec-preference
此选项将为每个对等端在首次连接后设置"编解码器偏好"选项。
每个对等端设置中的"编解码器偏好"选项将控制图像的编解码器。
**位置**：
1. **桌面** 设置 → 显示 → 默认编解码器
2. **移动端** 设置 → 显示设置 → 默认编解码器
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 否 | auto, vp8, vp9, av1, h264, h265 | auto | `codec-preference=auto` |
**注意**：除了"vp8"和"vp9"之外的选项可能无法工作。这取决于你的机器支持什么。
## 其他
### preset-address-book-name & preset-address-book-tag
预设通讯录名称和标签，https://github.com/rustdesk/rustdesk-server-pro/issues/257。
如果不想设置标签，可以仅设置preset-address-book-name。
请在Web控制台的通讯录页面上使用有效的通讯录名称和标签。
| 选项 | 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | 否 | | | `preset-address-book-name=<通讯录名称>` |
| preset-address-book-tag | 否 | | | `preset-address-book-tag=<通讯录标签名称>` |
### disable-group-panel
在RustDesk客户端上禁用组面板（在通讯录面板旁边，自1.3.8版本起命名为"可访问设备"），https://github.com/rustdesk/rustdesk-server-pro/issues/250。
| 选项 | 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: | :------: |
| disable-group-panel | 否 | Y, N | N | `disable-group-panel=Y` |
### pre-elevate-service
Windows便携版运行时自动提升权限，https://github.com/rustdesk/rustdesk-server-pro/issues/252。
| 选项 | 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: | :------: |
| pre-elevate-service | 否 | Y, N | N | `pre-elevate-service=Y` |
### disable-floating-window
当Android服务启动时，它会显示一个浮动窗口，这有助于防止系统杀死RustDesk服务。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `disable-floating-window=Y` |
### floating-window-size
当Android服务启动时，它会显示一个浮动窗口，这有助于防止系统杀死RustDesk服务。当大小小于120时，浮动窗口将难以被点击。非常小的尺寸可能无法在某些设备上保持后台服务。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| [32, 320] | 120 | `floating-window-size=120` |
### floating-window-untouchable
默认情况下，点击浮动窗口会弹出菜单。设置为"不可触摸"后，点击或滑动将穿过浮动窗口并传输到底层窗口。设置为"不可触摸"后，浮动窗口的位置无法更改，系统可能会自动将浮动窗口设置为半透明。但是，此功能可能在少数应用程序中不起作用，例如GitHub应用。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `floating-window-untouchable=Y` |
### floating-window-transparency
Android浮动窗口具有可调节的透明度。如果要启用但隐藏浮动窗口，可以将透明度设置为0，浮动窗口将自动设置为"不可触摸"以穿透点击事件。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| [0, 10] | 10 | `floating-window-transparency=5` |
### floating-window-svg
如果没有为Android浮动窗口设置图标，它将默认显示RustDesk图标。
设置时，请将SVG的文本内容写成一行，并注意[SVG支持限制](https://bigbadaboom.github.io/androidsvg/index.html)。
| 默认值 | 示例 |
| :------: | :------: |
| RustDesk图标 | `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>` |
### keep-screen-on
这是针对Android受控端的。请注意，保持屏幕开启依赖于浮动窗口。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| never, during-controlled, service-on | during-controlled | `keep-screen-on=never` |
### enable-directx-capture
这是针对Windows受控端的。如果没有遇到任何问题，建议使用默认设置，优先使用DirectX进行截图而不是直接使用GDI。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | Y | `enable-directx-capture=N` |
### enable-android-software-encoding-half-scale
这是针对Android受控端的。默认情况下，当分辨率大于1200时，硬件编码使用原始分辨率，而软件编码使用一半分辨率，因为软件编码较慢。此选项用于设置软件编码是否应缩放到一半分辨率。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | Y | `enable-android-software-encoding-half-scale=N` |
### allow-remote-cm-modification
控制是否允许控制端点击连接管理窗口来接受连接、更改权限等。
https://github.com/rustdesk/rustdesk/issues/7425
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-remote-cm-modification=Y` |
### remove-preset-password-warning
控制当自定义客户端中有预设密码时是否移除GUI上的安全警告。
https://github.com/rustdesk/rustdesk-server-pro/discussions/286
https://github.com/rustdesk/rustdesk/discussions/7956
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | Y | `remove-preset-password-warning=Y` |
### 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
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `hide-security-settings=Y` |
### hide-username-on-card
控制是否在设备列表中显示用户名。因为有时用户名太长，会隐藏其他信息。
https://github.com/rustdesk/rustdesk-server-pro/issues/284#issuecomment-2216521407
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `hide-username-on-card=Y` |
### hide-help-cards
控制是否在GUI上显示UAC/权限警告。
https://github.com/rustdesk/rustdesk/issues/8687
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `hide-help-cards=Y` |
### display-name
更改将在连接到远程设备时弹出窗口中显示的显示名称。默认情况下，它首先显示登录用户的名称，否则显示您的操作系统用户名。
https://github.com/rustdesk/rustdesk-server-pro/issues/277
### disable-udp
控制是否仅使用TCP。它将不再使用UDP 21116，而是使用TCP 21116。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
将用户/策略/设备组分配给设备。您也可以通过[命令行](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)执行此操作。
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
设备组在RustDesk客户端>=1.3.8、pro >= 1.5.0中可用
### default-connect-password
您使用`默认连接密码`来建立到远程设备的连接。此密码在控制端配置，不应与受控（仅传入）客户端上找到的任何[预设密码](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access)混淆。
例如 `default-connect-password=abcd1234`
### enable-trusted-devices
允许受信任的设备跳过2FA验证。
https://github.com/rustdesk/rustdesk/discussions/8513#discussioncomment-10234494
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | Y | `enable-trusted-devices=N` |
### hide-tray
禁用系统托盘中的托盘图标。
https://github.com/rustdesk/rustdesk-server-pro/issues/332
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `hide-tray=Y` |
### one-way-clipboard-redirection
禁用从受控端到控制端的剪贴板同步，在RustDesk客户端>=1.3.1（受控端）中可用
https://github.com/rustdesk/rustdesk/discussions/7837
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `one-way-clipboard-redirection=Y` |
### one-way-file-transfer
禁用从受控端到控制端的文件传输，在RustDesk客户端>=1.3.1（受控端）中可用
https://github.com/rustdesk/rustdesk/discussions/7837
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `one-way-file-transfer=Y` |
### sync-init-clipboard
建立连接时是否同步初始剪贴板（仅从控制端到受控端），在RustDesk客户端>=1.3.1（控制端）中可用
https://github.com/rustdesk/rustdesk/discussions/9010
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `sync-init-clipboard=Y` |
### allow-logon-screen-password
在使用[仅点击批准模式](https://rustdesk.com/docs/en/self-host/client-configuration/advanced-settings/#approve-mode)时是否允许在登录屏幕上输入密码，在RustDesk客户端>=1.3.1（受控端）中可用
https://github.com/rustdesk/rustdesk/discussions/9269
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-logon-screen-password=Y` |
### 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
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-https-21114=Y` |
### allow-d3d-render
D3D渲染可以获得高帧率并减少CPU使用率，但在某些设备上远程控制屏幕可能会变黑。在RustDesk客户端>=1.3.9中可用，仅Windows。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-d3d-render=Y` |
### allow-hostname-as-id
[使用主机名作为ID](https://github.com/rustdesk/rustdesk-server-pro/discussions/483)，主机名中的空格会被替换为'-'。这不是100%保证的，只在第一次运行RustDesk客户端时发生（即在新安装的客户端上）；如果发生冲突，将分配一个随机ID。
在RustDesk客户端版本1.4.0及更高版本中可用。
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-hostname-as-id=Y` |
### 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
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-websocket=Y` |
### 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
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | N | `allow-numeric-one-time-password=Y` |
### register-device
不注册设备，您不会在Web控制台的设备页面中看到它。
**仅在Pro服务器>= 1.6.0中可用，需要[custom2许可证](https://rustdesk.com/pricing#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
| 值 | 默认值 | 示例 |
| :------: | :------: | :------: |
| Y, N | Y | `register-device=N` |
Reference in New Issue View Git Blame Copy Permalink