使用 GitHub Actions 编译打包最新版本 RustDesk 自定义客户端详细流程
前期准备
1、拥有 GitHub 账号
2、本地电脑安装有 Git 客户端
3、私有部署了 RustDesk Server 服务器
注:本教程适用于 RustDesk v1.3.9 + 版本
Import 导入项目
- 登录 GitHub 后,分别 Import 导入官方的
rustdesk
、hbb_common
- 填写导入的项目地址以及项目名称,点击导入
rustdesk
https://github.com/rustdesk/rustdesk
- 同样,再次点击导入项目功能,填写导入的项目地址以及项目名称,点击导入
hbb_common
https://github.com/rustdesk/hbb_common
- 出现如下画面时,即导入成功
Git 项目到本地并修改配置
- 在电脑的任意文件夹中,右键点击,选择 Open Git Bash here
- 执行
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/
,进入到项目主目录下,
- 执行命令,修改 .gitmodules 中的子模块 URL
git config -f .gitmodules submodule.libs/hbb_common.url https://github.com/Suery/hbb_common.git
- 重新初始化并同步子模块
git submodule sync
git submodule update --init --recursive
- 本地电脑打开主项目文件,编辑修改
src/common.rs
和flutter/lib/desktop/pages/connection_page.dart
- 打开src\common.rs,在1007行替换API地址,可以通过搜索
get_api_server_
,然后往下翻找到 .to_owned(),替换前面的URL即可
- 将
https://admin.rustdesk.com
修改为自己的API服务地址,如果没有也可以修改为部署Rustdesk Server
服务器地址,例https://192.168.10.10
- 打开
flutter/lib/desktop/pages/connection_page.dart
文件
- 将 81-110 行代码替换如下
Widget setupServerWidget() => Flexible(
child: Offstage(
offstage: !(!_svcStopped.value &&
stateGlobal.svcStatus.value == SvcStatus.ready &&
_svcIsUsingPublicServer.value),
child: Row(
crossAxisAlignment: CrossAxisAlignment.center,
children: [],
),
),
);
- 替换后
- 保存编辑修改后的
src/common.rs
和flutter/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
- API地址修改并提交后,执行命令
cd libs/hbb_common
,进入到引用模块目录下
cd libs/hbb_common
- 本地电脑打开主项目文件,编辑修改
libs/hbb_common/src/config.rs
,将103、104行中的rs-ny.rustdesk.com
、OeVuKk5nlHiXp+APNn0Y3pC1Iwpwn44JGqrQCsWqmBw=
修改为自己部署的Rustdesk Server
服务器的IP地址以及KEY
- 返回 Git Bash 页面,执行以下命令提交修改
git checkout -b fix-branch
git add src/config.rs
git commit -m "修改 config.rs"
git push origin fix-branch
- 提交完成后,返回
rustdesk
项目主目录,执行以下命令更新libs/hbb_common
并提交
cd ../..
git add libs/hbb_common
git commit -m "更新子模块引用"
git push origin fix-branch
- 提交完成后,浏览器打开你 Import 的
rustdesk
的项目主页,查看是否有fix-branch
分支出现,有的话,则点击进入fix-branch
分支
- 在
fix-branch
分支中,点击进入到libs
目录,进入libs
目录后,查看 hbb_common 是否为刚刚提交的修改,是的话,则点击hbb_common
目录,正常情况下,点击hbb_common
目录会自动跳转到你 Import 的 hbb_common 项目地址
- 在 hbb_common 项目地址,查看
src/config.rs
文件中的服务器IP地址和KEY是否已修改,如果已修改,则可以开始执行编译打包操作,否则,则检查上述步骤中是否有遗漏
GitHub Actions 编译打包
- 返回 rustdesk 项目地址,点击 Settings
- 左侧点击 Actions-->General,确保
Allow all actions and reusable workflows
和Read and write permissions
为选中状态,若不是则勾选并点击下方的Save
按钮
- 再次返回 rustdesk 项目地址,点击 Actions
- 左侧选择
Flutter Nightly Build
后,点击页面中的Run workflow
- 在出现的模态框中,我们要选择
fix-branch
分支
- 选择好分支后,点击
Run workflow
按钮开始编译打包
Run workflow
按钮点击后,等待一会,即可在页面中看到在运行的打包工作流
- 点击进去,即可查看打包进度,全部流程跑完,大约一个小时左右
- 全部编译打包完成后,即可返回 rustdesk 项目地址,点击跳转至 Releases 页面下载所需
标题:使用 GitHub Actions 编译打包最新版本 RustDesk 自定义客户端详细流程
作者:Mune
地址:https://cnxiaobai.com/articles/2025/08/05/1754384458268.html

0 评论