mDNSResponder とは、macOS で名前の引き(DNS)を受け持ち、その答えを控えておく常駐の仕組みです。

  • ネットは生きているのに、1 つのホストだけ「Could not resolve host」「Resolving timed out」で落ちる時の、原因の見分け方
  • dig・dscacheutil・curl --resolve が、それぞれ何を通って名前を引くかの違い
  • 当社の AI の席の Mac で、api.github.com だけが約 40 分引けず、CI が約 50 分止まった記録と、sudo が無い時に打てる手(社の実測 2026-11-17)

当社は開発の仕事の多くを AIエージェントの席に任せ、その席を Mac で動かしています。席は curl・git・gh で GitHub とやりとりします。この頁は、その Mac で 1 つのホストの名前だけが引けなくなった時に、何をどの順に確かめ、何で根を突き止めたかの記録です。

mDNSResponder は、Mac の名前の引きの窓口

macOS の man ページは、mDNSResponder を「Multicast and Unicast DNS daemon」とし、Mac OS X 10.6 から「system-wide Unicast DNS Resolver」(系統全体の DNS の引き手)でもあると書いています。さらに、手元のプロセスに代わって DNS を問い合わせ、「maintains a cache of the replies」(答えの控えを持つ)とあります(macOS の man「mDNSResponder(8)」2026-11-18 に確認)。

つまり Mac の上の curl や git がホストの名前を IP に直す時は、多くの場合この常駐に頼みます。この常駐が 1 つの名前で詰まると、DNS の機械(家のルーターなど)が正しく答えていても、その名前だけが引けなくなります。

道具ごとに、名前を引く道が違う

切り分けの要は、「同じ名前を、違う道で引いてみる」ことです。道具によって、mDNSResponder を通るか、DNS の機械に直に聞くか、名前を引かないかが違います。

確かめ方名前を引く道当社のその日の結果
curl https://api.github.com
OS の名前の引き(mDNSResponder)
「Resolving timed out」
dscacheutil -q host -a name api.github.com
OS の標準の呼び出し(控えに在れば控えから、無ければ取りに行く)
30 秒待って空
dig @<家のルーター> api.github.com
指した DNS の機械に直に聞く(OS の名前の引きを通らない)
即答で IP が返る(応答 2ms)
curl --resolve api.github.com:443:<IP> https://api.github.com
名前を引かない(指した IP へ直に繋ぐ)
200
curl https://www.google.com
OS の名前の引き(別の名前)
引ける
tailscale dns query api.github.com
Tailscale の手元の DNS の中継
SERVFAIL

出典: 結果の列は社の実測 2026-11-17。道の列は macOS の man「dscacheutil(1)」「dig(1)」、curl の man「--resolve」、Tailscale「Tailscale CLI」(いずれも 2026-11-18 に確認)。

dscacheutil の man は、-q を「standard calls」(標準の呼び出し)で問い合わせ、答えを「return results from the cache or go fetch live data」(控えから返すか、取りに行って控えに置く)と書いています。dig の man は、@server を「the name or IP address of the name server to query」(問い合わせる DNS の機械)としています(macOS の man、2026-11-18 に確認)。curl の man は --resolve を「Provide a custom address for a specific host and port pair」と書き、コマンドの上の /etc/hosts の代わりのようなものだと説明しています(curl の man、2026-11-18 に確認)。

この 3 つを並べると、「DNS の機械は答えている(dig)」「IP に繋げば通る(--resolve)」「OS の名前の引きだけが答えない(dscacheutil・curl)」が分かれます。こうなった時は、疑う先はネットでも相手のサービスでもなく、手元の Mac の名前の引きです。

「Could not resolve host」と「Resolving timed out」の読み方

curl のエラーの一覧は、6 番 CURLE_COULDNT_RESOLVE_HOST を「Could not resolve host. The given remote host was not resolved.」(相手のホストの名前が引けなかった)、28 番 CURLE_OPERATION_TIMEDOUT を「Operation timeout. The specified time-out period was reached according to the conditions.」(決めた時間に達した)と定めています(curl「libcurl - Error Codes」2026-11-18 に確認)。

