官方下载入口辨别
说明如何从正规渠道获取安装包，识别文件名与数字签名，避免下载到被捆绑的第三方修改版本。
WHAT'S INSIDE
这份安装指南能帮你解决什么
下载安装看起来简单，但真正卡住新手的往往是「装完连不上」「找不到防休眠开关」「权限没给够」。下面四件事是本页的重点。
五大平台逐步安装
Windows、macOS、Linux、Android、iOS 分别给出安装路径、权限授权项与首次启动的注意事项。
设备码与临时密码
解释设备 ID 与临时密码的作用，说明为什么首次连接失败多半是复制错误或密码已刷新。
防休眠设置入口
指出 ToDesk 客户端内的防休眠开关位置，并说明系统电源计划需要同步调整，否则仍会掉线。
网络与端口常识
简单交代局域网直连与公网中转的差异，帮助判断连接慢、画面卡是网络问题还是设置问题。
安全使用习惯
固定密码、设备白名单、临时密码轮换，三条习惯能大幅降低远程通道被陌生人尝试的风险。
BY PLATFORM
各系统版本下载与安装步骤
以「被控端」安装为主要场景说明。如果你是主动去连别人，装好客户端并登录账号即可，步骤更短。
Windows 10 / 11 安装步骤
- 下载安装包：在官方渠道选择 Windows 版本，得到形如
ToDesk_Setup.exe的文件，建议放在桌面方便查找。
< - 校验来源：右键文件查看「属性 → 数字签名」，确认签名信息与官方一致，再双击运行安装程序。
- 选择安装路径：默认路径即可；若系统盘空间紧张，可改到其他分区，但请避免放在中文或特殊符号过多的目录。
- 完成安装并启动：勾选创建桌面快捷方式，安装完成后首次启动会请求防火墙放行，务必选择「允许访问」。
- 记录设备信息：主界面左侧会显示本机的设备 ID 与临时密码，截图或抄写下来，供控制端连接使用。
- 设置防休眠：在客户端设置中找到「防休眠 / 保持唤醒」开关并打开，同时在 Windows 电源计划里把「睡眠」设为「从不」。
NOTE · WINDOWS
如果安装后托盘图标不显示，多半是被系统安全软件拦截了启动项，可在安全软件的白名单中放行 ToDesk 主程序。
macOS 安装步骤
- 选择芯片版本：根据 Mac 是 Apple 芯片还是 Intel 芯片下载对应安装包，通用版体积更大但兼容性更好。
- 拖入应用程序：打开
.dmg后把 ToDesk 图标拖到「应用程序」文件夹，再从启动台打开。 - 授予系统权限：首次运行需在「系统设置 → 隐私与安全性」中开启「屏幕录制」与「辅助功能」，否则只能看不能控。
- 允许后台运行：在「通用 → 登录项」中把 ToDesk 加入允许后台项目，确保重启后能自动待命。
- 关闭节能休眠：在「电池 / 节能」设置里把「防止电脑自动进入睡眠」打开，与客户端内的防休眠开关配合使用。
NOTE · MACOS
macOS 的权限授权需要重启客户端才生效。授权完成后建议先在本机测试一次自连，确认画面与控制都正常。
Linux 安装步骤
- 确认架构与发行版：用
uname -m查看是 x86_64 还是 aarch64，再按 Debian 系或 RedHat 系选择对应包。 - 安装软件包：Debian / Ubuntu 使用
sudo dpkg -i todesk.deb，若报依赖缺失执行sudo apt -f install修复。 - 启动服务：安装完成后通常会自动注册为系统服务，可用
systemctl status todesk查看运行状态。 - 授权图形会话：无桌面环境时只能做命令行运维；需要远程桌面则要保证 X11 或 Wayland 会话正常运行。
- 配置防休眠：在客户端设置中开启防休眠，或在系统层用
systemctl mask sleep.target关闭自动睡眠。
NOTE · LINUX
部分发行版默认开启 Wayland，远程画面可能出现黑屏。可切换到 X11 会话后再测试，或在客户端中选择兼容渲染模式。
Android 安装步骤
- 获取安装包：在应用商店搜索，或从官方渠道下载 APK，安装前需在系统设置中允许「安装未知来源应用」。
- 打开并登录：首次启动按提示允许通知与网络权限，登录账号后即可在设备列表中看到本机。
- 授权被控能力：如需被远程控制，要在系统无障碍设置中开启对应服务，并按提示完成屏幕录制授权。
- 保持前台运行：在电池优化设置中把 ToDesk 设为「不受限制」，避免后台被系统回收导致连接中断。
iOS 安装步骤
- 从 App Store 安装：搜索应用名称并获取，需使用与设备绑定的 Apple ID 完成下载。
- 登录并查看设备码：打开应用登录账号，首页会显示本机 ID，可作为被控端或控制端使用。
- 开启屏幕录制权限：iOS 的被控能力依赖系统屏幕录制权限，需在控制中心或设置中手动开启并保持。
- 保持应用活跃：iOS 后台限制较严，长时间无人值守场景建议配合充电与「引导式访问」保持前台。
CHEAT SHEET
各平台安装要点速查表
把最容易踩坑的几项整理成一张表，安装前扫一眼能省下不少排查时间。
| 平台 | 安装包形态 | 关键权限 | 防休眠入口 | 常见问题 |
|---|---|---|---|---|
| Windows | .exe 安装向导 |
防火墙放行、开机自启 | 客户端设置 + 电源计划 | 托盘图标不显示 |
| macOS | .dmg 拖拽安装 |
屏幕录制、辅助功能 | 客户端开关 + 节能设置 | 只显示画面无法控制 |
| Linux | .deb / .rpm |
图形会话、系统服务 | 客户端开关 + 屏蔽睡眠 | Wayland 下黑屏 |
| Android | APK / 应用商店 | 无障碍、屏幕录制 | 电池优化设为不受限 | 后台被系统回收 |
| iOS | App Store | 屏幕录制、通知 | 保持前台 + 充电 | 后台被挂起断连 |
FIRST CONNECTION
安装完成后的首次连接流程
装好只是第一步，真正让远程控制跑起来，还需要把「被控端」和「控制端」正确配对。
被控端需要做什么
- 保持客户端在后台运行，并确认设备 ID 与临时密码可见。
- 开启「允许被控制」，必要时设置固定密码以便长期访问。
- 在安全设置里启用设备白名单，只允许自己的账号连接。
- 打开防休眠开关，避免人离开后电脑自动睡眠掉线。
控制端需要做什么
- 在另一台设备上安装客户端并登录同一账号，或直接输入设备 ID。
- 输入临时密码或固定密码，等待被控端确认（如已开启验证）。
- 连接成功后先测试鼠标键盘，再调整画质与分辨率适配。
- 若画面卡顿，可切换为中转或直连模式，观察延迟变化。
TIP · 快速自检
连接失败时按顺序排查：设备 ID 是否复制完整 → 密码是否已刷新 → 双方网络是否正常 → 被控端是否被防火墙拦截。四步排完，绝大多数问题都能定位。
THE TEAM
维护这份指南的人
本站内容由几位长期做远程运维与终端支持的作者共同维护，所有步骤都在真实设备上复现过。
林舟
REMOTE OPS · 主笔负责 Windows 与 Linux 章节，长期为中小企业搭建无人值守远程环境，擅长把复杂配置拆成可复现的步骤。
苏晚
APPLE PLATFORM · 编辑负责 macOS 与 iOS 章节，专注苹果生态的权限模型与节能策略，解释为什么「授权了还是连不上」。
何叙
MOBILE & QA · 校对负责 Android 章节与全站校对，逐条验证安装包版本与权限入口，确保每一步描述与当前客户端界面一致。
MYTH BUSTED
三个常见误区与正解
关于下载安装与远程保持在线，流传着不少似是而非的说法，这里逐条纠正。
「安装包越大功能越全，随便找个下载站都行」
安装包体积与功能完整度没有必然关系，第三方下载站常附带捆绑软件或修改版程序。正解是优先使用官方渠道获取安装包，并在运行前检查数字签名与文件信息，安装时留意是否有额外勾选项。
「开了防休眠开关，电脑就绝对不会掉线」
客户端内的防休眠只是其中一环，系统电源计划、屏幕保护、网卡节能、笔记本合盖策略都会让设备进入休眠。正解是客户端开关与系统电源设置同步调整，笔记本还要确认合盖行为，才能做到真正长时间在线。
「macOS 装完就能直接远程控制」
苹果系统对屏幕录制与辅助功能有强制授权要求，未授权时通常只能看到画面而无法操作。正解是安装后主动前往隐私与安全性设置逐项开启，并重启客户端使授权生效，再测试控制是否正常。
FAQ
下载与安装常见问题
以下问题来自真实用户的反馈整理，覆盖安装、权限与防休眠三个方面。
安装时提示「文件已损坏」或「无法验证开发者」怎么办？
这通常出现在 macOS 上，原因是系统安全策略拦截了非商店来源的应用。可在「系统设置 → 隐私与安全性」页面底部找到被拦截的提示，点击「仍要打开」并确认。若仍无法打开，检查安装包是否下载完整，必要时重新从官方渠道获取。
装好了但对方看不到我的设备，是什么原因？
先确认客户端是否处于登录且在线状态，再检查设备 ID 是否输入完整。其次看防火墙与安全软件是否拦截了主程序，最后确认双方网络是否正常。若使用了公司网络，还需确认是否限制了相关端口。
防休眠设置入口到底在哪里？
在客户端主界面的设置中通常有「防休眠 / 保持唤醒」类开关，打开后客户端会阻止系统进入睡眠。但系统层面的电源计划仍需同步调整，具体位置可参考防休眠设置方法与原理一文的分平台说明。
Linux 安装后没有图形界面，能远程桌面吗？
没有桌面环境时只能进行命令行运维，无法获得图形远程桌面。需要图形控制时，请确保系统安装了桌面环境并正常启动图形会话，同时注意 Wayland 与 X11 的兼容差异。
手机作为被控端，锁屏后还能被连接吗？
移动系统的后台限制较严格，锁屏或长时间后台后连接可能中断。建议在被控手机上关闭电池优化限制、保持充电状态，并在需要时让应用保持在前台。更多移动端场景可查看无人值守远程控制配置要点。
装好之后，把「防休眠」也一起配好
安装只是起点。真正稳定的远程体验，取决于设备是否始终保持在线、权限是否给足、连接方式是否合适。继续阅读下一章，把长期在线的细节补齐。
FRESH UPDATES
最新资讯
近期与下载安装、系统兼容和远程保持在线相关的更新摘要。
- Windows 11 新版系统下安装包签名校验说明更新 INSTALL
- macOS 节能设置调整后防休眠开关的正确配合方式 POWER
- Linux 发行版 Wayland 会话下远程黑屏的排查思路 LINUX
- 移动端后台保活与无人值守场景的配置建议 MOBILE
- 首次连接失败的四步排查顺序整理 CONNECT
- 远程通道安全习惯：固定密码与设备白名单 SECURITY