目次
ノードは使えそうなのに、カスタムDoHでは名前解決に失敗し、別のDNSに替えると正常に動く。まず現在の設定と最初のエラーを保存します。ノードの切り替え、ルールの変更、証明書検証の無効化を同時に行わないでください。
ネイティブMac版で対象DoHのクエリが失敗しているか確認する
この記事は、ネイティブのStash Macで自分のYAMLを使い、現在有効な設定を把握し、復元できるコピーを保存できる方が対象です。HTTP/1.1のみをサポートするDoH上流サーバーとの互換性を扱います。
公式Mac更新フィードの5.0.0(build 607)には、サーバーがHTTP/2をサポートしない場合はHTTP/1.1を使うと記載されています。すべてのDNS障害を解決する修正ではありません。別のプラットフォームのバージョンを、実際のMacアプリのバージョンとして扱うこともできません。
まず上流サービス提供元のプロトコル説明やサーバー側の接続記録から、HTTP/1.1のみの対応か確認します。ブラウザーでDoHのURLを開けても、分かるのはそのブラウザーアクセスの結果だけです。StashがDNSクエリを正常に送信した証拠にはならず、上流サーバーが特定のHTTPバージョンだけに対応するとも判断できません。
失敗した段階から確認する
| 見られる症状 | 最初に確認すること |
|---|---|
| 同じカスタムDoHで失敗し、動作確認済みの別の上流サーバーは使える | 対象サーバーのプロトコルと、クエリが実際に通る経路を調べる |
| ノード自体のドメイン名を解決できない | proxy-server-nameserverと起動時の名前解決経路を別途確認する |
| 接続がタイムアウトする、または証明書の検証に失敗する | そのサーバーへのネットワーク、アドレス、証明書を確認し、すぐにHTTP/1.1の互換性問題と決めつけない |
| Webページは開けるが、新しいDNSクエリを確認できない | キャッシュが結果を隠している可能性があり、対象サーバーが正常とは判断できない |
元の設定を保存し、コピーで実際のDNS経路を確認する
使用中の完全なYAML、自分で加えた設定の上書き、元のノード選択を別に保存し、元の設定を再び有効にできるようにします。唯一の管理設定を直接変更したり、復元できるか未確認のクラウド上の状態に頼ったりしないでください。テストには自分で管理するコピーを使います。
Stashのnameserverに複数の上流サーバーを設定すると、並行して問い合わせ、最も早い応答を採用します。別のサーバーが成功すると、対象DoHがまだ失敗していることを見落とす可能性があります。nameserver-policyやfallbackによっても、実際に使うDNSサーバーが変わります。
有効な設定の上書きから別のサーバーが再び加わることもあります。配列は標準で先頭に追加する形でマージされるため、元のYAMLの記述だけでなく、最終的に有効なnameserverを確認してください。
比較が必要な場合は、コピー内にある既存のdnsブロックで、nameserverを一時的に元の対象DoHだけにします。nameserver-policyやfallbackで別経路に振り分けられないテスト用ドメインを選び、このコピーが有効になっていることを確認します。実際の経路を確認できなければ、そこで変更を止めてください。複数の経路が混じった結果を、単一の上流サーバーの検証として扱ってはいけません。
元のfollow-ruleの値を記録します。標準ではDNSリクエストはプロキシルールに従いません。有効にしている場合は、再帰を避けるため、DNS上流サーバーへの接続ルールと起動時の名前解決も確認します。proxy-server-nameserverはプロキシサーバーのドメイン名用で、独立した問い合わせ経路を使います。そこで成功しても、通常の対象ドメインをnameserverで解決できた証拠にはなりません。
今回の比較では必要な上流サーバーのリストだけを変更します。follow-rule、ノード、通信の取り込み方式を同時に変えたり、別のHTTP転送方式を強制することを今回の修正と同一視したりしないでください。見かけ上の成功のためにTLS証明書検証を無効にしてはいけません。
同じDoHサーバーのままネイティブMacアプリを更新する
同じ設定コピーで更新前後を比較する
アプリのバージョンと元の失敗を記録する
実際に動作しているネイティブStash Macのバージョンとbuildを確認し、対象DoHのアドレス、関連するDNS設定、機密情報を除いたエラーを保存します。ストアページ、サブスクリプション名、別の端末のバージョンだけで判断しないでください。
通常の手順で終了してネイティブアプリを更新する
まず現在のシステムとライセンスが対象バージョンに対応するか確認します。現在のネットワークを中断できるときに通常の手順で停止・終了し、ネイティブMac版の公式更新経路から5.0.0(607)の修正を入手します。更新できなければ、先に以下の方法で使える状態に戻してください。元のデータと設定は残します。出所不明の旧パッケージを入れたり、アプリ全体の更新をコアファイルの差し替えで代用したりしないでください。
元のテスト用設定を選び直す
再起動後に実際のバージョンとbuildを確認し、保存したテスト用コピーを選んで元と同じ方法で開始します。対象DoH、ノード、ルールはそろえたままにします。設定の検証やアプリの起動に失敗した場合は、まずその段階のエラーを処理してください。
更新できない場合は、先に使える状態へ戻す
まず元の設定に戻し、自分で以前に動作確認した暗号化DNSの上流サーバーを使います。失敗の記録とテスト用コピーを残し、更新できるようになってから同じ比較を行ってください。一時的に別のサーバーを使うことは、互換性問題が修正された証拠にはなりません。
この記事で確認したのは5.0.0(607)の公式修正です。後で別のバージョンを使う場合は、その配布経路と同じ修正が含まれる根拠を確認してください。バージョンを一致させるためにダウングレードする必要はありません。また、任意の過去バージョンを公式経路からインストールできると保証するものでもありません。
新しいクエリを確認してから実際の通信を試す
StashはDNSの結果をキャッシュします。有効期限が切れた後も、古い結果を使いながらバックグラウンドで更新する場合があります。以前のWebページが開ける、遅延テストが一度成功する、しばらく待つといったことだけでは、対象DoHの復旧を確認できません。
自分のテスト用ドメインと、参照が認められたログの範囲内で、新しいDNSクエリが実際に発生し、対象DoHを使ったことを確認します。サーバー側の権限があれば、その上流サーバーのリクエスト記録も照合できます。新しいクエリや実際の問い合わせ先を確認できない場合は「未検証」と記録し、成功したことにしないでください。その後、そのドメインを必要とする接続を新たに開始し、実際のWebページや業務サービスを利用できるか確認します。
今回の修正を確認するチェックリスト
- 修正を含むネイティブStash Macが実際に動作しており、バージョンとbuildを確認した。
- 現在のテスト用設定、対象DoH、元のノードが明確で、テスト用ドメインが別のDNS経路に振り分けられていない。
- 既存キャッシュの再利用だけでなく、対象サーバーへの新しいクエリが発生したことを確認した。
- 元の関連する名前解決エラーが出なくなり、そのドメインを使う新しい業務接続も正常に動く。
- 必要な通常設定へ戻した後も再確認し、元の設定と動作する上流サーバーへの復旧手段を残した。
当サイトは公式Mac更新フィードとDNS文書に基づいて、確認方法と操作を案内しています。利用者のネットワークや実際のStashクライアントで障害を再現したものではありません。当サイトの五言語、ソース、ブラウザーの検査は、端末上でのDoHや業務接続のテストを代替しません。
失敗が続く場合は元の設定に戻し、最初のエラーから調べる
更新後も対象DoHがタイムアウトする、または証明書エラーが出る
元の設定と動作確認済みの暗号化DNSへ戻します。対象アドレス、到達性、証明書、サービス提供元の状態を確認してください。ネットワークエラーをすべてプロトコルの互換性問題にまとめたり、証明書検証を無効にしたりしないでください。
設定を替えた後、ノードのドメイン名も解決できなくなる
まず元の設定に戻し、proxy-server-nameserver、DNS上流サーバーのドメイン名の起動時名前解決、元のfollow-ruleを確認します。以前動作していた経路を復元し、DNSやルーティングの変更をさらに同時追加しないでください。
テストは成功するが、通常設定に戻すとまた失敗する
nameserver-policy、fallback、上書き適用後の実際の設定を一つずつ確認します。単一サーバーのテストと元の設定との比較を残してください。別のサーバーの成功やキャッシュへのヒットだけでは、対象DoHが継続して正常だったとは証明できません。
アプリを起動できない、または設定の検証に失敗する
まず元の動作する設定に戻し、変更の追加を止めます。アプリのバージョン、検証エラー、操作記録を保存し、該当する段階について相談してください。唯一のデータディレクトリを削除したり、確認できない旧バージョンへの復帰に頼ったりしないでください。
相談時はmacOS、Stash Macのバージョンとbuild、上流サーバーのプロトコルの根拠、機密情報を除いたDNSの設定部分、最初のエラー、新しいクエリの検証結果を提示します。トークンを含むDoH URL、サブスクリプションのアドレス、非公開ドメインは隠してください。元の完全な記録は、自分で復元に使えるよう残します。
