客户端下载与安装
从官网获取对应系统安装包，双击运行，一路 Next 即可完成。安装后自动生成设备代码与临时密码，作为被控端的唯一入口。
root@todesk:~/guide$ init --title
ToDesk新手入门指南：快速上手远程控制
本指南将带你从零开始，完成 客户端下载安装、设备连接、安全设置 与 文件传输中心 的完整配置流程，并快速掌握共享剪贴板与跨系统拖拽文件等核心功能。全程命令行式讲解，新手也能一次跑通。
[00:00][OK] 检测运行环境 ... Windows 11 / macOS 14
[00:01][OK] 加载模块: remote-control, file-transfer, clipboard
[00:02][OK] 安全通道建立: TLS 1.3 + AES-256
[00:03][WARN] 未设置访问密码，建议前往安全设置完成配置
[00:04][READY] 等待设备连接 ...
// modules
入门必会的五大核心模块
ToDesk 将远程控制拆分为若干独立模块，理解它们的作用，能让你的上手路径更清晰。以下五项是新手最先需要掌握的。
设备连接与远程桌面
在控端输入被控端的 设备代码 与 密码，点击连接即可进入远程桌面。支持多屏切换、分辨率自适应与画面质量调节。
安全设置与权限管理
设置固定密码、开启双重验证、配置黑白名单，并针对每次会话授予临时权限，确保远程连接始终处于可控状态。
文件传输中心
会话中打开文件传输面板，即可在本地与远程设备之间双向传输文件，支持断点续传与批量拖拽。
共享剪贴板与拖拽
开启共享剪贴板后，两端复制粘贴即时同步；跨系统拖拽文件可直接把文件从本机拖入远程窗口完成传输。
// quickstart
四步完成首次远程连接
按照下面的顺序操作，通常 5 分钟内即可完成第一次远程控制。每一步都配有命令式提示，方便对照排查。
01DOWNLOAD
下载并安装客户端
访问 ToDesk 官网首页，根据系统选择对应安装包。Windows 用户下载 .exe，macOS 用户下载 .dmg，Linux 用户可选择 .deb 或 .rpm。安装过程中请保持网络畅通，首次启动会自动完成组件注册。
02IDENTIFY
记录被控端设备代码与密码
在被控端打开 ToDesk 主界面，左侧会显示一串九位 设备代码，右侧显示临时密码。建议登录账号后将其加入「设备列表」，后续可免密直达，无需每次手动输入。
03CONNECT
在控端发起连接
在控端输入被控端设备代码，点击「连接」，再输入密码确认。首次连接可能会提示安全确认，被控端点击「接受」后即进入远程桌面。若连接失败，可参考 常见问题排查页 中的网络与防火墙检查清单。
04TRANSFER
开启文件传输与剪贴板同步
进入远程桌面后，在顶部工具条点击「文件」打开传输中心，或直接开启「共享剪贴板」开关。此时两端复制粘贴与文件拖拽即时生效，具体技巧可延伸阅读 文件传输与共享剪贴板使用技巧。
// 首次连接检查清单 · checklist.shbash
# 1. 确认被控端已启动并处于在线状态 check "被控端 ToDesk 状态" → online # 2. 确认设备代码与密码输入正确（区分大小写） verify device_code && password # 3. 检查网络连通性与防火墙放行 ping relay.todesk.com → latency 12ms # 4. 开启所需权限（剪贴板 / 文件传输 / 音频） grant clipboard,file-transfer,audio → 全部通过，可以发起连接。
// security
安全设置：让远程连接始终可控
远程控制的核心风险在于「谁能在什么条件下进入你的设备」。ToDesk 提供了多层防护，新手至少应完成前三项配置。
// 推荐安全基线配置 · security.confconf
# 访问密码：固定密码 + 临时密码双通道 set access.password = "强密码(12位以上)" set access.temp_password = "每次连接随机" # 双重验证：登录与高危操作二次确认 set security.2fa = enabled # 黑白名单：仅允许可信设备发起连接 set whitelist = ["设备A", "设备B"] # 会话权限：按需授予，用完即回收 set session.permission = temporary → 配置已生效，建议每 90 天复查一次。
对于需要长期远控的办公电脑，建议开启「固定密码」并配合设备列表使用；对于临时协助家人朋友的场景，则使用「临时密码」更安全。任何情况下，都不要把设备代码与密码同时发送到公开群聊或社交平台。
// transfer
文件传输中心：双向传输与拖拽
文件传输是新手最容易忽略却最常用的功能。ToDesk 的文件传输中心支持双向传输、批量操作与断点续传，配合共享剪贴板即可实现无缝协作。
双向文件传输
在传输中心左右两栏分别代表本地与远程，选中文件后点击方向箭头即可上传或下载，大文件支持断点续传。
跨系统拖拽
Windows 与 macOS 之间可直接把文件从本机拖入远程窗口，系统会自动完成格式与路径适配，无需打包压缩。
共享剪贴板
开启后两端文本复制粘贴实时同步，支持中文与富文本，适合代码片段、链接与表格内容的快速传递。
更完整的传输技巧、速度优化与常见报错处理，请参阅 ToDesk文件传输与共享剪贴板使用技巧 专题页。
// feedback
用户真实评价
以下评价来自实际使用 ToDesk 完成远程办公与协助的用户，按时间倒序排列。
★★★★★
按照这篇指南一步步装好，第一次远程连接只花了不到三分钟，剪贴板同步真的很省事，代码直接复制粘贴过去就能跑。
@林工 · 后端开发
★★★★★
给家里老人远程修电脑，临时密码加白名单很安心，拖拽文件传照片也特别方便，不用再教他们用网盘了。
@周女士 · 自由职业
★★★★★
跨系统拖拽偶尔会有延迟，但整体体验很稳，文档里把防火墙排查写得很清楚，连接失败的问题当场就解决了。
@陈同学 · 设计专业
// authors
本指南的作者团队
内容由长期负责远程办公支持与客户端测试的同学共同撰写，并经过实际设备复现验证。
沈墨
// 技术文档主笔
负责远程控制客户端文档撰写，擅长把复杂配置拆成可复现的步骤。
赵一诺
// 客户端测试工程师
覆盖 Windows、macOS 与移动端的兼容性测试，负责整理常见故障清单。
顾行
// 安全与合规
专注远程连接安全策略，输出密码管理与权限最小化的实践建议。
// partners
被这些团队用于日常远程协作
ToDesk 广泛服务于中小企业 IT 支持、远程设计协作与教育场景，以下是部分合作与典型使用方。
NEXUS IT
云桁科技
BLUEPRINT LAB
远山设计
CORE OPS
栖木教育
GRIDWORKS
星野工作室
// faq
新手常见问题
以下问题在初次使用中最常出现，点击标题即可展开答案。
安装完成后无法连接远程设备怎么办？
先确认被控端 ToDesk 已启动并显示在线，再核对九位设备代码与密码是否输入正确。若仍失败，检查本机防火墙是否放行 ToDesk 主程序，并尝试切换中继节点。更多排查步骤见 常见问题解答页。
共享剪贴板开启了却没有同步？
请确认远程会话顶部工具条中的「共享剪贴板」开关已打开，且两端客户端版本一致。部分系统需要授予剪贴板读取权限，macOS 用户可在「系统设置 → 隐私与安全性」中放行。
跨系统拖拽文件为什么没有反应？
拖拽传输需要会话中已启用文件传输权限。若被控端处于「仅查看」模式，拖拽会被拦截。请在被控端权限设置中开启文件传输，并确保文件未被系统占用。
临时密码每次都不一样，如何免密连接？
登录同一账号后，将被控设备加入设备列表，即可在控端直接点击设备发起连接。若需固定密码，请在安全设置中开启固定密码，并配合双重验证使用，避免密码泄露风险。
远程桌面画面卡顿、延迟高怎么优化？
可在会话工具栏降低画质或关闭动画效果，优先选择就近的中继节点；同时关闭被控端不必要的后台程序。网络条件较差时，建议使用有线网络或 5GHz Wi-Fi。
// changelog
最新资讯与更新日志
近期与新手使用相关的功能更新与文档修订记录。