Windows Mihomo Party에서 TUN 모드 켜는 법과 권한 설정 가이드
TUN 모드와 시스템 프록시의 차이
Windows에서 Mihomo Party의 TUN 모드를 켜면 앱이 가상 네트워크 어댑터를 통해 운영체제의 네트워크 트래픽을 받아 Mihomo 코어로 전달합니다. 시스템 프록시 설정을 읽지 않는 프로그램이나 일부 게임·개발 도구도 이 경로를 사용할 수 있어, 브라우저만 프록시되고 다른 앱은 직접 연결되는 상황을 줄이는 데 도움이 됩니다.
시스템 프록시와 TUN은 같은 기능이 아닙니다. 시스템 프록시는 Windows 프록시 설정을 따르는 앱에 주소와 포트를 알려주는 방식이고, TUN은 가상 어댑터와 라우팅을 이용해 더 넓은 범위의 트래픽을 처리합니다. TUN을 켰다고 모든 연결이 자동으로 원하는 노드를 사용하는 것도 아닙니다. 연결은 여전히 현재 설정의 규칙, DNS 동작, 프록시 그룹 선택에 따라 처리됩니다.
아래 단계는 Windows 10·11에서 Mihomo Party를 사용하는 일반적인 흐름입니다. 메뉴 이름은 설치한 버전에 따라 달라질 수 있으므로, 화면에 표시되는 TUN, 서비스 모드, 권한 관련 항목을 기준으로 확인하세요. 설정을 바꾸기 전에 구독이나 사용자 지정 YAML을 백업해 두면 문제가 생겼을 때 복구하기 쉽습니다.
서비스 모드와 권한 준비
TUN 어댑터 생성이나 시스템 라우팅 변경에는 일반 앱 실행보다 높은 권한이 필요할 수 있습니다. Mihomo Party에서는 보통 설정 화면의 서비스 모드 또는 시스템 권한 관련 메뉴를 통해 필요한 서비스를 설치하거나 활성화합니다. 해당 항목이 표시된다면 상태가 설치됨·실행 중인지 확인하고, 설치나 변경 과정에서 Windows 사용자 계정 컨트롤 창이 나타나면 프로그램 출처를 확인한 뒤 승인하세요.
- Mihomo Party를 실행하고 현재 사용 중인 프로필이 정상적으로 로드되는지 확인합니다.
- 설정에서 서비스 모드 또는 시스템 권한 항목을 찾습니다. 아직 서비스가 설치되지 않았다면 화면의 설치 동작을 실행하고 관리자 권한 요청을 승인합니다.
- 서비스 상태가 실행 중인지 확인한 뒤 TUN 설정 화면으로 이동합니다. 상태가 갱신되지 않으면 앱을 완전히 종료하고 다시 실행합니다.
- Windows의 설정 변경을 방해할 수 있는 보안 프로그램이나 조직 관리 정책이 있는지 확인합니다. 회사·학교 기기에서는 서비스 설치가 정책상 제한될 수 있습니다.
매번 관리자 권한으로 앱을 실행하는 것보다 클라이언트가 제공하는 서비스 모드로 권한이 필요한 작업을 처리하는 편이 관리하기 쉽습니다. 서비스 모드 설치 메뉴가 보이지 않거나 설치가 실패한다면, 먼저 Mihomo Party와 코어가 최신 상태인지 확인하고 오류 로그의 권한 거부·서비스 시작 실패 메시지를 살펴보세요. 출처가 불분명한 드라이버나 별도 실행 파일을 임의로 설치하지 마세요.
Mihomo Party에서 TUN 켜기
권한 준비가 끝났다면 Mihomo Party의 설정 화면에서 TUN 항목을 찾아 활성화합니다. 버전에 따라 설정 화면의 분류나 토글 이름이 다를 수 있으므로, 특정 메뉴 경로가 보이지 않는다고 해서 설정 파일에 같은 이름의 값을 무조건 추가하지 마세요. 클라이언트가 관리하는 TUN 설정과 구독에서 내려오는 코어 설정은 별도로 적용될 수 있습니다.
- TUN 모드 스위치를 켭니다. 서비스 설치 또는 드라이버 초기화 안내가 다시 나타나면 완료될 때까지 기다립니다.
- 구성 옵션이 표시되면 먼저 기본값을 사용합니다. 모드나 스택을 선택할 수 있는 버전에서는 목적을 알고 있을 때만 변경하고, 변경 전 값을 기록해 둡니다.
- 설정을 적용한 다음 코어를 재시작하거나 클라이언트가 안내하는 재시작 절차를 따릅니다. 화면에 활성 상태가 표시되는지 확인합니다.
- 기존 시스템 프록시 설정과 다른 VPN의 자동 연결 기능을 함께 켜 두지 말고, 한 번에 하나의 트래픽 가로채기 경로만 테스트합니다.
실행 중 설정을 직접 편집하는 방식은 초보자에게 권장되지 않습니다. 구독 업데이트가 사용자 변경을 덮어쓸 수 있고, Mihomo 버전에 따라 지원 필드나 기본 동작이 달라질 수 있기 때문입니다. TUN이 켜지지 않을 때는 먼저 클라이언트의 설정 상태와 로그를 확인하고, YAML을 수정해야 한다면 원본을 복사한 뒤 실제 코어가 지원하는 필드인지 확인하세요.
mode: rule
log-level: info
위 코드는 규칙 모드와 일반 로그 수준을 보여 주는 예시일 뿐 TUN을 활성화하는 설정이 아닙니다. TUN 설정을 시험하려고 알지 못하는 키를 추가하면 코어가 설정을 거부하거나 기대하지 않은 동작을 할 수 있습니다.
어댑터와 연결 경로 테스트
TUN 스위치가 켜진 뒤에는 토글 상태만 보지 말고 Windows가 가상 어댑터를 인식하는지, 실제 앱의 연결이 Mihomo에 기록되는지 확인하세요. 관리자 권한이 필요 없는 PowerShell 창에서 아래 명령을 실행해 네트워크 어댑터의 상태를 확인할 수 있습니다.
Get-NetAdapter | Format-Table Name, Status, InterfaceDescription
목록에 가상 어댑터가 표시되는 이름은 설치 환경과 드라이버에 따라 다를 수 있습니다. 어댑터가 목록에 없거나 비활성 상태라면 Mihomo Party 로그에서 어댑터 생성 오류, 서비스 상태, 권한 거부 메시지를 확인합니다. 표시 이름만으로 특정 장치가 반드시 TUN이라고 단정하지 말고, TUN을 끄고 켰을 때 상태가 어떻게 바뀌는지도 비교하세요.
다음으로 연결 기록을 열어 새 요청이 나타나는지 확인합니다. 평소 사용하지 않던 웹사이트나 앱을 새로 실행해 테스트하고, 연결의 대상 도메인, 규칙, 선택된 정책 그룹을 살펴보세요. 연결이 기록되지만 직접 연결로 표시된다면 TUN 자체보다 규칙 순서나 프록시 그룹 선택이 원인일 수 있습니다. 반대로 어댑터는 활성인데 연결 기록이 전혀 늘지 않는다면 해당 앱이 기존 연결을 재사용하는지, 다른 VPN이나 네트워크 필터가 우선하는지 확인하세요.
- 일반 웹사이트만 확인하지 않기: 브라우저는 시스템 프록시를 별도로 사용할 수 있습니다. 브라우저 외의 앱도 새로 실행해 테스트합니다.
- 결과를 구분하기: 사이트 접속 실패와 Mihomo 로그에 연결 자체가 나타나지 않는 상황은 원인이 다릅니다.
- DNS도 함께 살펴보기: IP로는 연결되지만 도메인으로 실패한다면 DNS 설정이나 도메인 규칙을 따로 점검합니다.
- 변경은 한 번에 하나씩: 노드, DNS, TUN 옵션을 동시에 바꾸면 어느 변경이 결과에 영향을 줬는지 판단하기 어렵습니다.
어댑터 시작 실패와 VPN 충돌 점검
TUN을 켰는데 가상 어댑터가 만들어지지 않거나 네트워크가 끊기면 먼저 Mihomo Party 로그와 서비스 상태를 확인하세요. 코어 시작 실패, 권한 거부, 어댑터 생성 실패처럼 서로 다른 오류가 같은 현상으로 보일 수 있습니다. 문제 발생 시각과 로그의 첫 오류를 기록하면 반복해서 설정을 바꾸는 것보다 원인을 좁히기 쉽습니다.
- 서비스가 중지된 경우: 서비스 모드 상태를 확인하고 클라이언트를 재시작합니다. 설치 동작이 실패했다면 Windows 권한 요청과 보안 프로그램의 차단 기록을 확인합니다.
- 다른 VPN이 실행 중인 경우: 다른 VPN의 자동 연결과 가상 어댑터를 일시적으로 끈 뒤 TUN만 켜서 비교합니다. 두 프로그램이 기본 경로를 동시에 변경하면 트래픽이 예상하지 않은 어댑터로 흐를 수 있습니다.
- 가상화·보안 도구가 있는 경우: Hyper-V, 가상 머신 네트워크, 엔드포인트 보안 제품, 패킷 필터 드라이버가 네트워크 경로에 영향을 줄 수 있습니다. 관련 도구를 무작정 삭제하지 말고 하나씩 종료하거나 정책 담당자에게 확인합니다.
- 인터넷이 끊긴 경우: TUN을 끄고 연결이 복구되는지 확인합니다. 복구되면 라우팅 충돌이나 규칙·DNS 문제 가능성이 커집니다. 복구되지 않으면 Windows 네트워크 상태와 다른 어댑터도 점검합니다.
- 특정 앱만 실패하는 경우: 앱이 자체 DNS, 별도 VPN, 고정 프록시 또는 보안 연결을 사용하는지 확인합니다. Mihomo 연결 기록에 대상이 있는지 먼저 비교합니다.
원인을 확인할 때는 TUN을 끄고 네트워크가 정상으로 돌아오는지 시험한 다음, 다른 VPN을 종료하고 다시 켜는 식으로 한 단계씩 진행하세요. 문제가 해결되면 불필요한 설정 변경을 되돌리고, TUN을 사용하지 않을 때는 비활성화해 두는 것도 좋습니다. 로그를 다른 사람에게 전달해야 한다면 구독 주소, 서버 주소, 인증 정보와 개인 식별 정보가 포함되지 않도록 먼저 가리세요.