M-Abozaid/esp32-c3-adblock
Pi-hole-class DNS ad-blocker on a $2 ESP32-C3 (no PSRAM): 537k domains as 40-bit FNV-1a hashes in flash, binary-searched. UDP DNS sinkhole + web dashboard. https://youtube.com/shorts/RaxszOUMi8E?feature=share
C++ · ★ 1,595 · Fork 137 · 在 GitHub 查看
在手机上浏览源码、订阅每日 AI 趋势日报与项目架构深度解读:获取 CopoHub 客户端(iOS & HarmonyOS)→
GitHub Trending 上榜记录
M-Abozaid/esp32-c3-adblock 已在 GitHub Trending 每日榜单上榜 2 天,最高排名第 13,首次上榜 2026-10-05,最近一次上榜 2026-10-06。
| 日期 | 排名 | Star | 当日增长 |
|---|---|---|---|
| 2026-10-06 | #13 | 1,595 | +196 |
| 2026-10-05 | #13 | 1,305 | +196 |
同期上榜的项目
- tester-army/e2e – Next generation e2e testing framework for web and mobile apps.
- mattpocock/skills – Skills for Real Engineers. Straight from my .agents directory.
- earthtojake/text-to-cad – Design physical products with AI
- boykopovar/AnyPS5 – Tool for automatic PS5 executables porting to Linux and Windows
- pbakaus/impeccable – The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
- thedotmack/claude-mem – Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
M-Abozaid/esp32-c3-adblock 项目深度剖析与商业评估报告
M-Abozaid/esp32-c3-adblock 项目深度剖析与商业评估报告
1. 核心定位与商业落地价值
本项目解决的根本痛点是 DNS 广告拦截的"硬件下沉":传统 Pi-hole/AdGuard Home 需要一台常开的 Linux 主机(树莓派、NAS 或容器),带来功耗、维护与部署成本。该项目将 537k 域名的拦截能力压缩进一颗 $2 的 ESP32-C3(无 PSRAM、4MB Flash),以约 50KB RAM 常驻、单次查询约 10ms 的代价完成 sinkhole,本质上把"DNS 过滤器"从"服务"降维成"固件+USB 供电的哑设备"。
其商业护城河并非功能,而是 资源约束下的算法取舍:将域名转为排序后的 40-bit FNV-1a 哈希存于 Flash、二分查找命中。这一取舍让 141k 域名仅占 0.67MB Flash、零碰撞,537k 时仅 1 次碰撞(即一个域名被误拦)。相较 s60sc/ESP32AdBlocker 等"字符串入 RAM"路线,本项目在无 PSRAM 芯片上具备不可替代性。
企业级落地场景: IoT/OT 网络的 DNS 合规层:在工厂、门店、酒店等无法部署服务器的边缘网段,以 USB dongle 形态插入路由器 USB 口,实现 DNS 级策略(广告、恶意域名、成人内容),零运维。 家庭网关增值固件:路由器厂商可将此作为差异化功能预置。 安全演练/红蓝对抗:作为轻量 DNS sinkhole 用于恶意域名阻断验证。 教育/K12 场景:低成本批量部署内容过滤。
差异化在于:"无 PSRAM"是硬约束下的工程胜利,而非简单移植。作者明确指出该哈希方案在 ESP32-S3(16MB Flash)上可容纳 ~2.7M 域名,远超 8MB PSRAM 存字符串的 ~466k——即"哈希入 Flash 普遍优于字符串入 PSRAM",这构成方法论层面的护城河。
2. 核心架构设计与技术深度
模块拆解: 1. DNS 解析层:UDP :53 监听,解析查询报文,提取 QNAME,展开父级后缀(a.b.example.com 逐级剥离)。 2. 哈希匹配层:对每个候选域名计算 40-bit FNV-1a,在 Flash 中的已排序哈希表做二分查找(约 18 次 Flash 读取)。 3. 应答/转发层:命中则构造 0.0.0.0(ANCOUNT=1,NSCOUNT=ARCOUNT=0,规避 EDNS OPT 导致的畸形响应);未命中则向上游解析器转发并中继应答。 4. Web 控制面:mDNS 发现 + HTTP 仪表盘,含 per-client 计数、ban、自定义域名、OTA。 5. 配置/持久化层:secrets.h 注入凭据,partitions.csv 决定分区布局。
在 README 中展示上榜徽章
[](https://github.fq6825.top/repo/M-Abozaid/esp32-c3-adblock)