CopoHub Trending

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#131,595+196
2026-10-05#131,305+196

同期上榜的项目

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 决定分区布局。

查看完整 AI 分析 →

在 README 中展示上榜徽章

GitHub Trending

[![GitHub Trending](https://github.fq6825.top/badge/M-Abozaid/esp32-c3-adblock.svg)](https://github.fq6825.top/repo/M-Abozaid/esp32-c3-adblock)