devns

macOS向けのローカルドメイン https://<nama>.test ポートなし。

devns add webui 8080
# ✓ https://webui.test → 127.0.0.1:8080 (caddy admin load HTTP 200)

すべてをセットアップする単一のCLI: dnsmasq (ワイルドカード *.test → 127.0.0.1)、Caddy (ポート80/443の唯一の保持者、内部CAによる自動HTTPS)、そしてオプションのローカルDoHブリッジにより、Secure DNS を使用するブラウザでも .test ドメインを開くことができます。

なぜ必要か？

Related MCP server: DDEV MCP Server

インストール

必要: macOS + uv + Homebrew。

git clone https://github.com/apiep/devns && cd devns
uv tool install --editable .
devns init          # sekali saja — minta sudo interaktif 2-3x
devns doh install   # opsional: bridge DoH utk browser secure-DNS

devns init が準備するもの:

1. まだない場合は brew install dnsmasq caddy

2. /etc/resolver/test → macOSがTLD .test を127.0.0.1にルーティング

3. dnsmasq.conf の address=/.test/127.0.0.1 ブロック + :53のサービスルート

4. メインのCaddyfile (import ~/.config/devns/sites/*.caddy) + 80/443のサービスルート

5. Caddyの内部CAをシステムトラストストアへ (sudo caddy trust)

6. DoHブリッジ (AdGuardの dnsproxy — OS/archに応じてバイナリを自動ダウンロード)

日常的にはsudoは一切不要: add/rm/ls/open/doctor/doh/log。

使い方

devns add pueue 7337          # daftarkan domain + reload Caddy + cek port
devns add api 3000 --open     # sekalian buka browser
devns ls                      # ● https://pueue.test → 127.0.0.1:7337
devns open pueue              # buka di browser default
devns rm pueue                # hapus (konfirmasi; -y skip)
devns doctor                  # kesehatan: resolver/DNS/Caddy/HTTPS/DoH

devns doh install             # bridge DoH (LaunchAgent user-level)
devns doh status
devns doh log -f              # ikuti log dnsproxy live

Secure DNSを使用するブラウザ

devns doh install 後、Secure DNSをカスタムに設定: https://dns.test:8443/dns-query。 .test クエリはローカルで解決され、他のすべてのクエリは選択したアップストリームDoH (デフォルトはOpenDNS) に暗号化されて転送されます。

アーキテクチャ

Browser ──DoH──> dns.test:8443 (dnsproxy, launchd io.devns.doh)
                   ├─ [/test/] ──> dnsmasq :53 ──> 127.0.0.1
                   └─ lainnya  ──> https://doh.opendns.com/dns-query

Browser ──HTTPS──> Caddy :443 ──reverse_proxy──> 127.0.0.1:<port-app>
        ──HTTP───> Caddy :80  ──308──> HTTPS
                     cert: Caddy Local Authority (tls internal), per-hostname on-demand

• レジストリ: ~/.config/devns/registry.yaml = 唯一の真実のソース

• サイトファイル: ~/.config/devns/sites/<nama>.caddy (生成されたアーティファクト; テンプレートは flush_interval -1 を使用してSSEがバッファリングされないようにする)

• 毎日のリロード: Caddyのadminエンドポイント localhost:2019 にヘッダー Content-Type: text/caddyfile を使用

MCPサーバー

devnsは追加の依存関係なしでstdio MCPサーバーを含みます:

hermes mcp add devns --command devns-mcp    # Hermes Agent
# atau konfigurasi MCP client lain (Claude Desktop dsb) dengan command "devns-mcp"

ツール: list_domains, add_domain, remove_domain, check_health, doh_status。

AIエージェント用スキル

このリポジトリには skills/devns/SKILL.md にポータブルスキルが含まれています (agentskills.io / Claudeスキル形式)。エージェントのスキルディレクトリにコピーまたはシンボリックリンクしてください。

設計メモ (実際の教訓)

• ワイルドカード *.test は最新の検証器に拒否される — Chromeとcurlは、SANがRFC的に有効でもTLDに直接付くワイルドカード証明書を拒否します。そのため、証明書はCaddyの内部CAによってホスト名ごとにオンデマンドで作成されます。

• ポート5353はmDNSResponder (Bonjour) が使用中 → DoHブリッジは5335を使用。

• /etc/resolver/test はdnsmasqが停止しているときに解決をハングさせます (即座に失敗しない) — これはリゾルバがアクティブである証拠であり、バグではありません。

ライセンス

MIT