V2Ray 모든 플랫폼 설치·설정 가이드

처음 연결한다면 입문 가이드에 따라 구성을 가져오고 프록시를 켠 뒤 연결을 확인하세요. 클라이언트 설치를 마쳤거나 설치 파일, 시스템 적용 범위, 라우팅 및 DNS 설정을 확인하려면 이 가이드의 해당 장을 살펴보세요. 문제를 해결할 때는 한 번에 하나씩 설정을 변경하고, 문제를 재현할 수 있는 설정은 유지하세요.

공통 준비: 설치 파일, 구독, 연결 확인

클라이언트·코어·구독의 차이

데스크톱에서는 v2rayN을 먼저 선택하세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 살펴보고, 구독 제공업체가 v2fly 코어를 명시적으로 요구할 때 v2flyNG를 고려하세요. 클라이언트는 구독 관리, 노드 선택, 시스템 트래픽 연결을 담당하고 코어는 연결을 처리합니다. 구독은 제공업체가 제공하는 설정 가져오기 경로로, 보통 가져올 수 있는 노드 목록을 반환합니다. 설치 파일이 실행되더라도 현재 코어가 구독에 포함된 모든 전송 방식과 보안 옵션을 지원하는 것은 아닙니다.

설치 파일을 고를 때는 기기 상품명이 아니라 운영체제에서 실행할 수 있는 프로그램 아키텍처를 확인하세요. 데스크톱에서는 시스템 정보를 확인하고, 모바일 기기에서는 운영체제가 앱에 제공하는 아키텍처도 고려해야 합니다. 기기를 바꾸면 설치 파일을 다시 선택하고, 이전 기기의 프로그램 폴더 전체를 그대로 복사하지 마세요. 제공업체가 여러 구독 형식을 제공한다면 사용 중인 클라이언트에 맞는 형식부터 확인하세요. 두 클라이언트에서 같은 링크를 열 수 있다고 해서 생성되는 노드 설정까지 같다고 단정할 수는 없습니다.

플랫폼별 클라이언트와 설치 파일 선택 기준
플랫폼클라이언트설치 파일 선택 기준
Windowsv2rayNx64 시스템, 데스크톱 버전 또는 클래식 WPF 버전
macOSv2rayNApple Silicon 또는 Intel
Linuxv2rayN배포판의 패키지 형식, x64 또는 arm64
Androidv2rayNG / v2flyNGarm64 또는 범용 버전, 코어 호환성에 따라 클라이언트 선택

다시 가져올 수 있는 원본 정보 준비

구독 주소와 제공업체의 사용 안내는 본인만 읽을 수 있는 곳에 보관하세요. 구독 주소에 인증 정보가 포함될 수 있으며, 노드 공유 텍스트와 QR 코드, 내보낸 설정에도 연결 자격 증명이 들어갈 수 있습니다. 이런 자료를 공개 문의 게시판에 올리거나 출처가 불분명한 온라인 변환 도구에 입력하지 마세요. 기록할 때는 그룹 별칭, 프로토콜, 전송 방식, 갱신 시각만 적으세요. 새 기기와 동기화하기 전에 구독이 동시 접속 기기 수를 제한하는지 확인해 기기 한도를 설정 문제로 오해하지 않도록 하세요.

구독 갱신과 노드 연결은 별개입니다. 구독 갱신은 구독 서버에서 설정을 가져오는 작업이고, 노드 연결은 설정에 포함된 서버에 연결하는 작업입니다. 갱신에 성공해도 이번에 가져온 내용이 파싱 가능하다는 뜻일 뿐입니다. 전송 옵션 불일치, 인증서 검증 실패, 현재 네트워크 연결 불가 등의 이유로 노드 연결은 실패할 수 있습니다. 제공업체가 구독 주소를 변경했다면 기존 그룹의 주소를 먼저 바꾸고 해당 그룹을 직접 갱신하세요. 같은 이름의 그룹을 계속 새로 만들면 이전 항목을 잘못 선택하기 쉽습니다.

재현 가능한 테스트 순서 만들기

프록시를 켜기 전에 현재 네트워크에서 평소 사용하는 웹사이트가 열리는지 확인하세요. 로그인이 필요한 공용 네트워크라면 먼저 로그인한 뒤 클라이언트를 실행하세요. 시스템 날짜와 시간, 시간대를 확인하고 자동 시간 설정을 켜는 것이 좋습니다. 다음으로 그룹 하나만 가져와 한 번 직접 갱신한 뒤, 사용 가능 여부를 알고 있는 노드를 선택하세요. 먼저 코어 로그에 시작 오류가 없는지 확인하고, 플랫폼에 맞는 연결 방식을 켠 다음 같은 앱에서 같은 사이트에 접속해 전후 상태를 비교하세요.

데스크톱에서 처음 사용할 때는 시스템 프록시부터 확인하고, Android에서는 시스템 VPN 연결부터 시작하세요. 사용자 지정 DNS 설정, 라우팅 규칙 변경, 코어 전환은 우선 미루세요. 테스트에 실패하면 구독 갱신 실패인지, 코어가 시작되지 않았는지, 앱에서 접속할 수 없는지 기록하세요. 이전 기기의 설정을 옮기는 경우 새 기기에서 연결 하나를 먼저 확인한 뒤 라우팅과 예약 갱신을 하나씩 복구하세요. 이전 설정의 오류까지 함께 옮기는 일을 막을 수 있습니다.

Windows: v2rayN 설치와 시스템 프록시

데스크톱 버전 또는 클래식 WPF 버전 선택

