Windows 11에 Mihomo Party 설치하기|다운로드부터 첫 연결까지

Mihomo Party는 Windows 11에서 Mihomo 코어를 그래픽 화면으로 관리할 수 있게 해 주는 Clash 계열 클라이언트입니다. 설치 파일을 실행하는 것만으로 끝나는 프로그램이 아니라, 로컬 프록시 포트와 구독 설정, 시스템 프록시 또는 TUN 모드를 함께 구성해야 실제 트래픽이 프록시를 통과합니다. 따라서 처음 설치할 때는 프로그램을 실행하는 순서보다 다운로드한 파일의 출처, Windows 권한, 구독 형식과 연결 확인 방법을 함께 이해하는 것이 중요합니다.

이 글에서는 Windows 11 기준으로 Mihomo Party를 준비하고 설치하는 과정부터 구독 등록, 기본 모드 선택, 첫 연결 확인까지 단계별로 설명합니다. 메뉴 이름이나 화면 배치는 버전에 따라 조금씩 달라질 수 있지만, 확인해야 할 핵심 항목은 대부분 같습니다. 기존에 다른 Clash 클라이언트를 사용했다면 새 프로그램을 먼저 정상적으로 실행한 뒤 기존 클라이언트의 시스템 프록시와 TUN을 끄는 방식으로 충돌도 예방할 수 있습니다.

설치 전에 확인할 Windows 11 환경

먼저 사용 중인 Windows 11이 일반적인 64비트 환경인지 확인하세요. 대부분의 최신 Windows 11 PC는 x64 아키텍처를 사용하지만, ARM 기반 노트북이나 가상 머신에서는 다운로드해야 할 설치 파일이 달라질 수 있습니다. 다운로드 페이지에서 운영체제 이름만 보지 말고 x64, arm64 또는 포터블 패키지처럼 아키텍처와 배포 형식을 함께 확인해야 합니다.

이미 Clash Verge, Clash Verge Rev, Clash for Windows 또는 다른 Mihomo 클라이언트를 실행하고 있다면 설치 전에 시스템 프록시와 TUN 모드를 끄는 것이 좋습니다. 두 프로그램이 동시에 같은 로컬 포트를 열려고 하면 포트 충돌이 발생하고, 한쪽의 시스템 프록시가 다른 쪽을 가리키는 상황도 생길 수 있습니다. 기존 프로그램을 바로 삭제할 필요는 없으며, 설정과 구독 주소를 백업한 뒤 일단 완전히 종료하면 충분합니다.

다운로드한 설치 파일은 이름만 보고 안전하다고 판단하지 마세요. 공식 배포 경로 또는 신뢰할 수 있는 프로젝트 배포 페이지에서 Windows용 파일을 받아야 합니다. 출처가 불분명한 재배포 파일은 악성 코드가 포함되거나 코어가 변조되었을 가능성이 있습니다. 설치 파일의 디지털 서명, 게시자 정보와 제공되는 해시값을 확인하고, 이메일이나 공개 게시판에 공유된 단축 링크를 통해 받는 방식은 피하는 편이 안전합니다.

Windows Defender가 처음 실행되는 파일을 경고할 수 있습니다. 이때 경고를 무조건 무시하기보다 파일의 출처와 서명을 먼저 다시 확인하세요. 출처가 확인되고 파일이 공식 배포본과 일치하는 경우에만 추가 정보를 열어 실행을 선택합니다. 조직에서 관리하는 PC라면 관리자 정책에 의해 네트워크 드라이버, 방화벽 규칙 또는 TUN 기능이 제한될 수 있으므로 개인 PC와 같은 결과가 나오지 않을 수 있습니다.

Windows용 Mihomo Party 다운로드와 설치

다운로드 페이지에서는 Windows 설치 패키지와 포터블 패키지가 함께 제공될 수 있습니다. 설치 패키지는 시작 메뉴 등록, 바탕 화면 바로 가기와 자동 실행 설정을 관리하기 편리합니다. 포터블 버전은 별도 설치 없이 압축을 풀어 실행할 수 있지만, 설정 파일과 프로그램 디렉터리를 직접 관리해야 하며 Windows 시작 시 자동 실행이나 권한 처리가 조금 더 번거로울 수 있습니다. 처음 사용하는 경우에는 Windows 11에 맞는 일반 설치 패키지를 선택하는 편이 이해하기 쉽습니다.

