使用 GitHub Actions 编译打包最新版本 RustDesk 自定义客户端详细流程

前期准备

1、拥有 GitHub 账号
2、本地电脑安装有 Git 客户端
3、私有部署了 RustDesk Server 服务器
注:本教程适用于 RustDesk v1.3.9 + 版本

Import 导入项目

  • 登录 GitHub 后,分别 Import 导入官方的 rustdeskhbb_common

image.png

  • 填写导入的项目地址以及项目名称,点击导入rustdesk
https://github.com/rustdesk/rustdesk

image.png

  • 同样,再次点击导入项目功能,填写导入的项目地址以及项目名称,点击导入hbb_common
https://github.com/rustdesk/hbb_common

image.png

  • 出现如下画面时,即导入成功

image.png

image.png

Git 项目到本地并修改配置

  • 在电脑的任意文件夹中,右键点击,选择 Open Git Bash here

image.png

  • 执行 git clone 命令,克隆你导入的项目到本地
  • 注:本文中,GitHub地址中的 Suery 均需修改为你的GitHub用户名
git clone https://github.com/你的用户名/rustdesk.git
  • 例:
git clone https://github.com/Suery/rustdesk.git
  • 默认克隆时,一般会克隆 master 分支代码,该分支代码可能包含待测试代码,不建议克隆master分支到本地,也可以只克隆指定标签版本 - 推荐
  • 下述命令中的1.4.1为当前最新稳定版本的版本号,若需其他版本,修改克隆即可
git clone -b 1.4.1 https://github.com/Suery/rustdesk.git
  • 克隆完成后,执行命令 cd rustdesk/,进入到项目主目录下,

image.png

  • 执行命令,修改 .gitmodules 中的子模块 URL
git config -f .gitmodules submodule.libs/hbb_common.url https://github.com/Suery/hbb_common.git

image.png

  • 重新初始化并同步子模块
git submodule sync
git submodule update --init --recursive

image.png

  • 本地电脑打开主项目文件,编辑修改 src/common.rsflutter/lib/desktop/pages/connection_page.dart
  • 打开src\common.rs,在1007行替换API地址,可以通过搜索 get_api_server_,然后往下翻找到 .to_owned(),替换前面的URL即可

image.png

  • https://admin.rustdesk.com 修改为自己的API服务地址,如果没有也可以修改为部署 Rustdesk Server 服务器地址,例 https://192.168.10.10

image.png

  • 打开 flutter/lib/desktop/pages/connection_page.dart 文件

image.png

  • 将 81-110 行代码替换如下
Widget setupServerWidget() => Flexible(
       child: Offstage(
         offstage: !(!_svcStopped.value &&
             stateGlobal.svcStatus.value == SvcStatus.ready &&
             _svcIsUsingPublicServer.value),
         child: Row(
           crossAxisAlignment: CrossAxisAlignment.center,
           children: [], 
         ),
       ),
     );

image.png

  • 替换后

image.png

  • 保存编辑修改后的 src/common.rsflutter/lib/desktop/pages/connection_page.dart 文件,在 rustdesk 主目录执行以下命令,提交修改
git checkout -b fix-branch
git add .gitmodules
git add src/common.rs
git add flutter/lib/desktop/pages/connection_page.dart
git commit -m "更新配置文件"
git push origin fix-branch

image.png

  • API地址修改并提交后,执行命令 cd libs/hbb_common,进入到引用模块目录下
cd libs/hbb_common

image.png

  • 本地电脑打开主项目文件,编辑修改 libs/hbb_common/src/config.rs,将103、104行中的 rs-ny.rustdesk.comOeVuKk5nlHiXp+APNn0Y3pC1Iwpwn44JGqrQCsWqmBw= 修改为自己部署的 Rustdesk Server 服务器的IP地址以及KEY

image.png

image.png

  • 返回 Git Bash 页面,执行以下命令提交修改
git checkout -b fix-branch
git add src/config.rs
git commit -m "修改 config.rs"
git push origin fix-branch

image.png

  • 提交完成后,返回 rustdesk 项目主目录,执行以下命令更新 libs/hbb_common 并提交
cd ../..
git add libs/hbb_common
git commit -m "更新子模块引用"
git push origin fix-branch

image.png

  • 提交完成后,浏览器打开你 Import 的 rustdesk 的项目主页,查看是否有 fix-branch 分支出现,有的话,则点击进入 fix-branch 分支

image.png

  • fix-branch 分支中,点击进入到 libs 目录,进入 libs 目录后,查看 hbb_common 是否为刚刚提交的修改,是的话,则点击 hbb_common 目录,正常情况下,点击 hbb_common 目录会自动跳转到你 Import 的 hbb_common 项目地址

image.png

  • 在 hbb_common 项目地址,查看 src/config.rs 文件中的服务器IP地址和KEY是否已修改,如果已修改,则可以开始执行编译打包操作,否则,则检查上述步骤中是否有遗漏

image.png

GitHub Actions 编译打包

  • 返回 rustdesk 项目地址,点击 Settings

image.png

  • 左侧点击 Actions-->General,确保 Allow all actions and reusable workflowsRead and write permissions 为选中状态,若不是则勾选并点击下方的 Save 按钮

image.png

image.png

  • 再次返回 rustdesk 项目地址,点击 Actions

image.png

  • 左侧选择 Flutter Nightly Build 后,点击页面中的 Run workflow

image.png

  • 在出现的模态框中,我们要选择 fix-branch 分支

image.png

  • 选择好分支后,点击 Run workflow 按钮开始编译打包

image.png

  • Run workflow 按钮点击后,等待一会,即可在页面中看到在运行的打包工作流

image.png

  • 点击进去,即可查看打包进度,全部流程跑完,大约一个小时左右

image.png

image.png

  • 全部编译打包完成后,即可返回 rustdesk 项目地址,点击跳转至 Releases 页面下载所需

image.png

image.png


标题:使用 GitHub Actions 编译打包最新版本 RustDesk 自定义客户端详细流程
作者:Mune
地址:https://cnxiaobai.com/articles/2025/08/05/1754384458268.html

    评论
    0 评论
avatar

取消