# rootdesk **Repository Path**: blackqing/rootdesk ## Basic Information - **Project Name**: rootdesk - **Description**: RootDesk 只要有浏览器，你就能随时随地掌控你的远程控制设备。 支持Windows 7 / 8 / 10 / 11 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://rootdesk.cn - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 7 - **Created**: 2026-04-25 - **Last Updated**: 2026-04-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RootDesk: 可能是最优雅的免费开源 Web 远程控制 > 打破设备边界，让远程控制像刷网页一样简单！ > > RootDesk 是一款专为开发者和极客打造的**全栈远程控制系统**。它由 **Next\.js 强力驱动的 Web 控制端** 和 **轻量级 Python 客户端**组成。无需安装臃肿的桌面软件，只要有浏览器，你就能随时随地掌控你的远程设备，兼顾便捷性与安全性，适配个人、工作室及小型企业的私有化远控需求。 🔥 在线体验直达：[**rootdesk\.cn**](http://rootdesk.cn)，无需部署，打开浏览器即可快速体验所有核心远控功能，零门槛上手！ --- ## ✨ 为什么选择 RootDesk？ 传统的远控软件要么收费昂贵、功能冗余，要么体积庞大、操作繁琐。RootDesk 坚守“极简\+强大”的核心定位，精准解决开发者与极客的远程控制痛点： - 🌐 **纯 Web 控制**：打开浏览器即用，无需安装任何客户端（被控端除外），支持手机/平板/电脑跨端无缝操作，摆脱设备限制。 - 🏠 **支持私有化部署**：数据完全由你自主掌控，可轻松部署在内网、私有云或个人服务器，避免公网传输带来的安全隐患，隐私无忧。 - ⚙️ **灵活配置**：客户端内置可视化设置面板，支持自定义服务器 IP/域名及端口，一键适配你的私有控制端，部署后快速上手。 - ⚡ **毫秒级响应**：基于 WebSocket 实时双向加密通信，指令下发瞬间到达，桌面同步无延迟，操作体验媲美本地操作。 - 🐍 **轻量级客户端**：基于 Python 核心编译，绿色免安装、无捆绑插件，代码透明可审计，安全可控，不占用过多系统资源。 - 🎨 **颜值即正义**：采用 Shadcn UI \+ Tailwind CSS 构建，极简黑白灰设计风格，界面简洁流畅，高级感拉满，兼顾美观与实用性。 - 🛠️ **全能工具箱**：不止于基础屏幕控制，更集成文件管理、进程监控、远程终端、双向语音、音频监听、私有屏幕等深度功能，满足多场景使用需求。 无论是个人远程管理设备、开发者运维调试，还是工作室协同操控，RootDesk 都能以极简体验满足多样化远控需求，兼顾便捷性与安全性，成为远控工具的优选方案。 --- ## 🛠️ 核心功能一览 |功能|描述| |---|---| |🖥️ 实时桌面|高清流畅的屏幕画面同步，支持远程点击、拖拽、缩放，操作精准无偏差，适配不同分辨率设备。| |📁 文件管理|像网盘一样便捷浏览远程设备文件，支持上传、下载、删除、重命名、新建文件夹，跨设备传文件更高效。| |💻 远程终端|直接在网页端执行 CMD/Shell 命令，支持命令历史记录、复制粘贴，运维调试更便捷，堪称开发者神器。| |📊 进程监控|实时查看远程设备 CPU、内存、硬盘、网络资源占用情况，可一键结束流氓进程、释放系统资源。| |🏠 私有化连接|客户端内置设置面板，支持填写私有服务器 IP/域名及端口，自定义连接参数，适配不同部署环境。| |🔄 开机自启|支持系统服务安装，远程设备重启后自动运行客户端，确保设备永久在线，无需手动启动。| |🔒 锁屏解锁|深度集成系统权限，支持远程锁定与解锁屏幕，保护远程设备数据安全，防止他人误操作。| |🎧 音频监听|实时同步远程设备音频输出，清晰听见远程设备的声音，适用于远程排查音频问题、监控设备状态。| |🎤 麦克风通话|支持双向语音对讲，远程喊话、技术指导、协同办公更高效，无需额外借助通讯工具。| |🕵️ 私有屏幕|远程操作时可开启“隐私模式”，黑掉对方显示器，隐藏操作内容，保护敏感操作隐私，避免信息泄露。| |📱 安卓被控|**（即将推出）** 支持安卓设备作为被控端，实现电脑、手机跨平台远控，覆盖更多设备场景。| |ℹ️ 系统详情|远程设备 CPU、内存、硬盘、网络、系统版本等信息一目了然，便于快速了解设备状态。| |📢 广告推送|内置灵活的广告/通告位，支持远程动态更新，适合企业内部推送通知、公告等内容。| --- ![输入图片说明](%E5%AE%A2%E6%88%B7%E7%AB%AF%E7%95%8C%E9%9D%A2.png) ![输入图片说明](%E6%8E%A7%E5%88%B6%E7%AB%AF%E7%95%8C%E9%9D%A2.png) ## 🚀 快速部署与访问 ### 1\. 访问系统与初始配置 部署完成后，可通过以下方式访问系统，完成初始配置： - 💻 控制端 Web：`http://你的服务器IP:3000` - 🔗 服务器 WS：`ws://你的服务器IP:3000` - 📊 管理统计：`http://你的服务器IP:3000/admin/monitor` ### 1\. 准备工作 1\. 确认服务器已安装 Docker 及 Docker Compose（可选，用于更便捷的容器管理）； 2\. 确保服务器开放 3000 端口（Web 控制端）和 3000 端口（WebSocket 通信），避免端口占用； 3\. 下载项目部署包（链接见下文），并上传至服务器指定目录（建议单独创建项目文件夹，便于管理）。 - 💻 控制端 Web：`http://你的服务器IP:3000`（若配置了 Nginx，可访问`http://域名/np/`） - 🔗 服务器 WS：`ws://你的服务器IP:3000`（若配置了 Nginx，可访问 `ws://域名/ws`） - 📊 管理统计：`http://你的服务器IP:3000/admin/monitor` 管理员凭证：首次启动后，系统会自动在 `data/credentials\.json` 文件中生成管理员账号密码。可通过 `docker logs rootdesk` 命令快速查看生成的初始凭证，建议首次登录后立即修改密码，提升安全性。 --- ## 🚀 客户端使用指南 ### 1\. 下载与运行客户端 \(Client\) 客户端为绿色免安装的 `\.exe` 可执行文件，专为 Windows 系统设计，支持快速连接到你的私有服务器，无需复杂配置。 #### 系统支持 Windows 7 / 8 / 10 / 11（x64/x86 架构），确保系统已安装 Python 3\.8\.10 环境（客户端依赖该版本 Python 核心运行，不建议使用其他版本，避免出现兼容性问题）。 #### 使用步骤 1. 下载并双击运行 **RootDesk客户端**，启动后无需安装，直接进入主界面； 2. 设置服务器：在客户端界面的“设置”选项卡中，填写你部署的控制端 **服务器地址**（IP 或域名）和 **端口**（默认 3001），点击“保存配置”； 3. 连接成功：返回首页，系统会自动尝试连接服务器，连接成功后会显示设备 ID 和连接状态，此时 Web 控制端即可搜索并控制该设备； 4. 可选设置：在“设置”中可开启“开机自启”“后台运行”，确保设备重启后仍能正常连接。 ### 2\. 部署与使用协助 如果你在部署（服务器 Node\.js 安装、Docker 操作）或客户端使用过程中遇到困难，或者不熟悉 Node\.js、Python 3\.8\.10 环境搭建，欢迎联系开发者。我们可提供**远程技术支持**，协助你完成私有化环境的搭建、调试及客户端配置，解决各类使用问题。 --- ## ⚔️ RootDesk 对比 ToDesk 核心优势 ToDesk 作为主流远程控制工具，虽具备基础远控功能，但在隐私安全、功能灵活性及成本控制上存在明显局限，RootDesk 针对性突破这些痛点，更适配开发者、工作室及小型企业的核心需求，具体优势对比如下： - 🔒 **隐私安全更有保障，杜绝数据泄露风险**：RootDesk 支持私有化部署，所有远控数据、设备信息均存储在你自己的服务器或内网中，全程 TLS 加密传输，无第三方平台介入，从根源上避免数据被窃取、滥用的可能；而 ToDesk 采用公网服务器中转数据，存在数据泄露隐患，且曾出现被诈骗分子利用进行远程诈骗的案例，隐私安全性不足。 - 💸 **全功能免费，无使用限制**：ToDesk 已逐步转向收费模式，免费用户被限制最多只能连接两台主机，文件传输、隐私屏等核心功能需开通专业版才能使用，长期使用成本较高；RootDesk 所有核心功能（远程桌面、文件管理、进程监控、双向语音等）完全免费，无设备连接数量、功能使用时长限制，无需支付任何费用即可享受全量服务。 - 🌐 **纯 Web 控制，无需安装多余客户端**：ToDesk 控制端需安装专属桌面或手机 APP，占用设备存储空间，且跨端切换需频繁登录；RootDesk 控制端基于 Web 开发，打开浏览器即可使用，支持手机、平板、电脑跨端无缝操作，无需安装任何多余软件，操作更便捷。 - 🐍 **轻量无捆绑，运行更高效**：ToDesk 客户端安装过程繁琐，部分版本存在捆绑插件，且运行时占用较多系统资源；RootDesk 客户端为绿色免安装的 \.exe 文件，基于 Python 核心编译，无任何捆绑插件，体积小巧，不占用过多系统资源，启动速度更快，适配老旧 Windows 设备。 - 🛠️ **功能更贴合开发者需求，实用性更强**：ToDesk 侧重基础远控，缺乏针对开发者的专业功能；RootDesk 内置远程终端（可直接执行 CMD/Shell 命令）、进程监控、系统详情查看等专业功能，同时支持开机自启、锁屏解锁、音频监听等深度操作，更适配开发者运维调试、远程管理设备的需求。 - ⚙️ **灵活可控，适配多样化场景**：ToDesk 配置固定，无法自定义服务器地址，仅支持公网连接，内网场景下使用受限；RootDesk 支持自定义服务器 IP/域名及端口，可灵活部署在内网、私有云等多种环境，同时支持客户端个性化配置，适配个人、工作室、小型企业等不同使用场景。 --- ## 🏗️ 技术架构 虽然目前暂未开源，但我们采用了行业前沿的技术栈，兼顾系统稳定性、高效性与安全性，确保远程控制体验流畅可靠： - 💻 控制端：Next\.js 15 \(App Router\) 构建，搭配 Node\.js 高性能服务端，页面渲染流畅，支持高并发访问； - 🔗 通信层：基于 Socket\.io 实现实时双向加密通信，数据传输全程加密，防止信息泄露与篡改； - 🖥️ 客户端：基于 Python 3\.8\+ 核心编译的 Win32 原生交互程序（\.exe），轻量高效，可深度集成 Windows 系统权限； - 🔒 安全保障：全程 TLS 加密传输，动态令牌校验，访问密码保护，私有化部署进一步隔绝外部风险，确保数据安全。 --- ## 📅 路线图 \(Roadmap\) - \[√\] **Windows 客户端**（已发布，支持全功能使用） - \[√\] **Web 控制端**（已发布，支持所有核心控制功能） - \[√\] **源代码开源**（开放核心代码，接受社区贡献与优化建议） - \[ \] **Android 被控端**（开发中 🚀，预计近期上线，支持安卓设备远程控制） - \[ \] **虚拟按键功能**（开发中 🚀，实现手机端虚拟按键操控，支持手机玩电脑游戏，适配各类游戏操作场景） - \[ \] **自动化运维监控**（开发中 🚀，实现屏幕异常检测，当远程设备屏幕出现异常时，自动通知宿主，提升运维效率） --- ## 💡 注意事项 - 部署时请确保服务器 3000 端口未被其他程序占用，若端口冲突，可修改端口映射配置； - 客户端运行需依赖 Python 3\.8\.10 环境（不兼容其他 Python 版本），若启动失败，请检查 Python 环境是否安装及版本是否准确达标； - 私有化部署时，建议定期备份`data` 目录下的文件，避免数据丢失； - 若出现 Web 控制端无法访问、客户端连接失败等问题，可先检查服务器防火墙端口开放情况，或通过 `docker logs rootdesk` 查看容器运行日志，排查错误原因。 \*\*如果这个项目对你有帮助，请点个 ⭐️ Star 关注我们的进度，你的支持是我们持续优化的动力！\*\*