插个 U 盘就锁屏:我用 C# 写了个不联网的 USB 哨兵,源码全公开

该博客介绍了一个基于C#开发的轻量级Windows安全工具——USB哨兵,用于在检测到陌生USB设备插入时自动弹窗报警、锁屏并写入日志,同时支持系统级驱动拦截策略。工具严格遵循不联网、零数据收集、无第三方依赖原则,采用.NET Framework原生API实现。核心设计强调安全降级:宁可漏报也不误锁键鼠,并提供白名单迁移、策略守护、救援脚本等工程化保障机制。

前阵子我在整理旧电脑,插了个来历不明的 U 盘,突然意识到一个问题:电脑插上什么 USB 设备,我是不知道的。

键盘、U 盘、充电线——Windows 默认插上就装驱动。BadUSB 伪装成键盘插入,几秒钟就能把命令敲进你的电脑,而你看到的是「发现新硬件」。

杀毒软件管文件,不管「这个设备该不该插进来」。所以我自己写了个小工具补这一层,叫 USB 哨兵。写完发现,真正难的不是功能,是「怎么让它不误伤自己」——这部分比功能本身值得写。

它做什么

一句话:陌生 USB 设备插入 → 弹窗分类报警 + 锁屏 + 写日志,配合系统策略还能拦住陌生 USB 装驱动。

能力具体行为
分类报警区分 U盘 / 键鼠(HID) / 其他,文案不同:U盘提示「请勿打开文件」,HID 提示「警惕 BadUSB 输入注入」
立即/持续锁屏陌生设备在位就反复锁,拔出自动停
白名单按设备实例 ID 精确匹配;同一台物理设备的多个接口自动归成一个条目
多杀软扫描U 盘插入调用卡巴斯基或 Defender;都没装会明确提示,不静默跳过
系统级锁定注册表策略拦陌生 USB 装驱动: DenyUnspecified=1 是全局"未描述设备禁装",已装设备与信任设备逐一写进放行表;已有网卡、虚拟网卡、键鼠不受影响,但新装的非 USB 设备(如新蓝牙 HID、新网卡)也可能被拦,需先加信任
看护与守护主进程挂了 5 分钟内拉起;策略被改 10 分钟内校正回来

三条硬约束:不联网、不收集任何数据、零第三方依赖。全部用 .NET Framework 自带程序集。Release 提供未签名 exe + 完整源码,可下载即用,也可自行编译核对;源码公开可审。

一个设计决定:宁可漏报,不可误锁

这是整个项目里我花时间最多的地方。

一个会锁屏、会拦驱动的工具,最坏的情况不是「没拦住坏人」,而是把用户自己的键盘鼠标锁了——这时候你连点「信任此设备」都做不到,电脑暂时没法操作,只能靠远程桌面、另一个管理员会话或 WinRE 离线改注册表恢复——新插的 USB 键盘会被策略拦住,指望它救场是不行的。

所以我把安全降级写进了核心逻辑:

  • 白名单文件损坏 / 解析失败 → 不锁屏,只弹修复提示,保留现场文件。宁可这次漏报,也不误锁键鼠。
  • 配置文件缺失 → 用安全默认值,重建配置,防护不中断。
  • 安装脚本 → 在系统级策略生效的 Windows 上(Win10 2004+ 且 Pro/Enterprise/Education/LTSC),把本机当前所有已装设备(含网卡、声卡、虚拟网卡)一并纳入放行表。早期版本漏了这步,直接把虚拟网卡挡掉导致断网——这是踩过的坑,不是假设。Home 版或更早的 build 会跳过整套系统级策略,只保留报警锁屏,不写放行表。
  • 救援脚本族 → 误锁之后有 recover-keyboard.bat、recover-input.bat、修复-放行此鼠标.bat,按现象选一个,一键放行恢复输入。
  • 暂停/维修模式都有时限 → 30 分钟、2 小时自动恢复,不存在「永久静默」把防护悄悄关掉。

这套逻辑总结成一句话:一个防护工具,必须先保证自己不会成为故障源。

工程化比功能更麻烦

功能写完后,真正消耗时间的是这些:

白名单格式迁移。 旧版是设备实例 ID 字符串数组,新版要加描述、分类、信任时间。迁移必须幂等(断电重来不出错)、不能丢任何实例 ID、迁移前先备份。复合设备(比如带触摸板的键盘)有多个接口实例 ID,必须归到同一个条目,否则用户点一次「信任」,下次另一个接口插入还是报警。

注册表策略与进程互斥。 程序目录设成 Users 只读、只有日志可写,关键文件存 SHA256 指纹;策略守护以 SYSTEM 每 10 分钟校正。这里的坑是安装顺序:早期版本先写系统策略、再注册计划任务,结果安全软件拦下任务时,策略已经生效但看护和托盘程序没起来——设备被挡在外面,连报警都没有。现在改成先注册任务、确认看护和实时进程两个关键任务都在,最后才写策略;关键任务失败就回滚(撤销已建任务、不写策略),绝不留下"策略生效但没主程序"的半装状态。

