개발 환경에서 VPN은 단순히 웹페이지를 여는 도구가 아닙니다. GitHub 저장소 접속, Docker 이미지와 레이어 다운로드, npm 패키지 설치, 외부 API 요청, 원격 서버 연결은 각각 다른 도메인과 CDN, 인증 절차, 전송 특성을 사용합니다. 따라서 모든 트래픽을 무조건 같은 노드로 보내는 방식보다 업무별로 필요한 연결만 우회하고, 일반 웹·사내 시스템·로컬 개발 도구는 기존 경로에 남겨 두는 구성이 더 관리하기 쉽습니다.
특히 개발자는 한 번의 다운로드 속도보다 반복 작업의 안정성을 중요하게 봐야 합니다. 저장소를 clone하거나 pull할 때 연결이 중단되고, Docker 빌드 중 이미지 레이어가 다시 내려받아지며, npm install 과정에서 패키지 메타데이터 요청이 지연되면 실제 작업 시간은 크게 늘어납니다. 이 글에서는 GitHub·Docker Hub·npm을 업무별로 구분해 살펴보고, 공식 클라이언트와 Clash Verge, sing-box, Shadowrocket 같은 호환 클라이언트에서 적용할 수 있는 라우팅 원칙과 점검 순서를 정리합니다.
개발 작업에서 VPN이 영향을 주는 지점
GitHub 작업은 웹 화면 접속만으로 끝나지 않습니다. Git over HTTPS 또는 SSH를 사용해 저장소를 복제하고, 원격 저장소에서 브랜치를 가져오며, 릴리스 파일이나 Actions 관련 아티팩트를 내려받을 수 있습니다. 이 과정에서 웹페이지는 열리지만 git fetch가 실패하거나, 로그인은 성공했는데 특정 저장소의 원격 요청만 반복해서 끊기는 상황이 발생할 수 있습니다. 브라우저와 터미널이 서로 다른 프록시 설정을 사용하기 때문입니다.
Docker도 여러 호스트에 의존합니다. Docker Hub의 인증 엔드포인트, 이미지 매니페스트, 각 레이어 저장소가 서로 다른 주소를 사용할 수 있으며, 베이스 이미지에 따라 다른 레지스트리나 패키지 저장소로 연결될 수 있습니다. 한 주소만 프록시 처리하면 로그인은 되지만 pull이 실패하거나, 매니페스트는 읽히는데 실제 레이어 다운로드가 오래 걸리는 문제가 생깁니다.
npm install 역시 npm 레지스트리와 패키지에 지정된 의존성 주소, 프라이빗 레지스트리, Git 저장소 의존성을 함께 사용할 수 있습니다. package-lock.json에 기록된 주소가 현재 설정한 레지스트리와 다르면 일부 패키지만 다른 경로에서 내려받게 됩니다. 그래서 VPN을 선택하기 전에 어떤 명령이 느린지, 어느 호스트에서 멈추는지, 터미널과 Docker 데몬이 같은 네트워크 경로를 쓰는지부터 확인하는 것이 좋습니다.
90+
지원 국가
200+
제공 회선
5
지원 플랫폼
不限
동시 온라인 기기
회선 유형도 구분해야 합니다. Shadowsocks, VMess, Trojan, Hysteria2, WireGuard는 통신과 암호화에 사용되는 프로토콜 또는 구현 방식이고, IEPL·BGP·CN2와 같은 표현은 네트워크 경로와 전송 자원에 관한 설명입니다. 프로토콜 이름이 같아도 입구와 출구, 국제 구간, 현지 통신망에 따라 체감이 달라질 수 있습니다. 개발 작업에서는 하나의 프로토콜만 고집하기보다 현재 클라이언트가 안정적으로 지원하는 설정과 목적지에 맞는 회선을 비교해야 합니다>
GitHub 접속과 Git 명령을 분리해 점검하기
GitHub가 느릴 때는 먼저 브라우저 접속과 Git 명령을 나누어 확인하세요. 브라우저에서 저장소 페이지가 열린다고 해서 터미널의 git clone, git fetch, git push가 같은 경로를 사용하는 것은 아닙니다. Git은 환경 변수, Git 자체의 http.proxy 설정, SSH 설정, 운영체제의 시스템 프록시 중 하나를 사용할 수 있습니다. 여러 설정이 동시에 남아 있으면 VPN을 켠 뒤에도 이전 프록시로 요청하거나, 프록시를 거쳐서는 안 되는 사내 저장소까지 외부로 보내는 문제가 생깁니다.
HTTPS와 SSH를 업무에 맞게 선택하기
HTTPS 방식은 인증 토큰과 원격 저장소 주소를 기준으로 동작하며 일반적인 프록시 환경에서 확인하기 쉽습니다. 반면 SSH는 별도의 포트와 키 교환을 사용하므로 현재 네트워크에서 해당 연결이 허용되는지 별도로 점검해야 합니다. SSH가 불안정하다고 해서 저장소 자체에 문제가 있다고 단정하지 말고, 같은 저장소를 HTTPS 원격 주소로 테스트해 경로 문제인지 인증 문제인지 구분하세요.
GitHub 관련 도메인을 규칙에 넣을 때는 저장소 페이지에 보이는 주소 하나만 등록하지 말고 실제 명령에서 연결하는 호스트를 로그로 확인해야 합니다. Git LFS, 릴리스 파일, 패키지 다운로드가 포함되면 추가 호스트가 사용될 수 있습니다. 다만 확인하지 않은 광범위한 도메인 전체를 무조건 우회하면 일반 웹 요청과 개발 요청이 섞이고, 규칙 충돌을 찾기 어려워집니다.
- ✅ 브라우저, git clone, git fetch, git push를 각각 테스트해 어느 단계가 느린지 기록합니다.
- ✅ HTTPS와 SSH를 함께 사용한다면 두 방식의 프록시·포트 설정을 따로 확인합니다.
- ✅ Git LFS나 릴리스 파일을 사용하는 저장소는 실제 다운로드 호스트를 로그에서 확인합니다.
- ❌ 시스템 프록시와 Git 전용 프록시를 무작정 중복 설정하지 않습니다.
- ❌ 공개된 토큰이나 SSH 개인 키를 VPN 설정 파일과 함께 공유하지 않습니다.
Docker와 npm 다운로드를 안정화하는 방법
Docker에서 가장 흔한 오판은 Docker CLI만 VPN을 사용하면 Docker 빌드도 같은 경로를 사용할 것이라고 생각하는 것입니다. Docker Desktop, Linux의 Docker 데몬, 원격 빌더는 서로 다른 네트워크 네임스페이스에서 실행될 수 있습니다. 호스트의 브라우저가 정상이어도 데몬이 레지스트리에 접근하지 못할 수 있으며, 반대로 호스트의 모든 트래픽을 우회하면 내부 레지스트리나 로컬 서비스 연결이 꼬일 수 있습니다.
먼저 docker pull로 베이스 이미지 다운로드를 확인하고, 그 다음 실제 Dockerfile의 build를 점검하세요. 이미지 이름이 여러 레지스트리를 거치는지, 인증이 필요한지, 캐시가 제대로 재사용되는지 구분해야 합니다. VPN을 연결한 뒤 갑자기 모든 레이어를 다시 받는다면 속도보다 캐시 위치, DNS, 레지스트리 인증, 데몬의 프록시 환경 변수를 먼저 확인하는 편이 합리적입니다.
npm은 프로젝트의 설정 파일을 먼저 확인해야 합니다. npm config get registry로 현재 레지스트리를 확인하고, 프로젝트의 .npmrc에 별도 레지스트리와 인증 설정이 있는지 살펴보세요. 조직 내부 패키지는 내부 레지스트리로, 공개 패키지는 지정된 공개 레지스트리로 보내야 하는 경우가 많습니다. 이때 모든 npm 요청을 단일 외부 노드로 보내면 내부 패키지 인증이 실패하거나 회사 네트워크 정책을 위반할 수 있습니다.
| 업무 | 먼저 확인할 대상 | 권장 라우팅 원칙 | 실패 시 분리할 항목 |
|---|---|---|---|
| GitHub 웹 | 브라우저의 DNS와 HTTPS 접속 | 해외 개발 서비스 관련 요청만 우회 | 브라우저와 터미널의 프록시 설정 |
| Git clone·fetch | HTTPS 또는 SSH 원격 주소 | 선택한 방식에 맞는 호스트와 포트만 적용 | 인증, 프록시, SSH 키, 저장소 권한 |
| Docker pull | Docker 데몬과 레지스트리 연결 | 필요한 레지스트리 요청만 우회 | 호스트와 데몬의 네트워크 경로 |
| npm install | registry와 .npmrc 설정 | 공개·내부 레지스트리를 목적지별로 분리 | DNS, 인증 토큰, 잠금 파일의 주소 |
| CI·API 요청 | 실행 환경의 환경 변수와 DNS | 러너 또는 컨테이너 단위로 필요한 요청만 처리 | 로컬 VPN이 CI 환경에 적용되지 않는 문제 |
분할 터널링을 직접 설정하는 순서
분할 터널링은 모든 요청을 VPN으로 보내지 않고, 규칙에 맞는 목적지만 VPN으로 보내는 방식입니다. 개발자의 경우 GitHub와 필요한 레지스트리, 특정 외부 API는 우회하고 사내 Git 서버, 데이터베이스, 로컬호스트, 프린터와 같은 내부 자원은 직접 연결하는 구성이 일반적으로 관리하기 쉽습니다. 단, 실제 도메인과 IP가 바뀌는 서비스는 너무 좁은 규칙을 만들면 일부 요청이 누락될 수 있으므로 로그와 문서를 함께 확인해야 합니다.
- 현재 문제가 발생하는 명령을 하나만 정합니다. 예를 들어 git fetch, docker pull, npm install처럼 재현 가능한 작업을 선택합니다.
- 클라이언트 로그에서 DNS 조회 결과, 연결한 호스트, 사용된 규칙과 노드를 확인합니다. 이름만 보고 목적지를 추측하지 말고 실제 요청을 기준으로 기록합니다.
- 공식 클라이언트에서는 규칙 모드 또는 분할 연결 기능을 선택하고, 호환 클라이언트에서는 도메인·프로세스·IP 규칙을 목적에 맞게 추가합니다.
- GitHub, 필요한 이미지 레지스트리, npm 레지스트리처럼 우회가 필요한 대상과 사내 도메인, 로컬 네트워크처럼 직접 연결해야 하는 대상을 분리합니다.
- 규칙을 저장한 뒤 클라이언트와 필요한 데몬을 다시 시작하고, DNS 캐시와 기존 연결이 남아 있지 않은지 확인합니다.
- 같은 명령을 다시 실행해 다운로드 중단, 인증 실패, 내부 시스템 접근 이상이 함께 발생하지 않는지 확인합니다.
Windows와 macOS 공식 클라이언트는 설치 후 구독 링크를 가져와 노드 목록을 동기화하는 방식이 간단합니다. Android와 iOS에서는 운영체제의 VPN 권한을 허용해야 하며, 배터리 절전이나 백그라운드 제한이 연결 유지에 영향을 줄 수 있습니다. Linux에서는 공식 클라이언트 또는 sing-box, Clash 계열과 같은 호환 클라이언트를 사용할 수 있지만, 시스템 서비스로 실행되는 Docker 데몬과 셸에서 실행되는 Git이 서로 다른 환경 변수를 사용하는지 확인해야 합니다.
Clash Verge를 사용한다면 모드와 규칙 공급원의 우선순위를 확인하고, 수동으로 추가한 규칙이 기본 규칙에 의해 덮어써지지 않는지 살펴보세요. sing-box는 라우팅 규칙과 DNS 규칙이 서로 영향을 주므로 도메인 조회가 직접 연결로 빠지는 상황까지 점검해야 합니다. Shadowrocket은 모바일에서 앱 또는 도메인 기준으로 나누어 설정할 수 있지만, iOS의 앱별 동작과 시스템 DNS 처리 방식에 제한이 있을 수 있습니다. 어떤 클라이언트를 사용하더라도 여러 VPN 앱을 동시에 켜는 것은 피해야 합니다.
속도보다 재현성과 안정성을 확인하는 점검법
개발용 VPN을 평가할 때는 단일 속도 측정 결과보다 동일한 작업을 여러 네트워크 환경에서 반복해 비교하는 것이 유용합니다. GitHub는 저장소 페이지와 fetch를 나누고, Docker는 인증·매니페스트·레이어 다운로드를 구분하며, npm은 메타데이터 조회와 실제 패키지 설치를 나누어야 합니다. 이렇게 하면 VPN 자체의 문제인지, 목적지 서비스의 문제인지, 로컬 캐시나 인증 설정의 문제인지 좁혀 갈 수 있습니다.
노드를 바꿀 때는 한 번에 여러 설정을 변경하지 마세요. 노드, 프로토콜, 라우팅 모드, DNS를 동시에 바꾸면 어떤 변경이 효과가 있었는지 판단하기 어렵습니다. 먼저 가까운 입구와 안정적인 출구를 선택한 뒤 규칙을 최소화하고, 문제가 지속되면 다른 회선 유형이나 프로토콜을 비교하는 순서가 좋습니다. IEPL이나 BGP, CN2 같은 경로 설명도 참고할 수 있지만, 실제 목적지와 현재 통신사 환경에서의 결과가 최종 판단 기준입니다.
- ✅ 명령 실행 전후의 클라이언트 로그와 Docker·npm 로그를 함께 보관합니다.
- ✅ 변경할 때는 노드, 규칙, DNS 중 한 항목만 바꿔 원인을 추적합니다.
- ✅ 작업이 끝난 뒤 사내 저장소, 내부 API, 로컬 개발 서버가 정상인지 확인합니다.
- ✅ 구독 링크는 HBVPN 패널에서 가져오고 클라이언트에서 업데이트해 최신 회선을 유지합니다.
- ❌ 토큰, 비밀번호, 구독 링크, SSH 개인 키를 공개 저장소나 로그에 남기지 않습니다.
업무별 구성과 최종 선택 기준
개인 개발 환경에서는 우선 GitHub와 공개 레지스트리처럼 외부 경로 품질의 영향을 크게 받는 요청을 규칙 기반으로 분리하고, 사내 시스템과 로컬 서비스는 직접 연결로 유지하는 구성이 적합합니다. Docker Desktop을 사용한다면 호스트의 VPN 연결 여부만 보지 말고 데몬이 실제로 레지스트리에 접근하는지 확인하세요. CI 빌드는 로컬 컴퓨터의 VPN을 상속하지 않으므로, 러너의 네트워크 정책과 비밀 변수, 프록시 설정을 별도로 설계해야 합니다.
HBVPN은 Windows, macOS, iOS, Android, Linux를 지원하며, 구독 링크를 호환 클라이언트로 가져와 회선을 관리할 수 있습니다. 사용 가능한 전체 규모는 90+ 국가와 200+ 회선이며, 동시 온라인 기기 수는 제한되지 않습니다. 월 구독은 ¥9.9/월에 60GB, ¥18/월에 250GB, ¥28/월에 500GB가 포함되고, 유량 패키지는 ¥158/300GB, ¥358/1000GB, ¥658/3000GB입니다. 사용량과 작업 환경에 맞춰 선택하되, 개발 서버나 CI에서 발생하는 트래픽까지 개인 환경과 동일하게 처리하지 않도록 주의해야 합니다.
가입은 이메일 주소 없이 사용자 이름과 비밀번호로 진행할 수 있고, 결제 방식은 Alipay, WeChat Pay, USDT를 지원합니다. 연결을 시작하기 전에는 [사용 안내](../../setup.html)에서 클라이언트별 가져오기 절차를 확인하고, 필요한 경우 공식 [다운로드 페이지](../../download.html)에서 지원 플랫폼에 맞는 프로그램을 선택하세요. 서비스 이용 전에는 60일 무조건 환불 정책과 현재 네트워크·업무 환경의 호환성을 함께 확인하는 것이 좋습니다.