연결 문제 해결 · Clash 기술 블로그

Clash Party를 쓰는 macOS에서 DNS가 223.5.5.5로 바뀌었다면?

Clash Party v2.0.3의 한 macOS 사용자는 시스템 기본 DNS를 선택해도 223.5.5.5가 나타난다고 보고했습니다. 이 글은 시스템 DNS 확인, 관련 모드 중지, 네트워크 설정 복원과 실패 시 되돌리기를 안내합니다.

  • Clash Party
  • macOS
  • 223.5.5.5
  • 시스템 DNS
  • Helper
이 글의 목차

시스템 DNS에 223.5.5.5가 나타나는 이유는?

Clash Party issue #2176은 macOS의 v2.0.3 사용자 한 명이 올린 보고입니다. 화면에서 시스템 기본 DNS를 선택해도 네트워크 서비스에 223.5.5.5가 나타났고, 수동으로 삭제해도 재시작 후 다시 나타났습니다. 유지관리자가 일반적인 결함으로 확인한 상태가 아니며, 이 문제의 확인된 수정 버전도 없습니다.

v2.0.3 소스에서 setPublicDNS()는 macOS에서 온라인 상태이고 originDNS가 비어 있을 때만 현재 네트워크 서비스 DNS를 읽은 뒤 223.5.5.5 쓰기를 시도합니다.

timeout을 지정하지 않은 이 쓰기 경로는 먼저 로컬 Helper에 요청하고, 실패할 때만 관리자 승인이 필요한 networksetup으로 전환합니다. timeout을 지정한 복원 호출은 이런 방식으로 전환하지 않습니다. 따라서 Helper가 시작할 때마다 무조건 DNS를 덮어쓴다고 단정할 수 없습니다.

같은 파일의 recoverDNS()는 originDNS가 남아 있으면 원래 값을 복원하려고 시도합니다. 화면의 '시스템 기본 DNS 사용' 옵션과 이 시스템 수준의 임시 DNS 경로는 별개의 근거입니다. 코어 DNS 옵션만 바꿨다고 macOS 네트워크 서비스가 복원됐다고 볼 수 없습니다.

이 글은 Clash Party를 쓰는 macOS에서 네트워크 서비스 DNS가 바뀐 경우, 특히 v2.0.3 보고와 비슷한 상황에만 적용됩니다. Windows, 공유기 DNS, 브라우저 DoH 또는 일반 프록시 노드 문제는 따로 진단해야 합니다. 223.5.5.5가 보인다고 Clash Party가 썼다고 바로 결론 내릴 수도 없습니다.

어느 네트워크 서비스의 DNS가 바뀌었는지 기록하기

macOS '시스템 설정 > 네트워크'에서 실제로 연결 중인 Wi-Fi 또는 이더넷 서비스를 고르고 '세부사항 > DNS'를 엽니다. Apple 문서에 따르면 이 화면에서 해당 네트워크 서비스의 DNS 서버와 검색 도메인을 확인할 수 있습니다. Clash Party의 코어 DNS 화면만 보지 마세요.

먼저 DNS 목록과 네트워크 서비스 이름, 회사나 집에서 설정한 사용자 지정 DNS가 있었는지, Clash Party 버전 및 TUN·Helper 상태를 캡처하거나 기록합니다. 원래 223.5.5.5를 직접 사용했거나 조직에서 관리하는 기기라면 이 주소를 이상 항목으로 간주해 바로 삭제하면 안 됩니다.

Clash Party를 열기 전후에 동일한 네트워크 서비스 목록을 비교하고, 앱을 종료한 뒤 다시 확인합니다. 현재 서비스에만 이 주소가 새로 생긴 경우에만 다음 절차로 진행하세요. Wi-Fi와 이더넷의 DNS는 다를 수 있으므로 네트워크를 바꾼 뒤에는 사용 중인 서비스를 다시 확인해야 합니다.

기존 설정을 잃지 않도록 기준 상태 남기기

  1. 현재 서비스 확인

    시스템 네트워크 설정에서 연결 중인 서비스가 Wi-Fi인지, 이더넷인지 또는 다른 서비스인지 확인합니다. 기본 이름을 추측하지 마세요.

  2. 기존 DNS 기록

    기존 서버와 검색 도메인을 기록합니다. 회사·학교 또는 사용자 지정 DNS라면 먼저 관리자에게 용도를 확인하세요.

  3. 한 번에 한 변수만 비교

    같은 네트워크에서 시작 전, 시작 후, 완전히 종료한 뒤의 DNS 목록을 비교합니다. 구독, 규칙, 시스템 프록시는 동시에 변경하지 않습니다.

