연결 문제 해결

Stash Mac DoH 오류: 5.0.0 호환성 수정

Stash Mac에서 사용자 지정 DoH 이름 확인이 실패하나요? HTTP/1.1만 지원하는 업스트림, 캐시, DNS 정책을 구분합니다. 백업 후 5.0.0(607)으로 업데이트하고 새 쿼리와 실제 연결, 복구 방법을 확인하세요.

  • Stash
  • macOS
  • DoH
  • DNS
  • 5.0.0
이 글의 목차

노드는 쓸 수 있어 보이는데 사용자 지정 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 주소가 열려도 그 브라우저 요청의 결과만 알 수 있습니다. Stash가 DNS 쿼리를 성공적으로 보냈다는 증거가 아니며, 업스트림이 특정 HTTP 버전만 지원한다고 판단할 근거도 아닙니다.

실패한 단계부터 구분하기

보이는 증상먼저 확인할 내용
같은 사용자 지정 DoH만 실패하고, 사용 가능함을 확인한 다른 업스트림은 정상이다대상 업스트림의 프로토콜과 실제 쿼리 경로를 계속 확인한다
노드 자체의 도메인 이름을 확인할 수 없다proxy-server-nameserver와 초기 이름 확인 경로를 별도로 확인한다
연결 시간이 초과되거나 인증서 검증에 실패한다해당 업스트림의 네트워크, 주소, 인증서를 확인하고 HTTP/1.1 호환성 문제라고 바로 단정하지 않는다
웹페이지는 열리지만 새 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 앱 업데이트하기

같은 사본으로 업데이트 전후 비교하기

  1. 앱 버전과 원래 오류 기록하기

    실제로 실행 중인 네이티브 Stash Mac의 버전과 build를 확인하고 대상 DoH 주소, 관련 DNS 설정, 민감 정보를 제거한 오류를 보관하세요. 스토어 페이지, 구독 이름, 다른 기기의 버전만으로 판단하지 마세요.

  2. 정상 종료 후 네이티브 앱 업데이트하기

    먼저 현재 시스템과 라이선스가 대상 버전에 맞는지 확인하세요. 현재 네트워크를 중단해도 될 때 정상적인 절차로 앱을 중지하고 종료한 뒤, 네이티브 Mac 공식 업데이트 경로에서 5.0.0(607)의 수정을 받으세요. 업데이트할 수 없다면 아래 방법으로 먼저 작업 가능한 상태로 복구하세요. 원래 데이터와 구성은 보관하세요. 출처가 불분명한 구버전 패키지를 설치하거나, 앱 전체 업데이트 대신 코어 파일만 교체하지 마세요.

  3. 원래 테스트 구성 다시 선택하기

    다시 실행한 뒤 실제 버전과 build를 확인하고 저장한 테스트 사본을 선택해 원래 방식으로 시작하세요. 대상 DoH, 노드, 규칙은 동일하게 유지하세요. 구성 검증이나 앱 시작이 실패하면 해당 단계의 오류부터 처리하세요.

  4. 업데이트할 수 없으면 먼저 작업 가능한 상태로 복구하기

    먼저 원래 구성으로 전환하고, 자신이 이전에 정상 동작을 확인한 암호화 DNS 업스트림을 사용하세요. 실패 기록과 테스트 사본을 보관하고 업데이트할 수 있을 때 같은 비교를 다시 하세요. 업스트림을 임시로 바꿨다고 호환성 문제가 수정된 것은 아닙니다.

이 글에서 확인한 것은 5.0.0(607)의 공식 수정입니다. 나중에 다른 버전을 사용한다면 배포 경로와 같은 수정이 포함됐다는 근거를 확인하세요. 버전 숫자를 맞추려고 다운그레이드할 필요는 없습니다. 공식 경로에서 원하는 모든 과거 버전을 설치할 수 있다고 보장하지도 않습니다.

새 쿼리를 확인한 뒤 실제 접속 검증하기

Stash는 DNS 결과를 캐시합니다. 캐시가 만료된 뒤에도 이전 결과를 먼저 사용하면서 백그라운드에서 새로 고칠 수 있습니다. 이전 웹페이지가 열리거나, 지연 시간 테스트가 한 번 성공하거나, 일정 시간 기다렸다는 사실만으로 대상 DoH가 복구됐다고 판단할 수는 없습니다.

자신의 테스트 도메인과 접근이 허용된 로그 범위에서 새 DNS 쿼리가 실제로 발생했고 대상 DoH를 사용했는지 확인하세요. 서버 권한이 있다면 해당 업스트림의 요청 기록과도 대조할 수 있습니다. 새 쿼리나 실제 업스트림을 확인할 수 없다면 미검증으로 기록하고 성공한 결과를 만들어 내지 마세요. 이어서 해당 도메인을 필요로 하는 새 연결을 시작해 실제 웹페이지나 업무 서비스에 접속되는지 확인하세요.

이번 문제의 검증 체크리스트

  • 수정이 포함된 네이티브 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, 구독 주소, 비공개 도메인은 숨기세요. 원본 전체 기록은 자신의 복구용으로 보관하세요.

참고 자료