V2Ray 설정 가이드: 설치부터 라우팅 규칙까지
이 페이지는 단계별로 찾아볼 수 있는 설정 안내서입니다. 처음 연결한다면 먼저 빠른 시작 가이드를 따라 설정을 가져오고, 프록시 모드를 선택한 뒤 연결을 확인하세요. 기본 설정을 마쳤다면 이 페이지로 돌아와 각 설정이 어떤 트래픽에 영향을 주는지 살펴보세요. 특정 문제만 해결하려면 해당 섹션으로 바로 이동해도 됩니다.
1. 기본 개념: 클라이언트, 코어, 프로토콜
요청 흐름으로 이해하는 인바운드와 아웃바운드
웹사이트에 접속하는 과정을 세 단계로 나눠 보세요. 앱이 요청을 로컬 진입점으로 보내고, 코어가 규칙에 따라 출구를 고른 다음, 해당 출구가 목적지와 연결을 맺습니다. 브라우저에서 페이지가 열렸다고 해서 해당 요청이 어떤 출구를 거쳤는지까지 알 수 있는 것은 아닙니다. 클라이언트 창이 정상적으로 표시되더라도 코어가 실행 중이거나 앱 요청이 코어에 전달되고 있다는 뜻은 아닙니다. 문제가 생기면 설정을 계속 바꾸기보다 첫 단계부터 순서대로 확인하는 편이 효과적입니다.
인바운드는 코어가 요청을 받는 인터페이스입니다. 데스크톱 앱은 로컬 HTTP 또는 SOCKS 프록시를 직접 사용할 수 있고, 시스템 프록시는 시스템 설정을 참조하는 앱에 프록시 주소를 알려 줍니다. 아웃바운드는 코어가 요청을 처리하는 방식으로, 프록시를 통한 전달, 직접 연결, 차단 등이 있습니다. 라우팅 규칙은 인바운드 다음 단계에서 사용할 아웃바운드를 결정합니다. 따라서 분기 규칙을 바꿔도 원래 클라이언트를 거치지 않던 앱이 자동으로 연결되지는 않습니다. 뒤의 섹션에서 요청이 들어오는지와 어떤 경로로 나가는지를 각각 확인합니다.
VMess 프로토콜과 전송 설정은 서로 다릅니다
Project V는 V2Ray 생태계를 이해하는 데 도움이 되는 배경입니다. V2Fly와 Xray는 관련 오픈 소스 코어 계열이며, GUI 클라이언트는 구독 항목과 라우팅, 프록시 옵션을 코어 설정으로 변환합니다. 메뉴 이름이 비슷해도 생성되는 설정까지 완전히 같지는 않습니다. 두 클라이언트가 같은 항목을 가져올 수 있다고 해서 선택한 코어가 모두 해당 항목을 실행할 수 있는 것도 아닙니다. 설정 가져오기에 성공했다는 것은 클라이언트가 입력의 일부 이상을 인식했다는 뜻일 뿐입니다.
VMess와 VLESS는 프록시 연결에서 데이터를 주고받고 사용자를 식별하는 방식을 설명합니다. 전송 방식은 TCP나 WebSocket처럼 데이터를 전달하는 방법이며, TLS는 전송 보호와 상대방 인증에 관련됩니다. 주소, 포트, 프로토콜, 전송 경로, 서버 이름은 각각 다른 역할을 합니다. 포트에 연결되지만 세션이 실패한다면 이 설정을 모두 확인하세요. 주소가 확인된다는 이유만으로 프로토콜이 일치한다고 판단하거나, 경고를 없애려고 인증서 검증을 끄면 안 됩니다.
공유 링크, 구독 주소, 전체 설정 구분하기
단일 공유 링크는 보통 하나의 연결 항목을 담아 한 번 가져올 때 적합합니다. 구독 주소는 업데이트할 수 있는 항목 목록을 가리키며, 클라이언트가 그룹 단위로 가져옵니다. 전체 설정에는 수신 대기 주소, 라우팅, 로그, DNS 설정 등이 포함될 수 있습니다. 이 세 가지는 서로 대체할 수 없습니다. 링크를 받으면 먼저 제공자가 어떤 유형으로 안내했는지 확인하고 알맞은 메뉴를 선택하세요. 구독 주소와 단일 링크 모두 접속 정보가 포함될 수 있습니다. 문제를 공유할 때는 형식과 오류, 재현 절차만 설명하고 원문은 붙여 넣지 마세요.
도메인 이름 조회가 이뤄지는 지점은 여러 곳입니다. 앱이 먼저 조회할 수도 있고, 코어가 IP 규칙을 적용하기 위해 조회할 수도 있으며, 일부 프록시 아웃바운드는 도메인을 원격에서 처리할 수 있습니다. 로그에 IP만 보인다고 해서 원래 요청에 도메인이 없었다고 단정할 수는 없습니다. 앱이 요청을 넘기기 전에 이미 주소를 조회했을 수도 있습니다. 문제를 확인할 때는 먼저 전체 요청 경로를 기록하고 어느 단계에서 도메인을 확인할 수 있는지 살펴보세요. 그에 따라 도메인 규칙, IP 규칙, 앱의 DNS 설정 중 무엇을 확인할지 결정할 수 있습니다.
2. 클라이언트 선택: v2rayN, v2rayNG, v2flyNG
기기에 맞는 앱을 고르고 설정에 맞는 코어를 선택하세요
데스크톱에서는 v2rayN을 우선 고려하세요. 다른 데스크톱 플랫폼으로 옮길 계획이라면 해당 플랫폼용 데스크톱 버전을 확인하고, Windows에서 클래식 인터페이스에 익숙하다면 WPF 버전의 메뉴와 작업 방식을 비교해 보세요. Android에서는 Xray 코어를 사용하는 v2rayNG가 기본 선택입니다. 기존 설정이 V2Fly 환경에 맞춰 제공됐다면 v2flyNG를 대안으로 고려할 수 있습니다. 선택을 시작할 때 지연 시간이 가장 낮은 앱부터 찾지는 마세요. 지연 시간은 네트워크, 서버, 테스트 방법의 영향을 받으므로 필요한 기능이 작동하는지 먼저 확인하는 것이 좋습니다.
| 플랫폼 | 클라이언트 | 다운로드 전 확인 |
|---|---|---|
| Windows | v2rayN | 현재 패키지는 x64용입니다. 크로스 플랫폼 인터페이스의 데스크톱 버전과 클래식 WPF 버전을 구분하세요. |
| macOS | v2rayN | Apple Silicon은 arm64, Intel은 x64를 선택하세요. |
| Android | v2rayNG, 대안으로 v2flyNG | 지원되는 앱 아키텍처를 확인하고 필요에 따라 arm64 또는 범용 패키지를 선택하세요. |
| Linux | v2rayN | 먼저 배포판에 맞는 deb 또는 rpm 패키지를 확인한 뒤 x64나 arm64를 선택하세요. |
기기 이름만 보고 아키텍처를 추측하지 마세요. 데스크톱 시스템이 64비트라고 표시되어도 반드시 x64인 것은 아니며 arm64일 수 있습니다. Windows에서는 ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인할 수 있습니다. macOS에서는 ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Linux에서는 다음 명령으로 현재 시스템이 보고하는 머신 아키텍처를 확인할 수 있습니다. 일반적으로 x86_64는 x64, aarch64는 arm64에 해당합니다. 가상 머신에 앱을 설치한다면 호스트가 아니라 가상 머신의 운영체제와 아키텍처를 기준으로 선택하세요.
uname -m
호환성을 세 가지 질문으로 나눠 확인하세요
첫째, 앱이 제공자가 전달한 형식을 가져올 수 있나요? 둘째, 선택한 코어가 해당 항목의 프로토콜과 전송 방식을 지원하나요? 셋째, 앱에 필요한 로컬 연결 방식과 분기 기능이 있나요? 예를 들어 시스템 프록시를 사용하지 않는 데스크톱 앱을 프록시에 연결해야 한다면 두 클라이언트가 같은 구독을 가져올 수 있더라도 로컬 프록시 진입점이나 TUN 지원을 우선 확인하세요. 브라우저에서 정해진 리소스만 이용한다면 두 연결 방식을 동시에 켤 필요는 없습니다.
다른 기기에서 옮길 때는 출처가 분명한 구독을 다시 가져온 뒤 필요한 로컬 규칙만 직접 재구성하세요. 클라이언트 설정 전체를 다른 시스템에 그대로 덮어쓰지 마세요. 기존 파일에 이전 시스템의 경로, 아웃바운드 이름, 수신 대기 포트, 시작 시 자동 실행 설정이 남아 있을 수 있습니다. 두 기기에서 서버 항목을 공유할 수는 있지만 로컬 네트워크 설정까지 같을 필요는 없습니다. 데스크톱의 사설 네트워크 대역과 프린터 주소는 모바일 기기에서 자주 사용하는 네트워크와 다를 수 있습니다.
실제 용도에 필요한 기능만 최소한으로 시험하세요
클라이언트 다운로드 페이지에서 기기에 맞는 패키지를 선택하세요. 먼저 한 앱에 정상 작동이 확인된 설정 하나를 가져와 실행되는지, 요청을 받는지, 기대한 응답을 반환하는지 확인한 다음 전체 그룹을 옮길지 결정하세요. Android 클라이언트 두 개가 모두 설치되어 있다면 전환하기 전에 기존 앱의 연결을 끊으세요. 그래야 시스템 VPN 연결 주체가 바뀐 것을 앱 충돌로 오해하지 않습니다. 데스크톱에서 두 인터페이스를 비교할 때도 같은 로컬 수신 대기 포트를 동시에 사용하지 마세요.
제공자가 복잡한 코어 설정 파일만 전달했다면 현재 클라이언트가 해당 가져오기 방식을 지원하는지 먼저 확인하세요. 공유 링크를 인식한다고 해서 임의의 JSON 파일까지 가져올 수 있는 것은 아닙니다. 사용자 지정 설정 메뉴가 있더라도 코어를 실행할 뿐 일부 설정은 더 이상 관리하지 않을 수 있습니다. 세 클라이언트의 인터페이스와 생태계 차이는 클라이언트 선택 비교에서 확인하고, 당장 필요하지 않은 기능은 실제로 필요할 때 시험하세요.
3. 설치와 첫 실행: 먼저 로컬 환경 확인
데스크톱: 클라이언트만 먼저 실행해 보세요
다운로드 페이지에 표시된 운영체제, 아키텍처, 패키지 유형에 맞춰 설치하세요. Windows에서는 선택한 데스크톱 버전 또는 WPF 버전을 실행합니다. 런타임 안내가 나타나면 안내에 표시된 프레임워크 이름과 필요한 아키텍처를 기록한 뒤 맞는 런타임을 설치하세요. 오류 내용을 읽는 대신 반복해서 재설치하지 마세요. 설정을 저장할 때 권한이 부족하다는 메시지가 나오면 설정 폴더에 쓰기 권한이 있는지, 관리 대상 경로에 있는지 확인하세요. 해결책으로 매번 관리자 권한으로 실행하는 방식은 피하세요.
macOS에서는 칩에 맞는 설치 패키지를 선택하세요. 처음 실행할 때 보안 경고가 표시되면 출처와 시스템이 안내한 구체적인 이유를 먼저 확인하고, 시스템에서 허용하는 방법으로 처리하세요. 보안 기능 전체를 끄지는 마세요. Linux에서는 배포판에 맞는 패키지 형식을 선택하고 시스템 패키지 관리자로 의존성을 처리하세요. 의존성을 충족할 수 없다는 메시지가 나오면 배포판과 소프트웨어 저장소 상태부터 확인하세요. 의존성 검사를 강제로 건너뛰면 설치 오류가 원인을 찾기 어려운 실행 문제로 이어질 수 있습니다.
처음 실행할 때는 시작 시 자동 연결, 시스템 프록시, TUN을 켜지 마세요. 인터페이스가 열리고 설정을 저장한 뒤 다시 실행해도 설정을 읽어 오는지 확인하세요. 창을 닫은 뒤에도 트레이 아이콘이 남아 있다면 프로세스가 종료되지 않았을 수 있습니다. 업그레이드하거나 설정을 바꾸기 전에 트레이 메뉴에서 종료하고 프로세스 상태를 확인하세요. 이전 인스턴스가 포트를 점유하면 새 인스턴스는 실행되더라도 코어를 시작하지 못할 수 있습니다.
Android: 설치 권한과 VPN 권한 구분하기
설치 파일이 열렸다고 해서 시스템이 VPN 연결을 허용한 것은 아닙니다. 클라이언트를 열고 처음 연결하면 시스템 권한 확인 창이 표시될 수 있습니다. 안내를 읽고 요청을 시작한 앱이 예상한 앱인지 확인하세요. 시스템은 같은 사용자 또는 프로필에서 VPN 서비스를 하나만 활성 상태로 유지하도록 허용합니다. 업무용 프로필, 네트워크 보호 기능, 다른 VPN 서비스가 이미 실행 중이라면 조직 정책에 따라 중지할 수 있는지 확인한 뒤 연결을 시도하세요.
일부 기기는 앱의 백그라운드 활동을 제한합니다. 앱이 화면에 표시될 때는 정상 작동하지만 화면을 잠근 뒤 연결이 끊기고, 같은 현상이 여러 번 재현될 때만 배터리 최적화, 백그라운드 실행 제한, 시스템 VPN 상태를 확인하세요. 한 번 실패했다고 모든 권한을 허용하지 마세요. 설치가 시작 단계에서 실패한다면 시스템 안내를 통해 아키텍처 문제, 저장 공간 부족, 기존 설치와 서명 불일치 중 원인을 구분할 수 있는지 확인하세요. 앱을 삭제하기 전에 로컬 그룹과 직접 추가한 항목을 복구할 방법이 있는지 확인해야 합니다.
되돌릴 수 있도록 첫 실행 기록을 남기세요
앱 패키지 유형, 시스템 아키텍처, 설정 저장 위치, 시작 시 프록시 모드가 꺼져 있었는지 기록하세요. 정상 작동이 확인된 항목으로 한 번 실행한 뒤 코어 로그에 파싱 실패, 리소스 누락, 포트 점유가 있는지 살펴보세요. 인터페이스 오류와 코어 로그가 동시에 남을 수 있으므로 가장 먼저 기록된 구체적인 오류를 우선 확인하세요. 나중에 나타난 연결 시간 초과만 보인다면 실제 시작 실패 원인을 놓쳤을 수 있습니다. 로그를 확인할 때 서버 정보가 포함된 전체 내용을 다른 사람에게 보내지 마세요.
포트 충돌이 생겼다고 해서 현재 포트를 반드시 바꿔야 하는 것은 아닙니다. 같은 클라이언트의 다른 인스턴스가 실행 중인지 먼저 확인하세요. 로컬 프록시 포트를 바꿔야 한다면 해당 포트를 사용하는 브라우저, 테스트 명령, 시스템 프록시 설정도 함께 업데이트해야 합니다. 코어가 포트를 열었다고 해서 원격 서버와 연결된 것은 아니므로 두 가지를 따로 확인하세요. 창이 잠깐 나타났다가 사라진다면 시작 직후 종료 문제 해결 목록을 참고해 증상에 따라 원인을 좁혀 보세요.
4. 구독 가져오기: 그룹 추가, 업데이트, 항목 확인
먼저 구독 주소와 단일 공유 링크를 구분하세요
제공자가 구독 주소를 전달했다면 구독 그룹에 입력한 뒤 업데이트하세요. vmess:// 또는 vless://로 시작하는 단일 링크라면 클립보드 가져오기나 QR 코드 메뉴를 이용하세요. 구독 주소는 보통 HTTPS 링크지만, 시작 부분만 보고 판단하면 안 됩니다. 일반 다운로드 페이지도 HTTPS를 사용할 수 있으며 구독 메뉴에 붙여 넣으면 웹 페이지가 반환될 뿐입니다. 구체적인 형식은 공유 링크와 구독 주소의 차이에서 확인하세요.
구독 응답은 일반 텍스트 링크 목록이거나 목록 전체를 Base64로 인코딩한 텍스트인 경우가 많습니다. Base64는 인코딩 방식이지 암호화가 아니므로 디코딩한 내용도 민감한 설정으로 취급해야 합니다. 제공자에 따라 다른 형식을 지원할 수 있으니 설정에서 현재 클라이언트에 맞는 형식을 선택하세요. 익숙하지 않은 구독 주소를 제3자 온라인 변환 사이트에 입력하거나 로그인 페이지 주소를 구독 주소 대신 사용하지 마세요. 링크에 쿼리 매개변수가 있다면 복사할 때 전부 보존하고 임의로 삭제하거나 수정하지 마세요.
v2rayN과 Android 클라이언트에서 구독 가져오기
v2rayN에서 ‘구독 그룹 설정’을 열고 그룹을 추가하세요. ‘별칭’에는 구분하기 쉬운 이름을 입력하고 ‘선택 주소(url)’에는 구독 주소를 넣습니다. 저장한 뒤 현재 구독 또는 해당 그룹을 업데이트하는 메뉴를 찾으세요. 처음에는 새 그룹만 업데이트해 결과를 확인하는 편이 좋습니다. 자동 업데이트를 켜기 전에 수동으로 한 번 정상 작동하는지 확인하세요. 업데이트 간격은 인터페이스에 표시된 단위를 확인하고 제공자의 안내에 맞추세요. 너무 짧은 간격으로 반복해서 새로고침할 필요는 없습니다.
v2rayNG 메뉴에서 ‘구독 그룹 설정’ 또는 해당 항목을 열고 그룹을 추가한 뒤 저장하고 목록으로 돌아가 업데이트하세요. v2flyNG도 먼저 주소를 저장한 다음 내용을 새로고침하는 순서입니다. 메뉴 이름은 현재 인터페이스에 따라 다를 수 있습니다. 업데이트가 끝나면 새로 추가한 그룹으로 전환해 항목이 해당 그룹에서 가져온 것인지 확인한 뒤 하나를 선택해 연결하세요. 그룹을 업데이트해도 현재 선택 항목이 바뀌거나 실행 중인 연결이 자동으로 다시 시작되지는 않을 수 있습니다. 메뉴와 형식에 대한 자세한 내용은 구독 가져오기와 형식 안내를 참고하세요.
가져오기·파싱·연결 단계별로 문제 해결하기
가져오기에 실패하면 먼저 HTTP 상태 코드가 표시되는지, 도메인 조회에 실패했는지 확인하세요. 인증 오류가 발생하면 권한과 주소 변경 여부를 제공자에게 문의하세요. 연결 시간 초과라면 업데이트 요청의 네트워크 경로와 실제 프록시 트래픽의 경로를 구분해야 합니다. 일부 데스크톱 옵션은 현재 프록시를 통해 구독을 가져올 수 있습니다. 현재 설정으로 연결되지 않는다면 기존 네트워크에서 직접 접속할 수 있는 업데이트 주소를 제공자가 지원하는지 확인하세요. 오류 유형을 파악하지 못한 채 무한 재시도하지 마세요.
가져오기는 성공했지만 목록이 비어 있다면 반환된 내용이 클라이언트가 지원하는 목록인지, 로그인 페이지나 안내 페이지 또는 다른 클라이언트용 형식인지 확인하세요. 그룹을 잘못 선택했거나 필터가 켜져 있지 않은지도 살펴보세요. 목록은 보이지만 연결되지 않는다면 다음 단계로 넘어가 실제 선택 항목, 코어 지원 여부, 연결 로그를 확인하세요. 업데이트 후 이름은 같은데 동작이 달라졌다면 서버 주소나 전송 설정이 바뀌었을 수 있습니다. 항목 이름만 비교하지 말고 제공자에게 설정이 변경됐는지 문의하세요.
5. 프록시 모드: 앱이 클라이언트에 연결되는지 확인
시스템 프록시는 진입점을 제어하며 아웃바운드를 결정하지 않습니다
v2rayN의 ‘시스템 프록시 자동 설정’은 보통 로컬 프록시 주소를 시스템 설정에 기록해 해당 설정을 따르는 소프트웨어가 사용하도록 합니다. ‘시스템 프록시 해제’는 시스템 프록시 설정을 제거하는 기능이며 로컬 수신 대기를 중지하는 기능은 아닙니다. ‘시스템 프록시 변경 안 함’은 현재 값을 수정하지 않는다는 뜻이지, 시스템에 기존 프록시가 없다는 보장은 아닙니다. 모드를 바꾸기 전에 시스템 설정을 살펴보세요. 특히 조직에서 프록시를 설정한 기기라면 기존 설정을 클라이언트가 남긴 값으로 오해하지 않도록 주의하세요.
시스템 설정에 프록시 주소가 보인다는 것은 설정이 기록됐다는 뜻일 뿐입니다. 브라우저는 별도로 프록시를 지정할 수 있고, 명령줄 도구는 환경 변수를 확인할 수 있습니다. 시스템 설정을 읽지 않거나 자체 프록시 메뉴가 없는 앱도 있습니다. 따라서 한 번에 앱 하나씩 확인하세요. 앱에서 프록시를 직접 설정할 때는 클라이언트 수신 설정에 맞는 HTTP 또는 SOCKS를 선택하세요. 실제 주소와 포트를 입력해야 합니다. 원격 서버 포트를 로컬 포트로 착각하거나 구독 주소를 프록시 주소 칸에 입력하면 안 됩니다.
명시적 프록시로 요청을 비교 테스트하세요
아래 예시에서는 curl로 테스트 사이트에 요청을 보냅니다. 첫 번째 명령은 프록시를 사용하지 않고, 두 번째 명령은 로컬 HTTP 프록시를 명시적으로 사용합니다. 두 번째 명령은 클라이언트의 HTTP 수신 주소가 127.0.0.1:10809라고 가정합니다. 인터페이스에 다른 값이 표시되면 먼저 바꾸세요. 이 비교는 TUN을 끈 상태에서 진행하는 것이 좋습니다. TUN이 켜져 있으면 첫 번째 요청도 앱 수준의 프록시를 사용하지 않을 뿐 가상 네트워크 인터페이스를 거칠 수 있습니다. Windows 명령 환경에서 같은 이름의 별칭이 있다면 curl.exe를 명시적으로 실행하세요.
curl --noproxy "*" --max-time 15 --head https://example.com/
curl --noproxy "" --proxy http://127.0.0.1:10809 --max-time 15 --head https://example.com/
두 번째 명령에서 로컬 포트에 연결할 수 없다면 코어, 수신 주소, 포트를 확인하세요. 인증서 오류가 발생하면 오류 내용을 보존하고 시스템 시간, 인증서 신뢰, 상대방 신원을 확인하세요. HTTP 상태 코드가 반환됐다면 적어도 응답을 돌려주는 지점까지 도달한 것입니다. 하지만 코어가 프록시 아웃바운드를 선택했다는 뜻은 아닙니다. 아웃바운드를 확인하려면 같은 시각의 로그와 비교하세요. 대상이 HEAD 요청을 지원하지 않는다면 --head를 빼고 일반 요청을 보내세요. 메서드 제한을 연결 실패로 오해하지 마세요.
모바일 연결과 종료 후 설정 복구
Android 클라이언트는 시스템 VPN 서비스를 통해 앱 트래픽을 받는 경우가 많습니다. 앱 목록에서 연결 범위를 제한할 때 선택한 앱만 포함하는 모드인지, 선택한 앱을 제외하는 모드인지 먼저 확인하세요. 두 모드는 동작이 정반대입니다. 브라우저는 되지만 다른 앱은 안 된다면 해당 앱이 연결 대상에 포함됐는지 확인한 뒤 코어 규칙을 살펴보세요. 알림 영역에 VPN 상태가 표시되는 것은 트래픽을 가져오고 있다는 신호일 뿐 특정 목적지에 접속할 수 있다는 뜻은 아닙니다.
테스트가 끝나면 원래 네트워크 설정을 복구하세요. 데스크톱에서는 정해 둔 방법으로 클라이언트가 바꾼 시스템 프록시 설정을 되돌린 뒤 앱을 종료하고, 프록시 주소가 중지된 로컬 포트를 계속 가리키는지 확인하세요. 원래 조직에서 요구하는 프록시를 사용했다면 관리자 안내에 따라 설정을 복원하세요. 모바일에서는 연결을 끊은 뒤 같은 앱으로 테스트 대상에 다시 접속해 항상 사용 VPN 또는 VPN 없이 연결 차단 설정이 켜져 있는지 확인하세요. 관리 대상 환경에서는 조직 정책을 따르세요.
로컬 프록시 수신 주소는 기본적으로 루프백 주소로 제한하세요. LAN 연결 허용은 별도의 설정으로, 다른 기기가 해당 포트에 연결할 수 있게 합니다. 시스템 프록시를 읽지 않는 로컬 앱을 위한 해결책이 아닙니다. 특히 공용 네트워크에서는 문제 해결을 위해 수신 범위를 넓히지 마세요. 앱, 시스템 프록시, 코어의 세 단계마다 각각 독립적으로 확인할 방법을 마련하세요.
6. 라우팅 규칙: 규칙 순서·도메인 매칭·기본 출구
먼저 목적지를 세 종류로 나눈 뒤 규칙을 작성하세요
어떤 목적지는 직접 연결하고, 어떤 목적지는 프록시로 전달하며, 어떤 목적지는 차단할지 먼저 정하세요. 흔히 로컬 서비스와 직접 연결을 허용할 내부 네트워크 대역을 앞쪽에 두고, 구체적인 도메인 예외를 추가한 다음, 일치하지 않는 트래픽의 처리 방식을 마지막에 지정합니다. 많은 코어가 목록 순서대로 조건에 맞는 첫 번째 규칙을 찾습니다. 범위가 넓은 규칙을 앞에 두면 더 구체적인 규칙이 적용되지 않을 수 있습니다. 특히 차단 규칙은 순서에 따라 해당 요청이 뒤의 예외 규칙까지 도달할 수 있는지가 달라집니다.
규칙에 적는 아웃바운드 태그는 현재 설정에 실제로 정의된 태그와 일치해야 합니다. 인터페이스에 ‘직접 연결’이라고 표시되어도 내보내는 태그가 반드시 direct인 것은 아닙니다. 마찬가지로 정적 안내에 기본 경로 예시로 나온 final → proxy를 JSON에 그대로 복사하지 마세요. 코어마다 기본 아웃바운드 필드와 작성 방식이 다릅니다. GUI에서는 규칙 그룹의 기본 출구를 먼저 확인하세요. 코어 설정 파일을 읽을 때는 규칙에 일치하지 않는 연결이 어떻게 처리되는지 확인하세요.
도메인 조건과 IP 조건 구분하기
domain:은 도메인과 하위 도메인을 매칭할 수 있습니다. 도메인 하나만 지정하려면 full:을 사용할 수 있습니다. geosite:는 도메인 목록을, geoip:는 IP 주소 목록을 사용합니다. 이 항목을 사용하려면 코어가 해당 리소스를 읽을 수 있어야 하며 목록에 원하는 이름이 실제로 포함되어야 합니다. 안정적으로 사용하는 내부 네트워크라면 전체 목록을 추가하는 것보다 확인된 대역을 명시하는 편이 검증하기 쉽습니다. 도메인 매칭은 되지만 IP 규칙이 적용되지 않는다면 현재 정책에서 규칙 적용을 위해 도메인을 조회할 수 있는지 먼저 살펴보세요.
IPIfNonMatch는 도메인으로 매칭되지 않았을 때 이후 규칙에서 사용할 IP 주소를 조회하도록 할 수 있습니다. 앱 전체에 적용되는 DNS 스위치도 아니며, 이미 IP 주소가 전달된 요청을 신뢰할 수 있는 도메인으로 되돌리는 기능도 아닙니다. 다음은 V2Ray 계열 코어의 라우팅 객체 예시이며 완전한 실행 파일이 아닙니다. 호환되는 설정의 routing 필드에 병합하기 전에 direct와 proxy가 정의되어 있는지 확인하고, 예시 도메인과 네트워크 대역을 검증된 테스트 대상으로 바꾸세요.
{
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["127.0.0.0/8", "::1/128", "192.168.1.0/24"],
"outboundTag": "direct"
},
{
"type": "field",
"domain": ["full:example.com"],
"outboundTag": "proxy"
}
]
}
페이지가 열리는지만 보지 말고 규칙 적용 여부를 확인하세요
테스트 대상 세 개를 고르세요. 직접 연결해야 하는 내부 리소스, 프록시 규칙이 적용되는 테스트 도메인, 앞의 규칙에 해당하지 않는 일반 목적지입니다. 각 요청이 어떤 인바운드로 들어와 실제로 어떤 아웃바운드로 나가는지 기록하세요. 웹페이지는 정상으로 보여도 로그의 경로가 예상과 다르면 규칙을 더 확인해야 합니다. 브라우저가 기존 연결을 재사용할 수 있으므로 규칙을 수정한 뒤 새 연결을 만들어 테스트하세요. 페이지의 이미지와 API가 서로 다른 도메인을 사용할 수도 있으므로 기본 문서의 로그만으로 모든 하위 요청을 판단하면 안 됩니다.
특정 목적지에 문제가 생기면 먼저 요청에 도메인과 IP 중 무엇이 들어왔는지 확인한 다음 앞선 규칙에 가로막혔는지 살펴보세요. 범위가 가장 좁은 규칙 하나를 수정해 다시 테스트하세요. 임시로 네트워크 대역 전체를 넓히지 마세요. 도메인 목록을 추가한 뒤 코어가 시작되지 않으면 이전 규칙으로 되돌리고 목록 이름, 리소스 위치, 로드 오류를 확인하세요. 전체 설정에서 DNS와 아웃바운드가 어떻게 연결되는지 더 알아보려면 V2Ray JSON 설정 구조를 읽어 보세요.
클라이언트는 코어를 시작할 때 실제 설정 파일을 생성하는 경우가 많습니다. 생성 파일을 직접 편집하면 다음 실행 때 덮어써질 수 있으므로 먼저 GUI에서 규칙을 저장하고 내보낸 설정으로 확인하세요. 사용자 지정 설정을 꼭 써야 한다면 작동 중인 사본을 따로 보관하고, 코어가 불러올 수 있는지와 규칙이 기대대로 작동하는지를 나눠서 검증하세요. 새 규칙을 적용하기 전에 로컬 관리 화면에 다시 접속할 방법이 있는지도 확인하세요.
7. TUN 모드: 연결 범위·DNS·내부 네트워크 예외
연결 범위를 넓혀야 할 때만 활성화하세요
앱이 시스템 프록시를 사용할 수 있다면 먼저 시스템 프록시나 앱 내 프록시를 이용하세요. TUN은 앱 수준 프록시 설정을 따르지 않는 IP 트래픽까지 받아야 할 때 적합합니다. 가상 네트워크 인터페이스와 시스템 라우팅을 통해 트래픽을 코어로 전달하므로 브라우저 프록시를 바꾸는 것보다 영향 범위가 큽니다. 특정 트래픽을 가져올 수 있는지는 시스템 라우팅, 권한, 현재 코어, 앱 동작에 따라 달라집니다. 스위치를 켠다고 모든 프로토콜이나 기기 검색, 내부 네트워크 서비스가 자동으로 정상 작동하는 것은 아닙니다.
활성화하기 전에 기존 설정부터 정상 작동하는지 확인하세요. 로컬 수신 대기를 사용할 수 있고 선택한 아웃바운드가 연결되며 기본 라우팅이 예상대로 동작해야 합니다. 현재 시스템 프록시, 네트워크 인터페이스, DNS 설정을 기록하세요. 관리 대상 기기에서 가상 네트워크 어댑터나 라우팅 변경이 제한되어 있다면 먼저 허가를 받으세요. 이번 실행에만 권한 상승이 필요하다면 앱 안내에 따라 처리하세요. 시작 실패를 이유로 보안 설정을 반복해서 바꾸거나 실패한 상태를 시작 시 자동 실행으로 설정하지 마세요.
먼저 최소 범위만 연결하고 직접 연결과 종료를 확인하세요
v2rayN의 TUN 설정에서 선택한 코어와 현재 플랫폼이 해당 기능을 지원하는지 확인하세요. 처음 테스트할 때는 안내서나 인터페이스 설명에 따라 비교용으로 사용하던 시스템 프록시를 끄고 다른 트래픽 가로채기 도구를 종료하세요. 여러 경로를 동시에 바꾸지 않도록 하기 위해서입니다. TUN을 켠 뒤 클라이언트가 인터페이스 생성 성공을 보고하는지 확인한 다음, 원래 시스템 프록시를 사용하지 않던 앱으로 테스트하세요. 정상 작동이 확인된 테스트 대상 하나부터 시작해 해당 요청이 로그에 나타나는지 확인하세요.
그다음 직접 연결해야 하는 리소스를 테스트하세요. 예를 들어 직접 관리하는 LAN 관리 페이지나 공유 서비스를 이용할 수 있습니다. 시스템 라우팅에서 제외하는 것과 코어에서 직접 연결하는 것은 다릅니다. 제외는 트래픽이 가상 인터페이스에 들어오지 않는다는 뜻이고, 코어의 직접 연결은 트래픽이 먼저 코어로 들어온 뒤 코어가 연결을 맺는다는 뜻입니다. 브로드캐스트, 멀티캐스트, 특정 네트워크 어댑터에 의존하는 앱은 원래 시스템 경로를 유지해야 할 수 있습니다. 먼저 리소스가 실제로 위치한 네트워크 대역을 확인하고 현재 플랫폼에서 지원하는 제외 방법을 사용하세요. 다른 사람의 사설 IP 목록을 그대로 복사하지 마세요.
IP가 보인다고 도메인과 DNS가 모두 정상인 것은 아닙니다
TUN을 사용하면 IP 연결은 되지만 앱에서 도메인을 조회하지 못하는 경우가 있습니다. 먼저 설정을 켜기 전후 같은 도메인의 조회 결과를 비교한 뒤 클라이언트가 DNS 트래픽 처리 옵션을 변경했는지 확인하세요. 일부 앱은 자체 암호화 DNS를 사용하므로 시스템 조회 결과만으로 해당 앱의 동작을 모두 알 수는 없습니다. DNS를 바꾸기 전에 조회 요청이 전달되지 않은 것인지, 다른 해석기를 사용한 것인지, 조회에는 성공했지만 연결에 실패한 것인지 구분하세요. 앞의 두 경우는 트래픽을 가져오는 경계를 확인하고, 조회에 성공한 뒤 실패한다면 라우팅이나 아웃바운드를 살펴보세요.
TUN을 켠 뒤 대부분의 연결이 시간 초과된다면 클라이언트 자체의 아웃바운드 연결이 다시 가상 인터페이스로 들어가는지 확인하세요. 구현마다 인터페이스 바인딩이나 라우팅 제외 등의 방식으로 루프를 방지하므로 다른 플랫폼의 설정값을 무작정 적용하지 마세요. 큰 요청만 멈추고 작은 요청은 정상이라면 MTU와 경로 제한을 살펴볼 수 있습니다. 먼저 같은 테스트를 반복하고 기존 값과 복구 방법을 기록하세요. 한 번 느린 요청이 있었다고 바로 MTU 문제로 단정하지 마세요.
마지막으로 TUN을 끄고 시스템 프록시 상태, 기본 네트워크, 내부 네트워크 리소스를 다시 확인하세요. 인터페이스에서 껐는데 시스템 라우팅이 복구되지 않았다면 앱을 정상 종료한 뒤 시스템 도구로 남은 인터페이스와 라우팅 상태를 확인하세요. 정체를 모르는 가상 인터페이스를 함부로 삭제하지 마세요. Android 클라이언트도 VPN 서비스를 통해 트래픽을 가져오지만 데스크톱 TUN의 메뉴와 설정값을 그대로 적용할 수는 없습니다. 모바일에서는 시스템 권한, 앱 범위, VPN 상태를 먼저 확인하세요.
8. 일상 관리: 업데이트·백업·단계별 문제 해결
업데이트는 항목별로 나눠 진행하세요
클라이언트, 코어, 규칙 리소스, 구독은 모두 업데이트할 수 있지만 업데이트 이유는 각각 다릅니다. 클라이언트 변경은 인터페이스와 설정 이전에 영향을 주고, 코어 변경은 매개변수 호환성에 영향을 줄 수 있습니다. 규칙 리소스가 바뀌면 목록의 적용 범위가 달라지고, 구독이 바뀌면 서버 항목이 직접 변경됩니다. 모든 업데이트를 한꺼번에 끝낸 뒤에야 테스트하면 문제가 어느 변경에서 시작됐는지 빠르게 찾기 어렵습니다. 업데이트 전에 출처와 지원 범위를 확인하고 업데이트 후에는 이전과 같은 최소 테스트를 실행하세요.
백업할 때는 최소한 현재 클라이언트, 코어 선택, 수신 대기 포트, 직접 추가한 그룹, 라우팅 순서, TUN 예외 설정을 기록하세요. 내보낸 파일에 구독 주소나 계정 정보가 포함될 수 있으므로 관리되는 위치에 보관하고 공개 채팅방에 보내거나 공유 프로젝트에 그대로 추가하지 마세요. 제공자에게 다시 받을 수 있는 항목은 접속 정보를 복제하기보다 복구 방법만 기록해 둘 수 있습니다. 다른 기기로 옮기기 전에는 백업 형식이 호환되는지 확인하세요. 모든 내보내기 파일을 다른 운영체제나 버전에서 바로 복원할 수 있는 것은 아닙니다.
증상에 맞춰 첫 점검 항목을 선택하세요
| 증상 | 먼저 확인할 항목 | 다음 단계 |
|---|---|---|
| 인터페이스가 시작 직후 종료됨 | 시스템 아키텍처, 런타임 안내, 폴더 권한 | 앱 오류 기록과 보안 소프트웨어의 차단 이유를 확인하세요. |
| 구독 업데이트 실패 | 그룹 주소, 권한 상태, 업데이트에 사용된 네트워크 경로 | 요청 실패와 콘텐츠 파싱 실패를 구분하세요. |
| 연결 후 특정 앱 하나만 작동하지 않음 | 시스템 프록시 지원 여부, 앱에서 직접 지정한 프록시, 트래픽 연결 범위 | 해당 앱의 요청이 클라이언트에 들어오는지 확인하세요. |
| 연결 후 특정 목적지 하나만 문제가 있음 | 해당 목적지의 도메인, 주소, 규칙 순서 | 실제 아웃바운드와 같은 시간대의 로그를 비교하세요. |
| 종료 후에도 인터넷에 연결할 수 없음 | 시스템 프록시, 가상 인터페이스, 시스템 VPN 상태 | 원래 설정을 복원하고 정상 작동이 확인된 목적지로 테스트하세요. |
문제 기록에는 언제 시작됐는지, 무엇을 바꿨는지, 어떤 앱에 영향을 주는지 적으세요. ‘연결 안 됨’이라고만 쓰지 마세요. Wi-Fi에서는 실패하고 모바일 네트워크에서는 정상이라면 같은 앱과 같은 목적지로 비교하고, 두 테스트에서 같은 그룹을 사용했는지도 기록하세요. 네트워크를 바꾼 뒤 기존 연결에 이전 상태가 남아 있을 수 있으므로 새 연결을 만든 다음 비교하세요. 일부 페이지만 열리는 경우 시스템 시간과 인증서 오류도 확인하고 서버 장애라고 바로 단정하지 마세요.
재현에 필요한 범위만 로그에 남기세요
문제를 재현하기 전에 시간을 기록하고, 원인을 찾는 데 충분한 수준으로 로그를 잠시 활성화한 뒤 한 번 재현하고 기본 수준으로 되돌리세요. 도움을 요청할 때는 가장 먼저 발생한 오류와 테스트 결과, 설정 차이를 알 수 있도록 앞뒤 로그를 소량만 남기고 계정 식별 정보, 주소 매개변수, 관련 없는 접속 정보는 삭제하세요. ‘시간 초과’ 한 줄만으로는 로컬 수신 대기, 원격 연결, 목적지 응답 지연을 구분하기 어렵습니다. 요청이 들어왔는지와 올바른 아웃바운드를 선택했는지 함께 기록해야 유용합니다.
설정을 되돌린 뒤에도 검증이 필요합니다. 설정을 전부 지우기보다 직전 변경 사항, 예를 들어 이전 규칙 그룹부터 복원하세요. 다시 불러온 다음 기존 테스트 대상 세 개로 직접 연결, 프록시, 기본 경로를 각각 확인하세요. 클라이언트 파일만 복원하고 TUN이나 시스템 프록시를 되돌리지 않았다면 네트워크가 여전히 새 설정을 따를 수 있습니다. 복구가 끝나면 앱을 다시 시작한 뒤에도 정상 작동하는지 확인하고, 변경 사항이 실제로 문제의 원인을 설명했는지 기록하세요.
반복할 수 있는 작업은 점검 목록으로 만드세요. 업데이트 전에 설정을 복구할 수 있는지 확인하고, 업데이트 후에는 연결 테스트와 종료 테스트를 각각 한 번 진행하세요. 사용하지 않는 직접 추가 항목과 만료된 그룹도 주기적으로 정리하세요. 설치나 패키지 선택 문제는 다운로드 페이지의 시스템 요구 사항과 자주 묻는 질문에서 확인하세요. 이전 기기에서의 설치 경험으로 현재 플랫폼 안내를 대신하지 마세요.
9. 고급 활용: 설정 읽기·비교 테스트·인수인계
내보낸 설정을 읽고 직접 작성할지 결정하세요
먼저 정상 작동을 확인한 설정을 내보내세요. inbounds에서 테스트 앱이 실제로 사용하는 진입점을 찾아 주소, 포트, 태그를 기록합니다. outbounds에서는 각 태그가 어떤 동작을 하는지 확인하고, 마지막으로 routing이 두 항목을 어떻게 연결하는지 읽어 보세요. 이어서 dns와 log가 어느 단계에 영향을 주는지 살펴보세요. 파일 첫 줄부터 매개변수를 하나씩 외우는 것보다 이 순서가 이해하기 쉽습니다. 내보낸 설정에 계정 정보가 포함될 수 있으므로 확인용 사본을 공유 예시와 섞어 두지 마세요.
다음으로 클라이언트 인터페이스에서 설정 하나만 바꾼 뒤 다시 내보내세요. 두 파일을 비교해 해당 변경이 실제로 어떤 필드를 수정했는지 확인합니다. 인터페이스의 스위치 하나가 인바운드와 시스템 설정을 동시에 바꿀 수도 있고, 코어 파일에는 직접 반영되지 않을 수도 있습니다. 예를 들어 클라이언트가 시스템 프록시를 설정했는지는 코어의 라우팅 부분만 읽어서는 알 수 없습니다. 반대로 파일에 인바운드가 있다고 해서 현재 앱이 그 인바운드를 사용하고 있다는 뜻도 아닙니다.
설정 실험을 재현 가능한 테스트로 기록하세요
각 실험에 예상 결과, 반대 사례, 중단 조건을 기록하세요. 예를 들어 정확한 도메인 매칭을 확인하려면 대상 도메인과 매칭되지 않을 일반 대상이 각각 어떤 아웃바운드를 사용할지 먼저 적어 두세요. 규칙을 수정한 뒤 연결을 새로 만들고 로그를 확인한 다음 규칙을 되돌려 다시 테스트하세요. 결과가 달라지지 않았다면 요청을 먼저 처리하는 상위 조건이 있는지, 두 경로가 원래 같은 아웃바운드인지 확인하세요. 한 번 접속에 성공한 결과를 보여 주는 것보다 반대 사례까지 설명하는 편이 더 유용합니다.
여러 기기로 확장할 때 공유해야 할 것은 규칙의 의도이지 설정 파일 전체가 아닙니다. 데스크톱은 고정된 수신 포트를 사용할 수 있지만 모바일은 시스템 VPN의 연결 범위가 중요합니다. 구독을 공유한다고 모든 기기에서 같은 DNS와 내부 네트워크 예외를 사용해야 하는 것은 아닙니다. 기기 유형별로 필요한 최소한의 테스트를 마련하세요. 새 기기를 추가할 때는 먼저 최소한의 설정만 가져와 기본 경로가 정상인지 확인한 다음 필요한 규칙만 옮기세요. 고급 설정을 한꺼번에 모두 적용하지 마세요.
다른 사람이 이해하고 직접 복구할 수 있는 기록을 남기세요
인수인계할 때는 어떤 앱이 클라이언트를 거치는지, 계속 접속할 수 있어야 하는 LAN 서비스는 무엇인지, 기본 아웃바운드가 무엇인지, 구독 업데이트를 누가 담당하는지 쉬운 말로 설명하세요. 첨부 자료에는 민감 정보를 제거한 설정 일부, 비교 테스트용 목적지, 복구 순서를 포함할 수 있습니다. 예시를 작성할 때 실제 계정 정보는 넣지 말고 주소는 명확한 예시 도메인을 사용하세요. 다음 담당자가 스크린샷을 보고 스위치를 그대로 누르는 것이 아니라 예상 동작을 판단할 수 있도록 해야 합니다.
고급 설정을 모두 켜는 것이 고급 활용은 아닙니다. 요청이 클라이언트에 들어오지 않는지, 잘못된 경로로 분기되는지, 아웃바운드 자체가 작동하지 않는지만 구분해도 대부분의 일상적인 문제를 해결할 수 있습니다. 설명하기 어려운 스위치를 여러 개 더하는 것보다 작고 명확한 규칙을 유지하는 편이 안정적입니다. 일정한 주기로 설치, 구독 업데이트, 연결, 종료의 최소 절차를 다시 실행해 기록이 현재 인터페이스와 맞는지 확인하세요. 기본 절차를 다시 진행해야 한다면 빠른 시작 가이드로 돌아가세요.