Windows 다운로드로 이동한 뒤, 시스템 설정의 장치 정보에서 시스템 종류와 설치 파일 표기가 일치하는지 확인하세요. 데스크톱 버전은 여러 플랫폼에서 사용할 수 있는 인터페이스를 제공해 다른 데스크톱 운영체제와 메뉴 구성이 비슷합니다. 클래식 WPF 버전은 Windows에서 익숙한 인터페이스를 사용합니다. 먼저 한 가지 버전만 설치하세요. 두 버전을 동시에 시작 프로그램에 등록하면 같은 로컬 포트를 차지하거나 종료할 때 시스템 프록시 설정을 서로 덮어쓸 수 있습니다.

설치 마법사의 안내에 따라 설치하세요. 먼저 압축을 풀어야 하는 패키지라면 일반 계정에서 쓸 수 있는 위치에 폴더 전체를 압축 해제한 다음 그 폴더에서 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요. 시작할 때 실행 환경이 없다는 메시지가 나오면 현재 설치 파일의 안내와 다운로드 페이지 설명을 따르세요. 다른 프로그램 폴더에서 구성 요소를 복사해 오지 마세요. 설정을 옮길 때는 클라이언트를 정상 종료한 뒤 클라이언트가 지원하는 방식으로 내보내거나 백업하세요. 더 이상 실행되지 않는 이전 폴더를 새 버전에 그대로 덮어쓰지 마세요.

그룹을 가져오고 코어 시작 확인

구독 그룹 설정을 열어 새 그룹을 추가하고, 출처를 구분할 수 있는 별칭과 구독 주소를 입력하세요. 저장한 뒤 현재 그룹을 갱신하세요. 메인 창으로 돌아와 해당 그룹을 선택하고 노드를 골라 활성 서버로 지정하세요. 노드가 목록에 표시되는 것만으로는 활성화된 상태가 아닙니다. 현재 서버 표시와 시작 로그를 확인하세요. 갱신 결과가 비어 있다면 선택한 그룹과 제공업체가 안내한 구독 형식을 먼저 확인한 뒤 갱신 로그를 살펴보세요. 곧바로 포트를 바꾸거나 기존 그룹을 모두 지우지 마세요.

설정에서 로컬 리스너의 주소와 포트를 확인하세요. 이 기기에서만 테스트할 때는 루프백 주소를 유지하고, 포트 번호는 실제 설정값을 사용하세요. 로그에 주소가 이미 사용 중이라고 나오면 먼저 어떤 프로세스가 수신 대기 중인지 확인하세요. 아래 PowerShell 명령은 일반적인 포트를 예로 든 것이므로 실행 전에 화면에 표시된 포트로 바꾸세요. 이 명령은 수신 대기 주소와 프로세스 ID를 표시할 뿐 설정을 변경하지 않습니다. ID를 확인한 뒤 작업 관리자의 세부 정보 탭에서 프로세스를 확인하세요. 정체를 모르는 시스템 프로세스를 바로 종료하지 마세요.

Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

시스템 프록시 확인 후 TUN 고려

시스템 트레이 메뉴에서 시스템 프록시 자동 설정을 선택한 뒤 Windows의 네트워크 프록시 설정에서 현재 주소와 포트를 확인하세요. 시스템 프록시를 사용하는 앱은 보통 이 설정을 따르지만, 자체 프록시 설정이 있는 브라우저나 도구는 따르지 않을 수 있습니다. 시스템 설정을 따르는지 확인된 브라우저에서 새 요청을 보내고, 클라이언트 로그에 해당 연결이 나타나는지 확인하세요. 브라우저의 기존 탭은 이전 연결을 재사용할 수 있으므로 새 창에서 테스트하세요. 필요하면 브라우저를 정상 종료한 뒤 다시 시작하세요.

시스템 프록시를 사용하지 않는 앱만 연결해야 한다면 해당 앱에서 자체 프록시 주소를 설정할 수 있는지 먼저 확인하세요. 더 많은 트래픽을 처리해야 할 때만 데스크톱 TUN 점검 순서에 따라 기능을 켜고, 클라이언트 안내에 따라 필요한 권한을 부여하세요. 첫 테스트에서는 시스템 프록시를 기준 상태로 되돌려 두 경로가 겹치지 않도록 하세요. 회사 컴퓨터에서 권한 제한이 표시되면 관리자의 절차를 따르세요. 관리 정책을 끄거나 관리자 권한을 일반적인 연결 오류의 해결책으로 사용하지 마세요.

절전 모드에서 깨어난 뒤, 무선 네트워크를 바꾼 뒤 또는 비정상 종료 후 클라이언트를 끄자 인터넷에 연결되지 않는다면 Windows가 중지된 루프백 포트를 계속 가리키는지 확인하세요. 먼저 원래 프록시 설정을 복원한 뒤 기본 연결을 다시 테스트하세요. 조직에서 자동 구성 스크립트를 배포했다면 수동 프록시만 끄지 말고 원래 정책도 복구해야 합니다. 프로그램을 다시 설치해도 시스템에 남은 프록시 값은 지워지지 않는 경우가 많습니다. 압축 해제 폴더, 실행 환경, 최초 실행의 관계는 v2rayN 첫 설치 설정 체크리스트를 참고하세요.

macOS: v2rayN 설치와 네트워크 서비스 설정

칩에 맞는 설치 파일 다운로드와 첫 실행

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 칩이 표시되는 기기에는 Apple Silicon 설치 파일을, Intel 프로세서가 표시되는 기기에는 Intel 설치 파일을 선택하세요. macOS 다운로드에서 해당 디스크 이미지 파일을 받으세요. 이미지를 마운트한 뒤 창의 안내에 따라 앱을 ‘응용 프로그램’으로 복사하고, 복사한 위치에서 실행하세요. 정상 실행을 확인한 뒤 설치 이미지를 추출해도 됩니다. 마운트된 볼륨에서 앱을 계속 실행하면 이미지를 추출한 뒤 기존 실행 경로를 사용할 수 없습니다.

