Mihomo Party 사용법|구독 추가부터 프록시 노드 변경까지
Mihomo Party를 사용하는 전체 흐름 이해하기
Mihomo Party를 처음 실행하면 화면에 여러 설정과 노드가 표시되지만, 실제 사용 순서는 생각보다 단순합니다. 먼저 Mihomo 코어가 정상적으로 실행되는지 확인하고, 구독 주소를 추가해 설정을 가져온 다음, 프록시 그룹에서 사용할 노드를 선택합니다. 마지막으로 시스템 프록시 또는 TUN 모드를 켜서 애플리케이션 트래픽이 로컬 프록시 포트로 들어오게 하면 됩니다.
구독을 추가했다고 해서 모든 인터넷 연결이 자동으로 프록시를 사용하는 것은 아닙니다. 구독은 노드와 규칙, 정책 그룹을 가져오는 단계이고, 시스템 프록시는 운영체제의 프록시 설정을 변경하는 단계입니다. 또한 노드 목록이 정상적으로 표시되더라도 현재 선택된 정책 그룹이 DIRECT로 되어 있으면 해당 연결은 프록시 서버를 거치지 않습니다. 따라서 다음 세 가지 상태를 따로 확인해야 합니다.
- 코어 실행 상태: Mihomo 코어가 오류 없이 실행되고 로컬 포트를 열었는지 확인합니다.
- 설정 로드 상태: 구독 업데이트 후 노드, 프록시 그룹과 규칙이 정상적으로 표시되는지 확인합니다.
- 트래픽 전달 상태: 시스템 프록시나 TUN이 켜져 있고 선택한 정책 그룹이 실제 노드를 사용하는지 확인합니다.
구독 주소를 Mihomo Party에 추가하기
Mihomo Party를 설치하고 실행한 뒤 왼쪽 또는 상단 메뉴에서 프로필 관리 화면을 엽니다. 버전에 따라 메뉴 이름이 Profiles, 프로필 또는 配置처럼 다르게 표시될 수 있습니다. 프로필 화면에는 로컬 YAML 파일과 원격 구독을 추가하는 입력 영역이 있습니다. 서비스 제공자가 발급한 구독 URL을 복사한 다음 URL 입력란에 붙여 넣고 이름을 정해 저장하세요.
구독 URL은 일반 웹페이지 주소와 다릅니다. 주소에 긴 인증 문자열이나 사용자 식별 값이 포함되어 있을 수 있으므로 브라우저 주소창, 공개 게시물, 화면 공유 이미지에 그대로 노출하지 않는 것이 좋습니다. 구독 주소가 유출되면 다른 사람이 같은 계정의 노드 정보를 사용하거나 서비스 제공량을 소모할 수 있습니다. 이미 공개된 주소라면 제공 업체에서 새 구독 주소를 발급받는 편이 안전합니다.
프로필을 저장한 뒤에는 해당 항목을 선택하고 업데이트, Update 또는 새로고침 아이콘을 눌러 서버에서 최신 설정을 받아옵니다. 업데이트가 성공하면 노드 수, 마지막 업데이트 시간 또는 HTTP 상태가 표시됩니다. 일부 구독은 노드 목록만 반환하고, 일부는 proxy-groups와 rules까지 포함한 완전한 Mihomo 설정을 반환합니다. 따라서 업데이트 후 그룹이 바로 생성되지 않는다면 구독 자체가 손상되었다고 단정하지 말고 출력 형식을 확인해야 합니다.
| 화면에서 확인할 항목 | 정상적인 상태 | 문제 발생 시 의미 |
|---|---|---|
| 프로필 주소 | 저장된 URL이 잘리지 않고 표시됨 | 복사 과정에서 일부 문자가 빠졌거나 공백이 포함되었을 수 있음 |
| 업데이트 결과 | 성공 상태와 갱신 시간이 표시됨 | 주소 만료, 서버 오류, 네트워크 차단 가능성 |
| 노드 목록 | 여러 프록시 노드가 표시됨 | 구독 형식이 지원되지 않거나 변환이 필요한 상태 |
| 정책 그룹 | 자동 선택 또는 노드 선택 그룹이 생성됨 | 구독에 그룹이 없거나 설정 병합이 필요한 상태 |
업데이트 버튼을 눌렀는데 아무 반응이 없다면 먼저 URL 앞뒤에 공백이 없는지 확인하세요. 브라우저에서 주소를 열었을 때 로그인 페이지나 오류 문서가 반환되는 경우도 있습니다. Mihomo Party가 기대하는 것은 일반 HTML 페이지가 아니라 YAML 또는 호환 가능한 구독 데이터입니다.
프로필 활성화와 프록시 그룹 확인
프로필 목록에서 구독을 업데이트한 것과 실행 중인 설정으로 적용한 것은 서로 다른 작업일 수 있습니다. Mihomo Party의 버전에 따라 프로필 항목을 클릭하거나 활성화 버튼을 눌러 현재 설정으로 전환해야 합니다. 활성 프로필 표시가 바뀌었는지 확인한 뒤 대시보드나 프록시 메뉴로 이동하세요. 변경한 파일이 화면에 보이더라도 활성 프로필이 이전 설정이면 새 노드가 실제 연결에 사용되지 않습니다.
프록시 메뉴에는 보통 여러 정책 그룹이 카드나 목록 형태로 나타납니다. 가장 먼저 확인할 그룹은 규칙에서 기본 출구로 참조하는 그룹입니다. 이름은 Proxy, 节点选择, PROXY, 자동 선택 등 구독 제공자에 따라 다릅니다. 그룹 안에 노드가 표시되어야 하며, 현재 선택된 항목에는 체크 표시나 강조 상태가 나타납니다.
DIRECT는 프록시 서버를 사용하지 않고 대상 서버에 직접 연결하는 정책입니다. 연결 테스트를 위해 일시적으로 직접 연결을 선택할 수 있지만, 이 상태에서는 프록시가 작동하지 않는 것처럼 보일 수 있습니다. 반대로 REJECT가 선택되어 있으면 요청이 차단됩니다. 노드를 선택할 때는 이름만 보고 판단하지 말고 지연 시간 테스트 결과, 최근 연결 성공 여부와 서비스 목적을 함께 고려하세요.
mode: rule
proxy-groups:
- name: Proxy
type: select
proxies:
- Node-A
- Node-B
- DIRECT
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- MATCH,DIRECT
위 예시에서 example.com은 Proxy 그룹으로 전달되고, 앞선 규칙에 일치하지 않는 연결은 마지막 MATCH 규칙에 의해 직접 연결됩니다. 실제 구독의 그룹 이름과 규칙은 다를 수 있으므로 예시 이름을 그대로 입력하지 마세요. 규칙이 참조하는 그룹 이름과 프록시 그룹의 실제 이름이 한 글자라도 다르면 설정 로드 오류나 의도하지 않은 라우팅이 발생할 수 있습니다.
프록시 노드를 변경하고 연결을 확인하는 방법
노드를 바꾸려면 Mihomo Party의 Proxies 또는 프록시 화면에서 현재 트래픽이 들어가는 정책 그룹을 찾습니다. 해당 그룹을 열고 사용할 노드를 클릭하면 선택 상태가 즉시 바뀌거나, 버전에 따라 적용 버튼을 추가로 눌러야 합니다. 자동 선택 그룹을 사용하는 경우에는 직접 노드를 고르는 대신 URL 테스트 또는 지연 시간 테스트를 실행해 가장 적합한 노드를 자동으로 선택하도록 설정할 수 있습니다.
지연 시간은 노드와 테스트 서버 사이의 응답 시간을 측정한 값이지, 실제 모든 웹서비스의 다운로드 속도를 보장하는 수치는 아닙니다. 특정 노드가 80ms로 표시되어도 대상 서비스와의 경로, 서버 부하, 전송 대역폭에 따라 실제 속도는 느릴 수 있습니다. 반대로 지연 시간이 조금 높더라도 영상 재생이나 파일 다운로드가 안정적인 노드가 더 유용할 수 있습니다. 처음에는 가까운 지역의 노드 몇 개를 차례로 테스트하고, 연결 안정성과 속도를 함께 비교하세요.
노드 변경 후에는 브라우저에서 기존 탭을 새로고침하고, Mihomo Party의 연결 또는 로그 화면에서 새 요청이 어떤策略 그룹으로 처리되는지 확인합니다. 이미 연결된 TCP 세션이나 HTTP/3 연결은 기존 노드를 계속 사용할 수 있으므로, 확실한 비교가 필요하면 해당 탭을 닫고 새로 열거나 애플리케이션을 재시작하세요.
- 현재 규칙 모드가 활성화되어 있는지 확인합니다.
- 규칙에 연결된 정책 그룹을 엽니다.
- 새 노드를 선택하고 선택 표시가 바뀌었는지 확인합니다.
- 연결 기록에서 테스트 도메인의 규칙과 정책을 확인합니다.
- 필요하면 브라우저의 기존 연결을 종료한 뒤 다시 테스트합니다.
시스템 프록시와 TUN 모드 선택하기
데스크톱에서 브라우저와 일반적인 GUI 프로그램만 프록시로 연결하려면 시스템 프록시를 켜는 방법이 가장 간단합니다. Mihomo Party의 대시보드에서 System Proxy 또는 시스템 프록시 스위치를 활성화하면 운영체제의 HTTP 및 HTTPS 프록시 설정이 로컬 Mihomo 포트를 가리키도록 변경됩니다. 이 기능을 켠 뒤에는 운영체제 설정 화면에서 프록시 주소가 127.0.0.1 또는 localhost로 설정되고 포트 번호가 Mihomo Party의 현재 포트와 일치하는지 확인하세요.
시스템 프록시는 모든 프로그램을 강제로 가로채는 기능이 아닙니다. 프로그램이 운영체제 프록시 설정을 읽지 않거나 자체 프록시 설정을 사용하면 영향을 받지 않습니다. 터미널, 일부 게임, 가상 머신과 서비스 프로세스가 대표적인 예입니다. 이 경우 애플리케이션 내부 프록시 설정을 사용하거나 환경 변수, 별도 라우팅 설정을 추가해야 합니다.
TUN 모드는 가상 네트워크 인터페이스를 만들어 시스템 프록시를 지원하지 않는 애플리케이션의 트래픽까지 Mihomo 코어가 처리하도록 돕습니다. 다만 운영체제에 따라 관리자 권한이나 네트워크 확장 권한이 필요하고, DNS 동작과 기존 VPN·보안 프로그램의 충돌 가능성도 있습니다. 처음 사용하는 경우에는 시스템 프록시로 기본 연결을 확인한 뒤 TUN을 켜는 순서가 안전합니다.
| 방식 | 적합한 상황 | 주의할 점 |
|---|---|---|
| 시스템 프록시 | 브라우저, 메신저, 일반 데스크톱 앱 | 프록시 설정을 무시하는 프로그램에는 적용되지 않음 |
| TUN 모드 | 시스템 프록시를 지원하지 않는 앱과 전역적인 라우팅 | 권한, DNS, VPN 및 방화벽 충돌을 점검해야 함 |
| 애플리케이션별 설정 | 특정 프로그램만 프록시로 연결할 때 | HTTP, SOCKS5 주소와 포트를 프로그램별로 입력해야 함 |
시스템 프록시와 TUN을 동시에 사용할 때 문제가 발생하면 두 기능을 모두 켠 상태에서 원인을 추측하지 말고 하나씩 분리해 테스트하세요. 먼저 TUN을 끄고 시스템 프록시만 테스트한 다음, 정상적으로 연결되면 TUN을 다시 활성화합니다. 다른 VPN 클라이언트나 프록시 프로그램이 함께 실행 중이라면 하나를 종료하고 포트와 가상 인터페이스의 충돌 여부도 확인해야 합니다.
연결 실패와 설정 미적용 문제 점검
구독 업데이트가 실패하면 노드 선택보다 서버 응답과 주소 자체를 먼저 확인해야 합니다. 업데이트 결과에 시간 초과가 표시되면 현재 네트워크에서 구독 도메인에 접근할 수 없는 것일 수 있고, 인증 오류나 404가 표시되면 주소가 만료되었거나 서비스 측에서 경로를 변경했을 가능성이 있습니다. URL이 정상이어도 구독 서버가 HTML 안내 페이지를 반환하면 Mihomo Party는 유효한 설정으로 해석하지 못합니다.
프로필은 업데이트되었지만 노드가 보이지 않는다면 반환된 설정의 형식을 확인하세요. 노드 목록이 비어 있거나 그룹만 있고 구성원이 없다면 구독 변환 단계가 누락되었을 수 있습니다. 설정을 직접 수정할 때는 YAML 들여쓰기와 이름 참조를 확인하고, 구독으로 관리되는 파일을 편집한 경우 다음 업데이트에서 변경 사항이 덮어써질 수 있다는 점도 기억해야 합니다.
노드가 보이는데 연결되지 않는 경우에는 다음 순서로 점검하면 됩니다.
- 코어 상태: 대시보드와 로그에서 코어가 실행 중인지 확인합니다.
- 로컬 포트: 시스템 프록시가 현재 Mihomo Party가 실제로 열어 둔 포트를 가리키는지 확인합니다. 포트를 무조건
7890으로 가정하지 마세요. - 정책 선택: 사용 중인 그룹이 실제 노드를 선택했는지,
DIRECT나REJECT가 아닌지 확인합니다. - 규칙 결과: 연결 기록에서 대상 도메인에 적용된 규칙과 최종 정책을 확인합니다.
- DNS 및 TUN: 도메인 해석 실패나 TUN 권한 오류가 있는지 로그를 확인합니다.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
설정 예시의 포트와 실제 클라이언트 포트가 다르면 시스템 프록시가 켜져 있어도 연결되지 않습니다. 로컬 포트에 연결할 때 connection refused가 나오면 코어가 중지되었거나 다른 프로그램이 포트를 점유했을 가능성이 높습니다. 요청이 로그에 나타나지 않으면 애플리케이션이 Mihomo로 들어오지 않은 것이고, 요청은 보이지만 타임아웃이면 선택한 노드, 규칙, DNS 또는 원격 서버 상태를 더 자세히 살펴봐야 합니다.
문제를 해결한 뒤에는 설정을 한꺼번에 여러 개 바꾸지 않는 것이 좋습니다. 노드, 모드, DNS, TUN과 시스템 프록시를 동시에 변경하면 어떤 변경이 효과가 있었는지 알기 어렵습니다. 한 번에 한 항목만 바꾸고, 테스트 도메인과 결과를 기록하면 다음 장애에서도 같은 절차를 재사용할 수 있습니다.