HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

Armadillo – ホームラボ向けGleam製DNSサーバー

Armadillo – A DNS Server in Gleam for Homelab Use (github.com)

18 pointsby TheWiggles1 コメント

要約

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_PORT53DNSサーバーがリッスンするポート
DNS_UPSTREAM8.8.8.8未知のドメインのためのアップストリームリゾルバ
DNS_TTL300ゾーンレコードのデフォルトTTL(秒)
DNS_SOA_MINIMUM3600ネガティブキャッシングのためのSOAミニマムTTL(秒)
API_PORT3000Web UIとREST APIのポート
API_SECRET_KEY_BASEランダムなキーセッションクッキーに署名するために使用されるシークレット
ZONE_FILE/data/local.zoneDNSゾーンファイルへのパス

再起動後もゾーンファイルを永続化するために、/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サーバーとして設定されていると仮定します:

  1. ルーターをDNSサーバーとして追加し、xrayのためにLAN IPを直接ルーティングします:

  2. ローカルDNSサーバーにタグを付け、sing-boxのためにプライベートIPをそれ経由でルーティングします: