CrossDesk

简介

CrossDesk Web Client 是针对 CrossDesk 桌面远程软件进行适配的 Web 客户端。

部署

直接 Fork 本仓库，进入你的仓库 Settings → Pages，在 Branch 中选择 main，点击 Save。稍作等待后刷新页面，你会得到如下显示，该链接就是你的 Web 客户端地址。

配置项

web_client.js 中包含配置项：

const DEFAULT_CONFIG = {
  signalingUrl: "wss://api.crossdesk.cn:9099",
  iceServers: [
    { urls: ["stun:api.crossdesk.cn:3478"] },
    { urls: ["turn:api.crossdesk.cn:3478"], username: "crossdesk", credential: "crossdeskpw" },
  ],
  heartbeatIntervalMs: 3000,
  heartbeatTimeoutMs: 10000,
  reconnectDelayMs: 2000,
  reconnectMaxDelayMs: 30000,
  reconnectMaxAttempts: 8,
  interactionGuardEnabled: true,
  interactionGuardScope: "video", // "video" | "global" | "none"
  clientTag: "web",
};

在完成 CrossDesk Server 的部署后，请将配置项中的 signalingUrl 和 iceServers 配置成你的 CrossDesk Server 的外网地址和端口。

# signalingUrl
wss://api.crossdesk.cn:9099 替换为 EXTERNAL_IP:CROSSDESK_SERVER_PORT

# iceServers
api.crossdesk.cn:3478 替换为 EXTERNAL_IP:COTURN_PORT

WebRTC Adapter 版本锁定

项目不再依赖 adapter-latest.js，改为：

• 本地优先加载固定版本：vendor/adapter-9.0.1.min.js
• 本地加载失败时回退到固定版本 CDN：https://cdn.jsdelivr.net/npm/webrtc-adapter@9.0.1/out/adapter.min.js

这样可以避免上游 latest 漂移导致的不可控行为，并支持版本追踪与回滚。