처음 열 때 경고가 표시되면 일반적인 확인 요청인지, 시스템 보안 정책에 따른 차단인지, 앱 자체가 실행되지 않는 문제인지 구분하세요. 패키지 출처와 칩 종류, 현재 운영체제의 요구 사항을 확인하고, 관리 기기라면 제한 사항을 관리자에게 문의하세요. 앱을 열기 위해 기기 전체의 보안 검사를 끄지 마세요. 화면은 열리지만 코어 프로세스가 시작되지 않는다면 로그에서 어떤 프로그램과 경로를 가리키는지 먼저 확인하세요. 시스템 업그레이드 후에만 문제가 생겼다면 기존 설정을 바꾸기 전에 새 시스템과 설치 파일의 호환성 안내를 확인하세요.

구독 갱신 후 활성 연결 확인

구독 메뉴에서 그룹을 추가하고 별칭과 주소를 입력한 뒤 저장하고 한 번 직접 갱신하세요. 항목이 나타나면 활성 노드를 선택하고 코어가 시작되었는지 확인하세요. 이전 설정을 옮길 때는 다시 가져올 수 있는 구독 정보와 소수의 사용자 지정 규칙만 우선 보존하세요. 다른 기기의 코어 프로그램, 절대 경로, 시작 보조 항목을 그대로 가져오지 마세요. 경로와 칩 종류가 다를 수 있어 노드 이름이 같아도 실행 프로그램이 작동하지 않을 수 있습니다.

그룹 갱신 로그에 HTTP 오류가 기록되면 구독 권한과 현재 네트워크에서 해당 주소에 요청을 보낼 수 있는지 먼저 확인하세요. 전체 링크를 다른 사람에게 보내 대신 테스트해 달라고 하지 마세요. 갱신은 정상인데 연결 핸드셰이크가 실패한다면 활성 노드의 프로토콜, 전송 방식, 보안 설정이 일치하는지 확인하세요. 같은 그룹의 노드 대부분이 연결된다면 실패한 항목부터 좁혀 보세요. 시스템의 네트워크 위치를 바로 초기화하거나 전역 DNS를 수동으로 변경하지 마세요.

현재 네트워크 서비스를 기준으로 시스템 프록시 확인

클라이언트에서 시스템 프록시를 켠 뒤 시스템 설정의 ‘네트워크’에서 현재 사용 중인 네트워크 서비스를 열고 세부 정보의 ‘프록시’를 확인하세요. 무선 네트워크와 유선 네트워크는 서로 다른 서비스일 수 있습니다. 사용하지 않는 서비스에 설정하면 현재 앱은 원하는 연결 경로를 사용하지 못합니다. 도킹 스테이션을 연결하거나 무선에서 유선으로 전환한 뒤에는 현재 서비스를 확인하고 클라이언트의 로컬 포트가 계속 수신 대기 중인지 살펴보세요. 아래 명령은 시스템 프록시 상태만 조회합니다. 결과에 조직에서 설정한 주소가 있다면 전체 내용을 공개하지 마세요.

scutil --proxy

출력에서 활성화된 유형과 호스트, 포트를 대조하세요. ‘프록시’라는 문구가 있는지만 확인해서는 안 됩니다. 클라이언트 포트와 시스템이 실제로 지정한 경로가 일치해야 하며 프로토콜 유형도 맞아야 합니다. 브라우저는 정상인데 다른 앱에서 연결되지 않는다면 해당 앱의 자체 네트워크 설정이 있는지, 프록시를 켜기 전에 만들어진 연결을 재사용하는지 확인하세요. 한 번에 하나만 바꾸고 앱을 다시 열어 테스트하세요. 시스템 프록시의 모든 항목을 켤 필요는 없습니다.

네트워크 전환 또는 TUN 사용 후 되돌리는 방법

시스템 프록시를 따르지 않는 프로그램을 연결해야 한다면 먼저 현재 네트워크 서비스, 프록시, DNS 값을 기록한 뒤 클라이언트의 TUN 옵션과 시스템 권한 요구 사항을 확인하세요. 기능을 켠 뒤 일반 웹 요청과 계속 접속할 수 있어야 하는 로컬 리소스를 각각 테스트하세요. 웹페이지가 열린다고 로컬 트래픽이 우회되지 않았다는 뜻은 아닙니다. 사내망이나 로컬 기기에 갑자기 접속할 수 없다면 TUN을 끄고 이전 연결 방식을 복원해 문제가 사라지는지 확인하세요. 권한을 반복해서 부여하는 것으로 라우팅 문제를 해결하려 하지 마세요.

절전 모드에서 깨어난 뒤 연결이 끊기면 기본 네트워크가 바뀌었는지 확인한 다음 루프백 리스너와 현재 서비스의 프록시 설정을 살펴보세요. 클라이언트를 종료하면 이전 프록시 상태가 복원되어야 하며, 모든 설정을 일괄 삭제해서는 안 됩니다. 특정 무선 네트워크에서만 실패한다면 해당 네트워크에 웹 로그인이 필요한지, 별도의 프록시 정책이 있는지 확인하세요. 이를 통해 특정 네트워크의 설정 문제와 설치 자체의 문제를 구분하고 다른 네트워크를 불필요하게 변경하지 않을 수 있습니다.

Linux: v2rayN 패키지 형식, 데스크톱 프록시, TUN

배포판과 아키텍처에 맞는 설치 파일 선택

먼저 시스템 정보를 확인해 배포판을 파악한 다음 Linux 다운로드에서 v2rayN을 선택하세요. Debian 계열 패키지 관리자를 사용하는 시스템에는 보통 deb 패키지를 선택하고, RPM 패키지 관리자를 사용하며 패키지 의존성을 충족하는 시스템에는 rpm 패키지를 선택합니다. 형식이 같아도 의존성 호환성을 보장하지 않으며, 특히 오래된 배포판에서는 주의해야 합니다. 일반적으로 x86_64는 x64, aarch64는 arm64에 해당합니다. 컨테이너나 호환 계층에서 확인한 결과가 실제 데스크톱 세션의 실행 환경과 다를 수 있으니 클라이언트를 실행할 시스템에서 확인하세요.

