Armadillo – ホームラボ向けGleam製DNSサーバー
Armadillo – A DNS Server in Gleam for Homelab Use (github.com)
要約
Armadilloは、Gleamで書かれたホームラボ向けの自己ホスト型DNSサーバーです。ルーターに一度設定すれば、ネットワーク上のすべてのデバイスがローカルドメインを自動的に解決できます。ローカルレコードはDNSゾーンファイルに保存され、ETSにロードされて高速なクエリ解決を提供します。
全文翻訳
Armadillo
ホームラボ利用のためのセルフホスト型DNSサーバーで、Gleamで書かれています。
armadillo-showcase.mp4[動画: Armadilloのデモ]
ルーターのDNSリゾルバとして一度設定すれば、ネットワーク上のすべてのデバイスがローカルドメインを自動的に解決できるようになります。
仕組み
DNSクエリが到着すると、サーバーはまずローカルレコードストアを確認します。一致するレコードがあれば、設定済みのIPですぐに応答します。一致するレコードがなければ、クエリは設定可能なアップストリームリゾルバに転送され、応答はTTLに基づいてキャッシュされ、クライアントに返されます。
ローカルレコードはDNSゾーンファイルに保存され、起動時にETSにロードされます。実行時のクエリ解決はすべてETSのみを経由して行われ、クエリ処理中にゾーンファイルが読み込まれることはありません。
コンテナイメージ
ghcr.io/vshakitskiy/armadillo:v2.0.0 で利用可能です。
| 変数 | デフォルト | 説明 |
|---|---|---|
DNS_PORT | 53 | DNSサーバーがリッスンするポート |
DNS_UPSTREAM | 8.8.8.8 | 未知のドメインのためのアップストリームリゾルバ |
DNS_TTL | 300 | ゾーンレコードのデフォルトTTL(秒) |
DNS_SOA_MINIMUM | 3600 | ネガティブキャッシングのためのSOAミニマムTTL(秒) |
API_PORT | 3000 | Web UIとREST APIのポート |
API_SECRET_KEY_BASE | ランダムなキー | セッションクッキーに署名するために使用されるシークレット |
ZONE_FILE | /data/local.zone | DNSゾーンファイルへのパス |
再起動後もゾーンファイルを永続化するために、/data にボリュームをマウントしてください。ゾーンファイルが存在しない場合は自動的に作成されます。
デプロイガイド
デプロイガイドは、examples/ ディレクトリにあります。
- Podman — Caddyをリバースプロキシとして使用した、Podman Quadlet経由のsystemdサービス。
- Docker Compose — Caddyをリバースプロキシとして使用したマルチコンテナアプリケーション。
ドメイン命名
サーバーは任意のドメイン文字列を受け付けます。ただし、.local は避けてください。これはmDNS/Bonjour (RFC 6762) 用に予約されており、Appleデバイスは.local クエリをユニキャストDNSサーバーに送信しません。.lan または .internal が一般的な代替案です。
貢献
どのような貢献やフィードバックでも喜んで受け付けます。Issueやプルリクエストを歓迎します!
プロジェクトには3つのパッケージがあります: server はDNSリゾルバとHTTP APIを実行し、client はWeb UIで、shared は両方で使用されるモジュールを含んでいます。各パッケージは独立して開発されており、server/ で gleam run を、client/ で gleam run -m lustre/dev を実行してください。
ローカルでの開発中に環境変数を管理するために、direnv を推奨します。
sudoなしでローカルのポート53にバインドするには、BEAMバイナリにsetcapを実行してください:
# バイナリを見つける:
$(which erl) -noshell -eval 'io:format("~s~n",[os:find_executable("beam.smp")]),halt().'
# > /path/to/beam.smp
sudo setcap cap_net_bind_service=+ep /path/to/beam.smp
VPNでの解決
VPNでDNS問題に再び遭遇した場合のための個人的なメモ。
vlessをプロキシまたはtunモードで実行するVPNを使用する場合、VPNが正しいDNS経由でドメインを解決することを確認することが非常に重要です。ルーターのIP 192.168.1.1 がDNSサーバーとして設定されていると仮定します:
-
ルーターをDNSサーバーとして追加し、xrayのためにLAN IPを直接ルーティングします:
-
ローカルDNSサーバーにタグを付け、sing-boxのためにプライベートIPをそれ経由でルーティングします: