RustDesk 编译实战指南vcpkg 依赖安装、Docker 容器化构建与源码结构解析【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk本篇指南围绕 RustDesk 仓库的官方构建文档docs/README-PTBR.md该文档是仓库 README 的葡语版本构建流程与其他语言版 README 一致展开覆盖从零编译 RustDesk 的完整流程各 Linux 发行版的系统依赖安装、vcpkg 编解码库准备、Sciter/Flutter 双 GUI 体系说明、Docker 容器化构建以及仓库源码结构。读完本文你能够独立在裸机或容器中完成 RustDesk 的可执行文件构建并理解VCPKG_ROOT等构建变量在源码构建脚本中是如何被消费的。适用范围与前置条件按构建文档说明桌面版使用Flutter或Sciter已标记为 discontinued/不推荐作为图形界面。文档中给出的快速上手路径以 Sciter 为准因为它更简单、更易起步Flutter 版本的编译方式参见仓库 CI 配置。准备开发环境需要做三件事准备好 Rust 开发环境rustup和 C 编译工具链gcc/g、clang 等安装 vcpkg以源码仓库形式安装即可并正确设置环境变量VCPKG_ROOT按平台安装编解码依赖Windowsvcpkg install libvpx:x64-windows-static libyuv:x64-windows-static opus:x64-windows-static aom:x64-windows-staticLinux/macOSvcpkg install libvpx libyuv opus aomSciter 版还需要自行下载对应平台的 Sciter 动态库Windows 为sciter.dll、Linux 为libsciter-gtk.so、macOS 为libsciter.dylib来自 c-smile/sciter-sdk 发布资源。一个值得注意的版本前提当前仓库 Cargo.toml 声明的rust-version为1.75包版本为1.4.9即建议至少使用 Rust 1.75 及以上工具链来编译本仓库代码。vcpkg 依赖声明与源码的对应关系文档只要求安装libvpx libyuv opus aom四个库但仓库根目录的 vcpkg.json 实际上声明了更完整的依赖集合其中包含libvpx、libyuv、opus、aom均声明host: true与host: false两份分别用于构建宿主与目标平台libjpeg-turbo静态截图/图像编码路径使用mfx-dispatchIntel QSV 硬件编解码限定windows | (x86/x64 linux)平台ffmpeg限定静态构建平台并在 Windows/Linux 下启用amf、nvcodec、qsv等硬件编码 feature通过overlay-ports指向仓库内 res/vcpkg 目录下的定制端口仓库自带 aom/ffmpeg/libvpx/libyuv/opus/mfx-dispatch 的补丁与 portfile并通过overlay-triplets指向 res/vcpkg-tripletsbaseline则把依赖版本固定在一个提交上保证可复现构建。VCPKG_ROOT在哪里被消费这正是文档反复强调设置该变量的原因。从源码结构看屏幕捕获库的构建脚本 libs/scrap/build.rs 中的find_package()函数定义了三级查找策略若处于 Linux 且启用了linux-pkg-configfeature优先走 pkg-config可用NO_PKG_CONFIG_lib1关闭否则读取VCPKG_ROOT环境变量从$VCPKG_ROOT/installed/triplet/lib输出cargo:rustc-link-search与静态库链接指令并用 bindgen 基于 vcpkg 头文件生成 FFI 绑定两者都失败时仅 macOS aarch64 允许回退 Homebrew源码中直接panic!(Couldnt find VCPKG_ROOT, also cant fallback to homebrew because its only for macos aarch64.)。顶层 build.rs 在为 Android 目标编译时同样依赖VCPKG_ROOT或VCPKG_INSTALLED_ROOT来定位交叉编译产物目录并链接 NDK 兼容库。因此“正确设置VCPKG_ROOT”不是可选建议而是构建脚本解析编解码库链接路径的硬依赖。安装系统级依赖按发行版以下是构建文档给出的各发行版依赖安装命令与 Dockerfile 中实际安装的系统包高度一致gcc/g、git、nasm、yasm、libgtk-3-dev、clang、libxcb-*-dev、libxdo-dev、libxfixes-dev、libasound2-dev、libpulse-dev、cmake、make、libgstreamer1.0-dev 等可互为印证。Ubuntu 18Debian 10sudo apt install -y zip g gcc git curl wget nasm yasm libgtk-3-dev clang libxcb-randr0-dev libxdo-dev \ libxfixes-dev libxcb-shape0-dev libxcb-xfixes0-dev libasound2-dev libpulse-dev cmake make \ libclang-dev ninja-build libgstreamer1.0-dev libgstreamer-plugins-base1.0-devopenSUSE Tumbleweedsudo zypper install gcc-c git curl wget nasm yasm gcc gtk3-devel clang libxcb-devel libXfixes-devel \ cmake alsa-lib-devel gstreamer-devel gstreamer-plugins-base-devel xdotool-develFedora 28CentOS 8sudo yum -y install gcc-c git curl wget nasm yasm gcc gtk3-devel clang libxcb-devel libxdo-devel \ libXfixes-devel pulseaudio-libs-devel cmake alsa-lib-devel gstreamer1-devel gstreamer1-plugins-base-develArchManjarosudo pacman -Syu --needed unzip git cmake gcc curl wget yasm nasm zip make pkg-config clang gtk3 \ xdotool libxcb libxfixes alsa-lib pipewire这些依赖分别服务于屏幕捕获xcb/Xfixes、输入模拟libxdo、音频采集ALSA/PulseAudio、GTK 窗口Sciter 依赖 libgtk-3、GStreamer 管线macOS 之外的音频重定向等场景。安装 vcpkg构建文档固定了 vcpkg 的 checkout 版本与 Dockerfile 中--branch 2023.04.15 --depth1保持一致git clone https://github.com/microsoft/vcpkg cd vcpkg git checkout 2023.04.15 cd .. vcpkg/bootstrap-vcpkg.sh export VCPKG_ROOT$HOME/vcpkg vcpkg/vcpkg install libvpx libyuv opus aom锁定版本号的工程意义在于vcpkg.json 中baseline固定的提交与仓库内 res/vcpkg overlay 端口例如 aom 补丁、libvpx 的 UWP 支持补丁是按同一时期的 vcpkg 行为编写的随意升级 vcpkg 可能破坏 overlay 端口的构建。修复 Fedora 上 libvpx 的 -fPIC 问题在 Fedora 上编译时vcpkg 为 libvpx 生成的 Makefile 默认不带-fPIC会导致静态库无法链接进最终二进制。构建文档给出如下修复流程进入 vcpkg 构建目录手动重编并拷回已安装目录cd vcpkg/buildtrees/libvpx/src cd * ./configure sed -i s/CFLAGS-I/CFLAGS-fPIC -I/g Makefile sed -i s/CXXFLAGS-I/CXXFLAGS-fPIC -I/g Makefile make cp libvpx.a $HOME/vcpkg/installed/x64-linux/lib/ cd该问题的本质与 libs/scrap/build.rs 的链接方式直接相关Rust 侧以cargo:rustc-link-libstatic...方式链接 vcpkg 产出的静态库静态库中的目标文件必须开启位置无关代码PIC才能被链入动态链接的最终可执行文件Fedora 的工具链对缺省 PIC 行为的处理与其他发行版不同因而出现该差异。编译 RustDeskSciter GUI完整的裸机编译流程构建文档“Compilar”一节curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh source $HOME/.cargo/env git clone --recurse-submodules https://gitcode.com/GitHub_Trending/ru/rustdesk cd rustdesk mkdir -p target/debug # 下载 Linux x64 版 Sciter 动态库Windows/macOS 请按平台替换文件名 wget https://raw.githubusercontent.com/c-smile/sciter-sdk/master/bin.lnx/x64/libsciter-gtk.so mv libsciter-gtk.so target/debug VCPKG_ROOT$HOME/vcpkg cargo run要点说明--recurse-submodules不可省略仓库依赖 git 子模块libsciter-gtk.so必须放在可执行文件同目录target/debug运行时按相对路径加载——这一点在 Docker 构建入口脚本 entrypoint.sh 中被自动化处理test -f target/debug/libsciter-gtk.so || cp ...需要 release 优化版本时在命令后追加--release产物位于target/release/rustdesk。从 Cargo.toml 的 features 定义可以看到更多可定制的构建维度例如flutter启用 Flutter GUI 的flutter_rust_bridge依赖、hwcodec硬件编解码透传scrap/hwcodec、drm/drm-wakeDRM 屏幕捕获及其“显示唤醒”子开关、linux-pkg-configLinux 下改用 pkg-config 而非 vcpkg 查找依赖等。release profile 启用了lto、codegen-units 1、panic abort与strip即正式构建产物经过体积与性能优化。使用 Docker 编译Docker 方式把上述全部环境bullseye 基础镜像 系统依赖 vcpkg 2023.04.15 Sciter 库 rustup封装进构建容器宿主机只需保留 Docker。首先克隆仓库并构建构建器镜像git clone https://gitcode.com/GitHub_Trending/ru/rustdesk cd rustdesk git submodule update --init --recursive docker build -t rustdesk-builder .Dockerfile 的关键步骤基于debian:bullseye-slim安装与上文 Ubuntu 段落相同的系统依赖从 CMake 3.30.6 源码安装 CMake克隆 vcpkg 的 2023.04.15 分支并install libvpx libyuv opus aom设置VCPKG_FORCE_SYSTEM_BINARIES1下载libsciter-gtk.so安装 rustup并以非特权用户运行。之后每次编译执行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首次编译会拉取并缓存所有依赖耗时较长两个命名卷rustdesk-git-cache/rustdesk-registry-cache让后续构建复用 crate 缓存显著提速需要附加 cargo 参数时直接追加在命令末尾例如--release编译优化版本最终产物仍生成在宿主机的target目录debug 版运行target/debug/rustdeskrelease 版运行target/release/rustdesk。入口脚本 entrypoint.sh 解释了参数是如何被处理的它逐参扫描--release置位 release 并把 Sciter 库拷入target/release与--target triple调用rustup target add注册交叉编译目标其余参数原样透传最终统一执行VCPKG_ROOT/vcpkg cargo build --locked $argv这带来两个实用约束构建文档也特别提示必须从仓库根目录运行可执行文件否则应用可能找不到所需资源该容器化方法不支持cargo install、cargo run等子命令语义——entrypoint 固定调用cargo build即只把程序“构建”出来放到宿主机的target目录而非在容器内安装或运行。源码结构构建文档最后给出了仓库核心目录的职责划分结合 Cargo.toml 中 workspace members 的定义libs/scrap、libs/hbb_common、libs/enigo、libs/clipboard、libs/virtual_display、libs/portable、libs/remote_printer可以更清楚地理解模块边界libs/hbb_common视频编解码封装、配置、TCP/UDP 网络封装层、protobuf、文件传输用的文件系统函数及其他通用工具libs/scrap屏幕捕获。其内部按平台拆分src/common/下有 x11、wayland、quartz、dxgi、mediacodec、drm 等捕获后端src/bindings/存放 aom/vpx/yuv 的 FFI 头文件由 libs/scrap/build.rs 用 bindgen 生成 Rust 绑定libs/enigo各平台键盘/鼠标控制linux/macos/win 三套实现 统一 DSL 接口libs/clipboardWindows、Linux、macOS 的文件与文本剪贴板实现含 Windows 的wf_cliprdr.cCliprDr 协议src/ui旧版 Sciter 界面代码tis/html/css文档已注明该方向不推荐新版 GUI 在 flutter 目录src/server音频、剪贴板、输入、视频等服务以及网络连接处理audio_service.rs、input_service.rs、video_service.rs、connection.rs等src/client.rs发起直接连接peer connectionsrc/rendezvous_mediator.rs与自建 rendezvous/relay 服务器通信等待直接连接TCP 打洞或中继连接src/platform各平台特化代码Linux 权限提升、macOS 特权脚本、Windows 服务与安装器等flutter桌面与移动端的 Flutter 客户端代码Dart 层 各平台壳工程。另外Cargo.toml 还通过[patch.crates-io]将libxdo-sys替换为仓库内的 libs/libxdo-sys-stub使系统在未安装 libxdo例如纯 Wayland 环境时也能完成构建与运行——这与上文 Arch 段落依赖列表中出现xdotool但 Wayland 用户可缺省的场景相呼应。构建排障小结综合构建文档与源码常见问题可归纳为现象可能原因与处理构建脚本 panic 提示找不到VCPKG_ROOT未设置或 shell 未 export设置VCPKG_ROOT指向 vcpkg 根目录后重试见 libs/scrap/build.rsFedora 上 libvpx 链接报 undefined symbol / 无法生成最终二进制静态库缺-fPIC按上文 sed 修复流程重编libvpx.a并拷回installed/x64-linux/libcargo build报链接错误指向 aom/libvpx/opus检查vcpkg install的 triplet 是否与VCPKG_ROOT/installed下实际产物一致Docker 方式可整体规避运行target/debug/rustdesk提示缺少 Sciter 库将libsciter-gtk.so放到可执行文件同目录并从仓库根目录启动Docker 中cargo run/cargo install不生效entrypoint 只执行cargo build参数透传规则见 entrypoint.sh按以上步骤你可以在 Ubuntu、openSUSE、Fedora、Arch 等主流发行版或直接用 Docker上完成 RustDesk 的完整构建并通过--release获得经过 LTO 优化的发行级二进制。【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考