개발 작업에서 Clash 프록시가 필요한 순간
Git 저장소를 복제하고, SSH로 개발 서버에 접속하고, Homebrew로 도구를 설치하는 작업은 모두 터미널에서 일어나지만 네트워크를 사용하는 방식은 서로 다릅니다. 브라우저가 잘 열린다고 해서 git, ssh, brew도 같은 프록시 경로를 사용하는 것은 아닙니다. 각 명령은 자체 HTTP 라이브러리나 시스템 네트워크 설정을 사용할 수 있고, 어떤 프로그램은 프록시 환경 변수를 읽지 않은 채 직접 연결을 시도합니다.
이 글에서는 Clash Verge, Clash Verge Rev, Mihomo 계열에서 공통으로 적용할 수 있는 진단 순서를 중심으로 설명합니다. 목표는 모든 트래픽을 무조건 우회시키는 것이 아니라, 필요한 개발 요청만 적절한 경로로 보내고 문제 발생 시 어느 단계에서 막혔는지 확인하는 것입니다. 실제 버튼 이름은 클라이언트와 버전에 따라 달라질 수 있지만, 핵심은 활성 프로필, 프록시 포트, 라우팅 규칙, 터미널 프로세스의 환경을 차례로 맞추는 데 있습니다.
먼저 Clash에서 현재 사용 중인 프로필이 활성화되어 있는지 확인하고, 코어가 실행 중인지 살펴보세요. HTTP와 SOCKS 요청을 함께 받는 혼합 포트가 설정되어 있다면 포트 번호를 기록합니다. 흔히 HTTP 포트와 SOCKS 포트를 별도로 두지만, 설치 환경이나 사용자 설정에 따라 값은 다릅니다. 아래 예시의 포트는 설명용이므로 실제 Clash 화면에 표시된 값으로 바꿔야 합니다.
시스템 프록시, 터미널 변수, TUN 중 선택하기
시스템 프록시는 OS의 프록시 설정을 따르는 앱에 편리합니다. 브라우저와 일부 GUI 도구는 Clash에서 시스템 프록시를 켜면 바로 영향을 받지만, 터미널에서 실행한 모든 프로그램이 이를 자동으로 사용하는 것은 아닙니다. Git의 HTTP 전송은 설정이나 환경 변수로 프록시를 지정할 수 있지만, SSH 연결은 HTTP 프록시 설정과 별개입니다. 그러므로 “브라우저는 되는데 Git은 안 된다”는 상황만으로 노드 문제라고 단정하지 말고, 해당 명령이 실제로 프록시를 참조하는지 먼저 확인하세요.
터미널 변수는 현재 셸에서 실행하는 명령에 프록시를 명시적으로 전달하는 방법입니다. 아래는 HTTP 기반 요청을 대상으로 한 예시입니다. 사용하는 포트와 주소를 확인한 뒤 적용하고, 테스트가 끝나면 필요에 따라 변수를 해제할 수 있습니다.
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5h://127.0.0.1:7891
# Check whether the variables are set
env | grep -i proxy
# Remove them from the current shell
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY
환경 변수는 보통 그 셸에서 시작된 자식 프로세스에 전달됩니다. 따라서 터미널에서 실행한 git에는 적용되더라도, 이미 실행 중인 IDE나 GUI 앱의 통합 터미널에는 전달되지 않을 수 있습니다. GUI 앱을 완전히 종료한 다음 다시 실행하거나, 앱의 터미널에서 변수 값을 확인해 보세요. 회사 장비에서는 조직 정책이나 VPN 설정이 별도의 프록시 동작을 강제할 수도 있으므로 임의로 이를 우회하지 않는 것이 좋습니다.
TUN 모드는 시스템 프록시를 무시하는 프로그램까지 OS 네트워크 경로 수준에서 처리할 때 검토할 수 있습니다. 다만 다른 VPN, 보안 에이전트, 가상 네트워크와 충돌할 가능성이 있고, 어떤 트래픽이 규칙에 매칭됐는지 추적하기도 더 복잡해질 수 있습니다. 처음부터 TUN을 켜기보다 규칙 모드에서 시스템 프록시와 터미널 변수를 각각 시험하고, 프록시 설정을 지원하지 않는 프로그램만 남았을 때 TUN을 검토하는 편이 원인을 분리하기 쉽습니다.
Git HTTPS와 SSH를 별도로 설정하기
Git 저장소 주소가 https://로 시작하면 Git은 HTTP 계열 전송을 사용합니다. 이때는 셸의 HTTPS_PROXY를 적용하거나 Git 설정에 프록시를 지정할 수 있습니다. 저장소 주소가 git@ 또는 ssh:// 형식이면 SSH가 연결을 담당하므로, Git의 HTTP 프록시 설정만으로는 충분하지 않습니다. 이 두 경로를 구별하지 않으면 HTTPS clone은 성공하지만 SSH push가 실패하거나, 반대로 한 저장소만 되는 것처럼 보일 수 있습니다.
HTTPS 전송만 프록시로 보내려면 전역 Git 설정 대신 필요한 범위에 맞춰 설정하는 방법을 고려하세요. 전역 설정은 모든 저장소에 영향을 주기 때문에, 사내 Git 서버나 프록시를 사용하지 않아야 하는 호스트까지 경로가 바뀔 수 있습니다. 변경 전 현재 값을 확인하고, 문제가 생겼을 때 되돌릴 수 있도록 설정 범위를 기록해 두면 편리합니다.
# Inspect existing Git proxy settings
git config --show-origin --get-regexp 'http\..*proxy|http.proxy'
# Set an HTTP proxy for Git
git config --global http.proxy http://127.0.0.1:7890
# Remove the global setting when no longer needed
git config --global --unset http.proxy
SSH는 별도의 프록시 명령을 사용하도록 구성할 수 있습니다. 예를 들어 로컬에서 SOCKS5 연결을 지원하는 nc 또는 ncat을 사용할 수 있지만, 운영체제에 기본 포함된 netcat의 옵션은 구현마다 다릅니다. 아래 방식이 현재 설치된 명령에서 지원되는지 먼저 확인하고, 지원되지 않으면 해당 환경에 맞는 프록시 도구를 설치하거나 SSH 클라이언트가 제공하는 대안을 사용하세요. 프록시 명령의 실행 파일 경로와 SOCKS 포트도 실제 값으로 바꿔야 합니다.
# Example for a netcat implementation with SOCKS5 proxy support
ssh -o 'ProxyCommand=nc -X 5 -x 127.0.0.1:7891 %h %p' [email protected]
# Check the SSH connection and verbose routing details
ssh -vT [email protected]
반복해서 사용할 설정은 SSH 설정 파일의 특정 호스트 항목에 넣을 수 있습니다. 모든 SSH 목적지에 같은 프록시를 적용하기보다, 필요한 호스트에만 적용하는 편이 사내 서버나 로컬 장비 접속에 미치는 영향을 줄입니다. 호스트 별칭과 실제 접속 이름이 다르면 설정의 HostName과 인증 키 경로도 함께 확인하세요. 프록시 연결은 네트워크 경로를 바꾸는 것이며 SSH 키 인증을 대신하지 않습니다. 키나 토큰을 프록시 설정 줄에 직접 넣지 마세요.
# Example ~/.ssh/config entry
Host github-proxied
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519
ProxyCommand nc -X 5 -x 127.0.0.1:7891 %h %p
이 별칭을 쓰면 원격 URL도 git@github-proxied:owner/repository.git처럼 맞춰야 합니다. 기존 URL을 바꾸기 전에는 git remote -v로 현재 원격 주소를 확인하고, 특정 저장소만 별칭을 사용하도록 변경하세요. 설정 후에는 ssh -vT 출력에서 프록시 명령이 시작되는지, 이어서 SSH 서버에 연결되는지 단계별로 살펴봅니다. 인증 거부 메시지는 네트워크 연결 성공 뒤에 발생할 수도 있으므로, 이를 곧바로 프록시 장애로 해석하지 않는 것이 중요합니다.
Homebrew 다운로드와 프록시 환경
Homebrew 명령 하나가 단일 호스트에만 접속한다고 가정해서는 안 됩니다. 저장소 메타데이터, 소스 아카이브, 미리 빌드된 bottle, GitHub 릴리스 등 설치하는 패키지와 시점에 따라 서로 다른 도메인이 사용될 수 있습니다. 따라서 특정 도메인 목록을 무작정 규칙에 추가하기보다, 설치가 실패한 순간 Clash 연결 로그에서 목적지 호스트와 매칭된 규칙을 확인하세요. 패키지마다 호스트가 달라지므로, 이전 설치에서 관찰한 목록이 다음 설치의 전체 목록을 보장하지는 않습니다.
Homebrew가 실행되는 터미널에서 프록시 변수가 보이는지 먼저 확인하고, 필요하다면 해당 셸에서만 변수를 설정해 시험합니다. 설치 스크립트가 별도 프로세스를 시작하거나 다른 다운로드 도구를 호출하는 경우에도 환경이 전달되는지 확인해야 합니다. 프록시를 적용한 뒤 오류가 달라졌다면 전체 로그를 비교하세요. DNS 조회 실패, 연결 시간 초과, TLS 오류, 서버의 HTTP 오류는 서로 다른 원인을 가리킬 수 있습니다.
# Inspect the current environment
env | grep -i proxy
# Run a diagnostic request through the configured proxy
curl -Iv https://github.com/
# Run Homebrew with verbose output
brew install --verbose PACKAGE_NAME
curl 검사는 프록시 연결과 TLS 응답을 확인하는 데 유용하지만, 이 결과만으로 Homebrew의 모든 다운로드 경로가 정상이라고 결론 내릴 수는 없습니다. 실패한 명령에서 실제로 사용된 URL을 확인하고, 같은 시각의 Clash 로그와 대조하세요. Homebrew가 이미 받은 파일을 캐시에서 재사용하면 네트워크 요청 자체가 발생하지 않을 수도 있으므로, 반복 실행 결과가 달라질 때는 캐시 동작도 함께 고려합니다. 진단 목적으로 캐시를 무작정 삭제하면 재현에 필요한 단서가 사라질 수 있습니다.
규칙을 추가할 때는 GitHub 전체를 하나의 경로에 몰아넣기보다 필요한 목적지와 정책을 구분하세요. 공개 저장소 다운로드, 회사의 내부 Git 서비스, 사내 패키지 미러는 요구되는 경로가 다를 수 있습니다. 사용자 정의 규칙을 넣었다면 큰 범위의 규칙이나 최종 매칭 규칙보다 위에 있는지 확인하고, 프로필을 저장한 뒤 실제로 활성화된 설정에 반영됐는지도 살펴보세요. 편집 중인 파일과 실행 중인 프로필이 다르면 올바른 규칙을 작성해도 결과가 바뀌지 않습니다.
검증 순서와 자주 만나는 연결 오류
문제를 빠르게 좁히려면 한 번에 여러 항목을 바꾸지 말고, 같은 테스트를 기준으로 단계별 결과를 비교합니다. 먼저 Clash에서 코어 상태와 포트를 확인하고, 이어서 셸에 프록시 변수가 있는지 확인합니다. 다음으로 실패한 작업을 재현하면서 연결 로그를 열고, 실제 목적지 호스트, 적용된 규칙, 최종 프록시 그룹 또는 노드를 기록하세요. 마지막으로 해당 작업이 HTTPS인지 SSH인지 구분합니다. 이 네 가지 정보가 있으면 노드를 무작정 바꾸는 것보다 원인을 훨씬 좁히기 쉽습니다.
- 브라우저가 아니라 실패한 터미널과 같은 환경에서 테스트합니다. IDE 터미널과 별도 Terminal 앱은 서로 다른 환경 변수를 가질 수 있습니다.
- Git의 원격 주소를 확인해 HTTPS와 SSH 중 어느 전송 방식인지 구분하고, 각각에 맞는 프록시 설정을 검사합니다.
- Clash 연결 로그에서 실제 호스트와 매칭 규칙을 확인합니다. 예상과 다른 최종 규칙이 보이면 먼저 규칙 순서와 활성 프로필을 점검합니다.
curl -Iv,git ls-remote,ssh -vT처럼 작업 유형에 맞는 명령으로 재현합니다. 실패 단계와 오류 메시지를 기록하되 비밀 키나 액세스 토큰은 공유하지 않습니다.- 한 번에 한 변수만 바꿉니다. 포트, 규칙, 셸 변수, 프록시 노드를 동시에 변경하면 어떤 수정이 효과가 있었는지 알기 어렵습니다.
연결 거부가 보이면 먼저 주소와 포트가 Clash의 실제 수신 설정과 일치하는지, 코어가 실행 중인지 확인합니다. 이름 해석 오류는 DNS 설정이나 사용 중인 프록시 도구의 도메인 해석 방식과 관련될 수 있습니다. 특히 SOCKS 프록시를 사용하는 경우 도구가 목적지 이름을 로컬에서 먼저 해석하는지, 프록시 쪽에 전달하는지 차이가 날 수 있습니다. 도메인 해석을 원격으로 맡기도록 지원하는 옵션을 선택할 수 있지만, 지원 여부는 사용 중인 클라이언트에 따라 다릅니다.
TLS 연결은 시작되지만 Git 인증이 거부된다면 네트워크와 인증을 분리해 봅니다. 저장소 권한, SSH 키 등록 상태, 키 에이전트, HTTPS 자격 증명 도구를 확인하고, 성공 메시지와 오류 메시지를 구분하세요. 반대로 Clash 로그에 요청이 전혀 나타나지 않는다면 해당 프로그램이 프록시를 사용하지 않거나, 다른 네트워크 경로로 연결하고 있을 가능성이 있습니다. 그때는 환경 변수의 상속 여부, IDE 재시작, TUN 사용 필요성을 순서대로 검토합니다.
마지막으로 회사나 공동 개발 환경에서는 프록시 설정이 조직의 네트워크 정책과 충돌하지 않는지 확인하세요. 전역 Git 설정이나 셸 시작 파일에 남겨 둔 값은 나중에 네트워크가 바뀌어도 계속 적용될 수 있습니다. 설정을 실험했다면 git config --show-origin과 셸 환경을 다시 점검하고, 임시 값은 제거하거나 적용 범위를 좁혀 두는 습관이 재발 방지에 도움이 됩니다.
개발 환경에 맞게 설정을 유지하는 방법
개발 도구마다 프록시 처리 방식이 달라 단순한 시스템 프록시 스위치 하나로 Git HTTPS, SSH, Homebrew를 모두 해결하기는 어렵습니다. 일부 GUI 클라이언트는 OS 프록시 설정을 따르지만, SSH는 별도 프록시 명령이 필요하고, 패키지 설치는 여러 다운로드 호스트를 거칠 수 있습니다. 반면 Clash는 규칙과 전략 그룹을 이용해 관찰한 목적지별로 경로를 나누고, 연결 로그에서 적용 결과를 확인할 수 있습니다. 중요한 것은 넓은 규칙을 급하게 추가하는 대신 실제 로그에 나타난 목적지부터 좁게 조정하는 것입니다.
프록시 설정을 제공하는 다른 도구는 시작하기 쉬울 수 있지만, 터미널 프로세스의 환경 변수나 SSH 연결, 여러 패키지 다운로드 경로까지 세밀하게 진단하기 어려운 경우가 있습니다. Clash에서는 시스템 프록시로 브라우저를 확인한 뒤 Git의 HTTPS 설정, SSH 프록시 명령, Homebrew의 셸 환경을 각각 검증하고, 필요할 때만 TUN을 검토할 수 있습니다. 개발 작업을 위한 클라이언트를 찾고 있다면 사용 중인 플랫폼에 맞는 버전을 확인해 보세요.