状态提示任务。 原本每 5 分钟闪一个 PowerShell 窗口,体验极差;改成 wscript 隐藏启动。Toast 失败时的备用弹窗原本永久驻留,改成 30 秒自动关。后来又修了一个误报:策略守护重建白名单的瞬间被状态提示撞上,误判「白名单为空」弹了防护异常——改成「先增后删」消除了空窗。

这些都不性感,但不是它们,工具根本没法日常用。

代码结构

单文件堆到 700 行以后没法维护了。v10 已重构成 23 个 .cs 模块,按职责拆分:

入口与界面   UsbGuard.cs / MainForm.cs / DeviceManagerForm.cs / SetupTrustForm.cs / AlertPresenter.cs
设备与扫描   DeviceInventory.cs / ScanCoordinator.cs / ShellTrayController.cs
状态与协同   GuardRuntime.cs / GuardStateCoordinator.cs / GuardStateStore.cs / SingleInstanceActivator.cs
存储与配置   WhitelistStore.cs / ConfigStore.cs / AtomicJsonStore.cs / DiagnosticsStore.cs / GuardModels.cs
防护与控制   ProtectionControlService.cs / MaintenanceService.cs / OperationFeedback.cs
构建与自检   BuildInfo.cs / SelfTests.cs / AssemblyInfo.cs

编译不需要 Visual Studio。双击 程序文件\源码\编译.bat 即可——它按 sources.list.txt 的明确源文件清单编译(不用 *.cs 通配符,避免混入临时文件),并做版本、哈希、源集合一致性核验,产出与 Release 一致的 UsbGuard.next.exe。想直接用现成 exe 的话,Release 包里就有,跳过编译这步。

两条文档

我把需求和技术设计也一起放出来了,不是凑数:

  • 需求规格:8 个能力模块,每条都是 EARS 格式验收条件(当...时 → 系统应当...),含异常场景和 DFX 约束。
  • 技术设计:15 个组件的拆分方案、白名单迁移状态机、UAC 提权边界、误锁救援路径。

技术设计是目标架构,当前代码是部分落地——有些组件按职责合并在现有文件里。这个功能边界我写在 README 里了,不藏着。

想用它的话

源码仓库在 https://github.com/tai-wei00/usb-guard ,README、使用说明、技术设计、需求规格都全。打包下载(v10,含预编译 exe + 完整源码 + LICENSE/README/CHANGELOG):https://github.com/tai-wei00/usb-guard/releases/download/v2-rev6/usb-guard-v10.zip

这个 v10 是 v2.1.0 重构版:源码独立编译、12 项自检(含交付一致性核验)、隐私零残留全部通过。它的前一版曾在 Windows 10 专业版虚拟机里完整跑过「安装 → 策略采集 → 卸载」——4 个计划任务正常注册(含 SYSTEM 权限的策略守护)、系统允许列表策略生效、事件日志有记录、卸载后数据保留;过程中修掉了两个只有在真机上才暴露的问题——空信任名单时的写回崩溃、白名单文件被占用时的替换崩溃。系统级策略要求 Win10 2004+ 且 Pro/Enterprise/Education/LTSC,家庭版只保证报警锁屏。

但先说清楚三件事:

  1. 它会真的改系统策略,创建 4 个计划任务(其中策略守护是 SYSTEM 权限),不是演示程序。只适合个人单机、Win10 2004+ 且专业版及以上;家庭版只保证报警锁屏。
  2. 只适合个人单机、你自己能物理接触的电脑。别装在公用机、办公机上。
  3. 装之前先看「误锁了键鼠怎么办」。键鼠全锁住时你没法双击救援脚本,最后手段是远程桌面、另一个管理员会话或 WinRE 离线改注册表。

Release 包里已经带了预编译的 UsbGuard.exe,解压后双击 1-装好就能用.bat 就能装,不用自己编。SHA-256 记在 build-manifest.json,可用 Get-FileHash 核对。提醒:exe 未签名,SmartScreen 和部分杀软(尤其卡巴斯基)可能误报——核对哈希后按需放行即可,或者干脆走源码自己编一份。仓库只放源码,想编译就双击 程序文件\源码\编译.bat。

关于许可

本文遵循 CSDN 的 CC BY-SA 4.0 协议,仅指文章文字;文中涉及的源码以仓库 LICENSE.txt 为准(source-available:允许个人学习自用与 GitHub fork,禁止商用、禁止在 GitHub 以外平台公开再分发;作者官方指定的镜像除外——当前为 gitcode.com/tai__wei/usb-guard,用于国内访问,与 GitHub 仓库同步)。两者适用范围不同,源码许可不因本文协议而改变。

最后

这个小工具最初只是为了「知道自己插了什么」,写到后面变成了一次完整的工程化练习:威胁模型、安全降级、格式迁移、提权边界、救援路径、文档同步。

如果你也在做单机小工具,希望这些踩坑记录能省你一点时间。有问题评论区说,我看到会回。

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址