前言

关于我为什么要写这个项目（作者的一点小废话，想看使用说明可跳过😎）

我经常会通过smb去共享我电脑中的文件，然后躺在床上用手机或者平板看下在电脑里的视频，看完视频总得下床关电脑(毕竟开一晚上电费也不少😭），到了冬天简直是一种折磨！！

于是就写了这样一个项目，能够在局域网中，通过安卓手机等设备远程对Windows电脑执行cmd命令以及bat、vbs脚本，从而实现Windows电脑远程关机、重启、息屏、锁定等功能，自定义cmd命令以及bat、vbs脚本也能让你在远程对Windows电脑执行更多操作。😁

当然，本项目也支持多台Windows设备管理，支持批量操作，适合家庭、公司等需要批量操作多设备的场景。

一、📦项目组成

本项目分为总体分为两部分：

操作端(前端) ：运行在安卓设备上，用于远程发送指令的部分。点击前往仓库

服务端(后端) ：运行在Windows设备上，用于接收并执行操作端发送的指令。点击前往仓库

二、🎮快速使用

1、下载 App

• 点击下载 AssenControl.apk 操作端并安装。

2、配置服务端

• 点击下载 服务端.zip 服务端程序压缩包；

• 请将该压缩包放置在需要管理的 Windows 设备上，放置任意目录并解压；

• 打开settings.txt，修改【TOKEN_CIPHERTEXT】为你个人的密钥并保存关闭，此密钥将作为你操作此设备的凭证，不修改可能会让同局域网中的其他人凭借默认密钥也能有权限操作你的Windows设备；
  • 更多安全防护请看安全保护
• 双击【run.exe】即可运行服务端，如果需要每次开机自启的话可以点击【快速设置开机启动.vbs】
  • 首次启动时，系统会弹出【是否要允许公共网络和专用网络访问此应用】，点击允许（如果点击取消会导致服务端被防火墙拦截，无法与操作端连接）

• 服务端程序首次运行会在【系统桌面】生成一张二维码(PNG格式)和一份配置文件(TXT格式)。

3、连接设备

• 请保证需要管理的 Windows 设备与手机处于同一局域网络下；
• 手机操作端点击右上角 扫一扫二维码即可连接设备；
  • 你也可以复制配置文件中的内容，点击左上角设置 ，在侧边栏中点击配置导入，粘贴文本进行导入配置进行连接；
  • 你也可以在【操作端】首页点击【添加设备】手动填写配置信息，配置信息在配置文件中。

4、基本使用

• 首页点击配置成功的设备进入详情页；

• 在详情页就能实现基本的重启、关机、锁定、息屏基本功能。

三、📱进阶使用

1、自定义指令

• 可以配置自定义指令来实现更多对Windows设备的更多操作，设备详情页下滑，点击【自定义命令】 填写类型、指令名称、cmd命令/脚本。(执行的命令或脚本如果需要管理员权限，请选择【开启管理员权限】)；
  • 如果你对cmd命令以及bat、vbs脚本不了解，你可以让AI帮你生成代码，实现你需要的功能，比如你想让D盘下名为personal的目录共享，你可以跟Deepseek或者Chatgpt说：我想用cmd命令或者bat、vbs脚本写一段代码，能够实现让D盘下名为personal的目录共享，限制最多5人访问，并告诉我是否需要管理员权限运行

2、批量操作

• 在首页点击右上角 进入批量处理模式，点击选择你需要管理的设备，点击批量操作，弹出批量操作侧边栏，这里与设备详情页交互一致，也可以自定义命令或脚本。

3、文件传输

• 可以在设备详情页进入文件传输，实现操作端设备向服务端设备传输文件。
  • 传输目录如果为空，会默认传输至Windows【⬇️下载】目录中。

四、📲数据共享

⚠️【注意】本项目数据皆为本地存储，不会将你的数据传至任何云端服务器

1、导入 | 导出 多个设备信息

• 如果操作端存在多台设备，想要快速、批量导入设备信息，可以在某一台已经存在设备信息的操作端首页点击左上角 进入设置侧边栏，点击【配置导出】复制数据
  • 也可以在首页点击右上角 进入批量处理模式，点击【批量导出】
• 在需要导入配置设备信息的操作端首页点击左上角进入设置侧边栏，点击【配置导入】粘贴数据

2 、导入 | 导出 单个设备信息

• 点击进入设备详情页，点击二维码分享当前设备信息
• 在需要导入设备配置信息的操作端首页点击右上角 扫一扫导入数据

3、导入 | 导出 自定义命令

• 进入设备详情页，下滑至自定义指令区域，点击【导出模式】，选择需要导出的自定义指令，点击【导出】复制数据；
• 在需要导入自定义指令的设备详情页，在命令模式下点击【导入】粘贴数据。

4、批量操作导入自定义指令

• 参考步骤3导出自定义指令，在首页点击右上角 进入批量处理模式，点击【批量操作】，在批量操作侧边栏点击【导入】粘贴数据。

五、🔐安全保护

1、操作端安全保护

• 为保护操作端不被他人误操作，建议在操作端设置密码，并开启密码验证或指纹验证，首页点击左上角 进入设置侧边栏，点击【安全配置】进行设置；

2、服务端安全防护

修改【TOKEN_CIPHERTEXT】

• 首次启动服务端前，请先修改 settings.txt 中的【TOKEN_CIPHERTEXT】为你个人的密钥并保存关闭，此密钥将作为你操作此设备的凭证，不修改可能会让同局域网中的其他人凭借默认密钥有权限操作你的Windows设备；

修改【ALLOW_HOSTS】

• 密钥是为了不让服务端接口完全透明的暴露在局域网中，避免被局域网中的其他人利用，如果你只是在家庭局域网中使用，修改【TOKEN_CIPHERTEXT】的操作已经完全足够，但如果是在公司等公共局域网中请务必修改【ALLOW_HOSTS】，它能完全拦截同局域网内坏人的恶意请求；
• 在settings.txt中的【ALLOW_HOSTS】填写你操作端设备的IP，在手机WIFI设置中，进入WIFI信息详情中，你可以看到此设备在当前局域网中的内网IP(IPv4)地址。

⚠️【注意】本项目不建议在公网中使用

六、🏄高级操作

1、开发者模式

• 在settings.txt中修改【DEVELOPER_MODE】值为1进入开发者模式，开发者模式下在浏览器输入【服务端设备IP】 + “:” + 【settings.txt中【PORT】服务运行端口号】+【”/docs”】进入Swagger文档，【”/redoc”】进入ReDoc文档，你可以根据你的需求使用接口进行二次开发。

⚠️【注意】开发者模式将不再验证密钥，如需要保证安全请修改【ALLOW_HOSTS】

2、操作端H5版本

• 如果需要安装操作端的设备数量过多，或者想在PC端设备上使用，可以将操作端H5打包版本部署在你的家庭NAS、软路由等设备上，点击下载 static.zip，把解压文件部署在你的设备上。
  • 不知道怎么在nas上部署的可以看这篇 《【飞牛】nginx零基础快速部署静态网页(新手向)》

• 当然你也可以直接将解压得到的static目录放置在服务端run.exe同目录下，运行run.exe后可以在浏览器输入【服务端设备IP】 + “:” + 【settings.txt中【PORT】服务运行端口号】即可进入H5版操作端。
  • 【注】此版本需要在settings.txt中修改【DEVELOPER_MODE】值为1进入开发者模式

七、🗑️关闭与卸载服务端

1、关闭

• Windows底部导航栏点击右键，点击【任务管理器】，搜索栏输入【run.exe】，在进程中找到运行中的【run.exe】，选中并点击结束任务即可。

2、卸载

• 需要完整卸载服务端，请进入服务端目录，双击运行【卸载文件.vbs】，弹出弹窗卸载即成功。

八、💥意外情况

【运行异常，请检查端口是否被占用】

• 如果运行服务端时出现如上提示，请先进入settings.txt中修改【PORT】端口号并保存，再次运行时如果仍然提示，请进入【logs】目录中选择当日日志文件，将错误日志提交至Issues，点击此处进入Issues。

【配置文件数据错误，请按照settings.txt内注释修改配置】

• 如果运行服务端时出现如上提示，说明你的settings.txt文件中配置信息存在错误或缺失，请从新获取服务端或者在gitee仓库下载settings.txt文件并替换。

【无配置文件，为了设备安全，请前往项目目录下settings.txt进行配置】

• 如果运行服务端时出现如上提示，说明你的服务端项目中settings.txt文件缺失，请参考上条修复。

【其他异常】

• 如果你部署且运行服务端的Windows设备出现且不限于底部导航栏右键无法进入对应系统功能设置，请在操作端配置一个无效的自定义cmd命令，如数字1，勾选开启管理员权限并运行。

九、🔩兼容性

• 操作端目前仅做了 H5、安卓 App 端适配，其他平台暂未适配。

• 服务端目前仅适用 Windows 系统，并在 Windows 11 中通过测试。

⚠️免责声明

• 本程序按“原样”提供，不附带任何明示或暗示的担保。作者不对因使用或无法使用本程序所引发的任何直接、间接、特殊、附带或后果性损害承担责任。用户应自行承担使用本程序的风险。

• 作者不对任何第三方以恶意方式使用本程序的行为负责。任何因滥用、非法使用或未经授权使用本程序而导致的后果，均与作者无关。用户应确保遵守所在地区的法律法规，并仅将本程序用于合法用途。

⚠️ 本程序仅供学习参考，请勿用于非法用途。