RustDesk 多平台部署保姆级教程：三步走，让你在 Windows、macOS、Linux 上都顺利跑起来

RustDesk 多平台部署保姆级教程三步走让你在 Windows、macOS、Linux 上都顺利跑起来【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk开工之前先把三件事搞清楚RustDesk 是一款用 Rust 语言编写的开源远程桌面软件核心卖点是自托管 端到端加密它既不强制你登录厂商账号也不要求你把设备名单交给第三方而是把谁能连、走哪条线路、传什么数据的控制权全部交还给你。换句话说它是 TeamViewer、AnyDesk 这类商业工具的替代品尤其适合在意隐私和数据归属的个人与团队。在动手部署之前请先花 30 秒对号入座确认自己的身份后面就能直奔主题如果你是个人用户只想在两三台设备间互连请直接阅读第一个里程碑和第二个里程碑两节半小时内就能完成首连。如果你是IT 管理员需要批量下发并统一管理请务必读完规模化部署一节那里有 systemd 服务和 Ansible 方案。如果你是自托管玩家想编译最新版并自己架设信令与中继服务器那么从源码编译这一小节就是为你准备的。整篇文章按下载 → 首连成功 → 加固 → 规模化四个里程碑推进每一段都有明确的验收点读完任何一段你都能立刻动手验证。要点提示RustDesk 桌面端同时支持 Windows、macOS、Linux移动端覆盖 iOS 与 Android浏览器也能连。本文聚焦三大桌面平台的部署移动端操作逻辑与此完全一致可触类旁通。第一个里程碑先让本机跑起来无论你选哪条路线第一步都是在这台机器上把程序启动起来。RustDesk 的官方发布包按平台提供了多种形态先看一张基础要求对照表确认你的设备达标。平台系统版本内存其他注意点WindowsWindows 10 / 1164 位建议 4GB 及以上显卡支持 DirectX 9无需管理员权限即可运行macOSmacOS 10.14 及以上建议 10.15建议 8GB需支持 Metal 的显卡LinuxUbuntu 18.04 / Debian 10 / Fedora 28 或更新建议 4GB 及以上需要 X11 或 Wayland 桌面环境Windows 上的两条路便携版与静默安装版推荐新手走便携版从发布页下载rustdesk-版本号-x86_64.exe这种免安装的便携程序双击即可运行解压后只有一个文件夹绿色无害连 U 盘上都能跑。启动后主界面中央会显示本机的 ID 和一次性密码这就是你的门牌号和钥匙。进阶用户可以直接用命令行静默安装方便批量场景# 下载安装包把 版本号 换成实际版本号 Invoke-WebRequest -Uri https://github.com/rustdesk/rustdesk/releases/download/版本号/rustdesk-版本号-x64-setup.exe -OutFile rustdesk-setup.exe # /S 表示静默安装不弹向导窗口 .\rustdesk-setup.exe /S # 验证进程是否已在运行 Get-Process -Name rustdesk -ErrorAction SilentlyContinue装完先别急着连Windows 端有一件最容易忽略的事——防火墙放行。RustDesk 依赖 21115~21119 这几个 TCP/UDP 端口如果后续连接一直转圈八成就是这里被拦了。可以顺手补一条入站规则# 放行 RustDesk 主程序的入站连接 New-NetFirewallRule -DisplayName RustDesk -Direction Inbound -Program 安装路径\rustdesk.exe -Action Allow现在你可以验证本机 ID 是否正常生成在另一台设备上输入这个 ID 能否看到请求连接能就说明 Windows 这台已经开门了。macOS 的三道权限关一次给全macOS 安装相对简单二选一即可从发布页下载.dmg镜像双击后把图标拖进应用程序文件夹或者用 Homebrew 一条命令搞定# 通过 Homebrew 安装 RustDesk brew install --cask rustdesk真正的难点在权限。macOS 出于安全机制远程控制类软件必须显式授权三项权限否则会出现能连上但屏幕是黑的鼠标动不了这类诡异问题。请依次打开系统设置 → 隐私与安全性把 RustDesk 加入以下清单并保持勾选屏幕录制——不授权则无法抓取画面辅助功能——不授权则无法模拟键盘鼠标输入输入监控——不授权则远端按键事件可能被吞掉。如果你在调试中把权限弄乱了可以用下面的命令重置后重新授权# 重置屏幕录制权限随后重新勾选 tccutil reset ScreenCapture com.carriez.rustdesk授权完成后重启一次 RustDesk再验证能否看到远端屏幕并完成一次遥控能这台 Mac 就绪。LinuxAppImage 最省心deb/rpm 看发行版Linux 桌面发行版众多但 RustDesk 给了三种主流形态任选其一方法一最通用AppImage 免安装运行# 下载后赋予执行权限即可直接运行 wget https://github.com/rustdesk/rustdesk/releases/download/版本号/rustdesk-版本号-x86_64.AppImage chmod x rustdesk-版本号-x86_64.AppImage ./rustdesk-版本号-x86_64.AppImageAppImage 不污染系统目录删除文件即完成卸载非常适合先试后装。方法二走发行版包管理器# Ubuntu / Debian 系 sudo apt install ./rustdesk-版本号-x86_64.deb # Fedora / CentOS / RHEL 系 sudo dnf install ./rustdesk-版本号-x86_64.rpm # Arch / Manjaro 用户可以直接从 AUR 安装 yay -S rustdeskdeb 包在安装后会自动完成两件事把可执行文件软链到/usr/bin/rustdesk并注册 systemd 服务Debian 系安装脚本里可以看到这段逻辑。如果你想要自定义桌面图标项目仓库里的res/rustdesk.desktop就是现成模板复制到~/.local/share/applications/下即可出现在应用菜单里。要点提示Linux 上若使用 Wayland 会话且遇到画面捕捉异常可在登录界面切换到 X11 会话或用软件包管理器补装gstreamer1.0-pipewire等多媒体插件多数兼容性问题都能化解。现在验证应用菜单里能否看到 RustDesk 图标点击能否正常弹出主界面能这台 Linux 机器也开门了。第二个里程碑让两台设备真正握上手跑起来不等于能用。这个阶段的目标是完成一次真实的跨平台连接并顺手把最容易踩的坑填平。核心动作有三个核对 ID 与密码、放行端口、核对配置文件路径。先给三平台的关键配置项做一张对照表后续排查时随时回来查配置项WindowsmacOSLinux配置文件路径%APPDATA%\RustDesk\config\RustDesk.toml~/Library/Application Support/RustDesk/config/RustDesk.toml~/.config/RustDesk/config/RustDesk.toml网络端口21115-21119TCP/UDP21115-21119TCP/UDP21115-21119TCP/UDP无人值守模式设置中开启开机自启登录项加入 RustDesksystemd 服务或桌面自启动命令行服务模式rustdesk.exe --servicerustdesk --servicerustdesk --service日志位置%APPDATA%\RustDesk\log\~/Library/Logs/RustDesk/~/.local/share/RustDesk/log/跨平台首连的标准动作是这样的被控端把主界面的ID 和临时密码告诉你你在控制端输入 ID 并回车被控端弹窗点接受即可建立 P2P 直连。若网络 NAT 较复杂RustDesk 会自动切换为中继转发无需人工干预。如果这一步没走通对照下面的排查清单逐项检查问题 1一直提示连接中迟迟连不上。多半是防火墙拦截。请确认控制端与被控端的 21115-21119 端口都已放行尤其是企业网络和路由器上做了入站限制的场景。问题 2连上了但屏幕是黑的或卡在第一帧。Windows 上检查是否使用了过期显卡驱动macOS 上 90% 是屏幕录制权限未授予Linux 上优先怀疑 Wayland 会话兼容性先切 X11 再试。问题 3能看画面但鼠标键盘完全没反应。这是权限不足的典型表现。Windows 检查是否以受限权限运行macOS 复查辅助功能和输入监控两项Linux 检查是否缺少xdotool或输入设备访问权限。问题 4音频断断续续或完全无声。先确认两端声音开关都开启再检查被控端音频服务状态Linux 下常见于 PulseAudio 与 PipeWire 切换后未重启应用。要点提示以上每个问题都对应一个具体可执行的动作——放行端口、授予权限、切换会话、重启服务。照做后重新发起连接即可验证别在同一个坑里卡两次。第三个里程碑加固别把门敞着连接通了之后第一件该做的事就是收紧权限。远程桌面是把双刃剑默认的临时密码固然方便但如果你希望机器被随时可控且不被外人趁虚而入请按下面三步做一次安全加固。第一步把临时密码换成固定密码。在安全设置中关闭临时密码设置强密码并勾选无人值守访问这样你不在现场时也能远程登录但密码绝不会出现在别人眼前。第二步设置密码策略与登录门槛。开启连续错误锁定限制登录尝试次数必要时启用二次验证2FA。对于敏感主机建议关闭文件传输与打印等非必要能力只保留远程控制。第三步管好网络入口。配置层面你完全可以把网络约束收紧例如# 配置文件~/.config/RustDesk/config/RustDesk.toml # 以下为自托管信令/中继服务器示例你的服务器请替换为实际地址 [options] custom-rendezvous-server 你的服务器地址 key 你的加密密钥key是与信令服务器配套的加密串两侧设备使用相同的key才能互相识别这就等于给通信加了第二道锁。若你不自建服务器保持默认公共中继即可不要随意修改这一段。要点提示安全配置的验收标准很直白——在不告知对方的情况下你还能不能凭固定密码连上不能说明门已经关紧加固成功。第四个里程碑从单机到规模化当你要管理的机器从 1 台变成 50 台逐台手工操作就不现实了。这一节提供三个层次的上量方案按你的运维功底任选。方案 A用 systemd 把服务钉在后台对于 Linux 无头服务器没有显示器、没有桌面最省心的做法是把 RustDesk 注册为系统服务。项目仓库中自带一份可直接使用的服务文件res/rustdesk.service核心内容如下# res/rustdesk.service —— 直接拷贝使用 [Unit] DescriptionRustDesk Requiresnetwork.target Aftersystemd-user-sessions.service [Service] Typesimple ExecStart/usr/bin/rustdesk --service ExecStoppkill -f rustdesk -- Userroot LimitNOFILE100000 Restartalways [Install] WantedBymulti-user.target把它放到/etc/systemd/system/rustdesk.service后执行# 重新加载并启用开机自启然后立即启动 sudo systemctl daemon-reload sudo systemctl enable rustdesk sudo systemctl start rustdesk # 验证服务状态是否为 active (running) systemctl status rustdesk方案 BDocker 一键出构建产物如果你需要频繁拉取最新源码、产出各平台可执行文件仓库根目录的Dockerfile已经把编译环境打包好了免去本机装 vcpkg 和一堆编译工具的麻烦# 克隆仓库首次构建耗时较长后续有缓存会快很多 git clone https://gitcode.com/GitHub_Trending/ru/rustdesk cd rustdesk # 构建编译镜像 docker build -t rustdesk-builder . # 每次需要编译时挂载当前目录运行产物输出到 target/ 目录 docker run --rm -it -v $PWD:/home/user/rustdesk \ -v rustdesk-git-cache:/home/user/.cargo/git \ -v rustdesk-registry-cache:/home/user/.cargo/registry \ -e PUID$(id -u) -e PGID$(id -g) rustdesk-builder --release方案 C从源码编译自托管玩家的进阶之路想定制功能或提前体验新特性直接编译源码是唯一途径。核心依赖链是Rust 工具链 → vcpkg 提供libvpx / libyuv / opus / aom四个多媒体库 → 构建脚本打包。# 1. 安装 Rust 工具链 curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh source ~/.cargo/env # 2. 准备 vcpkg 与四个核心依赖库 git clone https://github.com/microsoft/vcpkg cd vcpkg git checkout 2023.04.15 ./bootstrap-vcpkg.sh export VCPKG_ROOT$HOME/vcpkg ./vcpkg install libvpx libyuv opus aom # 3. 克隆项目并编译首次编译较慢属正常现象 cd .. git clone https://gitcode.com/GitHub_Trending/ru/rustdesk cd rustdesk VCPKG_ROOT$HOME/vcpkg cargo build --release编译完成后可执行文件位于target/release/rustdesk把它拷贝到/usr/local/bin/即可全局使用。Linux 各发行版所需的系统依赖在 README 中按 Ubuntu、Fedora、Arch 分别给出编译前先按自己的发行版装齐否则会在链接阶段报错。要点提示规模化部署的验收标准很具体——关机重启后服务是否自动拉起50 台机器是否都能凭固定密码被统一接管能你的运维体系就算立起来了。写在最后给你一份可立即执行的行动清单回顾这趟部署之旅RustDesk 的价值可以用一句话概括用开源的力量把远程桌面的数据主权还给使用者。无论你是个人用户、IT 管理员还是自托管爱好者都能在几十分钟内完成从下载到规模化的全流程。现在请按下面这份清单动手今天先装一台按你的平台选一条路径在 Windows、macOS 或 Linux 上把 RustDesk 跑起来确认本机 ID 正常显示。完成一次跨平台首连用手机或另一台电脑连一下刚装好的机器顺手把防火墙、权限这三道关全部过一遍。做一次安全加固设置固定密码、开启登录尝试限制必要时配置自托管服务器与加密密钥。如果你是管理员本周内挑一台无头服务器按 systemd 服务方案注册并验证开机自启。把本文收藏进书签遇到连接超时、黑屏、输入失灵时回到第二个里程碑的排查清单逐项对照。每一步都有明确的验收点跑通一步再走下一步。远程桌面的世界很宽而你已经有了全平台的钥匙。【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考