把desktop-cc-gui共享到手机：局域网网页访问与二维码Token鉴权完整指南

把desktop-cc-gui共享到手机局域网网页访问与二维码Token鉴权完整指南【免费下载链接】desktop-cc-guiMulti-engine AI coding desktop client (Tauri). Claude Code, Codex, Gemini, OpenCode, DeepSeek Harness and more in one GUI.项目地址: https://gitcode.com/zhukunpenglinyutong/desktop-cc-guidesktop-cc-gui 是一款多引擎 AI 编程桌面客户端Claude Code、Codex、Gemini、OpenCode、DeepSeek Harness 等引擎共用一个图形界面。它的「局域网网页访问」功能只需一键启动就能让同一 Wi-Fi 下的手机通过浏览器打开完整界面配合每次随机生成的 Token 鉴权与二维码入口既安全又省事。本篇完整指南带你三步完成配置并讲清二维码 Token 鉴权背后的安全设计。为什么要把桌面端共享到手机 写代码的主力还在电脑但有些场景离开工位更方便AI 任务正在跑想躺到沙发上看它什么时候结束手机里突然想起要追问一句、补一个文件路径演示时直接把界面投到第二块屏幕上。desktop-cc-gui 为此内置了一个「局域网桥接」桌面端在本地起一个服务把前端界面通过 HTTP 发布出去同时把后端命令与事件流通过带 Token 鉴权的 WebSocket转发给手机浏览器后端实现在 src-tauri/src/web.rs。手机打开后看到的和桌面端是同一套界面而所有 AI 编码工作仍然在你电脑上执行——手机只是「遥控器」。一键开启局域网网页访问三步搞定第 1 步打开「设置 → 远程访问」进入设置页找到「远程访问」卡片默认停在「内网访问」页签前端页面src/features/settings/WebAccessSection.tsx。第 2 步点击「启动 Web 访问」点击后页面会变为「运行中」状态并直接展示访问地址形如http://192.168.x.x:随机端口/?token一长串随机字符你不需要手动配置任何端口——程序自动绑定一个空闲端口并探测局域网 IP拼好地址给你。第 3 步手机扫码或输入地址启动成功后页面上会出现一张二维码包含的就是上面带 Token 的完整地址用浏览器或相机扫一扫即可进入也可以点地址旁的复制按钮手动粘贴到手机浏览器。 注意手机必须和电脑连接同一个 Wi-Fi。在手机浏览器里该页面只显示服务状态无法启停——启停操作只在桌面端可用。二维码 Token鉴权是怎么保护你的 这个桥接会暴露终端、文件读写等能力所以安全设计相当克制核心就一条规则每次启动都换一把新钥匙。Token 每次随机生成启动时由两个 UUID 拼接成一串 64 位十六进制随机码见 web.rs#L245最终拼进访问地址web.rs#L284。旧地址立刻作废。两个入口都校验 TokenWebSocket 握手和/file文件接口都会检查 Token缺失或不匹配直接拒绝陌生人即使连上你的 Wi-Fi 也打不开。Token 放在 URL 里而非请求头因为img标签无法携带自定义请求头放在查询参数?token…里界面里的图片资源才能正常加载web.rs#L682-L702。二维码 免登录二维码内容就是带 Token 的完整地址扫码即完成鉴权手机上没有任何多余账号体系。不用的时候点一下「停止」桥接立即关闭、Token 随之失效网络层面不再有任何暴露面。进阶外网访问与配对密钥可选同一个「远程访问」卡片里还有一个「外网访问」页签。首次点击时会弹出一张风险确认每台电脑只需确认一次——因为它会把桌面端的能力暴露到公网。中转服务经由 Cloudflare Worker 中转可一键部署填写 Cloudflare API Token 即可之后手机在任意网络都能通过中转地址连接。配对密钥外网路径下设备还需额外配对。开启「授权访问」会生成一串8 位配对密钥每串密钥只能配对一台设备配对成功后自动更换前端卡片src/features/settings/WebAuthCard.tsx。手动放行手机输入密钥后只是「提交申请」还要你在电脑「授权列表」里点一次「授权」该设备才真正放行src/features/settings/WebDevicesCard.tsx——没有人在电脑前密钥本身无法授予任何权限。可见性有远程连接接入的瞬间桌面端会显示「远程控制中」标记你随时知道谁在操作。连不上常见排查清单 ✅现象可能原因手机打不开地址两台设备不在同一 Wi-Fi同一 Wi-Fi 但无法访问路由器开启了 AP 隔离设备间互不可达可在路由器后台关闭一直转圈/无响应电脑防火墙拦截了随机端口请放行一次本应用地址里出现 127.0.0.1局域网 IP 探测失败时的兜底值web.rs#L282手机上无效请改为电脑的局域网 IP换地址后旧二维码失效正常现象每次重启服务 Token 都变化请以当前地址为准相关文件速查 内网访问前端页面二维码、复制地址WebAccessSection.tsx局域网桥接、Token 生成与校验Rust 后端web.rs外网配对密钥卡片WebAuthCard.tsx设备授权列表配对/授权/删除WebDevicesCard.tsx中转服务卡片WebRelayCard.tsx全部界面文案含安全提示zh.ts项目功能总览README.md把手机变成远程操控台只需要三个步骤启动服务 → 扫二维码 → 开聊。用完记得点「停止」让 Token 立刻失效——这是这套设计里成本最低、也最有效的一道防线。【免费下载链接】desktop-cc-guiMulti-engine AI coding desktop client (Tauri). Claude Code, Codex, Gemini, OpenCode, DeepSeek Harness and more in one GUI.项目地址: https://gitcode.com/zhukunpenglinyutong/desktop-cc-gui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考