cat /etc/os-release
uname -m

다운로드한 패키지는 배포판의 소프트웨어 설치 프로그램이나 로컬 패키지를 지원하는 패키지 관리자로 설치하고, 의존성 충돌이 있는지 확인하세요. 아키텍처가 맞지 않는다는 메시지가 나오면 다운로드 페이지로 돌아가 올바른 패키지를 선택하세요. 의존성을 사용할 수 없다는 메시지가 나오면 현재 배포판이 요구 사항을 충족하는지 확인하고 강제로 의존성을 건너뛰지 마세요. 설치 과정에서 권한이 필요할 수 있지만, 평소에는 일반 사용자 그래픽 세션에서 클라이언트를 실행하세요. 데스크톱 앱 전체를 관리자 권한으로 실행하면 설정 디렉터리나 파일 소유자가 바뀌어 일반 계정에서 설정을 읽을 수는 있어도 저장하지 못할 수 있습니다.

구독 가져오기와 코어 리스너 확인

일반 데스크톱 세션에서 v2rayN을 실행하고 구독 그룹을 만든 뒤 별칭과 주소를 입력하세요. 현재 그룹을 갱신하고 노드를 선택하세요. 전환하기 전에 해당 노드에 필요한 코어와 전송 설정을 확인하세요. 설정을 가져오면 노드 항목이 만들어질 뿐입니다. 코어 프로세스가 매개변수를 받아들이고 수신 대기를 시작하는지도 확인해야 합니다. 프로그램 화면이 열리지 않으면 앱 시작 안내를 확인하세요. 화면은 열리지만 코어가 시작되지 않으면 매개변수 파싱, 프로그램 권한, 수신 포트를 살펴보세요. 모든 실패를 구독 만료 탓으로 돌리지 마세요.

포트는 먼저 로컬에서 확인하세요. 아래 명령은 ss가 설치된 시스템에서 로컬 TCP 수신 대기 상태를 확인합니다. 예시 포트는 화면에 표시된 실제 포트로 바꾸세요. 출력이 없으면 코어가 시작되었는지 먼저 확인하고 방화벽 허용 규칙부터 추가하지 마세요. 수신 대기 상태가 확인되어도 로컬 연결 지점이 있다는 뜻일 뿐 원격 연결이 정상이라는 보장은 없습니다. 예상보다 넓은 범위에서 수신 대기 중이라면 LAN 접근을 실수로 켰는지 확인하고, 계속 테스트하기 전에 이 기기에서만 접속할 수 있는 주소로 되돌리세요.

ss -ltn 'sport = :10808'

현재 데스크톱 세션의 프록시 설정 반영 여부 확인

데스크톱 환경마다 시스템 프록시 설정이 저장되는 위치가 다릅니다. 클라이언트의 같은 버튼을 눌러도 모든 세션, 브라우저, 백그라운드 서비스에 설정이 똑같이 적용되는 것은 아닙니다. 시스템 프록시를 켠 뒤 현재 데스크톱 환경의 프록시 설정을 확인하고, 해당 설정을 따르는 앱에서 새 요청을 보내세요. 터미널 프로그램은 현재 프로세스의 프록시 환경 변수를 읽을 수도 있고 자체 설정을 사용할 수도 있습니다. 다른 터미널 세션은 임시 변수를 자동으로 상속하지 않습니다. 문제를 찾을 때는 테스트 프로그램 하나에서 올바른 프록시 유형을 명시적으로 선택하세요. 모든 프로세스에 영향을 주는 전역 변수는 설정하지 마세요.

브라우저는 프록시를 사용하지만 명령줄 요청은 직접 연결되는 상황이 반드시 라우팅 오류인 것은 아닙니다. 먼저 명령줄 요청이 코어에 도달하는지 확인한 다음 HTTP 또는 SOCKS 중 어떤 연결 지점을 지원하는지 확인하세요. 포트 번호만 보고 연결 유형을 추측할 수는 없습니다. 서비스 관리자가 시작한 프로그램의 실행 환경은 로그인 후 데스크톱 환경과 다르므로 브라우저에서 성공했다고 해서 서비스도 정상이라고 판단하지 마세요. 앱 하나의 설정만으로 충분하다면 되돌리기 쉬운 작은 범위의 설정을 유지하세요.

TUN에 필요한 권한과 라우팅 확인

TUN이 꼭 필요하다면 이 기기가 가상 네트워크 인터페이스를 지원하고, 클라이언트가 배포판의 권한 부여 방식에 따라 필요한 권한을 얻을 수 있는지 확인하세요. 전환 전후의 라우팅을 각각 확인하고, 네트워크 카드가 여러 개이거나 가상 머신을 함께 사용한다면 유지해야 하는 로컬 네트워크 대역도 비교하세요. 아래 명령은 IPv4 라우팅과 정책을 확인할 뿐 시스템을 변경하지 않습니다. 현재 네트워크에서 IPv6도 사용한다면 IPv6 라우팅도 확인하세요. 사내망이나 가상 머신에 영향을 주는 변화가 생기면 기본 경로를 바로 덮어쓰지 말고 TUN을 끈 상태에서 확인하세요.

ip route show
ip rule show
ip -6 route show

종료 후에도 연결되지 않는다면 가상 인터페이스와 클라이언트 프로세스가 멈췄는지 확인하고, 데스크톱 프록시가 남아 있는지, 현재 네트워크가 원래 출구로 복원되었는지 살펴보세요. 네트워크 관리 서비스가 관리하는 기기라면 해당 서비스를 통해 복구하고 서비스가 만든 파일을 직접 덮어쓰지 마세요. 재부팅으로 일시 복구되더라도 문제를 일으킨 조건을 기록하세요. 클라이언트 종료 순서인지, 절전 모드에서 깨어날 때인지, 네트워크 전환 때문인지 확인하면 다음에 재현했을 때 문제 발생 중의 상태를 비교할 수 있습니다.

