브라우저는 되는데 터미널만 끊기는 이유
브라우저에서 웹사이트가 잘 열려도 Git, SSH, curl, Homebrew까지 같은 경로를 사용한다고 볼 수는 없습니다. 브라우저는 운영체제의 시스템 프록시 설정을 따르는 경우가 많지만, 터미널 프로그램은 별도 프록시 변수를 요구하거나 프록시 설정을 아예 무시한 채 직접 연결할 수 있습니다. 그래서 Clash Verge Rev에서 시스템 프록시를 켰는데도 git clone만 시간 초과되고, 패키지 설치가 중간에 멈추는 일이 생깁니다.
Clash TUN은 가상 네트워크 인터페이스와 운영체제 라우팅을 이용해 애플리케이션의 연결을 Mihomo 코어로 전달합니다. 프로그램마다 프록시 지원 여부를 따지는 대신, 네트워크 계층에서 트래픽을 받아 규칙에 따라 보낼 수 있다는 것이 장점입니다. 다만 TUN을 켠다고 모든 요청이 자동으로 원하는 프록시 노드를 타는 것은 아닙니다. 규칙이 실제 연결과 일치하는지, DNS가 올바른 주소를 돌려주는지, 최종 아웃바운드가 기대한 그룹인지 함께 확인해야 합니다.
아래 내용은 Clash Verge Rev와 Mihomo 계열 클라이언트를 기준으로 설명합니다. 메뉴 이름은 운영체제와 클라이언트 버전에 따라 다를 수 있으므로, 특정 버튼 이름을 찾기보다 TUN 활성화, 관리자 권한, DNS 처리, 규칙 로그라는 네 가지 확인 지점을 중심으로 진행하세요.
TUN을 켜기 전에 확인할 항목
먼저 현재 사용 중인 프로필과 규칙 모드를 확인합니다. 전역 모드는 모든 연결을 한 출구로 보내므로 원인 분리에는 쓸 수 있지만, 사내 Git 서버나 국내 패키지 저장소까지 우회할 수 있습니다. 평상시에는 규칙 모드를 유지하고, 장애를 재현할 때만 테스트용으로 전역 모드와 비교하는 편이 안전합니다. 프로필을 수정하기 전에는 원본을 복사해 두고, 편집한 YAML이 실제 활성 프로필에 반영됐는지도 확인하세요.
TUN은 가상 어댑터와 경로를 설정해야 하므로 관리자 권한이나 서비스 권한이 필요할 수 있습니다. Windows에서는 서비스 설치 상태와 권한 승인을 확인하고, macOS에서는 네트워크 확장 또는 VPN 구성 승인 요청이 나타나는지 살펴봅니다. Linux에서는 TUN 장치 접근 권한과 라우팅 권한이 필요할 수 있습니다. 회사 VPN, 제로 트러스트 에이전트, 보안 필터가 이미 네트워크를 관리한다면 TUN과 경로가 겹치지 않는지 먼저 확인하세요.
Mihomo 프로필의 TUN 설정은 개념상 다음 항목으로 구성됩니다. 기존 설정 전체를 이 예시로 덮어쓰지 말고, 사용 중인 프로필과 코어 버전에서 지원하는 키를 확인한 뒤 필요한 값만 병합하세요.
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
auto-route와 인터페이스 자동 감지는 운영체제의 경로 선택을 돕지만, 사내망이나 다른 VPN 환경에서는 자동 경로가 의도와 다를 수 있습니다. 문제가 발생하면 옵션을 한꺼번에 바꾸지 말고 TUN 활성화 여부, DNS 가로채기, 경로 자동 설정을 하나씩 분리해 테스트합니다. 설정을 적용한 뒤에는 코어 로그에서 TUN 초기화 성공 여부를 확인하고, 실패 메시지가 있으면 규칙을 손보기 전에 권한과 어댑터 상태부터 해결하세요.
Git·SSH·Homebrew를 구분해 연결하기
Git은 원격 저장소 주소가 HTTPS인지 SSH인지에 따라 프록시 처리 방법이 달라집니다. HTTPS 원격은 Git의 프록시 설정이나 HTTPS_PROXY 환경 변수를 이용할 수 있습니다. 반면 SSH 원격은 일반적인 HTTP 프록시 변수를 그대로 적용하지 않습니다. SSH는 별도 프록시 명령을 설정하거나, TUN으로 직접 연결을 포착하는 방식이 필요합니다. “Git 프록시를 설정했다”는 말만으로 두 프로토콜 모두 처리됐다고 가정하지 마세요.
HTTPS 방식으로 먼저 시험할 때는 터미널 세션에만 임시 변수를 설정하면 설정 범위를 제한할 수 있습니다. 포트는 Clash 클라이언트의 실제 혼합 포트 또는 HTTP 포트를 확인해 바꾸고, 테스트가 끝나면 변수를 해제합니다.
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
git ls-remote https://github.com/example/project.git
unset HTTP_PROXY HTTPS_PROXY
환경 변수 방식이 필요한 저장소에서만 적용하려면 Git 설정의 범위를 고려하세요. 전역 프록시를 등록하면 사내 Git이나 직접 연결이 필요한 저장소에도 영향을 줄 수 있습니다. 인증 정보를 포함한 URL을 셸 기록이나 설정 파일에 남기지 말고, 회사에서 지정한 인증 도구와 자격 증명 관리 방식을 유지합니다. SSH 연결은 ssh -vT처럼 상세 로그를 켜서 DNS 조회, TCP 연결, 키 교환 중 어느 단계에서 멈추는지 확인하면 원인을 좁히기 쉽습니다.
Homebrew는 Git 저장소 접근뿐 아니라 설치 스크립트, API 요청, 패키지 아카이브 다운로드에도 여러 호스트를 사용할 수 있습니다. 한 주소만 규칙에 넣으면 저장소 정보는 받아도 병 패키지 다운로드가 실패할 수 있습니다. 설치가 멈춘 시각의 Clash 연결 로그에서 실제 호스트를 확인하고, 관측된 도메인만 필요한 그룹에 추가하세요. DOMAIN-KEYWORD,github처럼 넓은 키워드 규칙을 먼저 넣으면 다른 GitHub 기반 업무 트래픽까지 한꺼번에 우회될 수 있습니다.
개발 트래픽 규칙은 관측한 호스트부터
규칙 엔진은 보통 위에서 아래로 내려가 처음 일치하는 규칙을 적용합니다. 따라서 구체적인 예외와 개발 도구 규칙을 넓은 규칙 세트나 마지막 매치 규칙보다 위에 둡니다. 아래는 규칙 구조를 설명하기 위한 예시이며, 그룹 이름과 도메인은 실제 프로필 및 로그에 맞게 바꿔야 합니다. 존재 여부를 확인하지 않은 저장소 호스트를 그대로 복사하지 말고, 실패가 발생한 연결에서 관측한 이름을 사용하세요.
proxy-groups:
- name: DEV-PROXY
type: select
proxies:
- AUTO
- DIRECT
rules:
- DOMAIN-SUFFIX,github.com,DEV-PROXY
- DOMAIN-SUFFIX,githubusercontent.com,DEV-PROXY
- DOMAIN,git.corp.example,DIRECT
- MATCH,GLOBAL
git.corp.example은 사내 서버를 설명하기 위한 자리표시자이므로 실제 사내 FQDN으로 교체해야 합니다. 사내망은 공용 프록시로 보내면 접근이 끊기거나 정책 위반이 될 수 있으니, 회사 정책을 확인한 뒤 필요한 호스트나 CIDR만 예외 처리하세요. 규칙을 추가했는데도 결과가 바뀌지 않는다면 편집한 파일이 활성 프로필인지, 사용자 규칙이 원격 RULE-SET보다 앞에 있는지, 규칙 대상 도메인이 실제 로그의 호스트와 일치하는지 확인합니다.
그룹을 select로 두면 직통과 여러 노드를 비교하기 쉽고, 지연 테스트 그룹은 노드 상태를 자동으로 확인하는 데 유용합니다. 다만 자동 선택이 항상 업무상 최적의 출구를 보장하는 것은 아닙니다. Git 서버의 접속 정책, 인증 흐름, 전송량, 회사의 네트워크 규정을 기준으로 선택하세요. 특정 연결만 반복해서 끊긴다면 노드 전체를 바꾸기 전에 매칭된 규칙과 최종 출구를 코어 로그에서 기록해 두는 편이 진단에 도움이 됩니다.
DNS와 사내망 문제를 분리하는 방법
TUN에서 DNS는 자주 놓치는 변수입니다. 셸에서 확인한 도메인 주소와 Mihomo가 처리한 주소가 다르거나, 운영체제와 애플리케이션에 이전 DNS 응답이 캐시되어 있으면 규칙은 맞아도 연결이 실패할 수 있습니다. 특히 fake-ip 모드를 쓰는 환경에서는 애플리케이션이 받은 가상 주소를 코어가 원래 도메인과 연결하는 과정이 중요합니다. DNS 서버를 무작정 여러 개 추가하기보다, 실패한 도메인의 조회 결과와 코어 로그를 같은 시점에 비교하세요.
먼저 TUN을 켠 상태에서 도메인 조회와 연결 테스트를 각각 실행합니다. macOS나 Linux에서는 dig 또는 nslookup, Windows에서는 Resolve-DnsName이나 nslookup을 사용할 수 있습니다. 다음으로 curl -v 또는 SSH 상세 로그에서 실패 지점을 확인합니다. 이름 해석 전부터 실패하면 DNS, IP가 나온 뒤 TCP 연결에서 멈추면 경로·방화벽·출구, TLS 이후 오류가 나면 인증서나 서버 정책을 우선 의심할 수 있습니다.
사내망 주소는 공용 DNS가 올바른 내부 주소를 제공하지 않을 수 있습니다. 사내 VPN이 내려 준 DNS 서버나 검색 접미사가 필요한 환경이라면 이를 Clash TUN이 가로채거나 다른 DNS로 대체하는지 확인해야 합니다. 내부 도메인을 외부 리졸버로 보내면 이름이 해석되지 않거나 잘못된 공용 주소를 받을 수 있습니다. 조직에서 승인한 DNS·VPN 설정을 우선하고, 사내 이름은 필요한 범위만 내부 DNS로 처리하도록 구성하세요.
IPv6도 별도로 확인할 만합니다. 애플리케이션이 IPv6 주소를 먼저 선택하지만 TUN 경로나 네트워크가 IPv6 트래픽을 제대로 처리하지 못하면, IPv4 브라우저 테스트와 다른 결과가 나올 수 있습니다. IPv4와 IPv6의 조회 결과 및 연결 시도를 비교하고, 문제를 재현하는 경우에만 해당 경로를 임시로 분리해 원인을 검증합니다. IPv6를 전역으로 비활성화하는 방법은 다른 서비스에 영향을 줄 수 있으므로 마지막 수단으로 두세요.
재현 가능한 검증 순서와 흔한 증상
설정을 바꿀 때마다 동일한 테스트를 반복하면 원인 추적이 쉬워집니다. 먼저 브라우저에서 대상 사이트가 열리는지 확인하고, 다음으로 터미널에서 같은 도메인을 조회한 뒤 Git 또는 SSH 연결을 시험합니다. 마지막으로 Clash 로그에서 요청의 호스트, 매칭된 규칙, 선택된 그룹과 노드를 확인합니다. 테스트 시간과 결과를 간단히 기록해 두면 DNS 캐시나 노드 변경에 따른 우연한 차이를 설정 효과로 오해하는 일을 줄일 수 있습니다.
- 활성 프로필과 규칙 모드를 확인하고, 현재 TUN 상태를 기록합니다.
- 실패한 명령을 한 번 실행하면서 코어 로그에서 실제 호스트와 규칙을 찾습니다.
- DNS 조회 결과와 연결 실패 단계가 같은 시점에 일치하는지 비교합니다.
- 규칙, DNS 또는 프록시 환경 변수 중 하나만 바꾸고 동일한 명령을 다시 실행합니다.
- 검증이 끝나면 임시 변수를 해제하고, 불필요한 우회 규칙과 테스트 설정을 정리합니다.
- 브라우저는 되지만 Git HTTPS만 실패: Git 프로세스가 시스템 프록시를 따르지 않을 수 있습니다. 임시 환경 변수와 TUN을 각각 시험하고 로그의 규칙 매칭을 비교하세요.
- Git HTTPS는 되지만 SSH가 실패: HTTP 프록시 설정만으로 SSH가 처리되지는 않습니다. TUN 경로, SSH 프록시 명령, 사내 서버의 포트 접근 정책을 확인하세요.
- 저장소 정보는 받지만 Homebrew 다운로드가 멈춤: 저장소와 패키지 파일이 서로 다른 호스트에서 제공될 수 있습니다. 실패 시점의 새 연결을 로그에서 찾아 규칙을 보완하세요.
- TUN을 켜면 사내 Git만 접근 불가: 내부 DNS, 사내 VPN 경로 또는 DIRECT 예외가 빠졌을 수 있습니다. 공개 프록시로 우회하기 전에 회사 네트워크 정책부터 확인하세요.
- 모든 연결이 느려지거나 끊김: 충돌하는 VPN, 잘못된 기본 경로, DNS 가로채기 설정을 의심하고 TUN을 잠시 끈 상태와 비교합니다. 문제가 전체 네트워크로 확산되면 즉시 이전 경로로 되돌리세요.
일부 앱별 프록시 설정은 적용 범위를 세밀하게 나눌 수 있지만, 프로그램마다 설정 방식이 달라 새 CLI나 하위 프로세스가 추가될 때마다 다시 점검해야 합니다. 반대로 TUN은 프록시 설정을 지원하지 않는 도구까지 한 경로에서 다루기 좋지만, 사내 VPN·DNS·라우팅과 충돌할 가능성이 있어 로그와 예외 규칙을 함께 관리해야 합니다. Git과 Homebrew는 프로토콜별 설정을 병행하고 SSH나 프록시 미지원 도구만 TUN으로 보완하면 불필요한 우회를 줄일 수 있습니다. 개발 환경에 맞는 Mihomo 호환 클라이언트를 찾고 있다면 운영체제별 선택지를 먼저 살펴보세요.