用Python接收邮件执行CMD命令让你的电脑关机，这个需求听起来挺小众，但我认真做完之后发现，它其实就是一套“远程控制电脑”的极简方案。有天我人都已经在地铁上，才想起来办公室那台电脑还开着，上面还挂着几个数据处理任务，跑完也不知道能不能自动关。当时就想着，要是能给电脑装一个“遥控器”就好了。于是第二天就写了一个小工具：电脑每隔一段时间自动登录邮箱，检查有没有来自我自己的新邮件，如果邮件主题里带有指定的“关机指令”，就调用系统命令把电脑关掉。
这套方案对技术的门槛并不高，只需要有 Python 基础、一个能开启 IMAP 的邮箱、以及一台能正常联网的电脑就能完成。它的核心不是“远程控制”的高大上框架，而是把邮件服务器当成一个消息通道，让电脑自己“读指令”。对很多想给家里或办公室电脑加一点自动化能力的朋友来说，这是最轻量、最好上手的思路之一。
1. 这个项目到底做了什么
1.1 项目形态与实际使用效果
整个项目其实就是一个常驻后台的 Python 脚本，核心功能是循环监听邮箱。脚本启动后会按固定时间间隔连接邮件服务器，查询收件箱里有没有未读邮件。如果发现未读邮件，就解析发件人和主题，看是不是“预先设定好的那个人”和“预先设定好的指令”。匹配成功，就执行关机命令；不匹配，就继续正常循环。
我第一次测成功的时候，还真有点成就感：手机发一封主题为“shutdown”的邮件出去，电脑在几十秒内自动关机。整个过程不需要登录任何远程控制软件，不需要配置路由器端口转发，更不需要在电脑上装一堆可能带广告的远程桌面工具。只需要系统自带的任务计划配合一个后台 Python 脚本，等于把邮箱变成了一个可以用手机控制的“开关”。
它能解决的实际问题其实不少：
- 出门后发现电脑忘关，用手机发邮件就能补救。
- 人在外面，需要让办公室电脑在某项任务结束后自动关机，可以提前发一封“定时邮件”。
- 不想用远程桌面软件，又需要远程触发一次系统重启或关机。
- 结合其他指令，还能顺带实现休眠、锁屏、打开指定程序等操作。
1.2 为什么选邮件当“遥控器”
我在设计时也考虑过其他方案。最直接的，用远程桌面软件；但很多远程控制软件需要电脑端保持登录、需要设置密码，还有可能遇到网络限制。第二种，自己写一个服务器程序监听端口；但大多数个人电脑没有公网 IP，需要内网穿透或租一台服务器，成本一下子高了起来。
邮件通道的好处在于，邮箱服务商本身就是一套稳定、成熟的消息系统。电脑能上网就能访问邮件服务器，手机发邮件又是几乎所有手机自带的功能。而且邮件天然支持身份认证，发件人是谁、发件时间都是服务商记录的，脚本只要在解析层做一层白名单校验，就可以最大程度避免无关邮件的干扰。最关键的一点是，这套实现基本靠 Python 标准库就能完成，不需要额外安装一堆第三方包，项目可复制性很强。
2. 核心原理拆解：邮件如何变成系统命令
2.1 收邮件为什么优先用 IMAP 而不是 POP3
很多人刚接触时会在 IMAP 和 POP3 之间纠结。简单说，IMAP 和 POP3 都是收邮件协议，但它们的工作方式差别很大。POP3 的核心思路是“下载”，把服务器上的邮件下载到本地，邮件状态由本地客户端管理；而 IMAP 是“同步”，邮件仍然保留在服务器上，客户端操作的是服务器上的邮件副本。
对这类“监控型脚本”来说，IMAP 要合适得多：
- IMAP 可以只搜索“未读”邮件，每次只处理新进来的内容，不需要重复下载全部邮件。
- IMAP 支持把邮件标记为“已读”后仍然保留在服务器上，不会把邮箱弄乱。
- IMAP 登录后可以按条件搜索，不要求把所有邮件都拉下来再本地过滤，流量更省。
- POP3 一旦收取，部分服务商默认会把邮件从服务器删除或标记为下载过，容易造成“脚本退出一次后，邮件就丢了”的尴尬情况。
所以除非你用的是不支持 IMAP 的老旧邮箱，否则直接选 IMAP。绝大多数邮箱服务商都在后台提供了 IMAP 服务开关，开启后会给一个服务器地址和端口，通常是 993（SSL）。脚本连接的就是这个服务器。
2.2 解析邮件时真正需要关心的字段
一封标准邮件看起来是一大段文本，但脚本并不需要关心邮件正文。我们真正需要的信息有两个：一个是发件人地址，用来确认“命令来自主人”；另一个是邮件主题（Subject），用来承载“指令内容”。
这里有个容易被忽略的坑：邮件的主题在传输过程中可能会被编码。如果直接读取原始字段，看到的可能是类似=?UTF-8?B?...?=的一串字符，必须用 Python 的email.header.decode_header解析一遍才能还原出可读文本。否则你设定主题是“shutdown”，结果邮件头里带了编码前缀，匹配永远失败。
解析完主题和发件人之后，剩下的逻辑就比较简单了：判断发件人是否在白名单里，再判断主题是否满足预设的命令规则。满足就在系统层面触发命令。
2.3 执行系统命令时，为什么用 os.system 就够了
在 Python 里执行系统命令有os.system和subprocess两个选择。对于本项目的“关机”场景，os.system足够简单：
os.system("shutdown /s /t 60")这行命令会告诉系统：在一分钟后关机。/s表示关机，/t 60表示延迟 60 秒。
如果使用subprocess.run，好处是更安全，可以避免 shell 注入、可以捕获输出，但在只执行一条固定命令时，os.system的代码更轻。我个人的经验是：如果只是封一个“关机”和“重启”，直接用os.system没问题；如果你把项目扩展成“执行任意命令”，请务必改用subprocess且严格过滤参数。因为一旦把邮件内容拼进命令里去执行，就很危险，这在下文会专门讲。
3. 动手实现：从邮箱授权到执行关机
3.1 前置准备：开通邮箱 IMAP 服务并获取授权码
这一步是很多人卡住的地方，也是完成项目最关键的准备工作。
登录邮箱网页端，进入设置，找到“IMAP/SMTP服务”之类的选项，把它开启。开启后，邮箱服务商会要求生成一个“授权码”。这个授权码是一个较长的字符串，作用是允许第三方客户端访问你的邮箱。需要注意，授权码通常和登录密码不同，有些服务商生成后只显示一次，一定要立刻复制保存。
为什么不能用邮箱密码？一方面，很多邮箱服务商为了安全，强制第三方登录必须用授权码；另一方面，授权码可以随时重置，万一泄露，你可以在网页端直接作废，而不是改邮箱密码。脚本配置里保存授权码，比保存真实密码要安全一些。
同时，把 IMAP 服务器地址记下来。如果服务商没特别说明，常见格式是imap.邮箱域名，端口是 993，连接方式为 SSL。后面写代码时直接填进去。
3.2 用 imaplib 连接邮箱并抓取未读邮件
Python 标准库imaplib是操作 IMAP 协议最直接的库。下面的示例代码是一个基础连接过程：
import imaplib IMAP_SERVER = "imap.example.com" IMAP_PORT = 993 USERNAME = "your@example.com" AUTH_CODE = "your-auth-code" def fetch_unseen(): mail = imaplib.IMAP4_SSL(IMAP_SERVER, IMAP_PORT) mail.login(USERNAME, AUTH_CODE) mail.select("INBOX") # 搜索未读邮件 status, data = mail.search(None, "UNSEEN") if status != "OK": return [] uids = data[0].split() messages = [] for uid in uids: status, msg_data = mail.fetch(uid, "(RFC822)") if status == "OK": messages.append((uid, msg_data[0][1])) return messages这段代码里有两个细节需要注意。
第一，mail.select("INBOX")是在选择邮箱文件夹。如果邮箱里有多个分类，通常默认收件箱就是 INBOX。
第二，mail.search(None, "UNSEEN")的意思是搜索所有未读邮件。返回的data[0]是一串用空格分隔的邮件编号，比如b'1 2 3 5'，需要 split 成列表再逐个 fetch。
还有一个看上去很矛盾的点：脚本连接的是“邮件服务器”，而不是某个本地邮箱软件。也就是说，这台电脑根本没装邮件客户端也没关系，只要网络能访问服务商的服务器端口，脚本就能正常收信。
3.3 解析发件人和标题并匹配规则
光把邮件原始数据取回来还不够，下一步是把 MIME 格式的内容解析成 Python 对象。这里用标准库email即可：
import email from email.header import decode_header def parse_message(raw_email): msg = email.message_from_bytes(raw_email) # 解析发件人 from_header = msg.get("From", "") # 解析主题，处理编码 subject_parts = decode_header(msg.get("Subject", "")) subject = "" for part, charset in subject_parts: if isinstance(part, bytes): subject += part.decode(charset or "utf-8", errors="ignore") else: subject += part return from_header, subject这里的decode_header是处理中文或特殊字符标题的关键。如果主题是 ASCII，比如 “shutdown”，结果基本就是原字符串；但如果是 “shutdown 现在关机” 这类，就很可能带编码标记，不解码会匹配不上。
拿到发件人和主题后，执行一个双重判断：
ALLOWED_SENDER = "me@example.com" COMMAND_KEYWORD = "shutdown" def should_shutdown(from_header, subject): if ALLOWED_SENDER not in from_header: return False if COMMAND_KEYWORD.lower() not in subject.lower(): return False return True这里用的是“发件人包含白名单地址 + 主题包含关键命令词”。为什么用“包含”而不是“完全相等”？因为邮件头里的发件人可能带显示名称，格式类似某人 <me@example.com>，直接用==很脆。主题同理，允许用户在主题里加备注，比如“shutdown 我走了”，反而更灵活。当然，如果你想要更严格，可以改成完全相等，这个按自己的需求调整。
3.4 执行 CMD 关机命令并防止“下载后丢邮件”
命令执行部分最简单，但要注意延时和取消机制：
import os def shutdown_computer(): os.system("shutdown /s /t 60")执行完关机命令之后，如果你不处理邮件状态，下一次循环还会搜索到同一封未读邮件，于是又执行一次关机。虽然此时系统已经在倒计时关机，但重复执行没有意义，还可能干扰取消操作。
因此，在处理完一封邮件之后，要把它标记为已读。最直接的方式是使用STORE命令：
def mark_as_seen(mail, uid): mail.store(uid, "+FLAGS", "\\Seen")这样，脚本下一次循环时，UNSEEN搜索就不会再返回这封邮件了。
3.5 加上循环和异常处理
脚本不能只跑一次，需要永久监听。最简单的循环框架如下：
import time POLL_INTERVAL = 30 # 每30秒检查一次 def main(): while True: try: messages = fetch_unseen() for uid, raw in messages: from_header, subject = parse_message(raw) if should_shutdown(from_header, subject): shutdown_computer() mark_as_seen(mail, uid) except Exception as e: print("监控出现异常:", e) time.sleep(POLL_INTERVAL) if __name__ == "__main__": main()关于轮询间隔，30 秒是我试下来比较合适的值。间隔太短会增加邮箱服务商的负载，也可能被限制登录频率；间隔太长，从发邮件到电脑执行命令的延迟会变大。如果想用手机“喊关机”，半分钟内能生效，体感已经挺不错了。如果你希望更快，可以改成 10 秒，但请确保邮箱服务商能接受频繁登录。
另外，这段代码不能一直裸奔。网络断线、IMAP 连接超时、邮件解析失败都可能发生。所以每一轮循环都要用try/except包住，并在异常后稍微等一下再继续，避免服务商把频繁失败当成攻击。还要注意：在fetch_unseen里建立的连接，最好在一个轮询结束后主动logout()或关闭连接，防止连接数堆积。
4. 部署运行与常见问题排查
4.1 本地运行和首次测试的顺序
代码写完后，不建议直接拿“真关机”来测试。先做一次安全演练：把shutdown_computer()临时改成print("收到关机指令")，然后自己给自己发一封带有关键词的邮件。确认脚本能收到、能解析、能打印日志，再把逻辑恢复成真正的关机命令。
即便恢复成真命令，第一轮测试也建议把延时加长，比如shutdown /s /t 300，给自己留足反悔时间。确认一切正常后再改成 60 或 30 秒。这个习惯看起来很保守，但能避免很多哭笑不得的“手滑”。
测试时还需要提前想好取消关机的方式。系统里执行了倒计时关机后，在命令行执行：
shutdown /a可以取消本次关机。如果你用了/t 300的延迟，取消窗口就有 5 分钟，足够处理各种意外。
4.2 让脚本开机自动运行
脚本本身是前台运行的程序，关掉终端就停了。要想达到“电脑开着就自动监控”的效果，需要把它设置成开机自启。
在系统上，最简单的方式是任务计划。打开系统自带的“任务计划程序”，新建任务，触发器选“登录时”或“启动时”，操作选择“启动程序”，程序填 Python 解释器路径，参数填脚本路径。为了避免每次开机弹出一个黑色命令行窗口，可以把解释器换成pythonw.exe，这样脚本会在后台静默运行，不占用任务栏。
如果你不想用任务计划，也可以直接把脚本的快捷方式放进系统启动文件夹。不过这种方式对“是否显示窗口”的控制没那么方便，而且用户关闭终端容易误关监控。我还是推荐任务计划的方式，更稳定，也方便看日志。
4.3 常见问题排查速查表
我在实际调试中遇到过不少问题，列成了一张表，方便你按图索骥。
| 现象 | 可能原因 | 排查方法 |
|---|---|---|
| 登录不上 IMAP 服务器 | 服务器地址填错 / 授权码过期 / 未开启 IMAP 服务 | 检查邮箱设置，重新生成授权码；确认端口是 993 |
| 能登录但搜不到未读邮件 | 邮件已被其他客户端标记为已读 | 在网页邮箱里把测试邮件标记为“未读”再试 |
| 能收到邮件但命令没执行 | 发件人白名单不匹配 / 主题解析编码异常 | 打印解析后的发件人和主题，先看日志 |
| 脚本运行一会儿就掉线 | 长时间占用连接被服务商断开 | 每次循环重连，不要一直维持同一个连接 |
| 日志显示连接超时 | 电脑无法访问 IMAP 端口 | 检查本机防火墙、代理设置和网络连通性 |
| 重复执行关机 | 邮件没有被标记为已读 | 确认store调用成功；考虑按 UID 缓存去重 |
表格中的“服务商”泛指邮箱服务商，不同邮箱的具体差异要以服务商说明为准。
4.4 日志留下运行证据
脚本在后台运行后，最好加一点简单的日志。标准库中的logging就能满足需求，输出到文件后，后续排查会轻松很多。我一般会记录这些信息：
- 每次成功连接和断开时间；
- 搜索到的未读邮件数量；
- 每封邮件的发件人、主题、是否匹配；
- 触发关机命令的时间和倒计时参数。
只要日志在，就算邮件被误删，也能回溯到底发生了什么。对于自动化脚本来说，可观测性比代码本身更重要。
5. 扩展玩法与安全加固建议
5.1 从一个命令扩展到一组命令
“只用来关机”有点浪费。你可以用同一套链路把“关机”扩展成“重启”“休眠”“锁屏”等多个指令。思路是在命令词上做映射，比如：
COMMAND_MAP = { "shutdown": "shutdown /s /t 60", "reboot": "shutdown /r /t 60", "sleep": "rundll32.exe powrprof.dll,SetSuspendState 0,1,0", }然后根据邮件主题里包含哪个关键词，执行对应的命令。这里要提醒一句：需求越灵活，风险也相应变大。如果你把“执行任意命令”做成邮件内容直接拼进os.system，很可能被有心人利用。比较好的折中是只维护一个有限的命令字典，不接受字典之外的命令。
5.2 给命令加一个“随机口令”
既然是邮件遥控，最大的风险是垃圾邮件或伪造发件人。虽然已经加了发件人白名单，但为了更保险，我还建议在命令词里加入一段随机口令。例如你设置一个只有你自己知道的口令k6#9pQ，邮件主题必须写成shutdown k6#9pQ才被识别。对于不知道口令的人来说，即使碰巧发件人地址一样，也很难触发命令。
如果你的邮箱服务商支持 SMTP 发信，脚本甚至可以做成双向通道：电脑发一封“确认收到”的邮件到你手机，这样远程控制就能形成回执。不过这个属于进阶需求，没有它，脚本也照样能跑。
5.3 关于授权码安全，我踩过的坑
最后聊一点和实现无关但非常重要的内容。我在最初做这个项目时，为了方便，把授权码直接写到了脚本里。后来整理文件时，差点把整个目录上传到公开代码仓库。如果当时传上去了，等于把邮箱后台管理权限白送给别人。从那以后，我习惯把这些敏感信息放到独立配置文件或环境变量里，脚本只负责读取。
比如在项目根目录建一个config.py：
IMAP_SERVER = "imap.example.com" EMAIL_ACCOUNT = "your@example.com" EMAIL_AUTH_CODE = "your-auth-code" ALLOWED_SENDER = "me@example.com"这个配置文件默认不应该提交到任何公开仓库。你也可以使用系统环境变量，避免在代码里出现任何明文密码类信息。授权码泄露了，第一时间去邮箱设置里重置，不需要改邮箱密码。
5.4 我的实际使用体会
这套小项目我前前后后用了一段时间，最大的感受是“够用就好”。它不能像专业远程控制软件那样给你一个桌面界面，但如果你只需要“让电脑在我需要的时候关个机”，它足够轻、足够安静，也没有多余依赖。我还顺手在脚本里加了“如果检测到电池电量低于某个值就自动关机”的逻辑，不过那是另一个故事了。
如果你也想做，建议从最简单的版本开始，先把“收到特定邮件、打印日志、不执行任何命令”的流程跑通，再一步步加入真命令和开机自启。整个过程花不了多少时间，但能帮你把“远程控制”这件事彻底想明白。
