Skip to content
项目

Oppidi/DNS-Worker has 31 GitHub stars and 18 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-16 03:32 UTC. Last push 2026-11-11.

这些数字如何统计

31 星标18 复刻 +1 24小时

可以做什么

  • ⚡ Full-Stack Protocols: UDP 53, DoT 853 (DoQ RFC 9250 compatible), DoH (HTTP/2 & HTTP/3 compatible), ECH & DDR (RFC 9460).
  • 🔀 Multi-Profile & Multi-Access Points: Create separate protection profiles for different users or scenarios, and derive unlimited sub-access points with independent routing tokens for granular per-device identification, filtering, and analytics.
  • 🗄️ Multi-Database Engines: Easily switch between D1, Turso, and File backends via the DATABASE_SERVICE environment variable, eliminating D1 free-tier quota limits.
  • 🛡️ Post-Quantum Zero-Knowledge E2EE: NIST FIPS 203 P256-MLKEM768 hybrid lattice cryptography + Hardware Passkeys (WebAuthn).

实测星标增长

24小时
+1
7天
正在收集历史
15天
正在收集历史
1个月
正在收集历史

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Serverless Privacy-First Protective DNS Resolver

安全

README_zh-CN.md

原文
DNS Worker Logo

DNS Worker

隐私优先 Protective DNS 解析器 & DoH / DoT 服务端 & 广告拦截器

保护您的互联网第一跳

English | 中文 (简体) | 中文 (正體)

License: AGPL v3 npm: dns-worker Docker: hugokoo/dns-worker Platform: Cloudflare Workers Runtime: Node.js / Bun Database: D1 | Turso | File Security: NIST FIPS 203 PQC Docs: Astro Starlight Protocols: UDP 53 · DoT / DoQ · DoH (H2/H3)


📖 序

DNS Worker 是一套专为隐私、安全与性能而生的 Protective DNS 解析系统,原生支持广告与恶意域名拦截,支持双引擎架构:

  • ☁️ 边缘模式 (Serverless):运行在 Cloudflare 全球 300+ 城市边缘节点,配合 D1 数据库享受零运维的高可用 DoH 服务(全面兼容 HTTP/2 与 HTTP/3)。
  • 🖥️ 独立服务器模式 (Serverfull):脱离 Cloudflare,运行在自有 VPS 或家庭服务器(Linux/Windows/macOS),原生支持经典 UDP 53、DoT 853(兼容 DoQ 并支持 TLS SNI 路由,原生适配 Android 私有 DNS)与本地 SQLite;

📚 用户文档
👉 https://oppidi.github.io/DNS-Worker/

快速上手

Cloudflare Workers 一键部署

Deploy to Cloudflare

独立主机极速运行 (npm)

# 全局安装并启动
npm install -g dns-worker
dns-worker config init
dns-worker
# 访问控制台: http://localhost:10080

容器化一键部署 (Docker,Beta)

# 后台启动并直接映射 443 端口与 TLS 证书(建议通过 443 访问;满足证书时 80 端口自动重定向至 HTTPS)
docker run -d \
  --name dns-worker \
  --restart unless-stopped \
  -p 53:53/udp \
  -p 853:853/tcp \
  -p 80:80/tcp \
  -p 443:443/tcp \
  -v dns_worker_data:/var/lib/dns-worker \
  -v dns_worker_config:/etc/dns-worker \
  -v /etc/letsencrypt:/etc/ssl/dns-worker:ro \
  hugokoo/dns-worker:latest

# 访问控制台: https://your-domain-or-ip (配置证书后,80 端口自动跳转 HTTPS)

核心功能

  • ⚡ 全栈协议:UDP 53、DoT 853 (兼容 DoQ RFC 9250)、DoH (兼容 HTTP/2 与 HTTP/3)、ECH 与 DDR (RFC 9460)。
  • 🔀 多配置与多接入点支持:支持按用户、家庭成员或使用场景建立多套独立配置(Profiles),每套配置可派生多个专用接入点(Access Points)并配发专属 Token,实现精准的设备级识别、策略隔离与独立统计。
  • 🗄️ 多数据库自由切换:支持 D1、Turso、File 多种数据库后端(通过 DATABASE_SERVICE 一键无缝切换),破解原生 D1 免费层用量限制。
  • 🛡️ 后量子零知识 E2EE:NIST FIPS 203 P256-MLKEM768 混合格密码学 + 硬件通行密钥(Passkey / WebAuthn)。
  • 🚀 本地优先 (Local-First):浏览器端 WebAssembly SQLite + OPFS,0ms 瞬间日志查询与统计分析。
  • 🛡️ 分层混合防护与广告拦截:原生兼容 AdGuard Home 语法(@@ 白名单例外散列表、$dnsrewrite 重写、正则表达式池)、双态前缀布隆过滤器秒级精准命中、百万级外部规则库、自定义规则可选子域名匹配、单列表独立同步与平滑防并发时延。

🔎 预览

分析统计 解析目的地
统计分析 解析目的地
多接入点与端点设置 规则设置
多接入点 规则设置
外部拦截列表 解析日志
过滤列表 解析日志
移动端统计 移动端日志
移动端统计 移动端日志

💡 更多功能演示与端点设置,请部署后访问 Web 控制台或参阅 官方文档。


💪 动力

DNS Worker 的诞生与演进得益于现代开源生态的卓越基础设施与密码学成果:


📄 开源协议

本项目采用 AGPL-3.0 开源许可证。


如果 DNS Worker 对您有所帮助,请考虑给它一个 ⭐