「Resolving timed out」は、名前の引きの段で時間切れになったという curl の言い方です。「答えが空で返った」のではなく「答えが返ってこない」ので、DNS の機械が「その名前は無い」と言っている場合とは様子が違います。当社の時は、dscacheutil も 30 秒待って空だったので、OS の名前の引きが答えを返さないまま待っている、と読めました(社の実測 2026-11-17)。

確かめる順: 相手か、網か、手元の名前の引きか

  1. 相手のサービスの状態を見る。GitHub なら githubstatus.com。当社の時は All Systems Operational でした(社の実測 2026-11-17)。
  2. 同じ相手の別の名前・別の口を試す。当社では github.com は 200、api.github.com だけが落ちました(社の実測 2026-11-17)。
  3. 名前を引かずに繋ぐ。curl --resolve で IP を指して 200 なら、繋がり(TCP と HTTPS)は生きていて、名前の引きの話です。
  4. DNS の機械に直に聞く。dig @<家のルーター> で答えが返るなら、DNS の機械は正常です。
  5. OS の名前の引きで聞く。dscacheutil -q host -a name <名前> が待たされる・空なら、mDNSResponder が疑わしい。
  6. VPN など DNS を差し込む物を外して比べる。それでも直らなければ、OS の名前の引きそのものの詰まりと読めます。

どれも sudo は要りません。4 と 5 の結果が食い違う所が、見分けの印です。

当社の記録: api.github.com だけが約 40 分引けなかった

2026-11-17 の 01 時 20 分ごろから 01 時 40 分すぎ(日本時間)、AI の席を動かす Mac から api.github.com へ、TCP は通るのに HTTPS が 6〜10 秒応答しなくなりました。github.com と、curl --resolve で api の米国の口(別の IP)を指した時は 200 でした。GitHub の状態の頁は All Systems Operational でした(社の実測 2026-11-17)。

最初は GitHub 側の一部の口の不調を疑いましたが、02 時すぎに切り分け直すと、根は GitHub ではなくこの Mac の名前の引きでした。curl は「Resolving timed out」、dscacheutil -q host -a name api.github.com は 30 秒待って空。一方で dig @<家のルーター> は即答で IP を返し(ルーターの DNS の応答は 2ms)、その IP を curl --resolve で指すと 200。www.google.com は引けました(社の実測 2026-11-17)。

この Mac では Tailscale も動いており、tailscale dns query は SERVFAIL でした。Tailscale の文書は --accept-dns を「Accept DNS configuration from the admin console」(管理画面の DNS の設定を受け取る)としています(Tailscale「Tailscale CLI」2026-11-18 に確認)。そこで tailscale set --accept-dns=false で系統の DNS を家のルーターだけにしましたが、直りませんでした。ここで、macOS の名前の引き(mDNSResponder)が api.github.com だけ詰まっている、と読みました。accept-dns は元に戻しています。同じ網の別の機体(IP を直に指す設定)は影響を受けていませんでした(社の実測 2026-11-17)。

時刻(日本時間)起きた事
01:2x〜01:4x
api.github.com への HTTPS が 6〜10 秒で応答なし。github.com は 200
01:40
名前の引きの詰まりの始まり(01:40〜02:22 の約 40 分)
02:0x
dig・dscacheutil・curl --resolve で切り分け、根を Mac の名前の引きと読む
02:22
手を入れないまま自然に戻る(詰まりは約 40 分)

出典: 社の実測 2026-11-17。

止まった物: CI の作業員と gh

名前が引けない間、当社の自前の CI の作業員を立てる道具が GitHub App の札(トークン)を作れず、arm64 の作業員を立てられませんでした。そのため CI の run が約 50 分 queued のまま止まり、gh も失敗しました(社の実測 2026-11-17)。

この時に表に出たのは「作業員が来ない」「gh が落ちる」で、DNS の文字はどこにもありません。当社は見分けの印として、作業員の道具のログの「App の札が作れない」と、curl の「Resolving timed out」の 2 つを残しました。この 2 つが同時に出たら、まず名前の引きを疑います。

DNS キャッシュを消す: sudo が要る手と、要らない手

当社が用意していた直しは sudo killall -HUP mDNSResponder で、戻しは要らず数秒で済む手です(社の実測 2026-11-17)。広く使われているキャッシュの消し方は次の 2 行です。

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