Android: v2rayNG, v2flyNG, VPN 연결

클라이언트와 설치 파일 선택

Android 다운로드에서 먼저 v2rayNG를 확인하세요. 구독 제공업체가 v2fly 코어를 요구할 때만 v2flyNG를 선택하고, 첫 테스트에서 두 앱을 동시에 실행하지 마세요. 시스템이 arm64를 지원하는지 확인할 수 있다면 해당 패키지를 선택하세요. 아키텍처를 판단하기 어렵거나 기기 프로세서는 지원하지만 시스템이 다른 아키텍처의 앱만 실행한다면 범용 버전의 지원 범위를 먼저 확인하세요. 설치 프로그램에서 호환되지 않는다고 표시되면 아키텍처 외에도 시스템 요구 사항과 저장 공간을 확인하세요. 설치 오류를 해결하려고 구독을 반복해서 바꾸지 마세요.

브라우저나 파일 관리자에서 설치 파일을 열 때 현재 출처의 설치 권한을 허용하라는 메시지가 표시될 수 있습니다. 알려진 설치 파일을 여는 앱에 필요한 권한만 부여하고 설치가 끝나면 철회할 수 있습니다. 업데이트 중 설치 충돌이 발생하면 기존 앱을 다른 배포 경로에서 설치했는지 또는 다른 사용자 공간에 설치했는지 먼저 확인하세요. 삭제 후 재설치해야 한다면 구독 원본 주소와 필요한 설정 기록을 먼저 준비하세요. 로컬 그룹, 사용자 지정 규칙, 선택 항목이 앱 삭제와 함께 지워질 수 있습니다.

구독 추가 후 VPN 시작

구독 그룹 관리에서 그룹을 추가하고 별칭과 구독 주소를 입력한 뒤 저장하고 갱신하세요. 단일 공유 항목과 전체 구독은 가져오는 경로가 다릅니다. 단일 노드는 클라이언트의 단일 항목 가져오기 기능을 사용하고, 구독은 그룹에서 갱신하세요. 새로 만든 그룹을 보고 있는지 확인하고 항목을 선택한 뒤 메인 화면에서 시작하세요. 앱 메뉴의 문구는 버전에 따라 달라질 수 있지만 ‘주소 저장’, ‘항목 가져오기’, ‘항목 선택’, ‘연결 시작’은 각각 별개의 단계입니다.

VPN을 처음 시작하면 Android에서 클라이언트가 로컬 VPN 연결을 설정하도록 허용할지 묻습니다. 요청을 보낸 앱이 방금 실행한 클라이언트인지 확인한 뒤 허용하세요. 상태 표시줄 아이콘은 VPN 연결이 설정되었음을 나타낼 뿐 선택한 노드에 연결되었다는 뜻은 아닙니다. 브라우저에서 새 요청을 보내고 클라이언트 로그와 대조하세요. 기기가 다른 앱으로 이미 VPN 연결을 관리하고 있다면 해당 앱을 일시 중지할 수 있는지 먼저 확인하세요. 업무 프로필이나 기기 관리 정책으로 유지되는 연결을 임의로 해제해서는 안 됩니다.

백그라운드 중지, 앱별 제한, 네트워크 전환 구분

화면이 켜져 있을 때는 정상인데 화면을 끄면 연결이 끊긴다면 연결 서비스가 계속 실행 중인지 확인한 뒤 시스템의 앱 배터리 및 백그라운드 정책을 살펴보세요. 먼저 한 번 재현하고 화면을 끈 뒤 얼마 만에 끊기는지, 알림이 계속 표시되는지, 잠금을 해제하면 자동으로 다시 연결되는지 기록하세요. 시스템이 서비스를 중지한 것이 확인된 경우에만 해당 클라이언트의 백그라운드 실행 권한을 조정하세요. 모든 앱의 배터리 제한을 한꺼번에 해제하거나 상시 알림이 떠 있다는 이유로 원격 연결도 계속된다고 판단하지 마세요.

특정 앱에서만 연결되지 않는다면 앱별 프록시 설정이 켜져 있는지 먼저 확인하세요. 선택한 앱만 포함하는 모드인지, 선택한 앱을 제외하는 모드인지 확인하고 체크 표시가 있는지만 보지 마세요. 변경 후에는 클라이언트 안내에 따라 연결을 다시 설정하고 대상 앱에서 새 요청을 보내세요. 시스템의 ‘VPN 항상 사용’과 ‘VPN 없이 연결 차단’도 구분해야 합니다. 전자는 VPN을 유지하도록 하고 후자는 VPN 연결이 끊긴 동안 다른 네트워크 연결에도 영향을 줍니다. 첫 연결을 확인하기 전에는 이 옵션들을 해결책처럼 사용하지 마세요.

무선에서 모바일 데이터로 전환한 뒤 실패하면 원래 네트워크에서 다시 테스트한 다음 모바일 네트워크에서 새 요청을 보내세요. 기존 연결은 네트워크 전환으로 끊길 수 있고, 일부 앱은 시스템에서 모바일 데이터 사용이 제한될 수도 있습니다. 화면을 끄거나 네트워크를 바꿀 때만 문제가 생긴다면 시스템 정책을 먼저 확인하세요. 두 네트워크에서 같은 노드의 핸드셰이크가 모두 실패한다면 노드 설정을 살펴보세요. 배터리 사용과 백그라운드 안정성의 균형을 더 조정하려면 v2rayNG 배터리 최적화 및 백그라운드 실행 설정을 참고하고, 권한을 한 번에 하나씩 변경하며 결과를 기록하세요.

라우팅과 TUN: 연결 경로, 규칙, 출구

먼저 트래픽이 코어에 도달하는지 확인

