zamir4175/esphole

# 🛡️ esphole - 使用您的硬件屏蔽网络广告 [](https://github.com/zamir4175/esphole/releases) ## 🎯 关于本软件 esphole 充当您家庭互联网连接的过滤器。它位于您的设备和您访问的网站之间。当设备请求网页时，esphole 会检查该网站是否包含跟踪器或广告。如果发现此类内容，它会在其到达您的设备之前阻止该连接。这能加快您的浏览速度并保护您的隐私。您需要在 ESP32-S3 微控制器上构建此系统。 ## 🛠️ 系统要求 您需要以下物品才能使用本软件： * 一块 ESP32-S3 开发板。 * 一根与您的开发板兼容的 USB 数据线。 * 一台 Windows 10 或 11 电脑。 * 稳定的家庭 Wi-Fi 连接。 ## 📥 获取文件 您必须将固件文件下载到您的计算机。这些文件包含了指示 ESP32 芯片如何拦截网络流量的指令。 [访问发布页面以下载最新软件](https://github.com/zamir4175/esphole/releases) 寻找以 `.bin` 结尾的文件。将该文件保存到您以后容易找到的文件夹中，例如您的“下载”文件夹。 ## ⚙️ 设置您的设备 请按照以下步骤将软件刷入您的 ESP32-S3 开发板。 1. 使用 USB 数据线将 ESP32-S3 开发板连接到您的计算机。 2. 在 Chrome 或 Edge 浏览器中访问网站 [web.esphome.io](https://web.esphome.io)。 3. 点击网站上的“连接”按钮。 4. 从弹出的列表中选择对应于您的 ESP32 开发板的端口。 5. 点击网站上的“安装”按钮。 6. 选择您之前下载的 .bin 文件。 7. 等待浏览器将软件写入您的硬件。进度条会在几分钟内完成。 8. 当进度条显示 100% 时，拔下您的设备。 ## 🌐 配置网络 一旦软件安装在您的硬件上，您必须告诉它如何连接到您的家庭网络。 1. 将 ESP32-S3 重新插入电源，例如 USB 墙壁充电器。 2. 等待一分钟让设备启动。 3. 打开手机或电脑上的 Wi-Fi 设置。 4. 找到名为“esphole-setup”的网络并连接到它。 5. 此时应该会自动打开一个网页。从列表中选择您的家庭 Wi-Fi 网络。 6. 输入您的家庭 Wi-Fi 密码。 7. 保存您的设置。设备将重启并连接到您的家庭 Wi-Fi。 ## 📊 使用 Web 界面 esphole 提供了一个网页来管理您的拦截规则。您可以根据个人喜好在浅色模式和深色模式之间切换。 1. 通过路由器的管理面板找到您设备的 IP 地址，或者在浏览器中搜索“esphole.local”。 2. 使用仪表板实时查看被拦截的请求。 3. 如果某个网站无法正常加载，您可以将其添加到白名单中。 4. 系统对所有请求使用加密连接，以确保您的互联网服务提供商无法跟踪您访问的内容。 ## 🔄 更新与维护 该软件具备自动回滚系统。如果更新失败，设备会自动恢复到上一个可用的版本。这可以防止硬件失去响应。要更新您的固件，只需再次访问发布页面，下载新文件并重复设置过程即可。 ## 🛡️ 隐私功能 - **广告和跟踪器拦截：** 阻止数百种已知的跟踪脚本加载。 - **加密上游：** 通过安全通道发送您的 DNS 请求，以防止被窥探。 - **故障开放设计：** 如果硬件断电，您的互联网将继续正常工作，而不会中断您的连接。 - **本地控制：** 您所有的过滤日志都保留在设备上。数据永远不会离开您的家庭网络。 ## ❓ 故障排除 如果设备似乎没有屏蔽广告，请确保您的计算机和 ESP32-S3 处于同一个 Wi-Fi 网络中。如果您无法访问 Web 界面，请尝试拔下设备十秒钟，然后重新插上以重启服务。重置设备是安全的，不会清除您的配置设置。 关键词：ad-blocker, adblock, c, dns, dns-over-tls, dns-server, dns-sinkhole, esp-idf, esp32, esp32-s3, firmware, freertos, iot, network-security, pi-hole

标签：DNS Sinkhole, ESP32, 客户端加密, 嵌入式, 广告拦截, 物联网, 网络隐私