shortrangetech/opendoorsim

# OpenDoorSim 项目  OpenDoorSim 是一个**开源的 PACS / RFID 实验室**，你可以**自己构建！** OpenDoorSim 像真实世界一样模拟物理门禁系统 (PACS) —— 让从家庭实验到大型 CTF 和演示的一切变得轻而易举。凭借**全新的 Web UI**、**设备上的硬件菜单**、即插即用的**防篡改检测**以及简便的**批量用户管理**，你可能会对它爱不释手…… 你可以自己购买零件在家构建，或者从 [shortrange.tech](https://shortrange.tech) 订购简易套件，作为支持该项目的一种额外方式。🐙❤️ 套件包含一个微控制器、构建所需的所有零件、一个优质且耐候的 3D 打印 ASA 外壳……当然，还有支持该项目所带来的美好感觉。在[这里](#about-the-kits)阅读更多关于套件的信息。 感谢您支持 **OpenDoorSim**，该项目基于 evildaemond、iceman、bettse、nechry 等许多 RF 大神的杰出工作 —— 没有他们，这个项目就不会存在。请查看[致谢](#Acknowledgments)部分！ ## 功能特性 - 为学生、爱好者和行业专业人士设计 - 便携、易用且易于接线 - 可完全使用现成零件构建 (Tarrif-ic 型) - 兼容任何 wiegand 读卡器！ - USB-C 供电 - 精美的 Web UI，轻松管理 CTF 和卡数据 - 硬件菜单（可离线运行！） - 多种模式适用于各种用例（Raw、CTF、Wifi、防篡改检测等） - 坚固的 3D 打印外壳！ - 兼容多种屏幕（LCD、OLED） - 防篡改检测（针对支持的读卡器） - 批量用户管理 - 旋钮。<3  ## OpenDoorSim 型号对比 | **型号** | **LAB** | **Pocket** | **Tarrif-ic** | | ------------------------- | ---------- | ---------- | ------------- | | 微控制器 | ESP-32 | ESP-32 | ESP-32 | | 固件 | 最新 | 最新 | 最新 | | 屏幕尺寸 | 2.42" OLED | 0.96" OLED | 任意 | | 定制 PCB | ✅ | ✅ | ❌ | | 外壳 | ✅ | ✅ | ❌ | | 兼容 Wiegand 读卡器 | ✅ | ✅ | ✅ | | 硬件菜单 | ✅ | ✅ | ✅ | | 启用 Wi-Fi | ✅ | ✅ | ✅ | | 定制 GPIO 接线端子 (4) | ✅ | ✅ | ✅ | | 固定读卡器安装 | ✅ | ❌ | ❌ | | 定制模块插槽 | ✅ | ❌ | ❌ | | MagSafe 兼容环 | ✅ | ❌ | ❌ | | 磁性贴砖 | ✅ | ❌ | ❌ | | 挂带环 | ✅ | ❌ | ❌ | | 钥匙圈和登山扣 | ❌ | ✅ | ❌ | ## 入门指南： ### 如何构建你的 OpenDoorSim： 构建 OpenDoorSim 就像 1-2-3 一样简单： 1. 收集你构建所需的材料 and 工具。 1. 材料和工具 BOM（物料清单）可以在  中找到。 2. 需要工具？这是我个人最爱的。 2. 按照你想构建的型号对应的 3 部分构建指南（构建、组装、刷写！）进行操作。 1. 构建指南： 1. LAB + Pocket 官方书面构建指南 2. Tarrif-ic 书面构建指南 3. 学习如何使用它！ 1. 🚧 Youtube 视频、操作指南文章等即将推出！ ## 关于套件 套件包含一个微控制器、构建你自己的 OpenDoorSim 所需的所有材料，以及一个坚固的 3D 打印 ASA 碳纤维外壳。因为每个人对读卡器的需求各不相同，这些套件是 **BYOR（自带读卡器）** 的。这意味着如果你想将 OpenDoorSim 与读卡器一起使用，你需要**购买或携带自己的读卡器**。如果你购买了套件，感谢你支持该项目！ 你可能可以自己找到所有材料并在线订购 PCB，其成本比购买套件更低。如果是这样，太棒了！能有更多人进入精彩的 RF 世界，那就更好了。这个项目的目标是让 DoorSim 尽可能多地落入人们手中，并且有很多支持该项目的方式。 ## 许可证和协议 该项目在 GPLv3 下授权。 #### GPLv3 许可证 本程序是自由软件：你可以自由使用、修改和分发它。如果你分发你的版本，你必须在相同的 GNU 通用公共许可证第 3 版 (GPLv3) 下进行，并包含源代码。该软件不提供保修，作者不对损害负责。 有关更多详细信息，请参阅 LICENSE.md。 ## 致谢 该项目很大程度上基于并深受 evildaemond 的 [DoorSim 项目](https://github.com/evildaemond/doorsim) 启发，没有它，这个项目可能不会存在，或者至少不会这么快成型。 感谢 nechry 提供的 evildaemond 原始 DoorSim 项目的 [PlatformIO 重构分支](https://github.com/nechry/DoorSim)。这是一个很好的工作基础，LittleFS 和 PlatformIO 真的在开发中帮了大忙。 特别感谢 Iceman 的 Discord 社区 [RFID Hacking By Iceman](https://discord.gg/F6wwKj6BHr) 中那些了不起的学生、黑客、专业人士和导师，以及 Iceman 的支持。你们激励了我。 感谢所有在 PACS / RFID / RF 领域做出开创性工作的其他开源创作者和导师！**让我们 Hack 这个星球！**

标签：DIY, ESP32, PACS, PCB设计, RFID, Web界面, Wiegand, 开源硬件, 微控制器, 攻击路径可视化, 智能卡, 物理访问控制, 物理门禁, 物联网, 硬件安全, 网络安全实验, 近场通信, 门禁系统, 黑客工具