mirror of
https://github.com/nyakang/nyaterm.git
synced 2026-11-06 16:07:55 +00:00
Kang
0bd5f8093b
- Updated `Cargo.toml` to reflect new versions for `ironrdp-cliprdr`, `ironrdp-pdu`, and `ironrdp-svc`, ensuring compatibility with recent changes. - Implemented a test to verify that the clipboard backend supports file capabilities across all legacy clipboard modes. - Normalized clipboard settings to always enable text and file redirection, improving user experience and consistency across sessions. - Adjusted related documentation to clarify the new clipboard behavior and its implications for users.
74 lines
2.9 KiB
Markdown
74 lines
2.9 KiB
Markdown
# RDP 远程桌面
|
||
|
||
RDP 会话连接 Windows 主机或其他提供 RDP 服务的远程桌面。它和终端会话共享标签页、分屏和已保存连接体系，但承载的是图形画面而不是文本终端。
|
||
|
||
RDP 的协议解码运行在独立的 helper 进程中。从源码运行时需要先构建 helper，否则连接会以 `HelperMissing` 失败，见 [开发环境搭建](../development/setup#rdp--vnc-需要先构建-helper)。
|
||
|
||
## 连接配置
|
||
|
||
### 基本信息
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 主机 / 端口 | RDP 服务地址，默认端口 `3389` |
|
||
| 用户名 | 登录用户名 |
|
||
| 域 | Active Directory 域，独立主机留空 |
|
||
| 密码 | 登录密码 |
|
||
|
||
### 安全
|
||
|
||
**网络级身份验证**（NLA / CredSSP）在远程主机支持时启用。
|
||
|
||
**证书策略** 决定首次遇到未知证书时的行为：
|
||
|
||
| 策略 | 行为 |
|
||
|------|------|
|
||
| 未知证书时询问 | 弹出验证对话框由你决定（默认） |
|
||
| 拒绝不受信任证书 | 直接拒绝，不询问 |
|
||
| 仅本次接受 | 接受但不写入信任记录，下次仍会询问 |
|
||
|
||
选择 **未知证书时询问** 时，对话框可以只接受本次连接，也可以接受并记住该证书。已保存的证书后续发生变化时，连接前会再次提示。
|
||
|
||
### 显示
|
||
|
||
**显示模式** 可选 **适应窗口**（默认）或 **固定尺寸**。选择固定尺寸时需要填写宽高：
|
||
|
||
- 宽度范围 **640 到 7680**
|
||
- 高度范围 **480 到 4320**
|
||
|
||
默认分辨率为 1920×1080，色深 32 位。
|
||
|
||
### 剪贴板
|
||
|
||
剪贴板始终开启，无需配置。内置后端支持双向文本和文件／目录复制，尚不支持图片和富文本通道。Windows Native 使用微软控件的完整剪贴板重定向，实际格式和文件传输能力取决于系统控件及服务端策略。
|
||
|
||
旧连接、备份或恢复会话中保存的关闭／仅文本值仍可读取，但不再限制运行时的剪贴板能力。剪贴板重定向不会同时开启磁盘、打印机或设备重定向。
|
||
|
||
### 重连
|
||
|
||
**自动重连** 默认开启，对临时网络故障做有限次数重试。**重试次数** 范围 **0 到 20**，默认 5 次。
|
||
|
||
## 能力边界
|
||
|
||
RDP 会话不提供这些 SSH 专属能力：
|
||
|
||
- 终端命令历史与命令建议
|
||
- SFTP 文件浏览器
|
||
- SSH 代理、跳板机与隧道
|
||
- 远程主机监控面板
|
||
|
||
需要命令行能力时使用 SSH、本地终端、Telnet 或串口会话。
|
||
|
||
## 错误分类
|
||
|
||
连接失败时的错误类型有助于判断方向：
|
||
|
||
| 类型 | 常见原因 |
|
||
|------|----------|
|
||
| `Authentication` | 用户名、密码或域不正确；NLA 要求未满足 |
|
||
| `CertificateRejected` | 证书策略拒绝了服务器证书 |
|
||
| `ConnectionRefused` / `Timeout` | 端口不可达、防火墙拦截或主机未启用 RDP |
|
||
| `Tls` / `Negotiation` | TLS 握手或协议协商失败 |
|
||
| `HelperMissing` | helper 可执行文件不在应用旁边 |
|
||
| `HelperCrashed` | helper 进程在会话期间退出 |
|