uurc-web：UU 远程控制网页主控端

本文介绍 uurc-web，一个 UU 远程控制的网页主控端开源项目，支持短信登录、设备管理、远控会话等功能，可通过 Docker 或 Cloudflare Worker 部署。

项目简介

uurc-web 是一个开源的 UU 远程网页主控端项目，由 iola1999 开发维护。它提供了完整的远程控制管理界面，包括短信登录、账号凭证管理、设备列表、远控会话等核心功能，支持 Docker 和 Cloudflare 两种部署方式。

项目采用 MIT 许可证，致谢了 AssppWeb 项目在 Cloudflare 部署架构上的参考。

核心功能

• 短信登录：通过短信验证码完成账号登录
• 账号凭证导入导出：方便在多实例间迁移账号信息
• 设备列表：集中管理所有可远控的设备
• 远控会话：建立和管理远程控制连接
• 账号管理：多账号统一管理
• 本地 UU API 和信令网关：内置信令服务，无需额外依赖

部署方式

方式一：Docker 部署（推荐）

直接一行命令启动：

docker run -d \
  --name uurc-web \
  -p 8787:8787 \
  iola1999/uurc-web:latest

或者使用 Docker Compose：

# 下载 compose 文件
curl -O https://raw.githubusercontent.com/iola1999/uurc-web/main/compose.yml

# 启动服务
docker compose up -d

部署完成后访问 http://localhost:8787 即可使用。

方式二：Cloudflare 部署

项目支持 Cloudflare Worker + Durable Object 部署，适合需要公网访问的场景：

# 登录 Cloudflare
npx wrangler login

# 部署到 Cloudflare
npm run deploy:cloudflare

详细的部署要求和注意事项见项目仓库的 cloudflare/README.zh-CN.md。

本地开发

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 运行测试
npm test

# 构建生产版本
npm run build

# 本地构建 Docker 镜像
docker build -t iola1999/uurc-web:local .

致谢

项目的 Cloudflare 部署架构参考并致谢了 AssppWeb，尤其是：

• Cloudflare 部署入口体验
• 本地网关 / relay 的架构思路

项目链接

• GitHub 仓库：https://github.com/iola1999/uurc-web
• Docker 镜像：iola1999/uurc-web:latest
• License：MIT