시스템 프록시와 TUN은 트래픽이 클라이언트로 들어오는 방식을 처리합니다. 시스템 프록시는 앱이 읽을 수 있는 프록시 설정을 제공하지만 앱이 이를 사용하지 않을 수도 있습니다. TUN은 가상 네트워크 인터페이스와 시스템 라우팅을 이용해 조건에 맞는 트래픽을 받습니다. 라우팅은 받은 트래픽이 어떤 출구를 사용할지 결정합니다. 전역 프록시 규칙으로 바꿔도 시스템 프록시를 무시하는 앱이 자동으로 연결되지는 않습니다. 반대로 TUN을 켠다고 해서 받은 모든 연결이 원격으로 전달되는 것도 아닙니다.

‘특정 앱이 프록시를 사용하지 않는다’는 문제를 살펴볼 때는 해당 앱이 새 연결을 시작한 시점의 로그부터 확인하세요. 코어에 해당 기록이 없다면 시스템 프록시, 앱 자체 설정, 시스템 라우팅을 확인하세요. 로그는 있지만 직접 연결로 표시된다면 규칙을 살펴보세요. 로그에 기록되고 예상한 출구가 선택됐는데 연결에 실패한다면 DNS와 핸드셰이크를 확인하세요. 로그 수준에 따라 기록의 상세도가 달라질 수 있으므로 필요하면 잠시 한 단계 높인 뒤 문제를 재현하고 원래대로 돌리세요. 요청이 코어에 도달하지도 않은 상태에서 전체 규칙을 다시 작성하지 않도록 먼저 세 단계를 구분하세요.

범위가 작은 규칙부터 확인

클라이언트에 포함된 라우팅 구성을 사용할 때는 구성에 포함된 일치 조건과 기본 출구부터 살펴보세요. 이름이 비슷한 구성도 기본 동작이 다를 수 있으니 이름만 보고 결과를 추측하지 마세요. 사용자 지정 규칙은 명확한 도메인이나 네트워크 대역 하나부터 시작하고, 코어가 도메인과 IP 주소 중 무엇을 받았는지 확인하세요. 도메인 규칙은 연결의 라우팅 판단에 사용되는 도메인과 일치하며 브라우저에 입력한 전체 URL과 일치하는 것은 아닙니다. 일반적으로 도메인 조건에 프로토콜 접두사, 경로, 쿼리 매개변수를 넣지 마세요.

같은 트래픽이 여러 규칙에 해당하면 일반적인 코어의 라우팅 규칙은 순서대로 검사하며 먼저 일치한 규칙이 적용됩니다. 우선 확인해야 하는 예외 규칙은 범위가 넓은 규칙보다 앞에 배치하고, 일치하는 규칙이 없을 때 어떤 출구를 사용하는지도 확인하세요. 프록시 그룹의 별칭을 실제 아웃바운드 식별자로 착각하지 말고, 다른 코어의 설정 조각을 현재 규칙 편집기에 그대로 붙여 넣지 마세요. 코어를 바꾼 뒤에는 간단한 규칙부터 확인하고 기존 구성의 고급 조건을 단계적으로 복원하세요.

로컬 프린터, 공유 폴더, 사내 서비스는 보통 별도의 접근 경로를 사용합니다. 실제로 사용하는 로컬 도메인과 주소 대역, 사내 네트워크 요구 사항을 확인한 뒤 필요에 따라 직접 연결이나 시스템 차원의 제외 규칙을 설정하세요. 이 설정들은 항상 같은 계층에서 처리되는 것은 아닙니다. 로컬 리소스와 일반 웹페이지를 각각 테스트하세요. 웹은 정상인데 공유 리소스에 접근할 수 없다면 로컬 트래픽이 가상 네트워크 인터페이스로 들어갔는지 확인하고, 코어에 들어갔다면 어떤 출구가 선택되었는지 살펴보세요.

되돌릴 수 있는 순서로 데스크톱 TUN 사용

기존 연결 방식으로 같은 노드에 연결할 수 있는지 먼저 확인하고 시스템 프록시와 라우팅의 기준 상태를 저장한 다음 클라이언트의 구현 방식과 권한 요구 사항을 확인하세요. 테스트용 시스템 프록시를 끄고 TUN을 시작한 뒤 일반 웹페이지, 시스템 프록시를 따르지 않는 대상 앱, 계속 사용해야 하는 로컬 서비스를 각각 테스트하세요. 테스트할 때는 새 요청을 보내고 시작 전에 만들어진 장시간 연결을 재사용하지 마세요. TUN을 켠 뒤 모든 요청이 시간 초과되면 TUN을 끄고 기준 상태를 복원하세요. 기존 연결 방식이 다시 작동하는지 확인한 다음 가상 인터페이스와 시스템 라우팅을 살펴보세요.

가상 인터페이스와 다른 VPN이 동시에 실행되면 기본 경로, 대상 네트워크 대역, DNS 경로가 서로 덮어쓸 수 있습니다. 문제를 해결하려고 여러 트래픽 처리 기능을 동시에 켜지 마세요. 무선과 유선 네트워크를 전환하면 기본 게이트웨이도 바뀔 수 있습니다. 문제를 재현할 때 연결 방식, 대상 유형, 클라이언트 로그를 기록하세요. 정상 종료 후에만 문제가 생긴다면 종료 후 원래 프록시와 라우팅이 복구되는지 확인한 뒤 앱 재시작이 필요한지 판단하세요. 웹페이지 하나를 열려고 설정을 임시로 덧붙이는 것보다 안정적으로 원복할 수 있는지가 문제 해결에 더 중요합니다.

DNS 설정: 누가 어디에서 이름을 조회하는지 확인

요청별로 DNS 조회 위치 확인

