快速上手

DNS Worker 提供两种适配不同场景的部署路径。作为以 Serverless 为核心优先的项目，将服务部署至 Cloudflare Workers 是最推荐的零运维全球边缘防护方案。

方案 1：部署至 Cloudflare Workers（Serverless 边缘模式 / 首选推荐）

免去繁琐的服务器配置与运维，依托 Cloudflare 全球 300+ 节点实现高可用解析。

1. 克隆仓库并安装依赖

git clone https://github.com/Obein/DNS-Worker.git
cd DNS-Worker
npm install

2. 创建 Cloudflare D1 分布式数据库

# 登录 Cloudflare 账号
npx wrangler login

# 创建专属 D1 数据库
npm run db:setup

将控制台输出的 database_id 填入项目根目录 wrangler.toml 的 [[d1_databases]] 中：

[[d1_databases]]
binding = "DB"
database_name = "dns_worker_db"
database_id = "填写您的_database_id"

3. 初始化数据表结构并一键部署

# 1. 向云端 D1 数据库应用初始化数据表结构
npm run db:migrate:prod

# 2. 编译 Web 控制台并一键部署 Worker
npm run deploy

部署完成后，您的专属控制面板与 DoH 解析终端即刻上线：https://<您的Worker名>.workers.dev（或您绑定的自定义顶级域名）。

方案 2：独立服务器 / VPS 部署（Serverfull Node.js / Bun 模式）

若您需要内网路由器直接通过 UDP 53 解析，或直接使用 Android 原生私密 DNS（DoT 853 端口）：

# 1. 全局安装 CLI（支持 npm 或 bun）
npm install -g dns-worker
# 或使用 bun: bun install -g dns-worker

# 2. 初始化持久化数据目录与默认环境变量
dns-worker config init

# 3. 启动 DNS Worker 守护服务（运行于 Node.js >= 22.5 或 Bun >= 1.4）
dns-worker

启动后即可访问本地管理面板 http://localhost:10080 及经典 UDP DNS 127.0.0.1:53。