それは鳥であり、飛行機であり、それは...自己ホスト型の pi-hole 風の DNS リゾルバーです

serverless-dnsは、Pi-Hole 風のコンテンツ ブロッキング、サーバーレス、スタブ DNS-over-HTTPS (DoH) および DNS-over-TLS (DoT) リゾルバーです。Cloudflare Workers、Deno Deploy、およびFly.ioですぐに実行できます。これらすべてのサービスの無料利用枠は、1 か月あたり 10 ～ 20 台のデバイスに相当する DNS トラフィックをカバーするのに十分なはずです.

RethinkDNS リゾルバー

RethinkDNS は

serverless-dns

basic.rethinkdns.com

max.rethinkdns.com

サーバー側の処理には 0 ミリ秒 (ms) から 2 ミリ秒 (中央値) かかり、エンドツーエンドの待機時間 (地域やネットワークによって異なります) は 10 ミリ秒から 30 ミリ秒 (中央値) です。

セルフホスト

Cloudflare Workers はセットアップが最も簡単なプラットフォームです

serverless-dns

詳しい手順については、次を参照してください。

ブロックリストをセットアップするには、ブラウザーからアクセスします ( RethinkDNS の構成ページ

https://<my-domain>.tld/configure

ヘルプやサポートが必要な場合は、お気軽に問題を開くか、パッチを送信してください。

発達

設定

コード：

# navigate to work dir
cd /my/work/dir

# clone this repository
git clone https://github.com/serverless-dns/serverless-dns.git

# navigate to serverless-dns
cd ./serverless-dns

ノード：

# install node v16+ via nvm, if required
# https://github.com/nvm-sh/nvm#installing-and-updating
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
nvm install --lts

# get js dependencies
npm i

# (optional) update dependencies
npm update

# run serverless-dns on node
./run n

# run a clinicjs.org profiler
./run n [cpu|fn|mem]

での：

# install deno.land v1.18+
# https://github.com/denoland/deno/#install
curl -fsSL https://deno.land/install.sh | sh

# run serverless-dns on deno
./run d

ラングラー:

# install Cloudflare Workers (cli) aka Wrangler
# https://developers.cloudflare.com/workers/cli-wrangler/install-update
npm i @cloudflare/wrangler -g

# run serverless-dns on Cloudflare Workers (cli)
# Make sure to setup Wrangler first:
# https://developers.cloudflare.com/workers/cli-wrangler/authentication
./run w

# profile wrangler with Chrome DevTools
# blog.cloudflare.com/profiling-your-workers-with-wrangler

コードスタイル

このリポジトリでコミットすると、Google JavaScript スタイル ガイドが適用されます (参照: .eslintrc.cjs )。

pre-commit

.js

git commit --no-verify

プル リクエストのコード スタイル違反もチェックされ、可能な場合は自動的に修正されます。

環境変数

構成

.env

env.js

.env

env.js

wrangler.toml

ご依頼の流れ

1. リクエスト/レスポンス フロー: client <->

   src/server-[node|workers|deno]

   <->

   doh.js

   <->

   plugin.js

2. plugin.js

   流れ: -

   userOperation.js

   >

   cacheResponse.js

   ->

   cc.js

   ->

   dnsResolver.js

ランタイムに関する注意

Deno Deploy (クラウド) と Deno (ランタイム) は同じ API サーフェスを公開しません (たとえば、Deno Deploy は HTTP/S サーバーリスナーのみをサポートしますが、Deno はプレーンな HTTP と HTTP に加えて raw TCP/UDP/TLS をサポートします) /S)。

ノードを除き、環境変数/

serverless-dns

CF_DNS_RESOLVER_URL

CF_DNS_RESOLVER_URL_2

1.1.1.2

Node と Deno のエントリポイントはそれぞれ であり

src/server-node.js

src/server-deno.ts

src/server-workers.js

Deno での prod セットアップと Node でのローカル (非 prod) セットアップの場合、

key

cert

TLS_KEY_PATH

TLS_CRT_PATH

Node (Fly.io) での prod セットアップの場合は、次のように、env var ( ref ) でエンコードされたbase64またはに

TLS_OFFLOAD

true

key

cert

TLS_CERTKEY

# EITHER: offload tls to fly.io and set tls_offload to true
TLS_OFFLOAD="true"
# OR: base64 representation of both key (private) and cert (public chain)
TLS_CERTKEY="KEY=b64_key_content\nCRT=b64_cert_content"

プロセスの起動は、これらのランタイムごとに異なります。ノードの場合、起動

src/core/node/config.js

src/core/deno/config.ts

src/core/workers/config.js

src/system.js

Node と Deno では、インプロセス DNS キャッシング

@serverless-dns/lfu-cache

PROFILE_DNS_RESOLVES=true

クラウド

Cloudflare Workers と Deno Deploy は一時的なものです。つまり、クライアント リクエストを処理するプロセスは長続きせず、実際には、2 つの連続したリクエストが 2 つの異なるアイソレート(プロセス) によって処理される可能性があります。Node を実行する Fly.io 上のリゾルバーは、永続的な VMによって支えられているため、従来の「サーバーフル」環境のように長寿命です。

Cloudflare ワーカーのビルド時およびランタイム構成は で定義されてい

wrangler.toml

Deno Deploy の場合、コードベースは単一の JavaScript ファイルにまとめられ、

deno bundle

Node を実行する Fly.io の場合、ランタイム ディレクティブは(およびデプロイメント タイプ

fly.toml

dev

live

node.Dockerfile

flyctl

serverless-dns

TLS ターミネーションを Fly.io にオフロードするデプロイ (

B1

fly.tls.toml

参照: github/ワークフロー.

ブロックリスト

190 以上のブロックリストがSuccinct Radix Trie ( Steve Hanov の impl に基づく)で圧縮され、

lookup

CF_LATEST_BLOCKLIST_TIMESTAMP

CF_BLOCKLIST_URL

serverless-dns

serverless-dns