예상치 못한 변경이 확인되면 안전하게 복원하기

먼저 Clash Party에서 TUN처럼 Helper가 필요한 네트워크 제어 기능을 끄고 앱을 완전히 종료합니다. TUN을 끄는 것은 변수만 줄일 뿐, 소스에 있는 시스템 DNS 경로가 다시 실행되지 않는다는 보장은 아닙니다. 종료 후에도 macOS 네트워크 설정을 확인하세요.

현재 네트워크 서비스에서 223.5.5.5만 예상치 않게 추가됐고 기존 설정을 기록했다면, Apple 공식 DNS 설정 화면에서 그 항목만 선택해 제거합니다. 원래 있던 회사 DNS, 검색 도메인이나 다른 서비스의 설정은 건드리지 마세요. 그 뒤 현재 네트워크 연결을 끊었다가 다시 연결하고, 해당 서비스의 DNS가 예상한 값으로 돌아왔는지 확인합니다.

원래 수동 DNS였다면 기록한 서버로 되돌리고, 네트워크에서 자동으로 제공받았다면 예상치 못한 수동 항목만 제거합니다. Apple의 networksetup 문서에는 지정한 서비스의 수동 DNS 항목을 비우는 방법도 있지만, 서비스 이름과 권한이 다를 때는 위험이 커집니다. 일반 사용자는 그래픽 설정 화면을 우선 사용하세요.

구성 프로파일이나 조직이 관리하는 설정이라는 안내가 나오면 수동 변경을 멈추고 관리자에게 문의하세요. DNS 이상을 고치겠다며 Clash Party 데이터 디렉터리, Helper 파일 또는 시스템 plist를 삭제하면 설정을 잃거나 장애 범위가 커질 수 있습니다. 이 글의 복구 절차에는 포함되지 않습니다.

변경을 최소화해 네트워크 서비스 복원

  1. 관련 모드 중지 후 종료

    TUN을 끄고 Clash Party를 완전히 종료해 앱이 네트워크를 계속 제어하지 않도록 합니다.

  2. 예상치 못한 주소만 제거

    실제로 연결된 서비스의 DNS 목록에서 비교를 통해 확인한 223.5.5.5만 삭제하고 다른 기존 값은 유지합니다.

  3. 네트워크 재연결

    현재 Wi-Fi 또는 이더넷에 다시 연결한 뒤 동일한 서비스의 DNS 화면에서 확인합니다.

  4. 정상 요청 확인

    TUN을 다시 켜지 않은 상태에서 평소 접속 가능한 HTTPS 사이트를 열어 도메인 확인과 페이지 로딩을 점검합니다.

복원 뒤 실제로 해결됐는지 확인하기

먼저 시스템 설정에서 해당 네트워크 서비스의 DNS가 기록한 원래 값으로 돌아왔고 실제 HTTPS 요청이 가능한지 확인합니다. 컴퓨터를 재시작하거나 같은 네트워크에 다시 연결한 뒤 한 번 더 확인하세요. Clash Party 코어에 '시스템 기본 DNS'가 표시되는 것만으로는 시스템 설정이 복원됐다고 볼 수 없습니다.

Clash Party를 계속 써야 한다면 TUN을 끈 채 앱을 시작하고 같은 서비스의 DNS가 다시 바뀌는지 관찰합니다. 시작하거나 Helper가 동작한 뒤에만 재발한다면 해당 모드 사용을 중단하고 정확한 순서를 기록하세요. DNS를 반복해서 되돌려 재발을 가리지 마세요.

DNS가 더는 바뀌지 않는데 웹페이지가 열리지 않으면 시스템 프록시, 현재 Profile, 노드와 브라우저 DoH를 확인하세요. 시스템 네트워크 서비스 DNS와 프록시 앱 내부의 DNS 분기는 서로 다른 계층이므로, 검사 사이트 한 곳의 주소만으로 복원 성공 여부를 판단할 수 없습니다.

복구 확인 체크리스트

  • 실제로 연결된 네트워크 서비스를 기록하고 확인했으며 기존 사용자 지정 DNS와 검색 도메인이 남아 있다
  • 예상치 못하게 추가된 223.5.5.5를 해당 서비스에서 제거했고 다시 연결한 뒤 목록이 예상과 일치한다
  • 클라이언트를 종료할 때와 다시 시작할 때의 DNS 변화를 모두 기록했다
  • 실제 HTTPS 사이트의 도메인을 확인하고 열 수 있으며 시스템 프록시와 TUN 상태가 현재 사용 방식과 일치한다
  • 주소가 다시 쓰였다면 관련 모드를 중지하고 로그를 보관했으며 문제가 해결됐다고 주장하지 않는다