설치 파일을 실행하면 설치 위치와 바로 가기 생성 여부를 선택하게 됩니다. 특별한 이유가 없다면 기본 설치 위치를 사용해도 됩니다. 다만 회사 PC처럼 사용자 쓰기 권한이 제한된 환경에서는 설치가 중단되거나 설정 저장에 실패할 수 있습니다. 설치가 완료된 뒤에는 프로그램을 한 번 실행하고, Windows 작업 표시줄의 알림 영역에 Mihomo Party 아이콘이 나타나는지 확인하세요.

첫 실행에서 Windows 방화벽 허용 창이 표시될 수 있습니다. 로컬 컴퓨터에서만 시스템 프록시를 사용하는 경우 외부 네트워크에서 접근할 수 있도록 무조건 허용할 필요는 없습니다. LAN의 다른 기기에서 이 컴퓨터를 프록시로 사용할 계획이 없다면 공용 네트워크에서의 허용은 신중하게 판단하세요. allow-lan을 활성화하는 경우에도 방화벽 허용 범위와 실제 리스닝 주소를 함께 제한해야 합니다.

프로그램 정보 화면이나 코어 관리 화면에서 Mihomo 코어가 정상적으로 준비되었는지도 확인합니다. Mihomo Party는 화면을 제공하는 클라이언트이고 실제 규칙 매칭과 프록시 연결은 내부에서 실행되는 Mihomo 코어가 담당합니다. 코어가 설치되지 않았거나 실행에 실패하면 프로그램 창은 열려도 연결이 이루어지지 않을 수 있습니다. 시작 로그에 코어 초기화 완료, 설정 로드 완료와 로컬 포트 개방에 해당하는 메시지가 있는지 살펴보세요.

첫 실행에서 확인할 기본 설정

처음 화면에서는 연결 상태보다 먼저 로컬 포트와 실행 모드를 확인하는 것이 좋습니다. 데스크톱에서 일반 애플리케이션의 프록시를 받으려면 HTTP 포트, SOCKS 포트 또는 두 프로토콜을 함께 처리하는 혼합 포트가 필요합니다. 클라이언트가 표시하는 실제 포트 번호를 기준으로 사용해야 하며, 다른 문서에서 자주 보이는 기본값을 그대로 입력해서는 안 됩니다.

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

위 설정은 구조를 이해하기 위한 예시입니다. mixed-port가 7890이라는 뜻은 모든 Mihomo Party 설치에서 반드시 7890을 사용한다는 의미가 아닙니다. 설정 파일을 가져오거나 다른 프로그램과 포트가 겹치면 클라이언트가 포트를 변경할 수 있습니다. 시스템 프록시를 켠 뒤에도 인터넷이 되지 않으면 Windows 프록시 주소와 Mihomo Party의 현재 포트가 같은지 먼저 비교하세요.

rule 모드는 도메인과 IP, 규칙 제공자 등의 조건을 순서대로 검사해 DIRECT 또는 프록시 정책을 선택합니다. global 모드는 선택한 전역 정책을 모든 연결에 적용하는 방식이고, direct 모드는 가능한 연결을 직접 전송합니다. 처음에는 구독이 제공하는 규칙을 활용할 수 있는 rule 모드가 적합하지만, 특정 사이트가 예상과 다르게 연결될 때는 현재 모드와 실제 적용된 정책 그룹을 함께 확인해야 합니다.

DNS와 TUN은 설치 직후 모두 활성화해야 하는 기능이 아닙니다. 시스템 프록시만으로 필요한 프로그램이 동작한다면 먼저 그 방식으로 기본 연결을 확인하세요. TUN은 더 많은 애플리케이션의 트래픽을 가로챌 수 있지만, 관리자 권한, 가상 네트워크 어댑터와 DNS 경로에 영향을 줄 수 있습니다. 기본 연결이 확인된 뒤 필요한 경우에만 TUN을 켜고, 변경 전후의 로그와 네트워크 동작을 비교하는 것이 안전합니다.

구독 주소 등록과 설정 업데이트

Mihomo Party에서 사용할 구독 주소는 클라이언트가 제공하는 것이 아니라 서비스 제공자가 발급합니다. 구독 주소를 복사할 때 앞뒤에 공백이나 줄바꿈이 들어가지 않도록 주의하고, 일반 웹페이지 주소가 아니라 Clash 또는 Mihomo 형식의 설정을 반환하는 주소인지 확인하세요. 서비스에 따라 구독 링크가 전체 YAML을 반환할 수도 있고, 노드 목록만 반환한 뒤 클라이언트에서 정책 그룹을 생성하도록 구성될 수도 있습니다.

