你有没有过这样的经历：在家里想远程控制书房那台电脑，结果发现远程软件要先连到厂商的服务器，绕了一大圈才回到你家局域网？延迟高不说，心里还总觉得数据在别人那儿走了一遭。

今天要聊的 SubnetDesk，就是为了解决这个尴尬而生的。它是一个基于 RustDesk 独立维护的开源远程桌面工具，专为局域网、VPN 和可路由私网打造。简单说就是：你和目标电脑在同一个网络里，它就直接连过去，不绕路、不经过第三方服务器。

💡 打个比方：普通远程桌面像寄快递要先送到中转站，SubnetDesk 则是直接把东西递到隔壁邻居手上。

项目亮点

🔹 局域网直连优先：不需要经过公网服务器中转，同一网络内设备直接握手，延迟低到几乎感觉不到。

🔹 全平台覆盖：Windows（x64/ARM64）、macOS（Intel/Apple Silicon）、Linux（x86_64/ARM64）、Android 都支持，界面用 Flutter 统一构建。

🔹 数据路径完全可控：所有连接都在你自己的网络内完成，没有数据流向外部服务器的顾虑。

🔹 安全更新机制：内置签名的应用内更新，支持启动时检查、自动下载、进度显示和受保护的安装流程。

🔹 灵活的 Web 远程访问：支持显式配置 Web 远程监听，允许 VPN 地址在 CIDR 白名单内工作，证书自动生成包含这些地址。

解决什么痛点？

想象一下这个场景：你是一家小型工作室的 IT 负责人，办公室里有 20 台电脑需要互相远程维护。用市面上的远程桌面工具，每次连接都要经过厂商的云服务器，不仅速度慢，而且一旦外网断了，内网设备之间也没法互相控制。

或者你是一个开发者，家里有 NAS、开发机和笔记本，想在内网里自由切换控制。传统的远程桌面方案要么配置复杂，要么强制走公网中转。

SubnetDesk 的思路很直接：既然大家都在同一个网络里，为什么还要绕到外面去？

它保留了 RustDesk 的核心能力——屏幕捕获、输入控制、音频传输、剪贴板同步、文件传输，但把重心放在了局域网直连上。新安装后，它会提示你设置一个局域网密码，明确告诉你远程访问前需要配置什么。远程会话的标签页会优先显示本地别名，然后是远程设备名，最后才是对端地址——一眼就能看出你在连哪台机器。

🔹 另一个贴心细节：已知的局域网设备在用户确认设备身份指纹之前，不会被直接拒绝，而是给你一个确认的机会。这比"连不上就是连不上"友好多了。

手把手教程

➤ 环境准备

SubnetDesk 的构建依赖比较多，但项目提供了完整的构建脚本。你需要先准备好以下环境：

• Rust 工具链（通过 rustup 安装）
• Flutter SDK 3.44.1 或更高版本
• 各平台对应的编译工具链（Windows 需要 Visual Studio 2022，macOS 需要 Xcode，Linux 需要 GTK 开发库）
• vcpkg 用于管理 C++ 依赖

项目根目录下的 vcpkg.json 定义了所有依赖项，包括 FFmpeg、Opus、libvpx、libyuv、aom 等音视频处理库。这些依赖会根据你的目标平台自动选择。

➤ 克隆与初始化

首先克隆项目代码：

git clone https://github.com/zibo-chen/SubnetDesk.git
cd SubnetDesk

然后初始化子模块（项目依赖了自定义的 hbb_common 分支）：

git submodule update --init --recursive

➤ 构建 Flutter 界面

SubnetDesk 的现代界面基于 Flutter 构建。进入 flutter 目录，获取依赖：

cd flutter
flutter pub get

如果需要重新生成 Rust 与 Dart 之间的桥接代码：

cargo install flutter_rust_bridge_codegen --version 1.80.1--features uuid --locked
~/.cargo/bin/flutter_rust_bridge_codegen 
--rust-input ./src/flutter_ffi.rs 
--dart-output ./flutter/lib/generated_bridge.dart 
--c-output ./flutter/macos/Runner/bridge_generated.h

🔹 这一步会生成 Dart 和 Rust 之间的 FFI 桥接代码，让 Flutter 界面能够调用底层的远程桌面功能。