문제가 발생한 주소가 구독 서버 주소인지, 노드 서버 주소인지, 접속하려는 도메인인지 먼저 확인하세요. 이 세 주소는 서로 다른 단계에서 조회될 수 있습니다. 구독 갱신은 보통 클라이언트가 요청하고, 노드 서버 도메인은 원격 연결을 시작하기 전에 주소로 변환해야 합니다. 대상 도메인은 연결 방식과 아웃바운드 설정에 따라 앱, 시스템, 코어 또는 원격에서 조회될 수 있습니다. ‘도메인 조회 실패’만으로는 원인을 알 수 없으므로 같은 시각의 로그에서 어떤 대상에 관한 오류인지 확인하고 기기 전체의 DNS 서버를 바로 바꾸지 마세요.

앱은 이미 조회한 IP 주소를 프록시에 전달할 수도 있고 도메인 이름을 전달할 수도 있습니다. 코어가 주소만 받으면 도메인 기반 라우팅 규칙이 적용되지 않을 수 있습니다. 도메인을 받는 경우에는 출구를 선택하기 전에 IP 주소를 먼저 조회할 필요가 없을 수도 있습니다. 라우팅에 도메인 정책을 사용할 때는 도메인 규칙에 의존하는지, 조회된 주소를 네트워크 대역과 비교하는지 먼저 구분하세요. 지원되는 프로토콜과 조건에서는 트래픽 스니핑이 도메인 식별에 도움이 될 수 있지만 모든 연결에서 도메인을 알아낼 수는 없으며 올바른 DNS 경로를 대신하지도 않습니다.

최소한의 변경으로 DNS 설정 확인

처음 문제를 해결할 때는 기존에 작동하던 DNS 설정을 사용하세요. 같은 네트워크와 앱에서 평소 사용하는 도메인 하나와 유지해야 하는 내부 도메인 하나를 테스트하세요. 두 도메인의 올바른 조회 결과는 서로 다른 서비스에서 제공될 수 있습니다. 내부 도메인을 조직 네트워크에서만 조회할 수 있다면 설정을 통일하려고 외부 서비스를 사용하지 마세요. 암호화 DNS를 지원하는 브라우저라면 해당 기능이 켜져 있는지 기록하세요. 브라우저 결과가 운영체제의 결과를 나타내지 않을 수 있습니다. 변경한 뒤에는 앱과 시스템 캐시를 고려해 새 요청으로 다시 테스트하세요. 기존 탭의 표시 결과만으로 결론 내리지 마세요.

다음은 V2Fly 코어 설정에 사용할 수 있는 dns 섹션 예시입니다. localhost는 로컬 시스템 DNS 조회를 사용한다는 뜻입니다. 기존 코어 설정에 병합할 수 있는 JSON 조각으로, 단독 실행이 가능한 전체 설정이 아니며 DNS 서버 주소를 루프백 주소로 지정하는 것도 아닙니다. 그래픽 클라이언트는 보통 화면에서 최종 설정을 생성하므로 해당 설정 메뉴에서 조정하세요. 이 내용을 기존 파일에 덮어쓰지 마세요. 다른 코어를 사용한다면 변경 전에 해당 코어가 지원하는 설정 키와 버전을 확인하세요.

{
  "dns": {
    "servers": ["localhost"]
  }
}

DNS 루프와 주소 계열 차이 확인

TUN이나 사용자 지정 DNS를 켠 뒤 DNS 요청이 같은 연결 경로에 다시 잡히는지 확인하세요. 노드 서버 도메인을 프록시 연결 후에만 조회할 수 있다면 시작 과정에서 서로를 기다리는 상황이 생길 수 있습니다. 처음 오류가 기록된 로그와 기존 시스템 DNS를 비교해 기본 연결에 필요한 조회 요청이 어느 경로를 사용하는지 확인하세요. 최근 변경을 먼저 되돌린 뒤 DNS 관련 설정을 하나씩 복원하세요. DNS, 라우팅 규칙, 코어를 한꺼번에 바꾸지 마세요. 그래야 복구하더라도 어떤 설정이 영향을 줬는지 알 수 없습니다.

같은 도메인에 IPv4와 IPv6 주소가 함께 등록될 수 있습니다. DNS 조회에 성공했다고 해서 현재 네트워크에서 모든 주소에 접속할 수 있는 것은 아닙니다. 집에서는 정상인데 모바일 네트워크에서 시간 초과가 발생한다면 로그에 표시된 실제 연결 주소와 네트워크의 주소 계열 지원 여부를 확인하세요. HTTPS 사이트의 IP 주소로 직접 접속해 도메인 설정이 잘못됐는지 판단하지 마세요. 인증서 이름, 서버 이름, 실제 접속 도메인이 일치해야 할 수 있습니다. 같은 도메인으로 비교해 주소를 받지 못한 것인지 주소를 받은 뒤 연결되지 않는 것인지 확인하세요.

특정 브라우저에서만 DNS 오류가 발생하면 해당 브라우저의 프록시 및 암호화 DNS 설정부터 비교하세요. 모든 프로그램에서 실패한다면 시스템 DNS와 현재 네트워크의 연결 경로를 확인하세요. TUN을 켰을 때만 문제가 발생한다면 켜고 끈 상태의 DNS 경로와 로컬 서비스 접속 여부를 비교하세요. 점검을 마치면 불필요한 임시 설정을 원래대로 되돌리고 문제를 해결한 설정만 남긴 뒤 이유를 기록하세요. 네트워크가 바뀐 뒤 실험용 설정을 계속 필요한 설정으로 오해하지 않게 됩니다.

자주 발생하는 설정 문제: 로컬 상태부터 원격 연결까지 확인

구독 갱신 실패 또는 갱신 후 노드가 보이지 않는 문제

