# Host Control（backend）

**Repository Path**: assenimpact/host-control-backend

## Basic Information

- **Project Name**: Host Control（backend）
- **Description**: 基于Uni-app(Vue3)、Python开发的Windows设备控制中心，批量管理Windows设备。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-02-05
- **Last Updated**: 2025-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, FastAPI

## README

<center>
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/assenspace.webp" width="150"></img>
</center>

# <center>森空控制中心 🍃</center>

<center>

[![MIT](https://img.shields.io/badge/License-MIT-orange)](https://gitee.com/assenimpact/host-control-front-end/blob/master/LICENSE) ![Python](https://img.shields.io/badge/Python-3.11+-blue) ![Gitee](https://img.shields.io/badge/Gitee-仓库-orange?logo=gitee)

</center>

#### <center>服务端</center>

<center>

[操作端](https://gitee.com/assenimpact/host-control-front-end) | [下载](https://gitee.com/assenimpact/host-control-front-end/releases) | [官方文档](https://assenspace.top/archives/327)

</center>

<center>基于Uni-app(Vue3)、Python开发的Windows设备控制中心，批量管理Windows设备。</center>

## ✨ 核心功能

### 🚀 设备简单管理

- 手机 App 扫一扫添加设备即可管理
- 内置预设指令，轻松实现设备重启、关机、休眠、锁屏等功能
- 支持多设备同时操控，省事省心
- 内置文件传输，传输地址由你来定

### 🎮 自定义操作

- 支持自定义 cmd 命令以及 bat、vbs 脚本远程执行
- 无需担心权限，轻松获取管理员权限

### 🔐 设备安全防护

- 指纹、密码验证进入，更加安心
- 限制允许访问设备，防止坏人恶意操作

## 🚀 快速开始

**1.下载 App：**

- [点击下载 AssenControl.apk](https://gitee.com/assenimpact/host-control-front-end/releases) 操作端并安装。

**2.配置服务端：**

- [点击下载 服务端.zip](https://gitee.com/assenimpact/host-control-front-end/releases) 服务端程序压缩包；

- 请将该压缩包放置在**需要管理的 Windows 设备**上，并解压；

- 双击 exe 文件运行；

- 服务端程序首次运行会在【桌面】生成一张二维码和一份配置文件。

**3.连接设备**

- 请保证**需要管理的 Windows 设备**与**手机**处于同一局域网络下；

- 手机 App 扫一扫二维码即可连接设备；

- 设备连接成功后，即可进行远程操作。

## 📱 进阶使用

**1.自定义脚本**

- 设备连接后，首页点击对应在线设备进入详情页，向下滑动点击【自定义命令】，添加 cmd 命令以及 bat、vbs 脚本，添加后点击自定义命令即可执行。

<center>
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/page_1.webp" width="170"/>
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/page_2.webp" width="170"/>
<br />
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/page_3.webp" width="170"/>
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/page_4.webp" width="170"/>
</center>

**2.批量操作**

- 在首页点击![按钮](https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/icon_1.png)进入批量操作，选择需要操作的设备，点击【批量操作】打开批量操作侧边栏即可。

<center>
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/page_5.webp" width="170"/>
<img src="https://gitee.com/assenimpact/host-control-front-end/raw/master/static/img/md/page_6.webp" width="170"/>
</center>

## ⚠️ 使用注意事项

- 为了你的安全，请修改服务端程序目录 settings.txt 中【TOKEN_CIPHERTEXT】内容，避免他人通过相同的密钥控制你的设备；
- 本程序不建议在公网环境运行；
- 如需在公司等公共环境中运行，请在服务端程序目录 settings.txt 中修改【ALLOW_HOSTS】，替换为部署了 Web 服务或者安装了 App 设备的 IP 即可。

## 🛠️ 开发者指南（前端）

[点击这里](https://gitee.com/assenimpact/host-control-front-end)前往前端(操作端)仓库

#### 环境

    Python 3.11+

#### 运行

```bash
# 克隆当前项目
git clone https://gitee.com/assenimpact/host-control-backend.git
# 进入目录
cd host-control-backend
# 安装依赖
pip install -r requirements.txt
# 运行
python run.py
```

#### 打包

```bash
# 打包文件在dist目录下
pyinstaller -F -w run.py --hidden-import passlib.handlers.bcrypt
```

#### 兼容性

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

## ⚠️ 免责声明

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

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

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