企业官网建设流程全解析

把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-gui

desktop-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）。旧地址立刻作废。
• 两个入口都校验 Token：WebSocket 握手和/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）——没有人在电脑前，密钥本身无法授予任何权限。
• 可见性：有远程连接接入的瞬间，桌面端会显示「远程控制中」标记，你随时知道谁在操作。

连不上？常见排查清单 ✅

相关文件速查 📚

• 内网访问前端页面（二维码、复制地址）：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