Temporary failure in name resolutionの原因と対処法

Temporary failure in name resolutionは、「ドメイン名をIPアドレスに変換できなかった」ことを意味します。DNSサーバーの設定(/etc/resolv.conf)が誤っている、DNSサーバーに到達できない、そもそもネットワークにつながっていない、のいずれかが原因です。

このエラーが表示される例

$ ping example.com
ping: example.com: Temporary failure in name resolution
$ curl https://example.com
curl: (6) Could not resolve host: example.com

「Temporary failure in name resolution」の意味

example.comのような名前で通信するとき、Linuxは最初に、その名前に対応するIPアドレスをDNSサーバーに問い合わせます。この問い合わせに失敗すると、通信を始める前の段階でエラーになります。curlではCould not resolve host、aptではTemporary failure resolvingと表示されますが、原因は同じです。

切り分けの第一歩は、IPアドレスを直接指定すると通信できるかを試すことです。IPアドレスなら通信できる場合は、ネットワークは正常で、名前解決だけが失敗しています。IPアドレスでも通信できない場合は、DNSではなく、ネットワークそのものの問題です。

原因を切り分ける手順

ステップ1:IPアドレスで通信できるかを確認する

$ ping -c 3 8.8.8.8

外部のIPアドレスへ直接pingを送ります。応答があれば、ネットワークは外部につながっており、名前解決だけの問題だと分かります。

ステップ2:参照しているDNSサーバーを確認する

$ cat /etc/resolv.conf
$ resolvectl status

nameserverの行に書かれているのが、問い合わせ先のDNSサーバーです。この行がない、または誤ったアドレスになっていると、名前解決ができません。systemd-resolvedを使っている環境では、resolvectl statusで実際の設定を確認します。

ステップ3:DNSサーバーに問い合わせできるかを確認する

$ dig example.com
$ dig @8.8.8.8 example.com +short

既定のDNSサーバーでは失敗し、@8.8.8.8のように別のDNSサーバーを指定すると成功する場合は、設定されているDNSサーバーに問題があります。

原因別の対処法

/etc/resolv.confの設定が誤っている、または空になっている

正しいDNSサーバーのアドレスを設定します。ただし、多くの環境では、このファイルはNetworkManagerやsystemd-resolved、DHCPによって自動で書き換えられます。直接編集しても元に戻るため、nmcliやnetplanなど、その環境の設定方法で変更します。

DNSサーバーへの通信が遮断されている

DNSは、53番ポート(UDPとTCP)を使います。ファイアウォールやセキュリティグループのアウトバウンドの設定で、このポートが許可されているかを確認します。

ネットワークにつながっていない

IPアドレスでも通信できない場合は、ip addrでアドレスが割り当てられているか、ip routeでデフォルトゲートウェイが設定されているかを確認します。

コンテナや仮想環境の中だけで発生する

Dockerのコンテナや、WSLの中だけで名前解決に失敗する場合は、コンテナ側のDNSの設定が原因です。コンテナの中でcat /etc/resolv.confを実行し、ホストから到達できるDNSサーバーが設定されているかを確認します。

注意:
応急処置として、/etc/hostsに名前とIPアドレスを書き込む方法がありますが、相手のIPアドレスが変わると、気付かないうちに接続できなくなります。
恒久的な対処にはせず、DNSの設定を直すのが基本です。

再発を防ぐために

/etc/resolv.confが、どの仕組みによって管理されているかを把握しておくことが大切です。ls -l /etc/resolv.confでシンボリックリンクになっているかを確認すると、管理元の見当が付きます。DNSの障害に備えて、DNSサーバーを2つ以上設定しておくと、片方が応答しないときも名前解決を続けられます。

よくある質問

Could not resolve hostと同じ意味ですか?

同じ原因です。curlやgitではCould not resolve host、pingではTemporary failure in name resolutionと、コマンドによって表示が異なります。

/etc/resolv.confを編集しても、元に戻ってしまいます

NetworkManagerやsystemd-resolved、DHCPクライアントが、このファイルを自動で生成しているためです。その環境のネットワーク設定の方法で、DNSサーバーを指定します。

digでは引けるのに、pingでは失敗します

digはDNSサーバーへ直接問い合わせますが、pingなどは、/etc/nsswitch.confや/etc/hostsを含むシステムの名前解決の仕組みを使います。getent hosts 名前で、システムとしての結果を確認します。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

ほかのエラーメッセージを調べる

← エラーメッセージ辞典へ戻る