# JoDesk **Repository Path**: duihao/jodesk ## Basic Information - **Project Name**: JoDesk - **Description**: JoDesk 是对号出品的远程桌面客户端。所有连接经你自建的 ID / 中继服务器撮合,画面端到端加密、不落盘、不经过任何第三方云。Windows 解压即用,不需要安装。 - **Primary Language**: Rust - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # JoDesk(基于 RustDesk 的远程桌面客户端) 从 RustDesk 1.5.3 桌面客户端源码克隆改名而来,内置默认服务器信息,构建分发后开箱即用。 ## 目录结构 ``` E:/workbudy/JoDesk/ ├── rustdesk-src/ # RustDesk 1.5.3 源码(已改名 JoDesk) ├── vcpkg/ # vcpkg(构建 C 依赖:aom/libvpx/libyuv) ├── tools/ # llvm、cmake、nasm 等本地工具链 + 图标/改服务器/打包脚本 ├── patches/ # 相对上游 1.5.3 的定制补丁(源码不入库,用补丁对外提供) ├── site/ # 官网 jodesk.cn 的静态页(index.html / 404.html / logo) ├── deploy/ # rustdesk-api 服务端部署件(compose + nginx 反代配置) ├── build-env.sh # bash 构建环境变量(git 加速通道等) ├── build-jodesk.cmd # Sciter 版一键构建脚本(Windows) ├── build-flutter.cmd # Flutter 版构建脚本(prep / build / pack) └── dist/ # 产物输出目录 ``` ## 已完成的改动(相对原版 RustDesk) | 类别 | 位置 | 改动 | |------|------|------| | 应用名 | `libs/hbb_common/src/config.rs` | `APP_NAME` 默认值 RustDesk → **JoDesk**(窗口标题/托盘/服务名/安装目录/注册表/URI scheme 全部自动派生为 JoDesk) | | 默认服务器 | `libs/hbb_common/src/config.rs` | `RENDEZVOUS_SERVERS = ["ids.jodesk.cn"]`、`RS_PUB_KEY = "4ehQo5kScXoK5QaJDxkpzo9uimCzOMGRO53BCbCb8oA="`(hbbs 已启用密钥校验,公钥已内置) | | 进程名 | `Cargo.toml` | 产物 exe:`rustdesk.exe` → **JoDesk.exe**(`default-run`、`[[bin]]`) | | 版本资源 | `Cargo.toml` winres | ProductName/FileDescription/OriginalFilename/版权方 → JoDesk / 对号 | | 图标 | `res/icon.ico`、`res/tray-icon.ico` | 全新「对号」图标(蓝色圆角方块 + 白色勾,脚本 `tools/gen-icon.py` 可再生成) | | 其他硬编码 | `src/platform/windows.rs`、`src/whiteboard/windows.rs`、`src/auth_2fa.rs` | ProgramData 目录 / 消息框标题 / 白板标题 / 2FA 发行方 → 跟随应用名 | | 自动更新 | 语义不变 | APP_NAME ≠ RustDesk 后自动按「自定义客户端」处理,**不会联网升级成官方 RustDesk** | 刻意保留不改的:协议字段、剪贴板格式、签名上下文、虚拟显示驱动 ID、`is_rustdesk()`(语言包品牌替换开关)、`librustdesk` 内部名。 ## 默认服务器说明 - `RENDEZVOUS_SERVERS`:ID 服务器(自动补 `:21116` 端口) - `RS_PUB_KEY`:hbbs 的 `id_ed25519.pub` 内容,**留空 = 服务器未启用密钥校验**(当前已填入线上服务器公钥) - 中继服务器不用写死:hbbs 会自动下发 relay 地址;用户也可在客户端「设置 → 网络」里覆盖 - 所有默认值都只是**首选项**,终端用户可在设置页修改 换服务器一条命令: ```bash tools/set-server.sh ids.jodesk.cn # 只换 ID 服务器 tools/set-server.sh ids.jodesk.cn "$(cat id_ed25519.pub)" # 带公钥 ./build-jodesk.cmd # 重新出包 ``` ## 构建与打包 ### Sciter 界面(轻量版) Windows 上直接跑: ```cmd build-cargo.cmd :: 只编译(产物 target/release/JoDesk.exe) build-jodesk.cmd :: 一键:编译 + 组装 dist ``` 产物: - `rustdesk-src/target/release/JoDesk.exe` — 主程序(Sciter UI,无需 Flutter) - `dist/JoDesk-1.5.3-win64/` — 分发目录:`JoDesk.exe` + `sciter.dll` + `使用说明.txt` - `dist/JoDesk-1.5.3-win64.zip` — 压缩包(约 18 MB),解压即用 ⚠️ **sciter.dll 必须与 exe 同目录**:`--features inline` 只把 UI 资源(html/css/tis)编进 exe, 界面引擎本身仍是动态库(sciter-rs 的 `dyn` 分支),缺少时启动会报 `'sciter.dll' was not found neither in PATH nor near the current executable`。 当前 sciter.dll 取自 `c-smile/sciter-sdk` 的 `bin.win/x64/`,已放在 `tools/sciter/`。 ### Flutter 界面(主推版) 官方现代界面,`libs/hbb_common` 与通讯逻辑和轻量版完全共用,只是 UI 层不同。 ```cmd build-flutter.cmd prep :: flutter pub get + flutter_rust_bridge_codegen build-flutter.cmd build :: cargo build --features flutter --lib + flutter build windows --release ``` 产物在 `rustdesk-src/flutter/build/windows/x64/runner/Release/`,打包用: ```bash python tools/pack-zip.py dist/JoDesk-1.5.3-win64-flutter dist/JoDesk-1.5.3-win64-flutter.zip ``` Flutter 版的几个坑(都已固化): - `--features flutter` **不带 hwcodec**:hwcodec 需要 vcpkg 的 ffmpeg 头文件,未装;这是官方默认构建方式。 - pub 的 9 个 git 依赖会直连 GitHub 被拦,脚本用 `GIT_CONFIG_*` 的 `insteadOf` 走 `gh-proxy.com`。 - 插件符号链接需要 Windows 开发者模式,脚本里的 flutter_tools 已改为 `mklink /J` junction 回退。 - ffigen 找不到 libclang 时,把 `tools/clang+llvm-*/bin` junction 到 `LIBCLANG_PATH` 指定位置。 - `librustdesk.dll` 已在 `[profile.release]` 里 `strip = true`,无需再 strip(再 strip 体积不变)。 - 主窗口 show 之前必须 `registerActiveWindow(kWindowMainId)`,否则首次激活即退出。 构建链(脚本已自动处理):MSVC 2022 BuildTools + Rust 1.99 + LLVM/clang-cl(libclang 用于 bindgen)+ cmake 4.4.4 + vcpkg(aom/libvpx/libyuv/opus 静态库)。 构建时几个必须的坑(都已固化进脚本): 1. `feature = inline` 需要 `src/ui/inline.rs`,由 `python res/inline-sciter.py` 生成 —— `build-cargo.cmd` 已自动执行,缺失时报 `E0583: file not found for module inline`。 2. `winres` 0.1 用 `reg query` 探测 Windows SDK,本机安全策略拦 `reg.exe`, 因此靠 `JODESK_RC_BIN=\bin\\x64` 显式指定 rc.exe(`build.rs` 已支持该变量)。 3. `magnum-opus` 的 build.rs 按 `VCPKG_ROOT/installed/x64-windows-static` 找 opus, 需 `vcpkg-opus.cmd` 先装好 opus。 ## 国内网络适配(重要) 本机直连 github.com / googlesource.com 均不通,构建链已做如下适配: 1. `build-env.sh` / `build-jodesk.cmd` 里的 `GIT_CONFIG_*` 把 `https://github.com/` 的 git 访问改走 `gh-proxy.com`(cargo 的 git 依赖、vcpkg 的 from_git 端口都生效)。 2. crates.io 换清华 TUNA sparse 源(`rustdesk-src/.cargo/config.toml`)。 3. vcpkg 叠加端口 `res/vcpkg/aom`、`res/vcpkg/libvpx` 的源码获取改为 Google 存储(可达)的同版本官方发布包,SHA512 已重新计算;libyuv 走 gh-proxy 的 github 镜像(lemenkov/libyuv,含所需 commit)。 4. LLVM、cmake、ninja、vcpkg 工具本体均从镜像下载到 `tools/`,首次构建后不再依赖网络。 ## 官网与发布 - 站点:(`site/index.html` 单文件自包含,另有 `404.html`) - 隐私声明:(客户端「关于」页与官网页脚均链接到此) - 下载区: - 主推 Flutter 版 `/download/JoDesk-1.5.3-win64-flutter.zip`(约 30.6 MB) - 轻量备选 Sciter 版 `/download/JoDesk-1.5.3-win64.zip`(约 17.9 MB) - 管理后台: — nginx 反代到 `http://127.0.0.1:21114/_admin/` - 服务端部署件见 `deploy/rustdesk-api/`(docker compose + nginx 配置 + 步骤说明) 发布方式:FTP 到站点根(账号信息不入库,见本地 .env / 运维记录), **注意 FTP 已 chroot 到站点根**,上传路径写 `/index.html`、`/download/xxx.zip`, 不要带 `www/wwwroot/jodesk.cn/` 前缀。上传后建议核对线上 `Content-Length` 与本地一致。 ## 尚未完成 / 注意事项 - [x] 默认服务器已指向 `ids.jodesk.cn`(= 59.110.223.185,端口 21115-21118 已验证可达);`id.jodesk.cn` 同名记录也在,但部分本地 DNS 解析失败,故默认用 ids。 - [x] Flutter 现代界面已构建并发布,与轻量版并存于官网下载区。 - [x] 「由 JoDesk 提供支持」品牌文案已随语言包替换生效。 - [ ] hwcodec(硬件编解码)未启用:需先用 vcpkg 装 ffmpeg,再以 `--features flutter,hwcodec` 重编。 - [ ] HTTPS 账号登录受阿里云入口层 TLS 指纹过滤影响(TLS 1.2 被 RST,1.3 可过), 自建服务器或换非阿里云入口可解;客户端已做 TLS 1.3 优先 + native-tls 降级。 - [ ] 图标如需贴合对号 VI(颜色/形状),改 `tools/gen-logo-jodesk.py` 顶部配色重新生成。 - [ ] 便携单文件(`libs/portable/generate.py`)未出包:它依赖 python 的 `brotli` 模块, 本机 pip 源不可达装不上;当前分发形态为「exe + sciter.dll」压缩包。 - [ ] MSI/NSIS 安装包未做:如需安装到 Program Files + 开机自启,另行配置 `res/msi`。 - [x] 语言包 "Powered by RustDesk" 两处(`src/lang/en.rs`、`cn.rs`)已在 translate key 不动的前提下改 value 为 JoDesk,界面显示「由 JoDesk 提供支持」。 - [ ] 首次启动配置目录为 `%APPDATA%\JoDesk`,与已装 RustDesk 完全隔离(不迁移旧配置)。