FastAPI+PyAutoGUI实现手机远程控制电脑-育师

1. 项目背景与核心价值

躺在床上用手机控制电脑这个需求，相信很多数码爱好者都深有体会。想象一下冬天的夜晚，你已经窝在被窝里准备入睡，突然发现电脑还在播放音乐，或者下载任务还没结束需要关机。这时候如果有个手机就能控制的本地服务，简直不要太方便。

这个项目就是用Python的FastAPI框架搭建一个本地HTTP服务，通过手机浏览器访问特定页面，实现对电脑的基础控制。核心功能包括：

关机/重启/睡眠等电源管理
媒体播放控制（播放/暂停/切歌等）
简单的鼠标键盘模拟操作

相比市面上各种远程控制软件，这个方案有几个独特优势：

完全本地运行，无需注册账号，没有隐私泄露风险
轻量级实现，服务端代码不到200行
跨平台支持，只要电脑和手机在同一局域网即可
可高度自定义，想加什么功能就加什么

2. 技术栈选型解析

2.1 为什么选择FastAPI

FastAPI是构建这个项目的绝佳选择，主要因为：

开发效率高：声明式接口定义，自动生成文档
性能出色：基于Starlette和Pydantic，速度媲美NodeJS和Go
类型安全：Python类型提示的全面支持
异步支持：轻松处理并发请求

对比Flask和Django：

Flask虽然轻量但缺少异步支持
Django过于重量级，不适合这种小型服务
FastAPI的自动交互文档对调试特别友好

2.2 PyAutoGUI的妙用

PyAutoGUI是实现电脑控制的核心库，它提供：

跨平台的GUI自动化控制
鼠标移动/点击/拖拽
键盘输入模拟
屏幕截图和图像识别

特别适合我们的场景：

import pyautogui # 模拟媒体键 pyautogui.press('playpause') # 播放/暂停 pyautogui.press('nexttrack') # 下一首 pyautogui.press('volumedown') # 音量减小 # 鼠标控制 pyautogui.moveTo(100, 100) # 移动鼠标 pyautogui.click() # 点击

注意：使用PyAutoGUI时建议设置安全措施：
pyautogui.FAILSAFE = True # 启用故障安全保护
这样当鼠标移动到屏幕左上角时会自动终止程序，防止失控。

3. 服务端完整实现

3.1 基础环境准备

首先确保安装所需库：

pip install fastapi uvicorn pyautogui

项目目录结构建议：

/remote-control ├── main.py # 主程序 ├── static/ # 静态文件 │ ├── index.html │ └── style.css └── requirements.txt

3.2 核心API实现

main.py的基础框架：

from fastapi import FastAPI, Request from fastapi.staticfiles import StaticFiles from fastapi.templating import Jinja2Templates import pyautogui import os import uvicorn app = FastAPI() # 挂载静态文件 app.mount("/static", StaticFiles(directory="static"), name="static") @app.get("/shutdown") async def shutdown(): os.system("shutdown /s /t 1") # Windows # os.system("shutdown now") # Linux/Mac return {"status": "shutting down"} @app.get("/playpause") async def playpause(): pyautogui.press('playpause') return {"status": "ok"} # 其他控制接口... if __name__ == "__main__": uvicorn.run(app, host="0.0.0.0", port=8000)

3.3 前端控制页面

static/index.html简单实现：

<!DOCTYPE html> <html> <head> <title>电脑遥控器</title> <style> .btn { padding: 15px 25px; margin: 10px; font-size: 18px; } </style> </head> <body> <h1>电脑遥控器</h1> <button class="btn" onclick="control('shutdown')">关机</button> <button class="btn" onclick="control('restart')">重启</button> <button class="btn" onclick="control('playpause')">播放/暂停</button> <button class="btn" onclick="control('nexttrack')">下一首</button> <script> function control(cmd) { fetch(`/${cmd}`) .then(res => console.log(res)) .catch(err => console.error(err)); } </script> </body> </html>

4. 高级功能扩展

4.1 安全增强措施

裸奔的HTTP服务存在风险，建议添加：

基础认证：

from fastapi import Depends, HTTPException from fastapi.security import HTTPBasic, HTTPBasicCredentials security = HTTPBasic() @app.get("/secure-action") async def secure_action(credentials: HTTPBasicCredentials = Depends(security)): correct_username = "admin" correct_password = "secret" if not (credentials.username == correct_username and credentials.password == correct_password): raise HTTPException(status_code=401) # 执行安全操作...

CORS限制：

from fastapi.middleware.cors import CORSMiddleware app.add_middleware( CORSMiddleware, allow_origins=["http://localhost:8080"], # 只允许特定前端 allow_credentials=True, allow_methods=["*"], allow_headers=["*"], )

4.2 更多实用功能

可以继续扩展的功能：

文件传输：手机和电脑互传小文件
剪贴板同步：手机复制，电脑粘贴
屏幕截图：查看电脑当前画面
命令行执行：运行简单命令

例如实现截图功能：

from fastapi.responses import FileResponse @app.get("/screenshot") async def screenshot(): pyautogui.screenshot("screenshot.png") return FileResponse("screenshot.png")

5. 部署与使用技巧

5.1 启动与访问

启动服务：

python main.py

手机访问：

确保手机和电脑在同一局域网
在电脑上查看本机IP（ipconfig/ifconfig）
手机浏览器访问：http://电脑IP:8000

5.2 开机自启动

Windows创建计划任务：

Win+R输入taskschd.msc
创建基本任务
触发器选择"当用户登录时"
操作选择"启动程序"，指向Python脚本

Linux使用systemd服务：

# /etc/systemd/system/remote-control.service [Unit] Description=Remote Control Service [Service] ExecStart=/usr/bin/python3 /path/to/main.py Restart=always User=yourusername [Install] WantedBy=multi-user.target

5.3 常见问题解决

问题1：PyAutoGUI在无显示器环境下报错

解决方案：安装虚拟显示驱动

# Linux sudo apt install xvfb Xvfb :1 -screen 0 1024x768x24 & export DISPLAY=:1

问题2：手机无法访问服务

检查电脑防火墙设置
确认IP地址正确
尝试ping测试连通性

问题3：媒体键不生效

确保音乐播放器是活动窗口
尝试先模拟点击播放器窗口：

pyautogui.click(100, 100) # 播放器窗口坐标 pyautogui.press('playpause')

6. 项目优化方向

这个基础版本还可以进一步优化：

响应式前端：使用Vue/React构建更美观的控制面板
WebSocket支持：实现实时状态同步
语音控制：集成语音识别功能
插件系统：支持动态加载功能模块
移动端APP：打包成原生应用更方便使用

一个进阶的FastAPI配置示例：

from contextlib import asynccontextmanager from fastapi import FastAPI @asynccontextmanager async def lifespan(app: FastAPI): # 启动时初始化 print("Service starting...") yield # 关闭时清理 print("Service shutting down...") app = FastAPI(lifespan=lifespan)

这个项目虽然简单，但涵盖了Python web开发的多个实用技术点。我在实际使用中发现，最适合的场景就是睡前控制电脑和简单的媒体控制。对于更复杂的需求，可以考虑集成Home Assistant等智能家居系统。