프로필 또는 설정 관리 화면에서 새 구독을 추가한 다음 이름과 URL을 입력하고 저장합니다. 이름은 여러 설정을 구분하기 위한 로컬 표시명일 뿐 실제 서버 설정을 바꾸지 않습니다. 저장 후에는 업데이트 버튼을 눌러 원격 데이터를 받아오고, 노드 목록과 정책 그룹이 화면에 표시되는지 확인하세요. 업데이트가 성공했다는 메시지만 있고 노드가 비어 있다면 반환 형식이 Mihomo Party가 기대하는 형식인지, 구독이 만료되지 않았는지, 응답에 로그인 HTML 페이지가 들어오지 않았는지 확인해야 합니다.

  1. 구독을 추가합니다. 프로필 관리 화면에서 새 프로필을 만들고 제공받은 구독 URL을 입력합니다.
  2. 한 번 업데이트합니다. 저장 직후 수동 업데이트를 실행해 응답과 파싱 결과를 확인합니다.
  3. 프로필을 활성화합니다. 목록에서 방금 받은 프로필을 현재 사용 설정으로 선택합니다.
  4. 정책 그룹을 선택합니다. 자동 선택, 수동 선택 또는 서비스가 제공한 기본 그룹에서 실제 노드를 지정합니다.
  5. 설정을 적용합니다. 코어 재시작이나 설정 적용 버튼이 있다면 실행하고 로그에 파싱 오류가 없는지 확인합니다.

구독 업데이트 때마다 직접 수정한 YAML이 덮어써질 수 있다는 점도 기억해야 합니다. 포트, DNS, 규칙을 지속적으로 변경하려면 원본 구독 파일을 직접 편집하기보다 클라이언트의 오버라이드, 병합 또는 전역 설정 기능을 사용하세요. 구독 주소가 외부에 노출되면 제공자가 접근 권한을 회수하거나 새 URL을 발급해야 할 수 있으므로, 설정 화면과 백업 파일의 접근 권한도 관리해야 합니다.

시스템 프록시를 켜고 첫 연결 확인하기

프로필과 정책 그룹이 준비되었다면 Mihomo Party의 시스템 프록시 스위치를 켭니다. Windows 11의 설정에서 프록시를 별도로 입력하는 방식과 클라이언트의 시스템 프록시 기능을 동시에 사용하면 주소가 서로 덮어써질 수 있으므로, 처음에는 한 가지 방식만 활성화하세요. 클라이언트 화면에 시스템 프록시가 켜졌다고 표시되어도 Windows 설정의 수동 프록시 주소와 포트가 실제로 바뀌었는지 확인하면 더 정확합니다.

첫 테스트는 너무 많은 사이트를 동시에 열기보다 간단한 HTTPS 페이지 하나로 진행하세요. Mihomo Party의 연결 기록에서 해당 도메인이 나타나고, 어떤 규칙에 매칭되었으며, 어떤 정책 그룹과 노드가 선택되었는지를 확인합니다. 연결 기록에 요청이 나타나지 않으면 브라우저가 다른 프록시나 VPN 확장 프로그램을 사용하고 있을 가능성이 있습니다. 반대로 요청은 나타나지만 DIRECT로 처리된다면 규칙 순서와 실행 모드를 점검해야 합니다.

증상 먼저 확인할 항목 가능한 원인
연결 기록이 없음 시스템 프록시 주소와 포트 브라우저가 다른 프록시 또는 VPN을 사용함
노드 선택 후 타임아웃 노드 상태와 연결 로그 노드 만료, 서버 응답 지연 또는 방화벽 차단
모든 요청이 DIRECT 실행 모드와 rules 순서 direct 모드이거나 앞선 규칙이 먼저 매칭됨
프로필이 비어 있음 구독 응답과 업데이트 시간 잘못된 URL, 만료된 구독 또는 지원하지 않는 형식

브라우저 테스트가 끝난 뒤에는 명령줄에서도 로컬 포트를 확인할 수 있습니다. Mihomo Party 화면에 표시된 포트가 7890이라고 가정하면 Windows PowerShell에서 다음처럼 요청을 보낼 수 있습니다.

curl.exe -I -x http://127.0.0.1:7890 https://example.com

