RustDesk 如何用 AppImageBuilder 构建 Linux AppImage 版本？
【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk
如果你已经构建好了 RustDesk 的 Linux deb 包，想再产出一个免安装、可直接运行的 AppImage 分发包，RustDesk 仓库自带了完整的构建路径：appimage/目录下有两份 appimage-builder 配方文件 AppImageBuilder-x86_64.yml 与 AppImageBuilder-aarch64.yml，官方 CI（.github/workflows/flutter-build.yml）中的build-appimage任务就是按这套配方执行的。本文按 CI 的实际流程，说明如何在一个 Ubuntu 22.04 环境中，把rustdesk-<VERSION>-<arch>.deb构建成对应的 AppImage，其中<VERSION>和<arch>替换为你手上 deb 文件对应的版本号与架构（x86_64或aarch64）。
准备输入：deb 包与图标资源
AppImageBuilder 的配方不直接编译 RustDesk，它的输入是一个现成的 deb 包，配方里的script段会做这些事（见 AppImageBuilder-x86_64.yml）：
script: - rm -rf ./AppDir || true - bsdtar -zxvf rustdesk.deb - tar -xvf ./data.tar.xz - mkdir ./AppDir - mv ./usr ./AppDir/usr # 32x32 icon - for i in {32,64,128}; do mkdir -p ./AppDir/usr/share/icons/hicolor/$i\x$i/apps/; cp ../res/$i\x$i.png ./AppDir/usr/share/icons/hicolor/$i\x$i/apps/rustdesk.png; done - mkdir -p ./AppDir/usr/share/icons/hicolor/scalable/apps/; cp ../res/scalable.svg ./AppDir/usr/share/icons/hicolor/scalable/apps/rustdesk.svg - rm -rf ./AppDir/usr/share/applications因此执行前需要满足三个条件：
- 当前目录下有
rustdesk.deb。官方 CI 的做法是把 Linux 构建任务产出的 deb 改名放入appimage/目录：mv rustdesk-<VERSION>-<arch>.deb appimage/rustdesk.deb（deb 的架构必须与配方匹配，x86_64 的 deb 配 x86_64 配方，aarch64 同理）； - 能访问仓库根目录的
res/资源（脚本里用了相对路径../res/...），所以要从仓库的appimage/目录内运行构建，CI 正是用pushd appimage进入该目录。仓库中res/32x32.png、res/64x64.png、res/128x128.png与res/scalable.svg均已存在； - deb 的产物路径符合配方中
app_info.exec: usr/share/rustdesk/rustdesk的约定，仓库内 deb 的打包逻辑见 build.py。
另外注意配方app_info中的version: 1.5.0是写入 AppImage 元数据的版本字段，仓库用 res/bump.sh 对appimage/*yml等文件做批量替换来升级该值。
安装构建工具
按 CI 的Build appimage package步骤，在 Ubuntu 22.04 上安装依赖。以下命令需要 root 权限（sudo），会修改系统包和 Python 环境：
# 配方 script 段用 bsdtar 解开 deb；libfuse2 用于 AppImage 挂载所需的 FUSE sudo apt-get update -y sudo apt-get install -y libarchive-tools libfuse2 # CI 在从 git 安装 appimage-builder 前先固定 setuptools_scm 版本 sudo pip3 install "setuptools_scm<10" sudo pip3 install git+https://github.com/rustdesk-org/appimage-builder.git这里安装的是 RustDesk 维护的 appimage-builder fork（rustdesk-org/appimage-builder），与 CI 保持一致，不要换成上游包。
阅读配方：两个架构的差异
两份配方结构相同，差异集中在架构相关字段，修改或核对配方时对照这几处即可：
| 字段 | AppImageBuilder-x86_64.yml | AppImageBuilder-aarch64.yml |
|---|---|---|
apt.arch | amd64 | arm64 |
apt.sources | http://archive.ubuntu.com/ubuntu/的 focal（20.04）各组件仓库 | http://ports.ubuntu.com/ubuntu-ports/的 focal 仓库，带[arch=arm64]与key_url（从 keyserver 拉取签名密钥） |
apt.include | libc6:amd64及 GTK3、libxdo3、libva、gstreamer/pipewire、wayland、pulseaudio 等运行时库 | libc6:arm64及同一组运行时库 |
runtime.env中的路径 | x86_64-linux-gnu系列的库搜索路径（APPDIR_LIBRARY_PATH、GIO_MODULE_DIR、GST_PLUGIN_PATH等） | aarch64-linux-gnu系列路径 |
AppImage.arch | x86_64 | aarch64 |
runtime.env段值得留意的两处（注释是仓库原文的说明）：
GDK_BACKEND: x11：AppImage 内固定使用 X11 后端；XDG_DATA_DIRS/XDG_CONFIG_DIRS：AppRun 会把这两个变量设为$APPDIR/...:$XDG_DATA_DIRS，从而屏蔽 XDG 默认值；在 gdk-pixbuf 2.43+ 的发行版（Arch、Fedora）上会导致找不到 glycin 加载器、所有 PNG 解码失败，应用会在第一次绘制远程光标时中止。配方把宿主值放在末尾，保证/usr/share、/etc/xdg等默认目录仍然生效；- x86_64 配方还注明：由于
APPDIR_LIBRARY_PATH优先使用系统库，apt.include里捆绑的libc6实际不会被使用（注释提到若 gstreamer 崩溃可尝试LD_PRELOAD指向$APPDIR/usr/lib/x86_64-linux-gnu/libc.so.6）。
apt.exclude排除了humanity-icon-theme、hicolor-icon-theme、adwaita-icon-theme、ubuntu-mono，files.exclude排除了 man 页和 doc 目录下的 README/changelog 等文件，用于控制产物体积。
执行构建
进入appimage/目录并运行配方（以 x86_64 为例，aarch64 换成对应配方文件）：
pushd appimage sudo appimage-builder --skip-tests --recipe ./AppImageBuilder-x86_64.yml说明：
- 官方 CI 使用
sudo运行（FUSE 挂载权限相关），并带--skip-tests跳过配方末尾的test段；不带该参数时，builder 会先执行配方中的测试任务； - 这一步会在当前目录生成
AppDir中间产物，并最终产出 AppImage。
验证产物
仓库文档给出的核对方式有两层：
- 产物文件：CI 发布步骤上传的路径是
./appimage/rustdesk-<VERSION>-*.AppImage（见 flutter-build.yml），本地构建后按同样规律在appimage/目录下确认生成了带版本号与架构的rustdesk-<VERSION>-*.AppImage文件； - 配方内置测试：两份配方的
test段定义了五组容器化验证环境，每组都在appimagecrafters/tests-env镜像中执行./AppRun：
test: fedora-30: image: appimagecrafters/tests-env:fedora-30 command: ./AppRun debian-stable: image: appimagecrafters/tests-env:debian-stable command: ./AppRun archlinux-latest: image: appimagecrafters/tests-env:archlinux-latest command: ./AppRun centos-7: image: appimagecrafters/tests-env:centos-7 command: ./AppRun ubuntu-xenial: image: appimagecrafters/tests-env:ubuntu-xenial command: ./AppRun不带--skip-tests运行时，这些用例就是在多个发行版容器里启动./AppRun做冒烟验证，可用它替代只依赖"文件生成了"这一条判断。
限制与注意事项
- 配方依赖仓库内相对路径
../res/的图标资源，脱离仓库根目录运行（或单独拷出appimage/）会导致cp ../res/...失败； apt.sources固定指向 focal（Ubuntu 20.04）仓库且开启allow_unauthenticated: true，这是配方声明的依赖基线，不要随意换成其他发行版源，否则捆绑的运行时库版本可能与配方假设不符；- 两份配方只覆盖
x86_64与aarch64两种架构，AppImage.update-information: guess与压缩方式comp: gzip在两份配方中一致； - 若构建失败在 gstreamer/图形解码相关环节，可先对照配方中关于
APPDIR_LIBRARY_PATH优先使用系统库的注释排查，而不是直接修改apt.include的捆绑库。
【免费下载链接】rustdeskAn open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.项目地址: https://gitcode.com/GitHub_Trending/ru/rustdesk
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
