01 구독 설정 가져오기 및 활성화
핵심: 구독을 가져온 뒤에는 설정을 선택해 코어에 실제로 로드해야 합니다.시작하기 전에 서비스 제공자가 안내한 구독 URL 또는 현재 코어와 호환되는 YAML 설정 파일을 준비하세요. 클라이언트, 구독, 노드는 서로 다른 개념입니다. 클라이언트는 조작 화면을 제공하고, 구독은 설정 내용을 제공하며, 노드는 원격 연결 지점입니다. 클라이언트를 설치하는 것만으로 연결 가능한 노드가 생기지는 않으며, 구독을 가져오기 위해 시스템 네트워크 설정을 먼저 바꿀 필요도 없습니다.
원격 구독 추가
클라이언트를 열고 ‘설정’, ‘구독’ 또는 Profiles 페이지로 이동해 ‘새로 만들기’, ‘추가’, ‘URL에서 가져오기’ 메뉴를 찾으세요. 원격과 로컬 유형을 선택할 수 있다면 원격 설정을 고르고, 주소란에 구독 링크 전체를 붙여 넣습니다. ‘일상 설정’처럼 구분하기 쉬운 이름을 입력하세요. 붙여 넣은 뒤 URL 앞뒤에 공백이나 줄바꿈, 메신저가 덧붙인 문장 부호가 없는지 확인하고 저장 또는 가져오기를 누릅니다. 처음 다운로드할 때는 잠시 기다려야 할 수 있습니다. 완료되면 설정 카드나 구독 항목이 표시됩니다.
일부 서비스는 일반 구독, Clash 구독, 기타 형식의 URL을 따로 제공합니다. 현재 클라이언트 또는 mihomo 코어용으로 안내된 형식을 선택하세요. 다운로드가 완료됐는데 파싱 오류가 표시된다면 프록시 모드를 계속 바꾸지 마세요. 아직 설정을 가져오는 단계에서 발생한 문제입니다. 서비스 페이지에서 URL 유형을 확인하고 클라이언트가 표시한 오류 위치를 살펴보세요. 구독 서버가 로그인 페이지, 만료 안내 또는 다른 텍스트를 반환할 수도 있습니다. 브라우저에서 URL이 열리더라도 반환된 내용이 유효한 설정이라는 뜻은 아닙니다.
설정을 활성화하고 내용 확인
가져오기가 끝나면 해당 설정 카드의 활성화 버튼을 누르거나 클라이언트에서 선택 기능을 사용하세요. 현재 사용 중인 설정에는 보통 선택 표시가 나타납니다. 적용 또는 새로고침 버튼이 있으면 한 번 더 실행하세요. 그런 다음 ‘프록시’ 또는 정책 그룹 페이지에서 그룹과 선택 가능한 노드가 보이는지 확인합니다. 목록에 구독 이름만 있고 프록시 그룹이 없다면 연결 준비가 끝난 것이 아닙니다. 설정 페이지에서 올바른 파일을 선택했는지, 코어가 로드 오류를 보고하지 않았는지 확인하세요.
로컬 YAML 파일을 받았다면 같은 설정 페이지에서 파일 가져오기를 선택하고 저장한 뒤 활성화하세요. 로컬 파일은 원격 구독처럼 서버에서 정기적으로 업데이트되지 않는 경우가 많습니다. 노드 정보가 바뀌면 해당 설정을 다시 가져오거나 편집해야 합니다. 일반 노드 공유 링크를 완성된 YAML 파일처럼 사용하지 마세요. 단일 노드 가져오기를 지원하는지는 클라이언트마다 다릅니다. 형식이 호환되지 않으면 제공자에게 호환되는 형식을 요청하세요. 계정 정보가 포함된 URL을 신뢰할 수 없는 온라인 변환 도구에 입력하지 마세요.
이 단계의 완료 기준은 설정이 선택되어 있고, 코어에 설정 파싱 오류가 없으며, 프록시 페이지에 예상한 정책 그룹과 노드가 표시되는 것입니다. 아직 모든 네트워크 스위치를 켤 필요는 없습니다. 다음 단계에서 요청을 어떻게 분기할지 정하세요. 설정 덮어쓰기, 원격 업데이트, 로컬 수정의 관계는 설정 필드 참고에서 자세히 설명합니다.
02 프록시 모드와 출구 노드 선택
핵심: 처음 사용할 때는 규칙 모드를 선택한 뒤 실제 사용할 정책 그룹에 노드를 지정하세요.모드는 연결을 어떻게 분배할지 정하고, 노드 선택은 프록시 요청이 최종적으로 어디로 향할지 결정합니다. 서로 대체할 수 없는 설정입니다. 클라이언트 홈 화면이나 프록시 페이지에서 ‘모드’, ‘출구 모드’ 또는 Mode를 찾아 ‘규칙’ 또는 Rule을 선택하세요. 그런 다음 정책 그룹 목록으로 이동해 현재 설정에 포함된 선택 그룹을 찾고, 사용할 그룹을 펼쳐 노드를 선택합니다.
세 가지 모드의 차이부터 확인
규칙 모드는 설정에 정의된 순서대로 요청을 처리합니다. 일부 연결은 직접 연결하고 나머지는 지정된 정책 그룹으로 보내므로 일상적으로 사용하기 좋습니다. 전역 모드는 코어에 들어온 일반 프록시 요청을 전역 정책으로 보내며, 잠시 비교하거나 문제를 점검할 때 유용합니다. 이때도 전역 정책에서 출구를 선택해야 합니다. 직접 연결 모드는 원격 프록시 노드를 거치지 않고 대상에 바로 연결합니다. 여기서 ‘전역’은 트래픽 라우팅 범위를 켜는 설정이 아닙니다. 코어에 들어오지 않은 앱 트래픽은 전역 모드로 바꿔도 자동으로 코어에 전달되지 않습니다.
설정 파일에서 아래 항목을 확인할 수 있다면 각각 수신 포트, 프록시 모드, 로그 수준을 뜻합니다. 예시는 일반적인 필드 일부만 보여 주며, 노드와 트래픽 분기 규칙이 없으므로 현재 사용하는 구독 설정 전체를 대체할 수 없습니다. 처음 설정할 때는 들여쓰기 구조를 잘 모른 채 파일을 직접 수정하기보다 화면의 모드 버튼을 사용하세요.
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info올바른 정책 그룹에서 노드 선택
구독에는 기본 프록시, 미디어 서비스, 자동 선택 등 용도별 정책 그룹이 여러 개 포함될 수 있습니다. 그룹 이름은 설정 작성자가 정하므로 모든 클라이언트에 공통으로 적용되는 고정 이름은 없습니다. 기본 프록시에 해당하는 선택 그룹을 찾아 펼친 뒤 노드를 선택하세요. 그룹 안에 다른 정책 그룹이 보이면 최종 출구를 확인할 수 있을 때까지 계속 펼칩니다. 이름이 눈에 띄는 그룹 하나만 바꾸면 모든 요청에 적용된다고 생각하지 마세요. 실제로 어떤 그룹을 사용할지는 요청에 적용된 규칙에 따라 달라집니다.
노드 옆의 테스트 버튼은 보통 지정된 주소로 탐색 요청을 보내 연결 상태를 빠르게 확인합니다. 테스트에 응답이 와도 모든 사이트에 접속할 수 있다는 뜻은 아니며, 시간 초과는 테스트 주소나 로컬 네트워크 문제일 수도 있습니다. 처음 설정할 때는 테스트가 정상적으로 끝나는 노드 하나만 선택해 확인하면 됩니다. 자동 선택 주기, 부하 분산, 앱별 정책을 한꺼번에 바꿀 필요는 없습니다. 자동 그룹에서 노드를 직접 선택할 수 없다면 그룹 유형에 따른 동작입니다. 설정에 이미 포함된 수동 선택 그룹을 사용하세요.
설정 후 모드가 규칙으로 유지되고 관련 정책 그룹에 출구가 명확히 선택됐는지 확인하세요. 이제 설정은 ‘어디로 보낼지’를 알고 있지만, 브라우저나 다른 앱의 요청이 아직 클라이언트에 전달되지 않았을 수 있습니다. 다음 단계에서 트래픽 라우팅을 활성화해야 합니다. 모드, 중첩 정책 그룹, 규칙 참조 관계는 mode 필드 설명을 참고하세요. 모드 선택 관련 질문은 FAQ에서 확인할 수 있습니다.
03 코어를 실행하고 앱 트래픽 라우팅
핵심: 코어 실행, 설정 로드, 앱 트래픽의 코어 유입이 모두 충족돼야 연결을 시작할 수 있습니다.클라이언트 홈 화면으로 돌아가 현재 설정이 방금 가져온 파일인지, 코어가 실행 중인지 확인하세요. 데스크톱 클라이언트 중에는 창을 열면 코어가 자동으로 시작되는 경우도 있고, 시작 버튼을 눌러야 하는 경우도 있습니다. 창이 열려 있다는 이유만으로 코어가 실행 중이라고 판단하지 마세요. 시작 오류가 표시되면 로그에서 포트 충돌이나 설정 로드 오류를 먼저 확인하고, 문제를 해결한 뒤 시스템 프록시를 켜세요.
데스크톱에서는 먼저 시스템 프록시로 브라우저 테스트
‘시스템 프록시’ 또는 ‘시스템 프록시로 설정’ 스위치를 찾아 켜세요. 시스템 프록시 설정을 따르는 브라우저 대부분은 새 요청을 클라이언트의 로컬 수신 포트로 보냅니다. 처음 확인할 때는 기존 탭을 닫고 웹페이지를 새로 열어 기존 연결이나 페이지 캐시의 영향을 줄이세요. 브라우저 프록시를 변경하는 다른 확장 프로그램은 잠시 끄고, 프록시 클라이언트를 여러 개 동시에 실행하지 마세요. 실제 요청이 현재 클라이언트에 표시된 주소와 다른 곳을 사용할 수 있습니다.
시스템 프록시만으로도 처음 브라우저 연결을 확인하기에는 대체로 충분하지만, 모든 프로그램의 트래픽을 강제로 전달하는 기능은 아닙니다. 명령줄 도구, 일부 게임, 네트워크 연결을 직접 관리하는 프로그램은 시스템 프록시를 무시할 수 있습니다. 브라우저는 정상인데 터미널에서 연결되지 않는다고 해서 구독이나 노드에 문제가 있다고 단정할 수는 없습니다. 먼저 브라우저 확인을 마치세요. 이런 프로그램까지 연결해야 한다면 앱별로 별도 프록시를 설정하거나 클라이언트의 TUN 기능을 검토하세요. 프로그램 하나를 연결하려고 여러 네트워크 옵션을 한꺼번에 바꾸지 마세요.
모바일에서 시스템 VPN 권한 확인
모바일 클라이언트는 보통 홈 화면에 연결 버튼을 제공합니다. 버튼을 누른 뒤 VPN 연결을 허용하거나 VPN 구성을 추가할지 시스템에서 묻는다면, 방금 설치한 클라이언트가 요청한 것이 맞는지 확인한 후 허용하세요. 클라이언트로 돌아와 연결 상태를 확인하고, 다른 VPN 앱이 시스템 연결을 차지하고 있지 않은지 살펴보세요. 시스템에 VPN 표시가 나타나는 것은 네트워크 인터페이스가 만들어졌다는 뜻일 뿐, 원격 노드를 사용할 수 있다는 뜻은 아닙니다. 다음 단계에서 실제 요청으로 확인해야 합니다. 앱별 프록시를 지원하는 클라이언트라면 테스트할 브라우저가 라우팅 대상에 포함됐는지도 확인하세요.
처음 연결할 때는 TUN을 함께 사용하지 마세요
TUN은 가상 네트워크 인터페이스로 트래픽을 라우팅하며 서비스 설치, 관리자 권한, 라우팅 및 DNS 설정이 필요할 수 있습니다. 시스템 프록시를 따르지 않는 프로그램까지 연결해야 할 때만 클라이언트 안내에 따라 활성화하세요. 모바일에서 같은 이름의 스위치가 표시되는지는 구현 방식에 따라 다릅니다. 데스크톱에서 처음 테스트할 때는 시스템 프록시만 켜고 작동을 확인한 다음 TUN을 따로 테스트하세요. 문제가 생겼을 때 여러 라우팅 경로를 동시에 점검하지 않아도 됩니다.
로그에 수신 포트 충돌이 표시되면 이전 프록시 프로세스를 종료하거나 클라이언트에서 지원하는 설정 메뉴를 통해 수신 포트를 바꾸세요. 앱에 프록시 주소를 직접 입력한다면 주소와 포트가 현재 클라이언트 설정과 일치해야 합니다. 예시의 포트를 그대로 복사하지 마세요. 로컬에서만 사용할 때는 LAN 공유를 켤 필요가 없습니다. 다른 기기에서 접속하도록 공유하려면 수신 주소와 접근 제어를 설정해야 하며, 이는 이후 단계에서 다룰 내용입니다. 연결을 시작한 뒤에는 현재 설정을 그대로 유지하고 마지막 단계에서 요청이 실제로 어떤 경로를 거쳤는지 확인하세요.
04 연결 경로와 규칙 적용 확인
핵심: 웹페이지가 열린 것만으로는 충분하지 않습니다. 연결 기록에서 대상, 정책, 출구를 확인하세요.클라이언트에서 ‘연결’ 또는 Connections 페이지를 열어 둔 상태로 브라우저에서 확인할 사이트에 접속하세요. 연결 페이지로 돌아와 방금 생성된 요청을 찾고, 목록이 움직였는지만 보지 말고 대상 도메인을 확인하세요. 일부 요청은 금방 끝날 수 있으므로 클라이언트에서 지원한다면 최근 연결을 확인하거나 로그를 함께 열고 페이지를 새로고침하세요.
코어에 들어온 요청과 프록시를 거친 요청 구분
대상 요청을 찾으면 적용된 규칙, 정책 그룹, 최종 출구를 확인하세요. 직접 연결로 표시된다면 요청은 코어에 들어왔지만 현재 규칙에 따라 직접 연결됐을 수 있습니다. 이는 트래픽이 전혀 라우팅되지 않은 경우와 다릅니다. 연결 경로에 선택한 정책 그룹과 노드가 표시되어야 해당 요청이 지정된 프록시 경로를 사용했다고 볼 수 있습니다. 한 페이지에서 여러 도메인을 요청하므로 일부는 직접 연결되고 일부는 프록시를 거칠 수 있습니다. 모든 항목에 같은 노드가 표시될 필요는 없습니다.
출구 IP를 표시하는 웹사이트는 참고 자료로 사용할 수 있지만, 한 번의 결과만으로 연결 기록을 대신할 수는 없습니다. 웹사이트가 IP 주소 종류별로 다른 결과를 보여 줄 수 있고, 브라우저 캐시나 다른 네트워크 확장 프로그램도 판단에 영향을 줍니다. 먼저 요청이 지정한 노드를 실제로 거쳤는지 확인한 뒤 출구 IP 변화를 살펴보세요. 내장 노드 테스트, 시스템 VPN 아이콘, 스위치 색상은 각각 일부 상태만 보여 줄 뿐, 연결 전체가 정상 작동한다고 단독으로 증명하지는 않습니다.
필요하면 모드를 한 번 비교 테스트
규칙 모드에서 특정 대상에 접속할 수 없다면 잠시 전역 모드로 바꾸고 전역 정책에서 방금 테스트한 노드를 직접 선택한 뒤 같은 요청을 다시 보내세요. 전역 모드에서는 정상이고 규칙 모드에서 실패한다면 적용된 규칙과 해당 정책 그룹의 선택을 먼저 확인하세요. 두 모드 모두 실패한다면 노드, 로컬 네트워크, DNS를 점검하세요. 테스트를 마친 뒤에는 규칙 모드로 되돌려 임시 점검 설정이 일상 설정으로 남지 않도록 하세요. 전역 모드로 바꿔도 사용할 수 없는 노드가 복구되지는 않으며, 트래픽 라우팅을 대신할 수도 없습니다.
터미널 테스트에서 로컬 프록시 명시
명령줄에서 테스트할 때는 터미널이 시스템 프록시를 읽는지에 의존하지 않도록 클라이언트의 수신 주소를 직접 지정할 수 있습니다. 아래 명령은 클라이언트가 로컬 혼합 프록시 포트 7890에서 실제로 수신 중인 경우에만 사용할 수 있습니다. 포트가 다르면 먼저 설정 페이지에 표시된 값으로 바꾸세요. 예시 도메인은 요청이 완료되는지 확인하기 위한 것이며, 모든 네트워크에서 반드시 프록시를 거쳐야 하는 도메인은 아닙니다. 출구는 연결 기록과 함께 확인하세요.
curl -I --proxy http://127.0.0.1:7890 https://example.comHTTP 응답을 받았다면 대체로 대상 서버와의 통신이 완료된 것입니다. 다만 상태 코드의 의미는 대상 사이트에 따라 달라질 수 있습니다. 로컬 프록시 포트에 연결할 수 없다는 오류가 표시되면 원격 노드를 바꾸기보다 코어 실행 상태와 수신 주소를 먼저 확인하세요. 클라이언트가 요청을 받은 뒤 연결 시간 초과를 보고한다면 로그를 확인해 노드나 원격 연결 경로를 점검하세요. 로그를 공유할 때는 구독 URL, 인증 정보, 공개할 필요가 없는 접속 대상을 삭제하세요.
증상에 따라 마무리하고 여러 설정을 연달아 바꾸지 마세요
대상 연결 기록이 전혀 없다면 세 번째 단계에서 트래픽 라우팅 범위, 브라우저 프록시, 클라이언트 실행 상태를 다시 확인하세요. 요청 기록은 있지만 규칙이 잘못된 그룹을 가리킨다면 두 번째 단계의 모드와 그룹 선택을 점검합니다. 올바른 출구가 표시되는데 연결에 실패한다면 노드 상태, 시스템 시간, 네트워크 환경을 확인하세요. 도메인 해석 오류가 발생하면 오류 문구를 먼저 기록하고 DNS 변경, TUN 활성화, 전체 설정 업데이트를 한꺼번에 진행하지 마세요. 한 번에 하나씩 바꾸고 같은 대상으로 다시 테스트해야 변경 전후를 비교할 수 있습니다.
첫 설정은 구독 설정이 활성화되고, 모드와 정책이 명확히 선택되며, 테스트할 앱의 트래픽이 코어에 들어오고, 대상 요청이 예상한 경로를 한 번 이상 거치면 완료된 것입니다. 확인이 끝난 뒤에 부팅 시 실행, 자동 업데이트, 앱별 규칙을 설정하고 현재 설정 이름과 트래픽 라우팅 방식을 기록해 두세요. 이후 YAML을 자세히 조정하려면 설정 필드 참고에서 항목별로 확인하세요. 특정 문제만 해결하려면 전체 설치 절차를 다시 진행하지 말고 FAQ에서 증상에 맞는 내용을 찾아보세요.