➤ 编译 Rust 核心

回到项目根目录，使用项目提供的构建脚本：

./build.py --flutter

这个脚本会自动处理 Rust 代码编译和 Flutter 构建的整合。如果你只想编译 Rust 部分进行调试：

cargo build --locked --features flutter,hwcodec

➤ 各平台打包

Windows：构建完成后，可执行文件位于 flutter/build/windows/x64/runner/Release/ 目录下。

macOS：构建脚本会生成 SubnetDesk.app，然后使用 create-dmg 打包成 DMG 文件，并进行代码签名和公证：

codesign --force --options runtime -s $MACOS_CODESIGN_IDENTITY --deep --strict 
./flutter/build/macos/Build/Products/Release/SubnetDesk.app
create-dmg --icon "SubnetDesk.app"200190--hide-extension "SubnetDesk.app"
--window-size 800400--app-drop-link 600185
subnetdesk-$VERSION.dmg ./flutter/build/macos/Build/Products/Release/SubnetDesk.app

Linux：支持 DEB、RPM、AppImage 和 Flatpak 等多种打包格式。

Android：使用 Flutter 构建 APK：

flutter build apk --target-platform android-arm64,android-arm --release 
--obfuscate --split-debug-info ./split-debug-info

➤ 首次使用配置

安装完成后首次启动，SubnetDesk 会提示你设置局域网密码。这个密码用于局域网内设备之间的身份验证。设置完成后，在同一网络内的另一台设备上打开 SubnetDesk，输入对方的设备 ID 或从局域网设备列表中选择，就可以直接建立连接了。

🔹 远程会话标签页会显示本地别名（如果你设置了的话），否则显示远程设备名称，最后才是对端地址。这样你同时管理多台设备时不会搞混。

同类项目对比

🔹 从表格可以看出，SubnetDesk 在局域网场景下的优势很明显：不需要额外配置服务器，不需要登录账号，打开就能发现同网段的设备。而 RustDesk 虽然也支持自建服务器，但配置门槛相对较高。

一些值得关注的技术细节

SubnetDesk 的代码结构继承了 RustDesk 的架构，但做了不少针对性的调整：

服务管理：Linux 平台使用 systemd 管理服务，服务单元文件名为 subnetdesk.service，安装后会自动启用并启动。

屏幕捕获：Windows 平台使用 src/platform/windows.cc 中的原生代码，macOS 使用 macos.mm，各平台都有专门的捕获实现。

输入控制：跨平台的输入模拟集中在 libs/enigo/ 目录下，支持鼠标和键盘事件。

音频处理：Windows 平台有专门的音频处理代码，支持实时音频流传输。

剪贴板同步：支持文本、HTML、图片等多种格式的剪贴板内容同步。

文件传输：实现了安全的文件传输功能，支持大文件分块传输。

纹理生命周期修复：最新版本修复了 Windows 平台上因会话切换导致的纹理生命周期竞争问题，解决了远程桌面和摄像头卡顿的 bug。

macOS 更新加固：更新包解压时使用唯一挂载路径、符号链接安全清理、代码签名验证和 Gatekeeper 校验，确保更新过程安全可靠。

💡 这些细节说明 SubnetDesk 不是一个简单的"换皮"项目，而是在 RustDesk 的基础上做了大量针对局域网场景的优化和加固。

适合谁用？

如果你符合以下任一情况，SubnetDesk 值得一试：

• 家里或办公室有多台电脑需要互相远程控制
• 对数据隐私有要求，不希望远程数据经过第三方服务器
• 使用 VPN 或可路由私网连接不同地点的设备
• 需要在内网环境下快速部署远程桌面方案

🔹 特别是对于小型团队来说，SubnetDesk 可以省去搭建和维护远程桌面服务器的麻烦，装好就能用。

最后说两句

远程桌面这个领域，商业软件已经做得很成熟了，但开源方案一直在追赶。SubnetDesk 选择了一个很聪明的切入点：不做大而全，而是把局域网直连这个场景做深做透。

它基于 RustDesk 的成熟架构，保留了核心功能，同时针对局域网场景做了大量优化。如果你正好有这个需求，不妨下载试试。

项目地址： https://github.com/zibo-chen/SubnetDesk​

阅读原文：原文链接