V2Ray 전체 플랫폼 설치 및 설정 가이드
설치 파일, 구독 가져오기, 시스템 프록시 및 TUN
처음 설정하고 연결 하나만 확인하려면 빠른 시작의 가져오기, 연결, 확인 순서대로 진행하세요. 이 페이지는 플랫폼별 참고 가이드입니다. 설치 파일 선택, 시스템 권한, 트래픽 분할 방식이 다를 때는 해당 항목을 확인하세요. 설치를 마쳤는데 연결에 문제가 있다면 연결 확인 및 설정 복구 항목부터 살펴보세요.
공통 준비 사항
클라이언트, 코어 및 설치 파일
데스크톱에서는 v2rayN을 우선 권장합니다. 구독 그룹, 서버, 라우팅 설정, 로컬 연결 지점을 관리하며, 실제 연결 처리는 실행 중인 코어가 담당합니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어가 필요한 경우 v2flyNG를 선택하세요. 호환성은 전체 연결 설정을 기준으로 판단해야 합니다. VLESS로 표시된 두 설정이라도 전송 방식, 보안 유형, 흐름 제어가 다를 수 있으므로 프로토콜 이름만으로 클라이언트 간 호환 여부를 판단할 수 없습니다. 구독에 REALITY가 포함된 것을 알고 있다면 Xray 클라이언트가 해당 노드를 올바르게 인식하는지 먼저 확인하세요.
| 플랫폼 | 클라이언트 | 설치 파일 선택 기준 | 주요 트래픽 진입 방식 |
|---|---|---|---|
| Windows | v2rayN | x64 데스크톱 버전 또는 클래식 WPF 버전 | 시스템 프록시, TUN |
| macOS | v2rayN | Apple Silicon은 arm64, Intel은 x64 선택 | 시스템 프록시, TUN |
| Linux | v2rayN | 배포판에 맞춰 deb 또는 rpm을 선택한 다음 아키텍처 확인 | 데스크톱 프록시, 명시적 프록시, TUN |
| Android | v2rayNG、v2flyNG | 64비트 ARM 앱을 지원하면 arm64를 선택하고, 그렇지 않으면 범용 버전 확인 | 시스템 VPN 인터페이스 |
클라이언트 다운로드 페이지에서 해당 플랫폼을 선택하세요. 먼저 시스템 정보에서 아키텍처를 확인한 다음 설치 파일 형식을 살펴보세요. Linux에서는 배포판이 어떤 패키지 형식을 지원하는지도 확인해야 합니다. 두 기기가 모두 ARM 칩을 사용하더라도 같은 설치 파일을 쓸 수 있다는 뜻은 아닙니다. 데스크톱과 휴대전화는 앱 형식이 다르고, 같은 플랫폼에서도 시스템이 제공하는 실행 환경이 제한될 수 있습니다. 설치에 실패하면 시스템에 표시된 원래 오류 메시지를 먼저 확인하고, 아키텍처 불일치, 실행 구성 요소 누락, 설치 권한 부족을 구분한 뒤 설치 파일을 바꿀지 환경을 복구할지 결정하세요.
구독 주소, 단일 노드 링크 및 서비스 설정
구독 주소는 서버 목록을 주기적으로 가져오는 데 사용하고, 단일 노드 링크는 서버 항목 하나만 가져옵니다. 웹의 구독 관리 페이지와 클라이언트가 읽는 구독 주소도 서로 다릅니다. 복사하기 전에 용도를 확인하고, 로그인 페이지 주소를 구독 그룹에 입력하지 마세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 스크린샷, 로그, 문의 내역에 원본 링크를 첨부하지 않는 것이 좋습니다. 서비스 제공자가 QR 코드만 제공한다면 코드가 단일 노드인지 구독인지 확인한 뒤 스캔 또는 구독 가져오기 방식을 선택하세요.
직접 관리하는 노드가 있다면 구독에서 가져온 노드와 별도 그룹에 보관하는 것이 좋습니다. 구독을 새로 고칠 때 해당 그룹이 다시 구성될 수 있어 구독 노드의 설정을 직접 수정해도 유지되지 않을 수 있습니다. 그룹 이름에는 용도를 알아볼 수 있는 설명을 사용하고, 계정, 비밀번호, 전체 주소는 적지 마세요. 업데이트 후에는 활성 노드가 속한 그룹과 프로토콜을 기록해 비슷한 이름의 서버를 혼동하지 않도록 하세요. 여러 기기에서 하나의 구독을 공유한다면 서비스 제공자의 기기 수와 동시 연결 제한도 확인해야 합니다.
초기 상태를 기록하고 첫 테스트 범위를 좁히기
기기의 날짜, 시간, 시간대가 정확한지 확인하고 프록시를 사용하지 않는 상태에서 테스트 페이지에 접속할 수 있는지 확인하세요. 기존 시스템 프록시, 회사 네트워크 설정, 다른 VPN의 상태와 클라이언트의 로컬 수신 포트를 기록합니다. 조직에서 관리하는 기기라면 변경 권한이 있는 설정부터 확인하세요. 첫 설정에서는 노드 하나와 트래픽 진입 방식 하나만 선택하고, 기존 라우팅, 사용자 지정 DNS, 다른 전달 설정을 한꺼번에 가져오지 마세요. 기준 상태를 반복해서 확인할 수 있게 된 뒤 설정을 하나씩 추가하세요.
반복해서 접속할 수 있는 대상 두 곳을 준비하세요. 하나는 직접 연결 경로 확인용이고, 다른 하나는 프록시 경로를 확인할 서비스 주소입니다. 첫 테스트에서는 네트워크, 노드, 대상을 바꾸지 마세요. 무선 네트워크를 바꾸면서 노드까지 바꾸면 원인을 구분하기 어렵습니다. 기존 클라이언트에서 옮기는 경우에는 기존 실행 방식과 설정 디렉터리를 보존한 뒤 새 설치를 테스트하세요. 쓰기 가능한 디렉터리를 두 클라이언트가 동시에 사용하도록 실행하지 마세요. 이후 설정 변경에 문제가 생겨도 기존 네트워크 상태로 되돌릴 수 있습니다.
Windows: v2rayN 설치 및 시스템 프록시
데스크톱 버전과 클래식 WPF 버전
Windows 다운로드 페이지를 여세요. v2rayN 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 기존 Windows 인터페이스를 사용합니다. 메뉴 위치는 다를 수 있지만 설치 후 기본 순서는 같습니다. 구독 그룹 추가, 구독 업데이트, 서버 선택, 트래픽 진입 방식 설정 순으로 진행하세요. 인터페이스 버전을 바꾸기 전에는 기존 인스턴스를 종료하고 작업 표시줄 알림 영역에 실행 중인 프로세스가 남아 있는지 확인하세요. 두 인스턴스를 동시에 실행하면 같은 포트를 두고 충돌하거나, 종료 과정에서 서로의 시스템 프록시 설정을 덮어쓸 수 있습니다.
‘설정 → 시스템 → 정보’에서 ‘시스템 종류’를 확인하세요. x64 설치 파일은 앱 아키텍처에 맞는 파일입니다. 시스템에 ‘64비트’라고 표시된다는 이유만으로 x64라고 판단하면 안 됩니다. ARM 프로세서가 표시된다면 시스템의 호환 실행 조건도 별도로 확인하세요. 실행 시 시스템이 구성 요소 설치를 요청하면 구성 요소 이름과 아키텍처를 확인하고 안내에 따라 진행하세요. 기본 창은 열리지만 코어 시작에 실패한다면 클라이언트 로그를 확인하세요. 앱 실행 문제와 구독 문제를 혼동하지 말고, 같은 단계에서 설치 파일과 노드를 동시에 바꾸지 마세요.
구독 가져오기 및 활성 서버 선택
‘구독 그룹’ 메뉴를 여세요. ‘구독 그룹 설정’에서 그룹을 추가하거나 화면에 있는 ‘구독 그룹 추가’ 기능을 사용해 설명과 구독 주소를 입력합니다. 저장한 뒤 ‘모든 구독 업데이트’에 해당하는 기능을 실행하세요. 메뉴에서 프록시 사용 여부에 따라 업데이트 방식이 나뉜다면, 사용 가능한 연결을 아직 설정하지 않은 첫 실행에서는 현재 네트워크에서 구독 주소에 직접 접속할 수 있는지 먼저 확인하세요. 서비스 제공자가 특정 다운로드 경로를 요구한다면 안내된 방식으로 구독을 가져오세요. 관리 페이지나 오류 페이지를 구독 내용으로 사용하면 안 됩니다.
노드가 해당 그룹에 표시될 때까지 기다린 다음 목록에서 서버 하나를 명시적으로 활성 서버로 선택하세요. 행이 강조 표시되는 것은 선택 상태일 뿐입니다. 현재 서버로 적용됐는지는 상태 표시줄이나 알림 영역의 안내로 확인하세요. 업데이트 후 노드가 표시되지 않으면 그룹 주소, 업데이트 로그, 서비스 이용 기간을 먼저 확인하세요. 일부 노드만 빠졌다면 해당 항목의 형식과 현재 코어의 지원 범위를 확인하세요. 설치가 정상인지 확인하기 위해 그룹 전체를 먼저 속도 측정할 필요는 없습니다. 사용 가능한 것으로 확인된 노드 하나를 선택하는 편이 문제를 찾기 쉽습니다.
시스템 프록시, TUN 및 종료 순서
먼저 알림 영역의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 설정’을 선택한 뒤, 시스템 프록시를 따르는 브라우저로 테스트하세요. 필요하면 Windows의 ‘설정 → 네트워크 및 인터넷 → 프록시’에서 프록시 주소와 포트가 현재 클라이언트를 가리키는지 확인하세요. 여기서 ‘시스템 프록시 자동 설정’은 클라이언트가 시스템 프록시를 설정하는 동작이며 Windows의 ‘자동으로 설정 검색’과는 다릅니다. 일부 터미널 도구, 백그라운드 서비스, 자체 프록시 설정이 있는 앱은 시스템 설정을 따르지 않을 수 있습니다. 브라우저가 정상이라고 해서 모든 프로그램의 트래픽이 처리되는 것은 아닙니다.
대상 프로그램이 시스템 프록시를 사용하지 않는다면 자체 프록시 설정을 제공하는지 먼저 확인하세요. 가상 네트워크 인터페이스로 트래픽을 처리해야 할 때는 ‘TUN 모드 활성화’를 시도하세요. 테스트 전에는 클라이언트가 설정한 시스템 프록시를 해제해 진입 방식을 하나만 두세요. 안내에 따라 필요한 권한을 부여하고 가상 인터페이스, 라우팅, 로컬 네트워크가 정상인지 확인합니다. 설치나 문제 해결을 위해 모든 도구를 장기간 관리자 권한으로 실행하지 마세요. 기본 경로를 처리하는 다른 프로그램도 동시에 실행하지 않는 것이 좋습니다. 종료하기 전에 이번에 설정한 프록시와 TUN 상태를 해제하고 기록해 둔 이전 설정으로 복원하세요.
macOS: 칩에 맞는 설치 파일과 네트워크 서비스
칩에 맞는 버전 설치 및 시스템 안내 확인
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 정보에 ‘칩’이 표시되고 Apple Silicon이라면 macOS 다운로드 페이지에서 arm64 디스크 이미지를 선택하세요. Intel 프로세서가 표시되면 x64를 선택합니다. 디스크 이미지를 연 뒤 창의 안내에 따라 앱을 ‘응용 프로그램’으로 옮기고 해당 폴더에서 실행하세요. 마운트된 이미지에서 계속 실행하지 마세요. 업데이트할 때는 메뉴 막대에서 기존 인스턴스를 종료한 뒤 앱을 교체해 두 복사본이 같은 설정을 사용하거나 동시에 시스템 설정을 변경하지 않도록 하세요.
처음 실행할 때 시스템에서 차단된다면 안내 내용을 먼저 확인하세요. 아키텍처 불일치, 앱 손상 안내, 확인되지 않은 출처, 조직 정책 제한은 서로 다른 문제입니다. 설치 이미지와 시스템 아키텍처를 다시 확인한 뒤에도 보안 안내가 나타나면 전체 보안 기능을 끄지 말고 해당 앱에 적용되는 시스템 절차와 조직 정책에 따라 처리하세요. 인터페이스는 실행되지만 네트워크 기능을 사용할 수 없다면 클라이언트 로그부터 확인하세요. 이는 앱이 열리지 않는 문제와 다르며 앱을 다른 폴더로 옮기는 것만으로 해결되지 않습니다.
구독 그룹 및 메뉴 막대 상태
v2rayN의 ‘구독 그룹’에 주소와 알아보기 쉬운 설명을 추가하고 저장한 뒤 업데이트를 실행하세요. 구독 그룹을 열어 노드에 실제 주소, 포트, 프로토콜 항목이 있는지 확인하고 서버 하나를 활성 서버로 지정합니다. 업데이트에 실패하면 일반 웹 페이지에 접속할 수 있는지, 현재 네트워크에 로그인이 필요한지 비교한 다음 구독 응답이 클라이언트에서 읽을 수 있는 형식인지 확인하세요. 브라우저에서 서비스 관리 페이지에 로그인했더라도 클라이언트가 그 로그인 상태를 공유하는 것은 아닙니다. 로그인 페이지가 내려왔다면 서비스 제공자 페이지에서 전용 구독 주소를 다시 복사해야 합니다.
창을 닫아도 프로세스가 종료되지 않을 수 있습니다. 활성 노드, 프록시 모드, 종료 상태를 확인할 때는 앱 메뉴 막대나 상태 영역도 함께 살펴보세요. 첫 연결을 확인하는 동안에는 노드를 바꾸지 말고 같은 브라우저 창에서 같은 대상에 접속하세요. 기존 설정에 라우팅이나 사용자 지정 DNS가 있다면 먼저 기록한 뒤 간단한 규칙으로 기준 테스트를 진행할 수 있습니다. 노드를 바꾸기 전에 현재 서버가 실제로 적용됐는지 확인하세요. 노드 목록에서 행이 강조 표시된 것만으로 연결 상태를 판단하면 안 됩니다.
현재 네트워크 서비스, TUN 및 잠자기 후 재개
클라이언트에서 ‘시스템 프록시 자동 설정’을 활성화한 뒤 ‘시스템 설정 → 네트워크’에서 현재 연결된 서비스의 ‘세부사항 → 프록시’를 확인하세요. Wi-Fi와 유선 연결은 서로 다른 네트워크 서비스일 수 있으므로 한쪽에서 작동한다고 다른 쪽에서도 프록시가 유효한 것은 아닙니다. 자동 프록시 구성 스크립트나 조직 프록시가 기존에 설정돼 있다면 먼저 기록하고 임의로 덮어쓰지 마세요. 브라우저는 되지만 터미널 도구가 안 될 때는 해당 도구의 프록시 설정을 확인하세요. 시스템 프록시를 모든 명령줄 프로세스가 읽는 것은 아닙니다.
시스템 프록시를 따르지 않는 앱을 테스트해야 한다면 이번에 설정한 시스템 프록시를 먼저 해제한 다음 클라이언트 안내에 따라 TUN을 활성화하세요. 다른 VPN, 네트워크 필터링 기능, 조직 관리 정책이 같은 트래픽을 처리하는지도 확인합니다. 권한 요청은 현재 작업과 관련된 것인지 확인하세요. 시스템에 필요한 네트워크 상태가 만들어지지 않았다면 이 단계부터 해결하고 구독을 반복해서 업데이트하지 마세요. TUN을 끈 뒤 프록시가 필요한 앱과 로컬 서비스를 각각 확인해 연결이 예상한 경로로 돌아왔는지 점검하세요.
잠자기에서 깬 뒤 웹페이지가 오래 기다린다면 이번 트래픽 처리를 끄고 현재 Wi-Fi 또는 유선 연결이 정상인지 확인한 다음 원래 모드를 복원해 같은 노드로 다시 테스트하세요. 터미널에서 scutil --proxy를 실행하면 시스템이 보고하는 프록시 상태를 볼 수 있지만, 모든 앱이 해당 설정을 따르는지는 알 수 없습니다. 네트워크를 바꾼 뒤에만 문제가 발생한다면 서버 설정을 바꾸기 전에 활성 네트워크 서비스, 이전 프록시 포트, 가상 인터페이스부터 확인하세요.
Linux: 패키지, 데스크톱 프록시 및 TUN
패키지 형식 및 프로세서 아키텍처
Linux 다운로드 페이지에서 v2rayN을 선택하세요. 일반적으로 Debian, Ubuntu 계열은 deb를, Fedora 계열은 rpm을 선택합니다. 다른 배포판은 파일 확장자를 바꾸지 말고 패키지 형식과 의존성 조건부터 확인하세요. 다음 명령으로 시스템 아키텍처와 배포판 식별 정보를 확인할 수 있습니다. 결과가 x86_64이면 다운로드 페이지에서 x64를 선택하고, aarch64이면 arm64 항목을 확인하세요. 배포판 식별 정보는 설치 방법을 판단하는 데 사용하며 프로세서 아키텍처를 추측하는 근거로 사용하지 않습니다.
uname -m
cat /etc/os-release
다운로드한 패키지는 파일 관리자에서 열어 시스템 소프트웨어 설치 프로그램으로 설치할 수 있습니다. 데스크톱에 설치 기능이 없다면 배포판의 패키지 관리자로 로컬 파일을 처리하세요. 해당 apt install 또는 dnf install 명령에 실제 다운로드 파일의 절대 경로를 전달합니다. 경로에 공백이 있으면 전체 경로를 따옴표로 묶으세요. deb와 rpm을 한 번에 섞어 설치하지 말고, 의존성 무시 옵션으로 오류를 덮지 마세요. 의존성을 해결할 수 없다면 시스템을 무조건 다시 설치하는 대신 오류에 표시된 라이브러리, 아키텍처, 저장소를 확인하세요.
현재 데스크톱 사용자로 클라이언트 실행
앱 메뉴에서 현재 사용자로 v2rayN을 실행하고 기본 창과 상태 영역이 정상인지 확인하세요. 설정은 실행 사용자에 따라 달라질 수 있습니다. 일반 사용자와 권한 상승 사용자로 번갈아 실행하면 서로 다른 설정을 읽거나 일반 사용자가 수정할 수 없는 파일이 남을 수 있습니다. TUN 권한이 필요하다면 필요한 권한 상승 단계만 처리하고 데스크톱 앱 전체를 높은 권한으로 계속 실행하지 마세요. 창을 닫은 뒤 앱을 찾을 수 없다면 데스크톱 환경의 알림 영역 지원 여부를 확인한 다음 인스턴스를 다시 실행할지 결정하세요.
‘구독 그룹’에 주소를 추가하고 업데이트한 뒤 활성 서버 하나를 선택하세요. 업데이트 작업에서 네트워크 오류가 반환되면 데스크톱 브라우저와 클라이언트가 각각 어떤 프록시를 사용하는지 확인하세요. 브라우저에서 구독 관련 페이지가 열린다고 해서 클라이언트의 업데이트 요청도 같은 경로를 이용하는 것은 아닙니다. 가져온 뒤 코어 시작 로그에 포트 사용 중 오류가 나오면 ss -ltn을 실행해 로컬 TCP 수신 상태를 확인하고 클라이언트에 표시된 진입 포트와 비교하세요. 충돌한 프로세스를 확인하기 전에는 알 수 없는 프로세스를 종료하지 마세요.
데스크톱, 명령줄 및 가상 인터페이스를 각각 확인
데스크톱 프록시의 작동 여부는 데스크톱 환경과 앱이 프록시 설정을 읽는 방식에 따라 달라집니다. GNOME 또는 KDE의 프록시 설정을 일부 데스크톱 앱이 읽을 수 있지만, 명령줄 프로그램은 보통 자체 옵션이나 프로세스 환경을 사용합니다. 클라이언트에서 자동 설정이 성공했다고 표시되면 데스크톱 프록시를 따르는 것으로 확인된 앱 하나로 먼저 테스트한 뒤 명시적 프록시로 수신 포트를 확인하세요. 터미널에만 설정한 환경 변수는 데스크톱에서 실행한 앱에 전달되지 않을 수 있습니다. 새로 연 터미널도 다른 터미널에서 임시로 설정한 변수를 반드시 상속하는 것은 아닙니다.
TUN이 필요하다면 비교 테스트에 사용한 데스크톱 프록시나 앱 프록시를 먼저 끈 다음 클라이언트의 TUN 기능을 활성화하세요. 컨테이너 관리 환경, 제한된 환경, 관리형 워크스테이션에서는 데스크톱 인터페이스가 있어도 가상 인터페이스를 사용하지 못할 수 있습니다. 권한이 있는 호스트에서는 ip link show로 활성화 전후의 인터페이스를 비교하고, ip route show로 일반 라우팅을 확인할 수 있습니다. 후자는 기본 조회 범위만 표시하므로 정책 라우팅의 영향을 배제할 수는 없습니다. 정책 라우팅을 사용한다면 ip rule show와 실제 대상의 경로도 확인하세요.
그래픽 앱에서만 실패하면 데스크톱 프록시와 앱 설정을 먼저 확인하고, TUN에서만 실패하면 권한, 인터페이스, 라우팅, DNS 처리 차이를 우선 점검하세요. 클라이언트를 종료한 뒤에도 터미널 문제가 남아 있다면 명령이 이전 프록시 환경 변수를 계속 읽는지 확인하세요. 세션 종료, 테스트 환경 변수 정리, 데스크톱 프록시 복원은 서로 다른 작업입니다. 실제로 변경한 항목만 하나씩 되돌리면 되며 기기 전체의 네트워크를 초기화할 필요는 없습니다.
Android: 구독, VPN 권한 및 앱별 프록시
설치 아키텍처 및 클라이언트 선택
Android 다운로드 페이지를 여세요. Xray 코어를 사용하는 v2rayNG를 우선 권장하며, V2Fly 코어가 필요한 경우 v2flyNG를 대안으로 선택하세요. 64비트 ARM 앱을 실행할 수 있는 기기에서는 arm64를 우선 확인하세요. 아키텍처를 모르거나 arm64 패키지가 호환되지 않는다고 명시된 경우에는 범용 버전과 시스템 요구 사항을 확인합니다. 프로세서가 64비트 기능을 지원하더라도 현재 시스템에서 모든 64비트 앱을 설치할 수 있는 것은 아닙니다. 설치 실패 원인은 시스템 요구 사항 미충족, 저장 공간 부족, 기존 앱과 새 패키지의 서명 불일치일 수도 있습니다.
브라우저나 파일 관리자에서 설치 파일을 열면 현재 출처의 앱 설치를 허용하라는 안내가 표시될 수 있습니다. 출처와 이번 설치가 필요한지 확인한 뒤에만 허용하고, 설치가 끝나면 해당 권한을 취소할 수 있습니다. 업그레이드 과정에서 충돌이 발생해도 사용 중인 클라이언트를 바로 삭제하지 마세요. 배포 출처가 같은지, 구독에 사용할 수 있는 항목이 남아 있는지, 직접 등록한 노드를 백업해야 하는지 먼저 확인하세요. 두 클라이언트의 데이터는 별도로 저장되므로 다른 앱을 설치해도 기존 그룹, 라우팅, 앱 목록이 자동으로 옮겨지지 않습니다.
구독 추가 및 서버 선택
클라이언트 메뉴에서 ‘구독 그룹 설정’을 열고 그룹 설명과 구독 주소를 추가한 뒤 저장하세요. 구성 목록으로 돌아가 ‘구독 업데이트’ 또는 이에 해당하는 기능을 실행합니다. 화면이 바뀌면 메뉴 위치나 버튼 이름도 달라질 수 있습니다. 구독 그룹 추가와 클립보드에서 단일 노드 가져오기를 구분하는 것이 중요합니다. 새로 고친 뒤 노드가 속한 그룹을 확인하고 사용할 노드를 선택하세요. 노드 수가 예상과 다르면 다른 그룹으로 필터링된 것은 아닌지 먼저 확인한 다음 구독 내용이 지원되는 형식인지 점검하세요.
한 클라이언트에서 읽을 수 있는 항목을 다른 클라이언트의 테스트 기준으로 바로 사용하지 마세요. 구독에 여러 전송 방식과 보안 조합이 섞여 있다면 현재 코어에서 지원되는 것으로 확인된 노드 하나를 먼저 선택해 테스트하세요. 실패하면 오류 유형, 프로토콜, 발생 시간을 기록하고 채팅방이나 공개 스크린샷에 구독 주소를 노출하지 마세요. 모바일 기기에서 Wi-Fi와 모바일 데이터를 바꿨다면 다른 노드를 시도하기 전에 기존 노드부터 다시 테스트해 네트워크 변경과 서비스 측 변화를 구분하세요.
VPN 인터페이스 및 앱별 적용 범위
서버를 선택한 뒤 메인 화면의 연결 버튼을 누르세요. 처음 실행하면 Android 시스템 화면에서 VPN 연결을 허용할지 묻습니다. 연결 요청을 방금 실행한 클라이언트가 보냈는지 확인한 뒤 허용하세요. 두 클라이언트가 사용하는 것은 Android VPN 인터페이스이므로 데스크톱의 ‘시스템 프록시 자동 설정’ 절차를 그대로 적용하면 안 됩니다. 연결 아이콘이나 상태 표시는 인터페이스가 만들어졌을 가능성만 나타냅니다. 실제 앱을 열어 트래픽이 클라이언트로 들어가 응답을 받는지 확인하세요.
앱별 필터링을 켜지 않은 상태에서 브라우저 하나를 먼저 확인한 다음 필요에 따라 ‘앱별 프록시’를 설정하세요. 현재 모드는 화면의 안내를 기준으로 판단합니다. 허용 목록은 선택한 앱만 VPN 인터페이스로 들어가고, 제외 목록은 선택한 앱이 해당 인터페이스를 우회한다는 뜻입니다. 인터페이스로 들어간 뒤에도 클라이언트의 라우팅 판단을 거치므로 앱의 모든 요청이 반드시 프록시를 통해 나가는 것은 아닙니다. 브라우저는 연결되지만 대상 앱은 안 된다면 해당 앱이 처리 범위에 포함되는지 먼저 확인한 뒤 도메인과 아웃바운드 규칙을 점검하세요.
일정 시간 사용한 뒤 연결이 끊기면 시스템에서 상시 연결 VPN이 따로 설정돼 있는지, 클라이언트의 백그라운드 활동이 제한됐는지 확인하고 화면을 끄기 전후의 로그를 비교하세요. 시스템에 배터리 사용량을 ‘제한 없음’ 또는 비슷한 값으로 설정하는 옵션이 있다면 백그라운드 연결이 실제로 끊기는 경우에만 해당 클라이언트에 적용하고 배터리 소모와 안정성 변화를 확인하세요. 기기에 따라 백그라운드 실행도 제한될 수 있으며 메뉴 이름은 제조사별로 다릅니다. 다른 브랜드의 경로를 그대로 찾지 마세요. 화면과 모드의 차이는 v2rayNG Android 사용 팁을 참고하세요.
연결 확인, 로그 및 설정 복구
먼저 트래픽 진입 경로 확인
연결을 네 단계로 나눠 확인하세요. 앱이 요청을 보내고, 로컬 진입 지점이 요청을 받고, 라우팅이 아웃바운드를 선택하고, 아웃바운드가 연결을 완료해 응답을 반환합니다. 화면에 연결됨이라고 표시돼도 보통은 클라이언트에 필요한 서비스나 인터페이스가 시작됐다는 뜻입니다. 브라우저에서 페이지 하나가 열린다고 요청이 프록시를 통과했다고 단정할 수도 없습니다. 페이지가 캐시에서 표시됐거나 규칙에 따라 직접 연결됐을 수 있습니다. 서로 다른 요청의 결과를 혼동하지 않도록 클라이언트 로그, 대상 주소, 테스트 시간을 함께 확인하세요.
데스크톱에서는 v2rayN 설정이나 상태 표시줄에서 포트, 수신 주소, 진입 방식부터 확인하세요. HTTP와 SOCKS는 서로 다른 애플리케이션 계층 진입 방식이므로 둘 다 로컬이라는 이유만으로 바꿔 써서는 안 됩니다. 일부 설정은 혼합 진입 방식을 사용하고, 일부는 포트를 분리하므로 현재 화면에 표시된 값을 기준으로 하세요. 시스템에 이전 프록시 설정이 남아 있다면 현재 진입 설정과 항목별로 대조하세요. Android에서는 VPN 권한, 활성 클라이언트, 앱별 적용 범위를 확인하고 데스크톱 포트 테스트를 휴대전화의 모든 앱 트래픽에 적용하지 마세요.
같은 대상으로 명시적 프록시 비교 테스트
아래 명령은 curl이 설치된 데스크톱 환경에서 사용할 수 있습니다. Windows PowerShell에서는 명령 이름을 curl.exe로 입력하세요. 첫 번째 줄은 curl에서 프록시를 사용하지 않고, 두 번째 줄은 로컬 SOCKS 진입점을 명시적으로 사용합니다. 클라이언트가 실제로 127.0.0.1:10808에서 SOCKS 서비스를 제공할 때만 두 번째 줄을 그대로 실행하세요. 그렇지 않다면 화면에 표시된 로컬 주소와 포트로 바꾸세요. 비교하기 전에 TUN을 끄세요. 첫 번째 줄은 시스템 계층에서 이미 처리 중인 트래픽을 우회하지 못합니다.
curl --noproxy '*' --max-time 15 -I https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/
socks5h는 대상 도메인 처리를 SOCKS 진입점에 맡기지만 모든 도메인이 원격에서 조회된다는 뜻은 아닙니다. 이후 동작은 코어의 라우팅과 DNS 설정에 따라 달라집니다. 이 명령은 로컬 진입점의 영향을 분리해 확인하는 예시이지 노드를 평가하는 방법이 아닙니다. 두 명령 모두 응답을 반환한다면 프록시 요청이 실제로 어떤 아웃바운드를 거쳤는지도 확인해야 합니다. 서비스 주소가 HEAD 요청을 지원하지 않는다면 같은 진입점으로 일반 GET 요청을 테스트하세요. 메서드가 거부됐다는 이유만으로 네트워크 연결이 끊겼다고 판단하면 안 됩니다.
오류가 발생한 위치로 범위 좁히기
오류가 로컬 루프백 포트를 직접 가리킨다면 클라이언트 실행 여부, 수신 성공 여부, 포트나 프로토콜 입력 오류부터 확인하세요. 로그에 원격 연결 시도가 표시된다면 원격 주소, 포트, 연결 시간 초과, 핸드셰이크 설정 순서로 점검합니다. connection refused는 어느 쪽에서 거부됐는지 확인해야 하며 모든 서버가 작동하지 않는다는 뜻은 아닙니다. i/o timeout도 연결, 읽기·쓰기, DNS 중 어느 단계에서 시간 초과가 발생했는지 살펴봐야 합니다. TLS 핸드셰이크가 반복해서 실패하면 시스템 시간, 구독에 필요한 서버 이름, 보안 유형, 전송 설정을 확인한 뒤 서비스 제공자에게 설정을 문의하세요. 자세한 내용은 v2rayN 실행 로그 문제 해결을 참고하세요.
기준 상태로 복구한 뒤 설정을 단계별로 다시 추가
설정을 되돌릴 때는 이번에 활성화한 TUN을 먼저 끄고 기존 시스템 프록시를 복원하세요. 대상 앱에 직접 입력한 테스트 프록시를 지운 다음 원래 네트워크에서 기준 페이지에 접속할 수 있는지 확인합니다. 복구되지 않는다면 구독을 계속 변경하기보다 네트워크 자체나 기존 관리 설정부터 점검하세요. 기준 상태가 복구되면 노드 하나, 트래픽 진입 방식 하나, 라우팅 변경 하나씩 순서대로 적용하세요. 매번 설정 상태, 대상, 실제 결과를 기록합니다. 변경 직후 문제가 생기면 가장 최근 단계를 취소하고 다시 테스트한 뒤 판단하세요. 항목별 확인이 필요하다면 연결됐지만 인터넷이 안 될 때 확인할 사항을 참고하세요.
라우팅 분할 및 DNS 설정
트래픽 처리 범위와 아웃바운드 선택 구분
시스템 프록시, 명시적 프록시, TUN은 어떤 요청이 코어에 들어오는지를 결정하고, 라우팅 규칙은 코어에 들어온 요청이 어떤 아웃바운드로 나갈지 결정합니다. 시스템 프록시가 특정 프로세스의 트래픽을 처리하지 않는다면 코어의 도메인 규칙을 바꿔도 해당 프로세스에는 영향이 없는 경우가 많습니다. 반대로 앱 트래픽이 코어에 들어와도 직접 연결로 라우팅될 수 있습니다. 문제를 확인할 때는 먼저 진입 로그를 찾고 그다음 아웃바운드 표시를 확인하세요. 로그에서 대상 요청을 찾을 수 없다면 규칙 순서를 계속 바꾸기보다 앱 프록시나 가상 인터페이스부터 확인하세요.
v2rayN에서 ‘라우팅 설정’을 열고 현재 실제로 사용 중인 규칙 그룹을 확인한 다음 수정할 항목을 결정하세요. 규칙은 일반적으로 목록 순서대로 검사되므로 앞에 있는 포괄적인 규칙이 먼저 일치하면 뒤의 예외 규칙이 적용되지 않을 수 있습니다. 수정 전에 원래 규칙 세트를 보존하고 테스트 세트에는 별도 이름을 지정하세요. 예외 조건을 확인할 때는 대상과 앱을 고정하고 노드와 DNS 방식을 동시에 바꾸지 마세요. 테스트 후에는 다른 대상도 확인해 기존 트래픽 분할이 유지되는지 점검하세요. 사이트 하나가 복구되는 대신 다른 앱의 트래픽이 잘못된 아웃바운드로 보내지는 일을 막을 수 있습니다.
규칙 필드 및 코어 설정 예시
다음은 Xray 코어 설정의 routing 필드를 보여 주는 예시입니다. direct 아웃바운드 태그가 이미 선언된 설정에 사용할 수 있습니다. 첫 번째 규칙은 정확히 일치하는 도메인 example.com만 대상으로 하고, 두 번째 규칙은 지정된 사설 IP 주소 대역과 일치합니다. 전체 클라이언트 설정이 아니며 구독 주소 입력란에 붙여 넣는 용도도 아닙니다. v2rayN 그래픽 인터페이스를 사용한다면 사용자 지정 규칙에 해당 도메인이나 IP 조건을 입력하고 현재 규칙 세트에 있는 직접 연결 아웃바운드를 선택하세요. 실제 아웃바운드를 확인하지 않고 태그 이름만 복사하지 마세요.
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
"outboundTag": "direct"
}
]
}
}
full:은 입력한 전체 이름과만 일치하며 하위 도메인을 자동으로 포함하지 않습니다. 해당 도메인과 하위 도메인을 함께 처리하려면 domain:을 고려하세요. outboundTag는 실제 아웃바운드를 가리키는 참조이며 독립된 프로토콜이 아닙니다. 위 예시의 AsIs는 도메인을 IP 규칙과 일치시키기 위해 해당 도메인을 자동으로 조회하지 않습니다. 코어에 들어온 대상이 처음부터 IP라면 비교할 도메인이 없어 도메인 규칙을 적용하지 못할 수도 있습니다. 디버깅할 때는 브라우저 주소 표시줄만 보고 하위 요청도 같은 형식일 것이라고 추측하지 말고 로그에 실제로 기록된 대상을 확인하세요.
DNS 진단 및 변경 순서
앱, 운영체제, 코어가 모두 도메인 조회에 관여할 수 있습니다. 브라우저의 보안 DNS, 클라이언트의 DNS 설정, TUN의 DNS 처리 여부에 따라 요청이 도메인이나 IP 주소 형태로 코어에 도달할 수 있으며, 같은 도메인도 앱마다 다른 주소로 확인될 수 있습니다. 문제를 점검할 때는 실패한 대상의 전체 도메인, 발생 시각, 현재 모드를 기록하세요. 시스템 직접 연결과 명시적 프록시의 결과를 비교할 때는 최종 페이지가 열리는지만 보지 말고 각 방식이 도메인 조회를 어디에 맡기는지 확인해야 합니다.
도메인 접속은 실패하지만 같은 서비스의 다른 주소는 정상이라면 로그에 DNS 오류가 있는지 먼저 확인하고 규칙이 도메인, IP, 외부 분류 데이터 중 무엇을 사용하는지 살펴보세요. HTTPS 주소의 호스트 이름을 IP로 바꾸는 것은 같은 조건의 테스트가 아닙니다. 서버 이름과 인증서 일치 여부도 달라지기 때문입니다. 로컬 공유 폴더, 프린터, 조직 네트워크 서비스를 사용하는 경우 필요한 경로에서 사설 IP가 유지되는지 확인하세요. 공개 웹페이지에 접속된다는 것만으로 정상이라고 판단하면 안 됩니다. 변경 전 DNS와 라우팅 값을 보존하고 한 번에 한 계층만 조정하세요. 필드 설명은 개념 빠른 참조를 확인하세요.
설정 관련 자주 묻는 질문
구독 업데이트는 성공했는데 활성 노드가 없는 이유는 무엇인가요?
업데이트 메시지가 현재 그룹에 해당하는지 확인한 다음 검색어, 그룹, 필터 조건 때문에 노드 목록이 제한되지 않았는지 살펴보세요. 업데이트 성공은 클라이언트가 가져오기나 파싱의 특정 단계를 완료했다는 뜻이지, 이전 활성 서버가 여전히 목록에 있다는 보장은 아닙니다. 서비스 제공자가 기존 노드 이름을 바꾸거나 사용을 중단했을 수 있습니다. 해당 그룹에서 서버를 다시 선택하고 활성 상태를 확인하세요. 그룹이 완전히 비어 있다면 반환된 구독 형식이 클라이언트에서 지원되는지 확인한 다음 구독 권한과 이용 기간을 점검하고 관리 페이지 주소를 구독 주소로 잘못 입력하지 않았는지 확인하세요.
브라우저는 되는데 다른 앱은 왜 연결되지 않나요?
먼저 브라우저가 시스템 프록시를 사용하는지, 브라우저 자체 프록시 설정을 사용하는지 확인하세요. 데스크톱 앱에 프록시 옵션이 있다면 클라이언트가 실제로 수신 중인 프로토콜과 포트에 맞춰 설정할 수 있습니다. 앱에 해당 옵션이 없다면 TUN 사용을 고려하세요. Android에서는 앱별 설정에서 대상 앱이 제외되지 않았는지 먼저 확인합니다. 로그에 대상 앱의 요청이 표시되는데도 서비스 페이지가 열리지 않는다면 해당 도메인이 어떤 아웃바운드로 라우팅되는지와 DNS가 정상인지 계속 확인하세요. 클라이언트를 다시 설치할 필요는 없습니다. 테스트 전에 서비스 앱 자체에 정상적으로 로그인할 수 있는지도 확인하세요.
시스템 프록시와 TUN을 동시에 켜도 되나요?
시스템, 클라이언트, 규칙 세트마다 겹치는 트래픽을 처리하는 방식이 다르므로 두 설정이 모두 켜져 있다고 해서 앱이 어떤 경로를 사용하는지 단정할 수 없습니다. 처음 설정하거나 문제를 해결할 때는 진입 방식을 하나만 켜야 결과를 재현하기 쉽습니다. 시스템 프록시에서 TUN으로 바꿀 때는 이번에 설정한 시스템 프록시를 먼저 해제한 뒤 TUN을 켜세요. 반대로 전환할 때는 TUN을 끄고 네트워크가 정상인지 확인한 다음 시스템 프록시를 자동 설정하세요. 조직에서 지정한 프록시나 VPN이 기기에 설정돼 있다면 임의로 끄지 말고 처리 범위와 관리 요구 사항부터 확인하세요. 테스트 설정을 종료한 뒤에는 원래 값으로 복원하고 무조건 빈 설정으로 만들지 마세요.
노드 문제와 로컬 설정 문제는 어떻게 구분하나요?
기기 하나, 네트워크 하나, 테스트 대상 하나를 고정하세요. 로컬 진입점에 요청이 도달하는지 확인한 뒤 같은 그룹의 독립된 노드 두 개를 비교합니다. 하나는 실패하고 다른 하나는 정상이라면 실패한 노드의 서비스 상태와 설정을 먼저 확인하세요. 여러 노드가 로컬 포트 접속 단계처럼 같은 구간에서 실패하면 로컬 진입점을 먼저 점검합니다. 여러 노드가 아웃바운드 DNS 조회 단계에서 실패한다면 DNS와 네트워크 환경을 확인하세요. 여러 노드가 동시에 실패한다고 해서 서버 측 문제가 확정되는 것은 아닙니다. 같은 네트워크 조건, DNS 경로, 인증 상태에 의존하고 있을 수 있습니다.
클라이언트를 바꾸거나 재설치하기 전에 무엇을 저장해야 하나요?
구독 그룹 이름, 사용 중인 라우팅 그룹, 트래픽 처리 방식, 로컬 수신 포트, 직접 등록한 노드를 기록하세요. 클라이언트에 내보내기 기능이 있다면 통제된 위치에만 설정을 저장하세요. 내보낸 파일에는 주소와 접속 정보가 포함될 수 있으므로 공개 클라우드나 채팅방에 올리지 마세요. 클라이언트를 옮길 때는 구독을 다시 가져오고 라우팅을 하나씩 복원하세요. 다른 앱이 기존 설정 디렉터리를 완전히 읽을 것이라고 가정하지 마세요. 항목이 표시되고, 활성 노드가 정확하고, 로컬 진입점이 작동하며, 대상 트래픽이 예상대로 분할되는지를 기준으로 이전 성공 여부를 판단하세요. 클라이언트별 차이는 클라이언트 비교를 참고하세요.
다른 사람에게 도움을 요청할 때 어떤 정보가 필요한가요?
운영체제와 아키텍처, 클라이언트 이름과 화면에 표시된 버전, 활성 코어, 트래픽 진입 방식, 실패 범위, 처음 문제가 발생한 시간을 알려주세요. 구독 업데이트, 네트워크 변경, TUN 활성화 직후였는지 설명하고 기존 네트워크 상태로 복구할 수 있는지도 알려주세요. 로그는 문제 발생 전후의 관련 줄만 남기고 서버 주소, 구독 주소, 접속 정보를 가리세요. 계정 정보나 조직 내부 네트워크 정보가 스크린샷에 노출되지 않도록 주의하세요. ‘계속 연결되지 않아요’라고만 하기보다 ‘같은 브라우저와 같은 대상에서 시스템 프록시는 되지만 TUN은 안 됩니다’처럼 비교 결과를 알려 주면 확인 지점을 찾기 쉽습니다.