mihomo
mihomo는 Clash.Meta 프로젝트를 이어받은 프록시 커널로, 설정을 읽고 로컬 연결을 수신하며 규칙을 매칭하고 아웃바운드 연결을 처리합니다. Clash Verge Rev 같은 클라이언트는 조작 인터페이스를 제공하고 실제 네트워크 처리는 커널이 담당합니다. 설정 호환성을 진단할 때는 클라이언트 버전과 커널 버전을 구분해야 합니다. 인터페이스에 옵션이 표시되더라도 실제 동작은 커널의 구현에 따라 달라집니다.
설정 참고 / macOS
시스템 프록시는 어떤 앱의 연결을 커널에 전달할지 결정하고, 규칙 기반 라우팅은 전달된 연결이 어떤 경로를 이용할지 결정합니다. 항목별 설정, 설정 필드, 로그 용어를 확인해 보세요.
인터페이스, 커널, 원격 연결을 구분하세요.
mihomo는 Clash.Meta 프로젝트를 이어받은 프록시 커널로, 설정을 읽고 로컬 연결을 수신하며 규칙을 매칭하고 아웃바운드 연결을 처리합니다. Clash Verge Rev 같은 클라이언트는 조작 인터페이스를 제공하고 실제 네트워크 처리는 커널이 담당합니다. 설정 호환성을 진단할 때는 클라이언트 버전과 커널 버전을 구분해야 합니다. 인터페이스에 옵션이 표시되더라도 실제 동작은 커널의 구현에 따라 달라집니다.
프록시 프로토콜은 Shadowsocks, Trojan처럼 연결 설정, 인증, 데이터 전송 방식을 정합니다. 노드를 설정할 때는 프로토콜과 매개변수가 서버와 일치해야 합니다. 서버 주소와 포트만으로는 연결할 수 없습니다. 브라우저가 로컬 프록시에 접속할 때 사용하는 HTTP 또는 SOCKS5 인바운드 프로토콜과 커널이 원격 노드에 연결할 때 사용하는 프로토콜은 서로 다른 설정입니다.
노드는 설정에 정의된 프록시 아웃바운드 항목으로, 일반적으로 이름, 프로토콜, 서버 주소, 포트, 연결 매개변수를 포함합니다. 프록시 그룹에는 여러 노드나 직접 연결 같은 다른 정책을 넣을 수 있습니다. 같은 지역 이름으로 표시되는 노드라도 프로토콜이나 경로가 다를 수 있습니다. 노드를 바꾼 뒤에는 문제가 발생한 앱에서 다시 확인해 보세요.
클라이언트에 표시되는 노드 지연 시간은 보통 해당 노드로 지정된 테스트 주소에 접속해 측정한 값이며, 단위는 밀리초입니다. 테스트 주소, 측정 시점, 연결 상태가 달라지면 값도 바뀔 수 있습니다. 지연 시간이 짧다고 대역폭이 높은 것은 아닙니다. 파일 다운로드가 느리다면 한 번의 측정값보다 실제 전송 속도를 확인하세요.
먼저 연결이 커널에 전달되는 방식을 확인하고, 다음으로 커널의 처리 방식을 살펴보세요.
시스템 프록시를 켜면 Clash 클라이언트가 macOS 네트워크 프록시 설정에 로컬 프록시 주소와 포트를 등록합니다. 해당 설정을 읽고 따르는 앱만 지원되는 요청을 커널에 전달하며, 직접 연결을 설정하는 프로그램에는 적용되지 않을 수 있습니다. 브라우저는 정상인데 터미널에서 연결되지 않는다면 먼저 명령줄 도구가 시스템 설정을 읽는지 확인한 뒤, 필요하면 별도로 프록시를 설정하세요.
TUN 모드는 가상 네트워크 인터페이스와 시스템 라우팅을 통해 지정된 트래픽을 프록시 커널로 전달합니다. 앱이 시스템 프록시를 직접 읽지 않아도 됩니다. 사용 시 시스템 권한이 필요할 수 있으며, 적용 범위는 라우팅 설정과 제외 항목에 따라 달라집니다. 다른 VPN이나 가상 네트워크 인터페이스 도구를 함께 사용하는 경우 연결 문제가 생기면 하나씩 꺼서 비교해 보세요. 라우팅 충돌을 노드 문제로 오인하는 일을 줄일 수 있습니다.
아웃바운드 모드는 커널에 전달된 연결을 처리하는 방식만 결정합니다. 규칙 모드는 설정 순서대로 규칙을 매칭하고, 전역 모드는 보통 전역 그룹에서 선택한 정책을 사용하며, 직접 연결 모드는 인계된 연결을 목적지에 직접 연결합니다. 전역 모드로 바꿔도 커널에 전달되지 않은 앱이 자동으로 프록시를 이용하지는 않습니다. 직접 연결 모드로 바꿔도 TUN이 꺼지거나 시스템 프록시가 해제되는 것은 아닙니다.
혼합 포트는 커널이 로컬에서 연결을 수신하는 포트입니다. mihomo 설정의 mixed-port 항목에 해당하며 HTTP 프록시와 SOCKS5 요청을 모두 받을 수 있습니다. 앱에서 지원하는 프로토콜에 맞춰 프록시 유형도 설정해야 하며, 포트만 입력해서는 연결할 수 없습니다. 포트 번호는 클라이언트의 현재 설정을 따릅니다. 안내된 값을 사용하기 전에 기기에서 실제로 수신 중인 포트를 확인하세요.
로그의 매칭 규칙을 확인하면 연결 경로를 파악할 수 있습니다.
규칙 모드에서 커널은 설정 순서대로 도메인, 목적지 IP 등의 연결 특성을 확인하며, 보통 가장 먼저 일치하는 규칙을 적용합니다. 규칙에 따라 연결을 프록시 그룹으로 보내거나 직접 연결 또는 차단할 수 있습니다. 새 규칙이 적용되지 않는다면 먼저 연결 로그에서 어떤 규칙이 매칭됐는지 확인하세요. 그런 다음 새 규칙을 적용 범위가 더 넓은 규칙보다 앞에 두어야 하는지 살펴보세요.
도메인 접미사를 기준으로 매칭하는 규칙 유형입니다. DOMAIN-SUFFIX,example.com,DIRECT은 해당 도메인을 확인했을 때 example.com과 하위 도메인인 www.example.com에 매칭되지만 notexample.com에는 매칭되지 않습니다. 도메인 전체가 정확히 일치할 때만 매칭하려면 DOMAIN을 사용하세요.
GeoIP는 목적지 IP의 할당 정보에 따른 분류를 기준으로 연결을 매칭합니다. 웹사이트의 언어, 도메인 접미사, Mac의 위치로 판단하지 않습니다. 목적지가 처음에 도메인이고 커널이 아직 해당 주소를 모른다면 IP 규칙 확인 과정에서 DNS 조회가 발생할 수 있습니다. 같은 웹사이트도 지역별 CDN 노드에 따라 응답 IP가 달라지므로 매칭 결과가 달라질 수 있습니다.
MATCH는 조건 없이 매칭되는 규칙으로, 앞선 규칙에 해당하지 않은 연결을 처리하도록 보통 규칙 목록 마지막에 둡니다. 예를 들어 MATCH,DIRECT는 나머지 연결을 직접 연결한다는 뜻입니다. 구체적인 도메인 규칙보다 앞에 두면 연결이 먼저 MATCH에 매칭되어 이후 도메인 규칙이 적용되지 않습니다.
설정의 출처, 파일 형식, 참조할 수 있는 정책을 구분하세요.
구독은 클라이언트가 원격 주소에서 설정이나 노드 목록을 가져와 업데이트하는 방식입니다. 브라우저에서 링크가 열린다고 해서 가져오기에 성공하는 것은 아닙니다. 응답이 로그인 페이지이거나 클라이언트가 지원하지 않는 형식일 수 있습니다. 업데이트에 실패하면 링크가 유효한지, 응답 내용이 현재 클라이언트와 호환되는지 확인하세요. 오류를 다른 사람에게 문의할 때는 구독 URL 전체를 공유하지 마세요.
YAML은 텍스트 데이터 형식으로, Clash 설정에서는 포트, 프록시 그룹, 규칙 목록 등을 표현하는 데 널리 쓰입니다. 들여쓰기는 계층 구조를 나타내므로 탭 대신 일관된 공백을 사용하세요. 목록 항목은 보통 하이픈으로 시작합니다. YAML 문법에 맞게 파싱되더라도 커널이 모든 항목을 지원하는 것은 아니므로 오류가 발생하면 항목 이름과 값을 확인해야 합니다.
프록시 그룹은 설정의 proxy-groups로 정의합니다. 규칙이 특정 노드 대신 일관된 정책 이름을 참조할 수 있게 해 줍니다. 수동 선택 그룹에서는 사용자가 구성원을 지정하고, 자동 지연 측정 그룹은 자체 테스트 방식에 따라 구성원을 선택합니다. 정책을 변경하기 전에 연결이 어느 그룹에 매칭됐는지 확인하세요. 다른 그룹에서 노드를 바꿔도 해당 연결에 적용되는 정책은 바뀌지 않습니다.
규칙 세트는 도메인, 주소 또는 기타 매칭 조건을 별도의 출처에 모아 개별적으로 업데이트할 수 있게 합니다. mihomo 설정에서는 rule-providers로 규칙 세트 출처를 정의한 뒤 규칙 목록에서 RULE-SET으로 참조할 수 있습니다. 매칭된 연결의 아웃바운드 정책은 이를 참조하는 규칙 행에서 지정합니다. 규칙 세트가 업데이트되어도 목록에서 해당 행의 우선순위는 바뀌지 않습니다.
설정이 기기 전체, 현재 네트워크 서비스, 특정 앱 중 어디에 적용되는지 확인하세요.
127.0.0.1은 흔히 쓰이는 IPv4 루프백 주소로, 연결을 시작한 기기 자체를 가리킵니다. macOS 프록시 설정에 이 주소를 입력하면 앱은 원격 노드 서버가 아닌 Mac에서 수신 중인 포트에 연결합니다. 같은 주소를 휴대폰의 프록시 설정에 입력하면 휴대폰 자체를 가리킵니다. Mac의 커널이 지정된 포트에서 수신 중이 아니라면 Mac에서도 연결할 수 없습니다.
macOS는 네트워크 서비스를 통해 Wi-Fi와 이더넷 등의 연결을 관리하며, 서비스마다 별도의 프록시와 DNS 설정을 사용할 수 있습니다. 시스템 프록시를 확인하려면 ‘시스템 설정 → 네트워크’에서 현재 사용 중인 서비스를 열고 프록시 설정을 살펴보세요. 이더넷 케이블이나 도킹 스테이션을 사용하게 됐다면 이전 Wi-Fi 설정만으로 시스템 프록시가 적용 중이라고 판단하지 마세요.
시스템 네트워크 설정의 우회 목록은 해당 설정을 따르는 앱에 시스템 프록시를 사용하지 않을 호스트나 도메인을 지정합니다. 예를 들어 로컬 서비스인 localhost가 여기에 포함될 수 있습니다. 우회는 앱이 요청을 로컬 프록시에 보내기 전에 적용되므로, 연결을 받은 커널이 DIRECT를 적용하는 것과는 다른 단계입니다. TUN을 켠 경우 우회 목록을 라우팅 제외 항목으로 간주하지 마세요.
일부 명령줄 프로그램은 https_proxy, all_proxy, no_proxy를 읽어 프록시 사용 여부를 결정합니다. 각 도구의 문서에서 지원 여부를 확인하세요. 터미널 세션에서 내보낸 변수는 해당 세션에서 실행한 하위 프로세스에 전달되며 시스템 설정을 자동으로 바꾸지는 않습니다. 터미널과 브라우저의 동작이 다르면 두 환경의 프록시 설정 출처를 각각 확인하세요.
조회 요청을 어디에 맡기는지와 연결이 어디로 나가는지를 구분하세요.
DNS 조회는 도메인에 해당하는 주소 등의 레코드를 확인하는 과정입니다. 조회에 성공해도 해당 주소에 연결할 수 있다는 뜻은 아니며, 연결에 어떤 프록시 규칙이 적용됐는지도 알 수 없습니다. 문제를 진단할 때는 ‘주소를 받지 못함’과 ‘주소는 받았지만 연결 실패’를 먼저 구분하세요. 전자는 DNS 조회 경로를, 후자는 연결 로그와 적용된 정책, 노드 상태를 확인해야 합니다.
커널은 DNS 응답에 가상 주소를 반환하고, 해당 주소와 원래 도메인의 매핑을 로컬에 저장할 수 있습니다. 이후 연결이 커널에 전달되면 규칙 매칭에 사용할 도메인을 복원할 수 있으므로, 가상 주소가 보인다고 해서 DNS 오류인 것은 아닙니다. 특정 로컬 네트워크 서비스가 실제 주소에 의존한다면 이 모드와 충돌하는지 먼저 확인한 뒤, 필요하면 도메인별로 fake-ip-filter를 설정하세요.
지정된 경로로 처리될 것으로 예상한 DNS 조회가 다른 DNS 서버로 전달되면 DNS 누수가 발생할 수 있습니다. 웹 연결이 프록시를 통한다고 해서 도메인 조회도 같은 경로를 이용하는 것은 아닙니다. 진단할 때는 클라이언트의 DNS 설정, 시스템에서 현재 사용하는 DNS 서버, 브라우저의 별도 보안 DNS 사용 여부를 확인하세요. 테스트 결과는 예상한 DNS 정책과 비교해야 합니다.
분할 DNS는 도메인이나 지정 조건에 따라 업스트림 DNS 서버를 선택합니다. 예를 들어 내부 서비스 도메인은 해당 도메인을 조회할 수 있는 조직 내부 DNS 서버에 맡길 수 있습니다. mihomo에서는 nameserver-policy로 조건에 맞는 도메인의 DNS 서버를 지정할 수 있습니다. 분할 DNS는 ‘주소를 어디에 조회할지’를 정하는 기능이지, ‘해당 주소로 연결할 때 어떤 경로를 사용할지’를 정하는 기능이 아닙니다. 두 단계의 조건을 따로 확인하세요.