앱을 종료해도 바뀐다면 다른 변경 주체 확인하기

Clash Party를 완전히 종료한 뒤에도 DNS가 바뀐다면 원인을 #2176으로 바로 돌릴 수 없습니다. 다른 VPN, DNS 필터, 기기 관리 설정 또는 오래된 클라이언트가 실행 중인지 확인하고 동일한 네트워크 서비스가 언제 바뀌는지 관찰하세요. 비교 근거를 잃지 않도록 여러 도구를 한꺼번에 제거하지 마세요.

Clash Party의 공식 macOS 문제 해결 문서에는 Helper 서비스 이름 party.mihomo.helper와 서비스 로그 위치가 나옵니다. 현재 설치에 속한 서비스임을 확인한 경우에만 관리자에게 프로젝트 문서에 따라 중지하도록 요청하고 DNS 변경이 멈추는지 관찰하세요. plist, 실행 파일 또는 데이터 디렉터리 전체를 직접 삭제하지 마세요.

상위 프로젝트에 제보하려면 macOS 버전, Clash Party의 전체 버전, 현재 네트워크 서비스, 시작 전후 DNS 목록, TUN 상태와 첫 관련 로그를 첨부하세요. 스크린샷이나 로그를 공개하기 전에 구독 URL, 노드 비밀번호, 기기 식별자와 개인 네트워크 정보를 가리세요.

Party 종료 후에도 DNS가 계속 바뀜

다른 네트워크 도구, 관리 설정과 Helper 상태를 확인하고 증거만 기록하며 원인을 단정하지 않습니다.

Party를 다시 시작한 뒤에만 223.5.5.5가 나타남

TUN을 끄거나 해당 클라이언트 사용을 잠시 중단하고 전후 비교 기록을 보관해 #2176에 제보합니다.

DNS 목록은 정상인데 웹페이지를 열 수 없음

시스템 프록시, Profile, 노드 또는 브라우저 DoH를 확인하고 네트워크 설정을 더 지우지 않습니다.

조직에서 DNS를 강제로 설정함

개인적인 변경을 멈추고 관리자에게 DNS 출처와 허용되는 프록시 모드를 확인받습니다.

복원에 실패했을 때 Mac 전체를 초기화하지 않고 되돌리기

223.5.5.5를 제거한 뒤 연결 상태가 나빠졌다면 네트워크 서비스의 DNS, 검색 도메인과 프록시 상태를 작업 전에 기록한 값으로 되돌리고 다시 연결합니다. 원래 설정이 회사나 학교에서 제공된 것이라면 관리자가 지정한 값으로 복원하세요. 공용 DNS 주소를 모든 네트워크에 통하는 해결책으로 취급하지 마세요.

Clash Party의 TUN을 끄고 DNS를 바꾸는 것으로 의심되는 모드는 당분간 사용하지 마세요. 임시 프록시가 필요하다면 시스템 DNS와 일반 연결이 복원됐음을 확인한 뒤에만 해당 Helper에 의존하지 않는 검증된 방법을 고려합니다. 기능을 하나씩 켤 때마다 시스템 DNS를 다시 확인하세요.

예전 버전이 정상처럼 보인다는 이유로 출처를 확인하지 않은 설치 파일로 되돌리지 마세요. 공식 macOS 설치 문제 문서에 있는 데이터 디렉터리 삭제 단계도 그대로 따라 하지 마세요. 현재 #2176에 대한 유지관리자의 수정 결론은 없으며, 이후에는 프로젝트 issue, Release 또는 커밋을 근거로 다시 판단해야 합니다.

실패했을 때 되돌리기 완료 기준

  • 기존 DNS, 검색 도메인과 시스템 프록시 설정을 사전 기록대로 복원했다
  • 현재 네트워크 서비스에서 실제 도메인 확인과 HTTPS 요청을 완료할 수 있다
  • DNS를 바꾼 것으로 의심되는 모드는 꺼져 있고 재시작 후에도 다시 쓰이지 않았다
  • 설정, 로그와 구독을 보관하고 공개 제보에는 민감 정보를 가린 사본을 사용했다
  • 복원을 위해 Helper, 시스템 plist 또는 앱 데이터 디렉터리 전체를 강제로 삭제하지 않았다

참고 자료