macOS の man は、dscacheutil -flushcache を「Flushes the entire cache」(控えを全部消す)とし、「This should only be used in extreme cases」(よほどの時だけ使う)と添えています。killall は名前でプロセスを選んで合図を送る道具で、合図を変えずに撃つと TERM を送り、他の利用者のプロセスに送れるのは super-user だけです(macOS の man「dscacheutil(1)」「killall(1)」2026-11-18 に確認)。mDNSResponder の man には HUP を受けた時の動きは書かれていないため、HUP が控えを消す、という点は当社は Apple の文書では確かめられていません。

当社の時は、このキャッシュの掃除に sudo が要り、AI の席には合言葉(sudo のパスワード)を持たせていないので撃てませんでした。詰まりは 01:40〜02:22 の約 40 分続き、02:22 に自然に戻りました(社の実測 2026-11-17)。

sudo が無い時に打てるのは、名前の引きを通らずに済ませる手です。

  • dig @<DNS の機械> <名前> で IP を引き、curl --resolve <名前>:443:<IP> で繋ぐ
  • 落ちているのが名前の引きだけだと分かったら、相手のサービスへの問い合わせや、網の設定の変えすぎを止める

当社は再発に備えて、合言葉なしで外せる退避として、作業員の道具の curl に --resolve を足すことを次の手の候補にしました。まだ作ってはいません(社の実測 2026-11-17)。

よくある質問

dig で引けるのに curl で引けないのはなぜですか

dig @server は指した DNS の機械に直に聞き、macOS の名前の引き(mDNSResponder)を通りません。curl は OS の名前の引きに頼むので、mDNSResponder が 1 つの名前で詰まると、dig では引けて curl では引けない、という食い違いが出ます。dscacheutil -q host -a name <名前> でも引けなければ、手元の名前の引きの詰まりと読めます。

Mac の DNS キャッシュを消すコマンドは何ですか

広く使われているのは sudo dscacheutil -flushcache と sudo killall -HUP mDNSResponder の 2 行です。どちらも sudo が要ります。man は -flushcache を控えを全部消す物とし、よほどの時だけ使うよう添えています。

sudo が使えない時にできる事はありますか

キャッシュは消せませんが、名前の引きを通らずに繋ぐ事はできます。dig で IP を引き、curl --resolve <名前>:443:<IP> で繋げば、名前の引きが詰まっていても通ります。当社の時は sudo を撃てず、約 40 分後に自然に戻りました(社の実測 2026-11-17)。

「Could not resolve host」は相手のサーバーが落ちているという意味ですか

いいえ。curl のエラー 6 は「相手のホストの名前が引けなかった」という意味で(curl「libcurl - Error Codes」)、相手が落ちているとは限りません。当社の時は GitHub は正常で、引けなかったのは手元の Mac の名前の引きでした。

VPN(Tailscale など)の DNS を切れば直りますか

VPN が DNS を差し込んでいるなら、切って比べる価値はあります。ただ当社の時は tailscale set --accept-dns=false でも直らず、根は OS の名前の引きの側でした(社の実測 2026-11-17)。切って直らなければ設定は元に戻し、mDNSResponder を疑います。

鍵や認証で git が落ちる時は Permission denied (publickey) の頁を、ディスクが満杯で落ちる時は no space left on device の頁を見てください。

出典

  1. macOS の man ページ「mDNSResponder(8)」「dscacheutil(1)」「dig(1)」「killall(1)」(macOS 26 の機体の man で 2026-11-18 に確認)
  2. curl「libcurl - Error Codes」https://curl.se/libcurl/c/libcurl-errors.html(2026-11-18 に確認)
  3. curl「curl.1 the man page」--resolve・終了コード 6 と 28 https://curl.se/docs/manpage.html(2026-11-18 に確認。本文は手元の man curl で照合)
  4. Tailscale「Tailscale CLI」(tailscale set --accept-dns・tailscale dns query)https://tailscale.com/kb/1080/cli(2026-11-18 に確認)
  5. Tailscale「tailscale up command」(--accept-dns)https://tailscale.com/kb/1241/tailscale-up(2026-11-18 に確認)
  6. 当社の記録(AI の席を動かす Mac・CI の作業員のログ)社の実測 2026-11-17