2026-07-27 · 고급 설정 · 약 9분·clashsupport.com
Windows 11에 Mihomo Party 설치하기|초보자용 시작 가이드
geoip.metadb와 geosite.dat는 GEOIP, RULE-SET geosite와 같은 지역 규칙이 제대로 매칭되는지를 좌우합니다. 이 글에서는 두 데이터베이스 파일이 각각 어떤 역할을 맡는지, 기본 저장 위치가 어디인지, geodata-mode와 geo-auto-update를 어떻게 설정하는지, 그리고 다운로드가 실패하거나 규칙이 계속 적용되지 않을 때의 점검 절차를 정리합니다.
이 가이드는 Windows 11에서 Mihomo Party를 처음 설치하는 사용자를 위한 시작 절차를 정리한 문서입니다. 프로그램을 준비하는 단계부터 첫 실행, 구독 설정, 시스템 프록시와 TUN 모드의 차이, 연결 테스트, 보안 경고와 실행 실패의 점검 순서까지 실제 화면에서 확인할 수 있는 항목을 기준으로 설명합니다.
설치 전에 확인할 준비 사항
Mihomo Party는 mihomo 코어를 사용하는 그래픽 클라이언트입니다. 따라서 프로그램만 설치한다고 바로 인터넷 연결이 바뀌는 것은 아닙니다. 클라이언트가 실행된 뒤 사용할 설정 파일이나 구독 주소가 필요하고, 실제 트래픽을 어떤 방식으로 Clash에 전달할지도 정해야 합니다. 설치 전에 이 두 가지를 준비하면 첫 실행 후 헤매는 시간을 줄일 수 있습니다.
- Windows 11 환경: 일반적인 64비트 PC라면 Windows x64 빌드를 선택합니다. ARM 기반 Windows 장치라면 배포 페이지에 ARM64 빌드가 제공되는지 별도로 확인해야 합니다.
- 구독 주소 또는 로컬 설정 파일: 서비스에서 발급한 구독 URL, 또는 직접 작성한
config.yaml이 필요합니다. 구독 주소는 비밀번호와 같은 민감한 정보이므로 공개 게시판이나 화면 캡처에 포함하지 않습니다. - 기존 프록시 프로그램: 다른 Clash 계열 클라이언트나 VPN 프로그램이 이미 실행 중이면 같은 포트를 차지할 수 있습니다. 설치 자체는 가능하지만 첫 연결 테스트에서는 충돌을 피하기 위해 잠시 종료하는 편이 좋습니다.
- 관리자 권한 여부: 일반적인 시스템 프록시 사용에는 관리자 권한이 항상 필요한 것은 아니지만, TUN 모드는 가상 네트워크 어댑터와 시스템 네트워크 설정을 변경하므로 Windows 권한 승인 창이 나타날 수 있습니다.
설치 파일은 검색 결과의 임의 다운로드 사이트나 수정 배포본보다 프로젝트가 안내하는 공식 배포 경로에서 받으세요. 파일명이 비슷하다는 이유만으로 실행 파일을 신뢰하지 말고, 배포 페이지의 운영체제와 아키텍처 표기를 먼저 확인하는 것이 안전합니다.
Windows 11에 Mihomo Party 설치하기
배포 방식은 버전에 따라 설치 프로그램 형태와 압축 아카이브 형태가 다를 수 있습니다. 화면의 파일 확장자와 안내 문구를 기준으로 진행하되, 핵심은 Windows용 실행 파일을 안정적인 폴더에 배치하는 것입니다.
- 공식 다운로드 페이지에서 Mihomo Party의 Windows 빌드를 엽니다.
- 대부분의 Intel 또는 AMD PC에서는 Windows x64 항목을 선택합니다. ARM64 장치가 아니라면 ARM64 파일을 선택하지 않는 것이 좋습니다.
.exe설치 파일을 받았다면 파일을 실행하고 설치 위치를 확인합니다. 압축 파일을 받았다면 다운로드 폴더에서 바로 실행하지 말고, 예를 들어C:\Apps\MihomoParty처럼 권한과 경로를 관리하기 쉬운 폴더에 압축을 풉니다.- Windows Defender 또는 SmartScreen 확인 창이 나타나면 게시자와 파일 출처를 다시 확인합니다. 출처가 확실한 파일이라면 추가 정보 화면에서 실행을 계속할 수 있지만, 출처가 불분명한 파일의 경고를 무조건 무시해서는 안 됩니다.
- 설치가 끝나면 시작 메뉴에서 Mihomo Party를 실행합니다. 압축형 배포본은 압축을 푼 폴더 안의 실행 파일에 바로 가기를 만들어 두면 다음 실행이 편리합니다.
설치 폴더를 Program Files 아래에 둘 경우 설정 파일이나 로그 저장 과정에서 쓰기 권한 문제가 생기는 배포본도 있습니다. 실행 후 설정이 저장되지 않거나 데이터 폴더 생성에 실패한다면 클라이언트를 종료한 다음 사용자 문서 또는 별도의 앱 폴더로 옮겨 다시 확인합니다. 단, 이미 사용 중인 설정과 코어 파일을 옮길 때는 경로가 바뀌므로 구독을 다시 불러와야 할 수 있습니다.
첫 실행 후 기본 화면 확인
첫 실행 화면에서는 보통 현재 연결 상태, 설정 프로필, 프록시 노드 또는 정책 그룹, 시스템 프록시와 TUN 관련 스위치를 확인할 수 있습니다. 표시 이름은 Mihomo Party 버전에 따라 조금씩 다를 수 있지만, 기능의 역할은 대체로 비슷합니다.
| 항목 | 역할 | 처음 확인할 내용 |
|---|---|---|
| Profiles 또는 설정 | 구독과 로컬 YAML을 관리 | 활성 프로필이 실제로 선택되어 있는지 확인 |
| Proxies | 노드와 정책 그룹을 선택 | 정책 그룹에 사용할 수 있는 노드가 표시되는지 확인 |
| System Proxy | Windows의 HTTP 프록시 설정을 변경 | 브라우저와 일반 데스크톱 앱을 전달할 때 사용 |
| TUN | 가상 네트워크 인터페이스로 더 넓은 트래픽을 인수 | 권한 승인과 DNS 설정을 함께 확인 |
| Logs | 코어의 시작과 연결 상태를 기록 | 포트 충돌, 설정 오류, DNS 오류를 점검 |
처음부터 System Proxy와 TUN을 동시에 켤 필요는 없습니다. 먼저 구독을 추가하고 노드 선택이 정상인지 확인한 다음, 브라우저 하나로 연결 테스트를 진행하는 순서가 안전합니다. 두 기능을 동시에 켜면 어떤 계층에서 문제가 생겼는지 구분하기 어려워질 수 있습니다.
구독 파일을 추가하고 노드 선택하기
Mihomo Party에서 구독을 추가할 때는 보통 프로필 관리 화면에서 URL을 등록합니다. 서비스 제공자가 안내한 구독 주소를 복사한 뒤 새 프로필 또는 원격 프로필 추가 메뉴에 붙여 넣고, 이름을 구분하기 쉽게 지정합니다. 주소 끝에 공백이나 줄바꿈이 들어가면 다운로드가 실패할 수 있으므로 복사 후 앞뒤 공백을 확인합니다.
- 프로필 관리 화면에서 원격 프로필 추가 항목을 엽니다.
- 구독 URL과 프로필 이름을 입력하고 저장합니다.
- 업데이트 또는 새로고침을 실행해 YAML 설정이 내려오는지 확인합니다.
- 다운로드가 끝나면 해당 프로필을 활성화합니다.
- 프록시 화면에서 정책 그룹을 열고 실제로 사용할 노드를 선택합니다.
구독이 추가됐는데 노드 목록이 비어 있다면 단순히 네트워크 문제라고 단정하지 마세요. 구독 서버가 만료됐거나, 제공된 주소가 Clash용 YAML이 아닌 다른 형식일 수 있습니다. 로그에서 HTTP 상태 코드, YAML 파싱 오류, 인증 실패와 관련된 문구를 확인하고 서비스 제공자가 안내한 클라이언트 형식과 일치하는지 살펴봅니다.
mixed-port: 7890
mode: rule
allow-lan: false
log-level: info
dns:
enable: true
위 내용은 구조를 이해하기 위한 간단한 설정 예시입니다. 실제 구독 설정을 이 예시로 덮어쓰라는 뜻은 아닙니다. 구독 제공자가 내려주는 mixed-port, DNS, 규칙, 프록시 그룹 설정을 임의로 삭제하면 정상적인 노드 선택이나 도메인 분기가 작동하지 않을 수 있습니다.
직접 해보기: Windows 연결 테스트
이제 기능을 한 번에 많이 켜지 말고 단계별로 테스트합니다. 아래 순서는 문제가 생겼을 때 원인을 좁히기 쉽도록 구성한 것입니다.
- 프로필을 활성화하고 프록시 정책 그룹에서 사용할 노드를 선택합니다.
- Mihomo Party가 실행 중인지 확인한 뒤 System Proxy를 켭니다. Windows 설정의 프록시 화면에 수동 프록시가 등록되는지 함께 확인합니다.
- 웹 브라우저를 새로 열고 일반적인 웹 페이지에 접속합니다. 기존에 열려 있던 연결은 프록시 적용 전 상태를 유지할 수 있으므로 새 탭이나 새 창을 사용하는 편이 좋습니다.
- 접속이 되면 Mihomo Party의 로그에서 해당 도메인 요청이 보이는지 확인합니다. 요청이 로그에 나타나고 선택한 정책 그룹으로 처리된다면 기본 전달 경로는 정상입니다.
- System Proxy 방식이 정상인 것을 확인한 뒤에도 일부 프로그램이 연결되지 않을 때만 TUN을 검토합니다. TUN을 켤 때 Windows 권한 승인 창이 나타나면 내용을 확인하고 허용합니다.
- TUN을 켠 뒤에는 기존 VPN, 다른 가상 네트워크 어댑터, 보안 프로그램의 네트워크 필터와 충돌하지 않는지 확인합니다.
System Proxy는 운영체제의 프록시 설정을 따르는 프로그램만 영향을 받습니다. 반면 TUN은 더 낮은 네트워크 계층에서 트래픽을 인수하므로 프록시 설정을 무시하는 애플리케이션도 처리할 가능성이 높습니다. 대신 DNS, 라우팅, 권한, 가상 어댑터와 관련된 변수도 늘어납니다. 따라서 초보자라면 먼저 System Proxy로 정상 동작을 확인한 뒤 필요한 경우에만 TUN을 추가하는 것이 좋습니다.
브라우저 접속 성공만으로 모든 프로그램이 정상이라고 판단하지 마세요. Mihomo Party 로그에 요청이 기록되는지, 선택한 정책 그룹이 맞는지, DNS 오류나 연결 시간 초과가 반복되지 않는지를 함께 확인해야 합니다.
보안 경고와 실행 실패가 발생했을 때
Windows 11에서 처음 실행할 때 SmartScreen 경고, 방화벽 허용 창, 관리자 권한 요청이 차례로 나타날 수 있습니다. 이 메시지들은 각각 의미가 다르므로 같은 방식으로 처리하면 안 됩니다.
- SmartScreen 경고: 파일을 어디에서 받았는지, Windows용 파일이 맞는지, 파일명이 배포 페이지와 일치하는지 먼저 확인합니다. 출처가 불명확하면 실행하지 말고 다시 공식 배포 경로에서 받습니다.
- Windows 방화벽 허용: 로컬 클라이언트가 프록시 포트를 열거나 TUN 구성 요소가 통신할 때 나타날 수 있습니다. 공용 네트워크와 개인 네트워크의 선택을 구분하고, 필요 이상으로 모든 네트워크에 허용하지 않습니다.
- 관리자 권한 요청: TUN 가상 어댑터 설치나 시스템 네트워크 변경에 필요할 수 있습니다. 요청이 반복되면서도 기능이 시작되지 않는다면 보안 프로그램이 드라이버 또는 네트워크 필터를 차단하는지 확인합니다.
- 실행 후 즉시 종료: 오래된 설정 파일, 손상된 캐시, 충돌하는 코어 프로세스, 설치 폴더 권한 문제를 순서대로 확인합니다. 작업 관리자에서 기존 Mihomo 또는 Clash 프로세스를 종료한 뒤 다시 실행합니다.
실행되지 않을 때 점검 순서
먼저 클라이언트를 완전히 종료하고 작업 관리자에서 관련 프로세스가 남아 있는지 확인합니다. 다음으로 설치 폴더를 쓰기 가능한 경로에 두고, 보안 프로그램의 격리 기록을 확인합니다. 프로그램은 열리지만 설정이 적용되지 않는다면 활성 프로필이 올바른지, YAML 문법 오류가 로그에 표시되는지 확인합니다. 특히 들여쓰기와 콜론 뒤의 공백은 YAML 해석에 영향을 줄 수 있습니다.
포트 충돌도 자주 발생합니다. 다른 Clash 클라이언트, 개발 도구, VPN이 이미 7890 또는 설정에 지정된 포트를 사용 중이면 Mihomo Party가 시작돼도 요청을 받지 못할 수 있습니다. 로그에 address already in use와 유사한 메시지가 있으면 충돌하는 프로그램을 종료하거나 포트를 바꾼 뒤 클라이언트를 재시작합니다.
설치 후 안정적으로 사용하는 방법
설치가 끝난 뒤에는 매번 TUN을 켜는 것보다 사용 목적에 맞는 전달 방식을 고정하는 것이 좋습니다. 브라우저와 대부분의 데스크톱 프로그램만 사용할 때는 System Proxy가 단순하고, 프록시 설정을 무시하는 프로그램까지 처리해야 할 때 TUN을 고려합니다. TUN을 사용할 경우 내부망 주소, 회사 네트워크, 프린터와 NAS 같은 로컬 장치가 규칙에 의해 우회되지 않는지 확인해야 합니다.
구독 업데이트는 서비스 제공자가 권장하는 간격을 따릅니다. 너무 짧은 간격으로 반복 업데이트하면 서버가 요청을 제한할 수 있고, 업데이트 직후 정책 그룹 이름이 바뀌어 기존 선택이 해제될 수도 있습니다. 업데이트 후에는 활성 프로필, 선택된 정책 그룹, System Proxy 또는 TUN 상태를 간단히 다시 확인합니다.
문제가 생겼을 때는 노드를 무작정 여러 번 바꾸기보다 다음 순서로 기록하는 편이 효과적입니다. 첫째, 문제가 발생한 앱과 시간입니다. 둘째, System Proxy와 TUN 중 어떤 방식이 켜져 있었는지입니다. 셋째, Mihomo Party 로그의 오류 문구와 대상 도메인입니다. 이 정보를 구분하면 구독 문제, 노드 문제, DNS 문제, Windows 네트워크 설정 문제를 훨씬 빠르게 나눌 수 있습니다.