Port-Guard

Port-Guard 是一款专为 Debian 设计的 USB 端口管理与安全防护工具。它可以控制 USB 设备的访问权限、维护一份自定义白名单，并在后台执行自动扫描以检测任何未授权的连接。

⚠️ 测试版：该软件可以正常使用，但仍可能存在意外行为。如发现任何错误或异常，请通过 Git 仓库的 issues 进行反馈。

许可证： GNU GPL v3 作者： k3rnix

🧩 功能特性

🔒 锁定/解锁 所有 USB 端口。
📜 白名单管理（添加、删除、清理）。
🛰️ 自动扫描守护进程（portguard.service）。
🖥️ 清晰且带引导的 CLI 界面。
🗂️ 详细日志记录，位于： /opt/port-guard/logs/daemon-scan.log。

🚧 路线图与项目清单

本节用作项目各组成部分的进度表。它会随 Git 版本更新。

🔹 主程序（Shell）

模块	状态	描述
USB 管理（锁定/解锁）	✔️ 已完成	核心功能可正常使用
白名单管理	✔️ 已完成	添加 / 删除 / 清空 / 解析 `usb-whitelist.conf`
自动扫描守护进程	✔️ 已完成	手动启用，包含日志
`.deb` 打包	✔️ 已完成	干净安装 + 卸载程序

🔹 图形界面（C++ / ImGui）

模块	状态

📦 安装

CLI 版本

拔掉所有外部 USB 设备（初始白名单中要包含的设备除外）。
安装 .deb 包：
```
sudo dpkg -i PortGuard_1.x.x.deb
```

默认配置

安装完成后：

白名单中不包含任何设备。
默认不启用自动扫描。需要启动应用程序并通过主菜单手动启用。

白名单管理

配置文件：/opt/port-guard/conf/usb-whitelist.conf
格式： [USB] SERIAL=123456789 MODEL=USB_DISK_x
你可以通过应用程序的主菜单添加、删除或清空设备。

卸载

如需彻底卸载 Port-Guard，只需运行以下选项：

sudo portguard -u
# ou
sudo portguard --uninstall

此过程将：

停止并禁用 portguard.service 服务。
删除 /opt/port-guard/ 中应用程序的所有文件。
删除 /usr/local/bin/portguard 二进制文件。
删除 /usr/share/ 中的 desktop 文件和图标。
删除 /usr/share/doc/port-guard/ 中的系统文档。
将白名单和日志备份到 /tmp/ 目录。
执行完成后，Port-Guard 将从系统中完全移除。