1. 구독 업데이트 및 설정 적용 확인
먼저 현재 커널에서 어떤 설정 파일을 사용 중인지 확인하세요. 노드 목록이 보이는 것은 클라이언트가 마지막으로 성공적으로 불러온 내용을 보관하고 있기 때문일 수 있습니다. 구독 업데이트, 설정 적용, 커널 시작은 각각 별개의 단계입니다.
- 클라이언트의 설정 페이지에서 현재 활성화된 항목을 찾아 직접 업데이트하고, 업데이트 시간과 오류를 기록하세요. 항목이 활성화된 적이 없다면 업데이트에 성공해도 현재 연결에는 반영되지 않습니다.
- 업데이트 결과가 HTTP 401 또는 403이면 구독 주소와 계정 상태를 확인하고 서버에서 접근을 제한하는지도 살펴보세요. 404가 반환되면 주소가 변경되었는지 확인하세요. 이는 구독 요청의 결과이며 노드가 오프라인이라고 단정할 근거는 아닙니다.
- 다운로드는 완료됐지만 설정을 불러오지 못했다면 로그에서 첫 번째 파싱 오류를 확인하세요. 로그인 페이지나 오류 페이지가 반환되면 구독 주소를 수정하세요. 프로토콜 유형이나 필드 관련 오류라면 클라이언트에서 실제 사용하는 커널과 버전을 확인한 뒤 설정 요구사항과 비교하세요.
- 설정을 적용한 뒤 프록시 페이지에 예상한 노드와 정책 그룹이 표시되는지 확인하세요. 설정에서
proxy-providers를 사용해 노드를 별도로 가져오는 경우 해당 제공자의 업데이트 시간과 로그도 확인해야 합니다. 기본 설정 업데이트에 성공했다고 해서 제공자 목록까지 새로 받아온 것은 아닙니다.
2. 로컬 프록시 포트가 연결을 수신하는지 확인
먼저 앱이 로컬 커널에 연결되는지 확인하세요. mixed-port는 HTTP와 SOCKS가 함께 사용하는 로컬 프록시 진입점이며, 원격 노드의 포트가 아닙니다. 아래 예시에서는 7890을 사용합니다. 실제 테스트에서는 클라이언트에 적용된 설정을 확인하세요. 클라이언트가 구독 설정의 포트 값을 덮어쓸 수 있습니다.
mixed-port: 7890
allow-lan: false
먼저 포트가 연결을 수신하는지 확인한 다음 프록시 요청을 직접 보내세요
Windows PowerShell에서 포트가 연결을 수신하는지 확인하세요. OwningProcess 값을 작업 관리자의 '세부 정보' 탭에 있는 PID와 대조해, 다른 프록시 프로세스가 아니라 현재 클라이언트의 커널이 연결을 수신하는지 확인하세요.
Get-NetTCPConnection -State Listen -LocalPort 7890 |
Select-Object LocalAddress, LocalPort, OwningProcess
그다음 curl에서 로컬 HTTP 프록시를 명시적으로 지정해 요청을 보내세요. Windows에서는 아래의 curl.exe를 사용하고, macOS와 Linux에서는 명령어 이름을 curl로 바꾸면 됩니다. 연결 단계는 최대 5초, 전체 요청은 최대 15초까지 기다립니다. 이는 테스트용 설정이며 노드 속도 측정 결과가 아닙니다.
curl.exe -v --noproxy "" --proxy http://127.0.0.1:7890 --connect-timeout 5 --max-time 15 https://example.com/
- 로컬 포트 연결이 거부됨: 커널이 시작되었는지, 포트 번호가 올바른지, 수신 주소에 로컬 IPv4 루프백 주소가 포함되어 있는지 확인하세요. 시작 로그에 포트 사용 중이라고 표시되면 해당 포트를 사용하는 프로세스를 확인한 뒤 이전 인스턴스를 종료하거나 포트를 변경하세요. 포트를 바꾼 경우 시스템 프록시와 테스트 명령도 함께 업데이트해야 합니다.
- 로컬 연결은 수립됐지만 이후 요청 실패: 프록시 포트까지는 연결할 수 있습니다. 같은 시각의 커널 로그를 확인해 로컬 프록시 인증, 도메인 이름 확인, 규칙에 따른 차단, 아웃바운드 연결 시간 초과를 구분하세요.
- 대상 서버의 응답을 정상적으로 받음: 특정 노드까지 검증하려면 로그에서 실제로 해당 노드를 거쳤는지 확인해야 합니다.
DIRECT로 연결된 것은 아닌지 살펴보세요. 한 번의 성공으로 확인할 수 있는 것은 해당 요청이 통과한 경로뿐입니다.
3. 시스템 프록시, 앱별 프록시, TUN 구분
프록시를 명시한 요청은 성공하지만 브라우저에서 페이지를 열 수 없다면, 먼저 브라우저 요청이 커널로 전달되는지 확인하세요. 같은 대상에 접속하면서 연결 페이지나 로그에 같은 시각의 기록이 나타나는지 살펴보세요. 기록이 없다면 노드를 바꾸기 전에 프록시 진입점부터 확인하세요.
| 프록시 유형 | 확인 위치 | 확인 및 조치 방법 |
|---|---|---|
| Windows 11 시스템 프록시 | '설정' → '네트워크 및 인터넷' → '프록시' | 클라이언트에서 수동 시스템 프록시를 사용한다면 주소와 포트가 실제 수신 설정과 일치하는지 확인하고, 대상 주소가 프록시 제외 목록에 포함되어 있는지도 살펴보세요. |
| 앱별 프록시 설정 | 해당 앱의 네트워크 또는 프록시 설정 | 앱이 시스템 설정을 따르는지, 별도의 주소를 사용하는지 확인하세요. 앱에서 SOCKS를 별도로 설정했다면 SOCKS를 지원하는 포트를 사용해야 합니다. HTTP 전용 진입점을 그대로 사용하면 안 됩니다. |
| TUN 모드 | 클라이언트의 TUN 스위치 및 커널 시작 로그 | TUN을 활성화한 뒤에만 문제가 발생한다면 가상 인터페이스, 라우팅, DNS 가로채기가 제대로 작동하는지 확인하세요. 다른 VPN이 기본 경로를 동시에 변경하고 있지는 않은지도 살펴보세요. |
시스템 프록시는 해당 설정을 사용하는 앱에만 영향을 줍니다. TUN은 가상 인터페이스로 라우팅되는 트래픽을 처리하므로 시스템 프록시와 같은 기능이 아닙니다. 문제를 확인할 때는 한 번에 하나의 연결 방식만 전환하고 같은 대상을 다시 테스트하세요. 클라이언트 프록시 페이지의 노드 속도 측정은 보통 커널에서 요청을 보내므로 시스템 프록시가 꺼져 있어도 실행될 수 있습니다. 따라서 속도 측정 결과만으로 브라우저가 프록시에 연결됐다고 판단할 수 없습니다.
4. 노드 서버 DNS와 대상 사이트 DNS 구분
먼저 로그에서 어떤 도메인을 확인하지 못했는지 살펴보세요. 노드의 server 값이 도메인이라면 이름 확인에 실패할 경우 노드 자체에 연결할 수 없습니다. 접속 대상의 도메인 확인이 실패했다면 실제 라우팅 규칙과 프록시 프로토콜을 바탕으로 앱, 로컬 커널, 원격 서버 중 어디에서 이름을 확인하는지 파악해야 합니다.
커널에서 실제 사용하는 DNS 확인
다음은 mihomo DNS 설정 예시로, 각 필드의 역할을 설명합니다. nameserver는 일반적인 도메인 확인에 사용하고 proxy-server-nameserver는 노드 서버 도메인 전용으로 사용합니다. 예시에는 IP 주소 형식의 상위 DNS 서버를 사용했습니다. 현재 네트워크에서 해당 서버에 접근할 수 있을 때만 이 설정으로 문제를 진단할 수 있습니다. 설정을 바꾸기 전에 기존 설정을 백업하고, 현재 사용 중인 라우팅별 DNS 설정을 덮어쓰지 않도록 한 항목씩 테스트하세요.
dns:
enable: true
listen: 127.0.0.1:1053
nameserver:
- 1.1.1.1
proxy-server-nameserver:
- 223.5.5.5
시스템에 dig가 설치되어 있다면 예시의 수신 포트로 DNS 질의를 한 번 보내 보세요. 이 명령은 커널의 DNS 수신기가 해당 질의에 응답하는지만 확인합니다. 노드 서버 전용 상위 DNS는 확인하지 않으며 시스템 DNS 설정도 바꾸지 않습니다.
dig @127.0.0.1 -p 1053 example.com A +time=2 +tries=1
- 질의 시간 초과: 먼저 DNS 모듈이 실제로
127.0.0.1:1053에서 연결을 수신하는지 확인한 뒤 상위 DNS 서버에 접근할 수 있는지 살펴보세요. 서버를 지정하지 않고 시스템 DNS 질의만 실행하면 다른 DNS 경로를 테스트할 수 있습니다. - 질의에는 응답하지만 로그에 노드 도메인 확인 실패가 표시됨: 노드 주소의 철자와 현재 네트워크에서 노드 서버 전용 상위 DNS를 사용할 수 있는지 확인하세요. 대상 도메인을 조회할 수 있다는 사실만으로 이 문제를 해결할 수는 없습니다.
198.18.0.x와 같은 주소가 반환됨: fake-ip가 활성화되어 있고 주소가 설정된 fake-ip 대역에 속한다면, 도메인을 매핑하기 위한 가상 주소일 가능성이 높습니다. 이 주소에 ping을 보내 원격 노드의 온라인 여부를 판단하지 마세요.
5. 규칙 매칭 결과와 정책 그룹 선택 확인
요청을 받은 커널에서 당시 어떤 규칙이 매칭됐는지 확인한 다음, 해당 정책 그룹에서 실제로 무엇을 선택했는지 확인하세요. 규칙 모드에서는 설정된 순서대로 매칭되며, 먼저 일치한 규칙이 트래픽 경로를 결정합니다. DIRECT에 매칭된 요청은 원격 노드를 거치지 않고, REJECT에 매칭된 요청은 노드 연결 테스트에 사용할 수 없습니다.
예를 들어 현재 설정에 '수동 선택'이라는 정책 그룹이 있다면 아래처럼 구체적인 도메인 규칙을 기존 rules 목록에 임시로 추가할 수 있습니다. 해당 도메인보다 먼저 매칭될 수 있는 규칙 앞에 넣으세요. 최상위 rules를 새로 추가하거나 예시로 전체 규칙을 바꾸지 마세요.
- DOMAIN,example.com,수동 선택
해당 그룹에서 테스트할 노드를 하나 선택한 뒤 같은 요청을 다시 보내세요. 대상 도메인, 매칭된 규칙, 정책 그룹, 최종 노드를 기록합니다. 여전히 직접 연결로 표시되면 규칙 모드가 활성화되어 있는지, 그룹에서 DIRECT를 선택했는지, 요청이 더 앞에 있는 규칙과 매칭됐는지 확인하세요. 클라이언트 로그에 예상한 도메인이 표시되지 않는다면 앱이 IP 주소로 직접 접속했는지도 살펴보세요. 테스트가 끝나면 임시 규칙을 삭제하세요.
6. 같은 대상을 테스트해 특정 노드 및 속도 측정 문제 확인
요청이 테스트 대상 노드를 실제로 거친다는 것을 확인한 뒤에만 노드를 비교하세요. 기기, 네트워크, 대상 주소를 고정하고 같은 수동 선택 그룹에서 노드 A와 노드 B를 각각 테스트합니다. 노드를 바꿀 때마다 새 연결을 만들어 브라우저의 이전 연결을 재사용하지 않도록 하세요. 먼저 같은 네트워크에서 비교한 뒤, 필요하면 사용이 허용된 다른 네트워크에서 다시 테스트하세요.
| 확인된 결과 | 다음 단계 |
|---|---|
| A는 시간 초과, B는 같은 대상에 접속 가능 | A의 아웃바운드 오류를 확인하세요. 연결 시간 초과라면 서버 주소와 포트, 네트워크 경로부터 점검하세요. TLS 또는 인증 오류라면 구독에서 전달된 설정값, 기기 시간, 커널 호환성을 확인하세요. 인증서 검증을 끄는 방식으로 문제를 진단하지 마세요. |
| 속도 측정은 모두 실패했지만 확인된 노드를 통해 웹페이지에 접속 가능 | 속도 측정용 주소에 해당 노드로 접속할 수 있는지, 응답 상태가 설정 요구사항에 맞는지 따로 확인하세요. 속도 측정과 실제 서비스 접속은 대상이 다릅니다. 속도 측정 실패만으로 모든 노드가 오프라인이라고 판단할 수 없습니다. |
| 여러 노드가 같은 단계에서 모두 실패 | 공통으로 거치는 부분을 다시 확인하세요. 노드 도메인 확인, 공통 서버 주소나 포트, 현재 네트워크의 연결 조건을 점검합니다. 같은 오류가 반복되는 노드들을 각각 별개의 문제로 취급하지 마세요. |
문제 기록을 제출할 때는 오류 발생 시간, 커널 버전, 테스트 대상, 식별 정보를 삭제한 노드 표시, 같은 시각의 규칙 매칭 결과와 첫 번째 아웃바운드 오류를 포함하세요. 오류가 '로컬 연결', '도메인 확인', '원격 연결', '핸드셰이크' 중 어느 단계에서 발생했는지 적으면 '모든 노드 시간 초과'라고만 쓰는 것보다 문제를 찾기 쉽습니다.