이 명령은 시스템 프록시 설정을 거치지 않고 지정한 로컬 HTTP 프록시를 직접 사용합니다. 명시적 프록시 요청은 성공하지만 일반 브라우저만 실패한다면 Windows 시스템 프록시, 브라우저 확장 프로그램 또는 예외 목록을 확인하세요. 반대로 명시적 요청도 실패한다면 정책 그룹, 노드, 포트 리스닝 상태와 코어 로그를 먼저 살펴보는 편이 효율적입니다.

TUN 모드는 언제 켜야 하며 무엇을 주의해야 하나요?

시스템 프록시는 운영체제의 프록시 설정을 따르는 프로그램에 효과적이지만, 일부 게임, 개발 도구, 서비스 프로세스와 UDP 기반 애플리케이션은 이를 무시할 수 있습니다. 이런 프로그램까지 라우팅해야 한다면 Mihomo Party에서 TUN 모드를 검토할 수 있습니다. TUN은 가상 네트워크 인터페이스를 만들어 더 넓은 범위의 트래픽을 코어로 전달하는 방식이므로 단순한 스위치 하나보다 운영체제 네트워크 경로에 더 큰 영향을 줍니다.

TUN을 활성화하기 전에는 시스템 프록시와 기존 VPN 클라이언트, 다른 가상 네트워크 프로그램을 확인하세요. 여러 프로그램이 동시에 DNS와 라우팅을 제어하면 도메인 조회가 반복되거나 인터넷이 끊길 수 있습니다. Mihomo Party가 관리자 권한을 요구한다면 실행 파일을 무작정 관리자 모드로 고정하기보다, TUN 활성화 시 표시되는 권한 요청의 내용과 가상 어댑터 생성 여부를 확인하세요.

TUN을 켠 뒤에는 DNS 모드, 가상 IP 응답, IPv6 처리와 규칙 매칭 결과가 달라질 수 있습니다. 특정 앱이 갑자기 연결되지 않으면 TUN을 끄고 시스템 프록시만으로 같은 대상을 다시 테스트해 원인을 분리하세요. 문제가 해결되면 TUN 자체가 고장 났다고 단정하기보다 해당 앱의 UDP 사용 여부, DNS 예외와 방화벽 규칙을 단계적으로 점검해야 합니다.

설치 후 업데이트와 안정적인 사용 방법

Mihomo Party 본체 업데이트와 구독 업데이트는 서로 다른 작업입니다. 본체 업데이트는 클라이언트 UI와 포함된 Mihomo 코어, 네트워크 기능의 버전을 바꿀 수 있고, 구독 업데이트는 노드와 정책 설정 데이터를 새로 받습니다. 본체를 업데이트한 뒤에는 코어 버전과 기존 설정의 호환성을 확인하고, 구독을 갱신한 뒤에는 노드 수와 정책 그룹이 정상적으로 유지되는지 확인하세요.

업데이트 전에는 현재 활성 프로필의 이름, 사용자 지정 규칙, 포트와 TUN 상태를 기록해 두면 복구가 쉽습니다. 문제가 생겼을 때 프로그램을 여러 번 재설치하기보다 먼저 로그에서 YAML 파싱 오류, 포트 점유, DNS 실패, 인증 실패와 같은 핵심 문구를 구분하세요. 설정 백업은 평문 민감 정보가 포함될 수 있으므로 암호화된 저장 공간이나 접근이 제한된 개인 폴더에 보관하는 것이 좋습니다.

Windows 11이 절전 모드에서 복귀한 뒤 연결이 끊긴다면 노드를 즉시 바꾸기 전에 시스템 프록시 상태, Mihomo 코어 실행 상태와 로컬 포트 응답을 확인하세요. 네트워크가 변경되거나 Wi-Fi에서 유선으로 전환되면 기존 연결이 만료될 수 있습니다. 이때 프로필을 다시 다운로드하기보다는 코어 재시작, 시스템 프록시 재적용, 필요 시 TUN 재시작 순서로 간단한 조치를 먼저 시도하세요.

이제 Mihomo Party는 설치된 상태뿐 아니라 구독이 활성화되고, 정책 그룹이 선택되며, Windows 트래픽이 실제 로컬 포트로 들어오는 상태까지 확인되어야 정상적으로 사용할 수 있습니다. 플랫폼별 설치 파일과 기본 설정 절차가 필요하다면 클라이언트 보기와 사용법 확인에서 이어서 점검할 수 있습니다.

Clash 다운로드