현재 그룹을 편집 중인지 확인하고 주소에 불필요한 공백이 있거나 복사 과정에서 잘리지 않았는지 살펴보세요. 로그에 인증되지 않음 또는 접근 금지 응답이 있으면 제공업체에 주소 권한과 상태를 확인하세요. 응답 내용을 받았지만 파싱에 실패했다면 로그인 페이지나 안내 페이지 또는 다른 클라이언트 형식이 반환된 것은 아닌지 확인하세요. 같은 주소를 이전 노드를 통해서만 갱신할 수 있었다면 갱신 전에 사용 가능한 설정을 하나 보존하고 갱신 요청이 직접 연결인지 현재 프록시를 이용하는지 확인하세요. 새 그룹이 정상 작동하는지 확인하기 전에 기존 항목을 모두 삭제하지 마세요.

갱신에 성공했는데도 오래된 내용이 보인다면 현재 목록의 필터, 그룹 선택, 활성 서버를 먼저 확인하세요. 자동 갱신 간격과 수동 갱신은 별개입니다. 테스트할 때는 직접 갱신한 뒤 기록된 시각과 결과를 살펴보세요. 새 항목이 추가되었는데 활성 노드가 바뀌지 않았다면 해당 항목을 다시 선택해 새 요청을 보내세요. 특정 그룹에서만 문제가 생기면 해당 그룹만 분리해서 확인하고 클라이언트 설정 전체를 초기화하지 마세요.

코어 시작 오류, 포트 충돌, 권한 부족

시작 시점의 첫 번째 주요 오류를 확인하세요. 주소가 이미 사용 중이라면 플랫폼별 안내에 따라 이전 클라이언트 인스턴스인지, 잘못된 리스너 주소인지, 다른 프로그램이 포트를 사용 중인지 살펴보세요. 변경할 수 있는 것으로 확인되면 클라이언트의 리스너 포트를 바꾸고 이전 포트를 수동 설정한 앱도 함께 수정하세요. 파일을 찾을 수 없거나 실행할 수 없다는 메시지가 나오면 설치 파일 아키텍처, 프로그램 경로, 파일 권한을 확인하세요. 매개변수가 유효하지 않다면 최근 추가한 규칙이나 사용자 지정 설정을 잠시 끄고 간단한 노드로 테스트하세요. 오류마다 원인이 다른 계층에 있으므로 시스템 프록시를 다시 켜도 잘못된 매개변수를 코어가 읽을 수는 없습니다.

코어는 실행 중이지만 연결 시간 초과 또는 핸드셰이크 실패

요청이 올바른 로컬 연결 지점에 실제로 도달하는지 먼저 확인한 뒤 시스템 시간, 활성 노드, 코어의 호환성을 확인하세요. 핸드셰이크가 실패하면 제공업체가 안내한 프로토콜, 전송 방식, 보안 매개변수를 대조하세요. 오류를 숨기기 위해 인증서 검증을 끄지 마세요. 연결 시간 초과는 DNS 조회가 끝나지 않은 것인지, 연결이 성립되지 않은 것인지, 연결 후 예상한 응답을 받지 못한 것인지 구분하세요. 같은 앱과 연결 방식으로 사용 가능 여부를 알고 있는 다른 노드와 비교하거나 노드는 그대로 두고 허용된 다른 네트워크에서 테스트하세요. 한 번에 하나의 조건만 바꾸세요.

브라우저와 클라이언트의 속도 테스트 결과가 다르면 각 테스트가 무엇을 측정하는지 확인하세요. 속도 테스트는 선택한 연결의 일부 경로만 확인할 수 있으며 실제 앱 요청을 대신하지 않습니다. 웹페이지는 열리지만 동영상, 회의 또는 다른 앱에서 문제가 생긴다면 같은 연결 경로와 프로토콜을 사용하는지, 현재 연결 방식이 해당 트래픽을 처리하는지 확인하세요. 한 가지 테스트에 성공했다고 해서 기기 전체와 모든 앱이 같은 설정으로 작동한다고 단정하지 마세요.

클라이언트를 중지한 뒤 네트워크가 복구되지 않는 문제

데스크톱에서는 시스템 프록시가 중지된 로컬 포트를 계속 가리키는지 먼저 확인한 다음 TUN이 종료되었는지, 기본 네트워크와 DNS가 기준 상태로 돌아왔는지 확인하세요. 모바일 기기에서는 시스템 VPN의 항상 켜기 및 VPN 없이 연결 차단 옵션을 살펴보세요. 이번에 직접 변경한 항목만 복구하고 조직에서 미리 설정한 프록시나 다른 네트워크 설정은 삭제하지 마세요. 프록시 설정을 되돌렸는데도 일반 인터넷 연결이 되지 않는다면 클라이언트 없이 연결하는 조건으로 돌아가 현재 네트워크 로그인, IP 주소 할당, 기본 연결을 점검하세요. 라우팅 규칙을 더 추가하지 마세요.

다시 확인할 수 있도록 문제 기록 정리

운영체제, 클라이언트와 코어 유형, 연결 방식, 전환 전후 상태, 재현 시각, 오류 전후의 로그 몇 줄을 기록하세요. 네트워크 전환, 화면 꺼짐, 절전 모드에서 깨어난 뒤에만 문제가 발생한다면 발생 순서와 앱 상태도 적으세요. 진단용 스크린샷을 공유하기 전에 구독 주소, 계정 정보, 서버 주소, 내부 도메인을 가리세요. 어떤 변경을 되돌렸는지와 변경 전에는 정상 작동했는지 기록하면 다른 사람이 연결 문제와 테스트 과정에서 새로 생긴 문제를 구분하는 데 도움이 됩니다.

오류 문구를 기준으로 더 살펴보려면 V2Ray 실행 로그로 문제 찾기를 참고하세요. 설치와 사용 중 자주 묻는 질문은 도움말 센터에서 확인할 수 있습니다. 처음 연결 과정을 다시 진행하려면 입문 가이드의 구독 가져오기 단계로 돌아가 그룹 하나, 노드 하나, 연결 방식 하나로 새로운 기준 상태를 만드세요.