공통 준비: 설치 파일 선택, 구독 및 권한
운영체제, 프로세서, 설치 파일 형식 확인
설치 파일을 고를 때는 먼저 기기의 운영체제를 확인하고, 다음으로 시스템에 표시된 프로세서 아키텍처를 살펴본 뒤 파일 형식을 선택하세요. 데스크톱에서는 v2rayN을 권장합니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 고려하고, V2Fly 코어가 필요할 때 v2flyNG를 선택하세요. 이름이 비슷한 클라이언트라도 설치 파일을 서로 바꿔 쓸 수 있는 것은 아니며, 구독을 가져왔다고 모든 설정이 작동하는 것도 아닙니다. 아직 클라이언트를 고르는 중이라면 클라이언트 비교를 확인하세요. 운영체제와 아키텍처를 알고 있다면 바로 다운로드 페이지에서 설치 파일을 선택하면 됩니다.
| 운영체제 | 클라이언트 | 설치 파일 선택 기준 | 첫 연결 확인 방법 |
|---|---|---|---|
| Windows | v2rayN | x64 데스크톱 버전 또는 클래식 WPF 버전 | 시스템 프록시와 브라우저 |
| macOS | v2rayN | Apple Silicon 또는 Intel용 DMG | 현재 네트워크 서비스의 프록시 설정 |
| Linux | v2rayN | x64 또는 arm64. 배포판에 따라 DEB 또는 RPM 선택 | 로컬 프록시 포트를 지정한 요청 |
| Android | v2rayNG、v2flyNG | arm64 또는 범용 APK | 시스템 VPN 상태 및 앱 접속 결과 |
시스템이 64비트라고 해서 프로세서가 반드시 x64인 것은 아닙니다. arm64도 64비트지만 사용하는 명령어 체계가 다릅니다. 파일 형식도 확장자만 바꾼다고 해결되지 않습니다. 예를 들어 DEB와 RPM은 서로 다른 패키지 관리자가 처리하며, 포함된 의존성이나 설치 정보 등록 방식도 다릅니다. 다운로드 페이지에 현재 기기에 맞는 아키텍처나 형식이 없다면 클라이언트의 지원 범위를 먼저 확인하세요. 파일 이름을 바꾸거나 압축 해제 도구를 바꾸거나 강제 설치를 반복하지 마세요.
구독 주소, 단일 설정 링크, 현재 선택된 노드 구분하기
구독 주소는 여러 설정을 가져오는 경로이며, 단일 공유 링크는 하나의 연결 설정만 담고 있습니다. 각각 해당 메뉴에서 가져와야 합니다. 데스크톱에서는 보통 먼저 ‘구독 그룹 설정’에 주소를 저장한 다음, 기본 화면의 ‘구독 그룹’ 메뉴에서 업데이트합니다. 클립보드에서 단일 공유 링크를 가져오는 것은 이 단계를 대신하지 않습니다. 목록에 노드가 나타나면 사용할 설정 하나를 선택해야 합니다. 구독 그룹 이름은 용도별로 알아보기 쉽게 정할 수 있지만, 주소나 계정 정보, 노드 비밀번호는 이름에 넣지 마세요.
구독 링크에는 접속 정보가 포함될 수 있으므로 비공개 링크처럼 다루세요. 공개 메모나 온라인 변환 도구, 도움 요청 게시물에 붙여 넣지 마세요. 다른 사람에게 도움을 요청할 때는 오류가 발생한 단계와 주소·인증 정보·기기 식별자를 삭제한 로그 일부만 공유하세요. 이전 기기에서 설정을 옮길 때는 클라이언트가 지원하는 내보내기 및 가져오기 기능을 우선 사용하세요. 내보낸 설정 파일에 기존 인증 정보가 포함될 수 있으므로 사본을 저장할 때도 주의해야 합니다. 이전 기기의 폴더 전체를 새 버전에 덮어쓰지 말고, 특히 오래된 코어와 캐시는 함께 옮기지 마세요.
첫 테스트를 위한 명확한 시작점 만들기
시작하기 전에 프록시를 끈 상태에서 일반 웹페이지가 열리는지, 기기의 날짜·시간·시간대가 올바른지, 다른 프록시나 네트워크 필터링 도구 또는 VPN이 실행 중인지 확인하세요. 회사나 기관에서 관리하는 기기에는 고정 프록시나 관리형 네트워크 정책이 적용되어 있을 수 있습니다. 권한이 있을 때만 설정을 변경하고 원래 상태를 기록해 두세요. 첫 연결 테스트에서는 네트워크를 바꾸거나 기기를 다시 시작할 때 조건이 달라지지 않도록 클라이언트의 자동 업데이트와 시작 시 실행을 먼저 끄는 편이 좋습니다. 현재 네트워크, 테스트할 앱, 예상 결과를 미리 적어 두면 나중에 비교하기 쉽습니다.
데스크톱의 시스템 프록시는 해당 설정을 따르는 앱이 요청을 클라이언트의 로컬 진입점으로 보내도록 지정합니다. TUN은 가상 네트워크 인터페이스를 통해 해당 경로로 라우팅되는 트래픽을 받아들이므로 일반적으로 적용 범위가 더 넓습니다. Android는 시스템 VPN 인터페이스를 사용하므로 무선 네트워크 설정에 데스크톱 프록시 주소를 직접 입력할 필요가 없습니다. 어느 방식을 선택하더라도 모든 앱과 요청이 자동으로 처리되는 것은 아닙니다. 처음 설정할 때는 ‘브라우저에서 테스트 페이지 열기’처럼 목표를 구체적으로 정하세요. ‘기기 전체가 프록시를 사용한다’고 막연히 판단하는 것보다 유용합니다.
Windows: v2rayN 설치 및 시스템 프록시 설정
x64 확인 후 데스크톱 버전 또는 WPF 버전 선택
Windows에서 ‘설정 → 시스템 → 정보’를 열고 ‘장치 사양’의 ‘시스템 종류’를 확인하세요. 시작 메뉴에서 ‘PC 정보’를 검색해도 됩니다. x64 기반 프로세서라고 표시되는지 확인한 뒤 Windows 다운로드 옵션에서 v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 Windows에서 익숙한 화면 구성을 유지합니다. 두 버전은 연결 프로토콜이 다른 것이 아닙니다. 처음 사용한다면 한 가지를 선택하면 됩니다. 이전 버전에서 옮기는 중이라면 데스크톱 버전과 WPF 버전 비교를 확인한 뒤 기존 설치를 유지할지 결정하세요.
다운로드가 끝나면 설치 안내를 따르세요. 처음 실행할 때는 방금 설치한 앱을 열었는지 확인하세요. 작업 표시줄에 예전 바로 가기가 고정되어 있다면 특히 주의해야 합니다. 실행에 필요한 구성 요소가 없다는 메시지가 나오면 선택한 버전의 요구 사항에 맞춰 구성 요소를 설치한 뒤 다시 실행하세요. 다른 버전의 프로그램 파일을 가져와 누락된 파일을 채우지 마세요. 앱이 알림 영역에만 표시된다면 작업 표시줄 오른쪽의 숨겨진 아이콘을 열어 기본 창을 찾아보세요. 여러 번 실행을 시도하면 실제로는 실행된 앱을 실행되지 않은 것으로 오해할 수 있습니다. 버전을 바꿀 때는 기존 프로세스가 같은 포트를 사용하지 않도록 먼저 종료하세요.
구독을 가져온 뒤 브라우저에서만 프록시 테스트
기본 창에서 ‘구독 그룹 → 구독 그룹 설정’을 열고 그룹을 추가한 다음 구독 주소를 입력하세요. 저장 후 ‘구독 그룹’으로 돌아가 먼저 ‘전체 구독 업데이트(프록시 사용 안 함)’ 또는 비슷한 항목을 선택합니다. 사용할 연결이 아직 없는 상태라면 프록시를 통한 업데이트부터 시도하지 마세요. 클라이언트가 설정을 받기도 전에 이미 작동하는 연결을 요구할 수 있습니다. 업데이트가 끝나면 노드가 예상한 그룹에 표시되는지 확인하세요. 노드를 마우스 오른쪽 버튼으로 클릭하고 ‘활성 서버로 설정’을 선택한 뒤 상태 표시줄이나 로그에서 변경 결과를 확인합니다. 버전에 따라 메뉴 문구는 다를 수 있지만 주소 저장, 목록 업데이트, 활성 항목 지정은 각각 별도의 작업입니다.
알림 영역 아이콘 메뉴의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하고 기본 시스템 설정을 사용하는 브라우저로 테스트 페이지를 여세요. 필요한 경우 Windows의 ‘설정 → 네트워크 및 인터넷 → 프록시’에서 시스템 프록시 설정을 확인하고 클라이언트에 표시된 로컬 진입점과 비교하세요. Windows의 ‘자동으로 설정 검색’은 v2rayN 메뉴의 ‘시스템 프록시 자동 설정’과 다릅니다. 전자는 시스템에서 네트워크 프록시 구성을 찾는 기능입니다. 테스트 중 브라우저에 별도 프록시 확장 프로그램이나 정책이 적용되어 있다면 시스템 설정을 덮어쓰는지 확인한 뒤, 그런 설정이 없는 브라우저 창에서 다시 테스트하세요.
적용 범위를 넓혀야 할 때 TUN 사용
브라우저는 연결되지만 시스템 프록시를 따르지 않는 데스크톱 앱이 있다면, 먼저 앱 자체의 프록시 설정을 확인한 뒤 TUN이 필요한지 판단하세요. v2rayN의 시스템 프록시 메뉴에서 ‘시스템 프록시 지우기’를 선택하고, 클라이언트 안내에 따라 필요한 권한을 부여한 다음 기본 화면에서 ‘Tun 사용’을 켭니다. 인터페이스 생성 실패, 권한 부족, 경로 추가 실패 메시지가 나타나면 로그를 보관하고 다른 VPN이나 가상 네트워크 도구가 관련 설정을 사용 중인지 확인하세요. 회사 환경에서는 테스트를 위해 보안 도구를 끄거나 관리형 정책을 변경하지 마세요. 허용된 사용 방법을 먼저 확인해야 합니다.
TUN이 필요하지 않다면 시스템 프록시를 일상적인 설정으로 사용하는 편이 되돌리기 쉽습니다. 일부 백그라운드 서비스와 명령줄 도구는 별도의 프록시 설정을 사용하므로 브라우저가 정상이라고 해서 같은 경로를 이용한다고 단정할 수 없습니다. 클라이언트 실행 직후 주소 사용 중 오류가 나타나면 로그에서 충돌한 로컬 포트를 확인하고 이전 프로세스가 실행 중인지 살펴보세요. 포트를 변경했다면 수동으로 설정한 앱도 함께 업데이트해야 합니다. 종료하기 전에 ‘시스템 프록시 지우기’를 선택한 뒤 알림 영역 메뉴에서 클라이언트를 완전히 종료하세요. 네트워크에 회사나 개인용 프록시를 수동으로 설정해 두었다면 미리 기록한 값으로 복원하고, 시스템 설정을 무조건 비워 두지 마세요.
다음에 로그인했을 때 로컬 주소를 가리키는 프록시가 다시 나타난다면 시작 프로그램에 구버전과 새 버전이 모두 등록되어 있는지 확인하세요. 회사 정책이 설정을 자동으로 다시 적용하는지도 살펴보세요. 다시 테스트할 때는 프로세스를 하나만 실행하고 브라우저를 열기 전에 로컬 리스너가 준비되었는지 확인하세요. 클라이언트를 종료하면 일반 웹페이지가 다시 열리지만 실행 중에는 계속 실패한다면 구독 가져오기, 활성 설정, 핸드셰이크 로그를 확인하세요. 종료한 뒤에도 접속되지 않는다면 먼저 Windows의 현재 프록시 상태와 네트워크 연결을 점검하세요.
macOS: v2rayN 설치 및 네트워크 서비스 전환
칩에 맞는 DMG를 다운로드한 뒤 응용 프로그램으로 이동
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’ 항목에 Apple 칩이라고 표시되면 Apple Silicon용 arm64 설치 파일을 선택하고, ‘프로세서’ 항목에 Intel이라고 표시되면 Intel용 x64 설치 파일을 선택하세요. macOS 다운로드 옵션에서 알맞은 DMG를 다운로드한 뒤 디스크 이미지를 열고 창의 안내에 따라 앱을 ‘응용 프로그램’으로 이동하세요. 디스크 이미지를 추출한 다음 ‘응용 프로그램’에서 앱을 실행합니다. 앱을 마운트된 창에 둔 채 바로 실행하면 나중에 이미지를 추출할 때 원래 실행 경로를 찾지 못할 수 있습니다.
처음 실행할 때 시스템 알림이 나타나면 다운로드 출처 안내인지, 실행 차단인지, 시스템과의 비호환 안내인지 먼저 구분하세요. 출처를 신뢰할 수 있고 기기 정책에서 허용하는 경우에만 해당 앱에 제공되는 확인 절차를 진행하세요. 앱 하나 때문에 시스템 보호 기능을 전역으로 끄지 마세요. 현재 시스템에서 앱을 실행할 수 없다는 메시지가 나오면 더 높은 권한으로 반복 실행하지 말고 칩 종류와 앱 요구 사항을 다시 확인하세요. 업데이트할 때는 기존 프로세스를 먼저 종료하고 앱을 교체하세요. 개인 설정은 앱 자체와 별개이므로 따로 백업해 두세요.
구독을 가져오고 현재 네트워크 서비스 확인
v2rayN 기본 창에서 ‘구독 그룹 설정’을 열고 주소를 추가한 다음 ‘구독 그룹’으로 돌아가 프록시를 사용하지 않는 업데이트를 실행하세요. 목록이 나타나면 활성 설정을 선택하고 로그에 설정 해석 오류나 연결 오류가 계속 기록되지 않는지 확인합니다. 그런 다음 메뉴 막대의 클라이언트 아이콘에서 ‘시스템 프록시’를 열고 ‘시스템 프록시 자동 설정’을 선택하세요. ‘시스템 설정 → 네트워크’로 이동해 현재 사용 중인 네트워크 서비스를 여세요. Wi‑Fi를 사용하는 경우 ‘Wi‑Fi → 세부사항 → 프록시’에서 해당 프록시 항목의 서버와 포트가 클라이언트에 표시된 값과 일치하는지 확인합니다. 시스템 버전에 따라 무선 네트워크를 Wi‑Fi로 표시할 수 있지만, 현재 서비스의 세부 설정을 찾아야 합니다.
시스템 프록시는 네트워크 서비스별로 설정됩니다. 무선 네트워크에서 유선으로 바꾸거나 도킹 스테이션을 연결하면 기존 서비스의 설정이 새 연결에 적용되지 않을 수 있습니다. 메뉴 막대에 클라이언트 실행 중 표시가 남아 있어도 브라우저가 실제로 사용하는 설정은 달라졌을 수 있습니다. 먼저 트래픽을 전달하는 서비스가 무엇인지 확인한 다음 해당 서비스의 프록시 설정을 살펴보세요. 이전 무선 네트워크 항목에서만 계속 스위치를 바꾸지 마세요. 기기에 자동 프록시 구성 스크립트 주소가 있다면 용도를 기록해 두세요. 수동 프록시와 자동 구성이 함께 설정된 경우 앱이 시스템 설정을 읽는 방식에 따라 접속 결과가 달라질 수 있습니다.
TUN 및 잠자기에서 깨어난 뒤 연결 복구
시스템 프록시를 따르지 않는 앱을 처리해야 할 때만 클라이언트의 ‘Tun 사용’을 시도하세요. 먼저 이번에 설정한 시스템 프록시를 해제한 뒤 클라이언트 안내에 따라 필요한 권한을 부여하고, 로그에서 가상 인터페이스와 라우팅이 실제로 적용되었는지 확인하세요. 버튼 상태는 클라이언트가 전환 명령을 받았다는 뜻일 뿐, 성공 로그를 대신하지 않습니다. 현재 빌드에서 해당 기능을 지원하지 않거나 기기 관리 정책이 경로 변경을 제한한다면 시스템 프록시나 앱 자체의 프록시 설정을 사용하세요. 시스템 명령으로 기본 경로를 무작정 바꾸지 마세요.
덮개를 닫았다가 열면 시스템이 먼저 무선 네트워크에 다시 연결한 뒤 앱 연결을 복구할 수 있습니다. 잠깐 연결이 끊기면 네트워크 서비스가 복구되었는지 확인한 다음 새 웹페이지를 여세요. 네트워크가 주소를 받기도 전에 구독 업데이트를 연달아 시도하지 마세요. 계속 실패한다면 잠자기 전후로 접속 지점이 바뀌었는지 기록하고 클라이언트의 로컬 리스너가 여전히 실행 중인지 확인하세요. 그다음 사용 중인 모드에 따라 시스템 프록시를 다시 설정하거나 Tun을 다시 켭니다. 접속한 무선 네트워크에서 인증 페이지 로그인이 필요하다면 이번에 설정한 프록시를 잠시 끄고 인증하세요. 기본 접속이 복구된 것을 확인한 뒤 다시 연결하면 됩니다.
사용을 마치면 메뉴 막대에서 시스템 프록시를 해제하거나 켜 둔 Tun을 끄고, 클라이언트를 종료한 다음 현재 서비스의 설정을 다시 확인하세요. 네트워크 서비스에 원래 사용자 지정 프록시가 있었다면 미리 기록한 값만 복원하고 다른 서비스의 설정은 삭제하지 마세요. 잠자기 후 간헐적으로 문제가 생긴다면 특정 서비스에서만 발생하는지, 잠자기 후 매번 발생하는지 기록하는 것이 가장 유용합니다. 이 차이를 통해 네트워크 전환 문제인지, 클라이언트와 앱 연결이 시스템과 함께 복구되지 않은 문제인지 판단할 수 있습니다.
Linux: v2rayN 패키지, 데스크톱 프록시 및 TUN
아키텍처와 배포판에 따라 DEB 또는 RPM 선택
먼저 터미널에서 uname -m을 실행하세요. 일반적으로 출력값 x86_64는 다운로드 페이지의 x64에 해당하고, aarch64는 arm64에 해당합니다. 이어서 /etc/os-release를 확인해 배포판과 기본 패키지 관리자를 파악하세요. 보통 Debian 및 Ubuntu 계열은 DEB를, DNF를 사용하는 Fedora 계열 배포판은 RPM을 선택합니다. 같은 데스크톱 환경을 여러 배포판에서 사용할 수 있으므로 화면 모양만 보고 패키지 형식을 고르지 마세요. Linux 다운로드 옵션에서 v2rayN을 선택하고 아키텍처와 파일 형식을 확인한 뒤 패키지 관리자로 여세요.
그래픽 인터페이스를 선호한다면 배포판의 소프트웨어 설치 도구에서 다운로드한 패키지를 열면 됩니다. 의존성 문제로 설치할 수 없다는 메시지가 나오면 시스템 소프트웨어 저장소가 정상인지, 패키지가 배포판에 맞는지 먼저 확인한 뒤 어떤 의존성이 누락되었는지 살펴보세요. 의존성 확인을 강제로 건너뛰어 설치하지 마세요. 누락된 구성 요소의 문제는 앱 실행 때 바로 나타나지 않고 알림 영역 표시, 설정 저장, 프록시 전환 시점에 드러날 수도 있습니다. 설치 후 데스크톱 앱 메뉴에서 클라이언트를 실행하고 일반 사용자 계정으로 구독과 프록시를 설정하세요. 관리자 권한으로 실행하는 것을 일반적인 실행 방법으로 삼지 마세요.
일부 데스크톱 환경에서는 기존 알림 영역 아이콘이 기본 패널에 표시되지 않습니다. 닫기 버튼을 눌렀는데 클라이언트가 보이지 않으면 창이 알림 영역으로 최소화되었는지 확인한 다음 앱 메뉴에서 다시 열어 보세요. 여러 사용자 세션이 있다면 현재 작업 중인 세션에서 프로그램이 실행되는지도 확인하세요. 이전에 관리자 권한으로 실행한 뒤 일반 사용자로 설정을 저장할 수 없더라도 같은 방식으로 문제를 덮지 마세요. 설정을 백업하고 클라이언트 자체 디렉터리의 소유권 문제인지 확인한 뒤 배포판에서 제공하는 방법으로 소유권을 복원하세요. 홈 디렉터리 전체를 재귀적으로 변경하지 마세요.
구독을 가져오고 데스크톱 프록시와 터미널 프록시 구분하기
‘구독 그룹 설정’에서 그룹과 주소를 저장한 뒤 ‘전체 구독 업데이트(프록시 사용 안 함)’를 실행하고 목록에서 활성 설정을 선택하세요. 클라이언트의 ‘시스템 프록시 자동 설정’이 데스크톱 프록시를 적용할 수 있는지는 데스크톱 환경과 클라이언트의 연동 방식에 따라 다릅니다. 데스크톱 설정의 ‘네트워크 → 네트워크 프록시’에서 실제 값을 확인하세요. 일부 환경에서는 ‘시스템 설정 → 네트워크 → 프록시’에 있습니다. 데스크톱 프록시가 켜져 있어도 터미널 도구는 자체 옵션이나 환경 변수를 사용할 수 있으므로 따로 테스트해야 합니다.
아래 명령은 이번 요청에만 로컬 HTTP 프록시를 적용하며 데스크톱이나 터미널의 상시 설정은 바꾸지 않습니다. 실행 전에 예시의 포트를 v2rayN 설정에 표시된 HTTP 포트로 바꾸거나 HTTP를 지원하는 혼합 진입점 포트인지 확인하세요. SOCKS 전용 포트를 http:// 주소에 지정하지 마세요. 이 명령을 실행하려면 로컬에 curl이 설치되어 있어야 하며, 마지막 주소는 테스트가 허용된 웹페이지로 바꿀 수 있습니다.
uname -m
cat /etc/os-release
curl --max-time 15 --noproxy '' \
--proxy http://127.0.0.1:10809 \
--head https://example.com/
루프백 주소에 연결할 수 없다는 메시지가 바로 나오면 클라이언트가 리스너를 실행 중인지, 포트를 정확히 입력했는지 확인하세요. 로컬 포트에는 연결되지만 이후 시간 초과, 프록시 오류 또는 TLS 오류가 발생한다면 활성 설정과 로그를 확인하세요. 일부 웹사이트는 명령의 HEAD 요청을 허용하지 않습니다. 요청 방식이 지원되지 않는다는 응답이 나오면 --head를 제거하고 일반 요청으로 다시 테스트하세요. 한 번 성공했다고 모든 터미널 프로세스가 데스크톱 프록시를 상속한다거나 모든 도메인이 같은 경로를 이용한다고 볼 수는 없습니다.
TUN을 켜기 전에 로컬 복구 방법 확보
시스템이 TUN을 지원하고 클라이언트에 필요한 네트워크 작업 권한을 허용하는지 확인한 뒤 v2rayN에서 ‘Tun 사용’을 켜세요. 먼저 데스크톱 프록시를 해제하고 트래픽 처리 방식만 변경합니다. 첫 테스트는 직접 조작할 수 있는 세션에서 진행하세요. 유일한 원격 관리 연결에서 경로 변경을 시험하지 마세요. 로그에 장치를 사용할 수 없음, 권한 부족, 경로 추가 실패가 표시되면 시스템·컨테이너·권한 중 어떤 제약인지 먼저 확인하세요. 네트워크 장치를 모든 사용자가 조작할 수 있도록 무작정 설정하지 마세요. 스위치를 켠 뒤 사내 네트워크에 문제가 생기면 Tun을 끄고 원래 상태로 복원한 다음 네트워크 대역 충돌인지 규칙 적용 범위 문제인지 확인하세요.
일부 사용자는 터미널 프로그램에 별도의 프록시 환경 변수를 설정해 둡니다. 클라이언트를 종료해도 이런 변수는 데스크톱 설정처럼 자동으로 지워지지 않습니다. 새 터미널에서는 정상인데 기존 터미널에서 실패한다면 기존 세션의 http_proxy, https_proxy, all_proxy가 이전 포트를 가리키는지 확인하고 대문자 변수와 도구별 설정 파일도 살펴보세요. 이번에 임시로 추가한 설정만 되돌리고 회사 네트워크에 필요한 프록시까지 지우지 않도록 주의하세요. 복구한 뒤 데스크톱 앱 하나와 터미널 요청 하나를 테스트하면 두 진입점이 모두 예상대로 돌아왔는지 확인할 수 있습니다.
Android: v2rayNG·v2flyNG 설치 및 VPN 연결
클라이언트를 먼저 고르고 arm64 또는 범용 패키지 선택
Android 다운로드 옵션에서 v2rayNG를 우선 확인하세요. 설정 제공자가 V2Fly 코어를 명시적으로 요구하는 경우에만 v2flyNG를 선택하면 됩니다. 최신 기기 다수는 arm64 패키지를 사용할 수 있지만 설치 가능 여부는 Android 시스템에서 앱에 해당 아키텍처를 제공하는지에 달려 있습니다. 프로세서 하드웨어만 보고 판단하지 마세요. 확실하지 않다면 해당 클라이언트의 범용 패키지를 선택할 수 있습니다. 범용 패키지는 여러 아키텍처의 구성 요소를 포함하는 경우가 많지만, 시스템 버전 불일치나 저장 공간 부족, 기기 관리 제한까지 해결해 주지는 않습니다.
APK를 다운로드한 뒤 시스템 다운로드 목록이나 파일 관리자에서 여세요. 시스템이 현재 출처의 앱 설치를 허용하라고 요청하면 설치 출처를 신뢰할 수 있고 기기 정책에서 허용하는 경우에만 실제 설치를 시작한 앱에 임시 권한을 부여하세요. 설치가 끝나면 권한을 해제할 수 있습니다. 업데이트할 수 없다는 메시지가 나오면 기존 앱과 같은 클라이언트인지, 설치 출처가 같은지 확인한 뒤 서명이 달라 덮어쓸 수 없는 상황인지 살펴보세요. 설치 실패가 발생했다고 바로 기존 앱을 삭제하지 마세요. 구독과 로컬 설정이 함께 삭제될 수 있으므로 기존 내보내기 기능으로 먼저 사본을 보관하세요.
구독 업데이트가 곧 연결을 의미하지는 않습니다
클라이언트의 사이드바나 기본 메뉴에서 ‘구독 그룹 설정’을 여세요. 일부 화면에서는 ‘구독 설정’으로 표시됩니다. 항목을 추가하고 알아보기 쉬운 설명과 구독 주소를 입력한 뒤 그룹이 활성화되어 있는지 확인하고 저장하세요. 기본 화면으로 돌아가 오른쪽 위 메뉴에서 ‘구독 업데이트’를 누릅니다. 현재 그룹과 전체 그룹을 구분하는 화면이라면 처음에는 방금 만든 그룹만 업데이트해도 됩니다. 주소가 단일 공유 링크라면 원격 구독 주소로 넣지 말고 기본 화면의 더하기 버튼에서 클립보드 가져오기를 선택하세요. 목록을 불러온 뒤 설정 하나를 선택하고 기본 화면의 연결 버튼을 누릅니다.
처음 연결할 때 Android에서 VPN 연결 허용을 요청합니다. 권한을 부여하기 전에 알림에 표시된 앱 이름이 방금 연 클라이언트와 일치하는지 확인한 뒤 클라이언트 상태와 시스템 VPN 표시를 확인하세요. 권한을 부여하지 않아도 기본 목록은 정상적으로 보일 수 있지만, 트래픽이 클라이언트로 전달된다는 뜻은 아닙니다. 시스템 VPN 표시가 나타나면 인터페이스가 만들어졌다는 의미이지 선택한 노드에 접속할 수 있다는 보장은 아닙니다. 다음으로 브라우저에서 테스트 페이지를 열고 실제 사용할 앱도 따로 실행하세요. 결과가 다르면 해당 앱이 앱별 규칙에서 제외되었는지 먼저 확인하세요.
앱별 설정, 백그라운드 제한 및 네트워크 전환
Android에서는 일반적으로 무선 네트워크의 수동 프록시를 따로 설정할 필요가 없습니다. 클라이언트가 시스템 VPN 인터페이스를 통해 라우팅 및 앱 범위에 맞는 트래픽을 받아들입니다. 클라이언트 설정에서 ‘앱별 프록시’나 비슷한 기능을 켰다면 먼저 포함 목록인지 제외 목록인지 확인하세요. 같은 앱에 체크 표시가 있더라도 규칙에 따라 의미가 반대일 수 있습니다. 테스트할 때는 먼저 앱별 규칙을 끄고 기본 연결을 확인한 다음 앱 하나의 포함 또는 제외 여부만 바꾸세요. 변경 후 클라이언트가 연결을 다시 설정하라고 하면 안내에 따라 재연결한 뒤 결과를 확인하세요.
같은 사용자 환경에서 시스템 VPN 인터페이스를 사용하는 다른 앱은 현재 연결과 충돌할 수 있습니다. 일부 로컬 필터링 도구도 여기에 해당합니다. 연결을 누른 직후 끊긴다면 ‘설정 → 네트워크 및 인터넷 → VPN’과 비슷한 시스템 메뉴에서 어떤 앱이 VPN을 사용 중인지, 항상 켜기 또는 VPN 없이 연결 차단이 활성화되어 있는지 확인하세요. 기기에 따라 ‘기타 연결 설정’ 아래에 있을 수 있으니 설정 검색을 이용해도 됩니다. 업무용으로 관리되는 VPN을 임의로 교체하지 마세요. 충돌을 확인하려면 권한이 있는 환경에서 테스트해야 합니다.
화면이 꺼져 있을 때 연결이 끊기고 화면을 켜면 정상이라면 클라이언트 알림과 로그를 먼저 확인하세요. 서비스가 중지되었다면 시스템 배터리 설정에서 해당 앱의 백그라운드 제한을 살펴보세요. 서비스는 실행 중인데 요청이 시간 초과된다면 무선 네트워크와 모바일 네트워크를 나눠 테스트하세요. 네트워크가 바뀌면 기존 연결은 시스템 VPN 표시가 계속 보여도 끊길 수 있습니다. 기본 네트워크가 복구될 때까지 기다린 뒤 연결을 한 번 끊었다가 다시 연결하고 새로 연 페이지로 확인하세요. 자동 업데이트만 실패한다면 구독 설정의 업데이트 스위치와 간격, 백그라운드 실행 조건을 확인하세요. 자동 업데이트 주기가 현재 노드의 연결 가능 여부를 결정하는 것은 아닙니다.
잠깐 사용한 뒤에는 클라이언트 버튼을 눌러 직접 연결을 끊고, 시스템 VPN 항목을 다른 앱이 계속 사용 중인지 확인하세요. 기기에서 VPN이 아닌 트래픽을 차단하도록 설정했다면 클라이언트를 종료한 뒤에도 접속되지 않는 것은 해당 시스템 설정이 작동하고 있기 때문일 수 있습니다. 이 제한의 목적을 먼저 이해한 뒤 변경 권한이 있는 사람이 조정 여부를 결정해야 합니다. 모든 문제의 해결책으로 이 제한을 끄지 마세요.
연결 확인: 단계별 테스트와 설정 되돌리기
로컬 진입점부터 테스트한 뒤 활성 설정 확인
연결을 확인할 때는 세 가지를 살펴보세요. 앱이 요청을 클라이언트로 보냈는지, 클라이언트가 예상한 설정을 선택했는지, 대상에서 정상적인 응답을 받았는지입니다. 데스크톱에서는 먼저 기본 창에 표시된 활성 설정을 확인한 다음 로그에서 로컬 진입점이 실행 중인지 살펴보세요. 로컬 포트에 연결하지 못했다면 대개 원격 서버에 도달하기 전의 문제입니다. 로컬 진입점이 요청을 받았지만 원격 핸드셰이크 오류가 나타난다면 활성 노드 설정, 기기 시간, 현재 네트워크, 설정 제공자의 안내를 다시 확인하세요. Android에서는 이 단계만을 위해 LAN 수신을 켤 필요가 없습니다. 앱의 접속 시점과 클라이언트 로그를 비교하면 됩니다.
비교 테스트를 할 때는 같은 앱에서 같은 웹페이지를 먼저 열고, 두 번째 페이지를 바꿔 열어 특정 사이트만의 문제인지 확인하세요. 두 번째 앱을 테스트할 때는 노드와 라우팅을 그대로 유지해야 합니다. 캐시에서 표시되는 이미 로드된 페이지를 확인하는 대신 새 창을 열거나 페이지를 새로고침해 새 연결을 만드세요. 클라이언트 로그에서 요청을 확인할 수 있다면 작업 시각, 대상 도메인, 일치한 아웃바운드를 비교하세요. 로그 필터 수준에 따라 연결 세부 정보가 숨겨질 수 있으므로 로그가 보이지 않는다고 해서 트래픽이 전달되지 않았다고 단정할 수는 없습니다. 로그, 클라이언트 상태, 실제 접속 결과를 함께 확인하세요.
도메인 조회, 라우팅, 프록시 적용 범위를 나눠 확인
도메인 조회는 ‘이 이름이 어떤 주소를 가리키는지’를 확인하고, 라우팅은 ‘이번 요청이 어느 출구로 나가는지’를 정합니다. 도메인 조회에 성공해도 라우팅 규칙이 올바르게 적용된다는 보장은 없습니다. 반대로 규칙에 도메인이 있다고 해서 앱이 실제로 도메인 이름을 코어에 전달하는 것도 아닙니다. 앱에서 먼저 조회한 뒤 IP 주소만 전달할 수 있고, 브라우저가 자체 암호화 DNS를 사용할 수도 있습니다. 같은 도메인이 특정 앱에서만 문제를 일으킨다면 먼저 앱 자체의 DNS 설정을 확인하세요. 기기 전체에서 이름 조회가 실패한다면 시스템, 클라이언트, 현재 네트워크 각각의 DNS 설정을 비교해 문제가 시작되는 지점을 찾으세요.
아래는 라우팅 정책 필드를 확인하기 위한 코어의 최소 JSON 예시입니다. IPIfNonMatch는 도메인 이름이 포함된 대상에 대해 기존 규칙으로 먼저 일치 여부를 확인하고, 일치하는 규칙이 없으면 IP 주소로 조회해 IP 규칙을 계속 적용한다는 뜻입니다. 이 설정은 직접 연결 또는 프록시 출구를 자동으로 정의하지 않으며 앱의 DNS 요청을 다시 작성하지도 않습니다. 사용자 지정 설정에 이미 routing 객체가 있다면 코어의 지원 여부를 확인한 뒤 기존 규칙을 보존하면서 필드를 병합하세요. 이 예시로 파일 전체를 덮어쓰지 마세요. 그래픽 인터페이스를 사용한다면 v2rayN의 ‘설정 → 라우팅 설정’에서 해당 정책을 확인할 수 있습니다.
{
"routing": {
"domainStrategy": "IPIfNonMatch"
}
}
정책 필드는 올바르지만 규칙에서 참조하는 도메인이나 주소 데이터가 오래되었다면 조회 정책을 바꿔도 예상한 결과가 나오지 않을 수 있습니다. 먼저 어떤 규칙이 일치했는지 확인한 다음 라우팅 규칙 파일 업데이트 안내를 참고하세요. DNS 요청이 예상과 다른 출구로 나가는 것이 의심된다면 DNS 조회 확인 및 설정을 살펴보세요. 단일 검사 사이트의 한 줄 결과만으로 모든 것을 판단하지 말고, 되돌릴 기록도 없이 규칙 데이터와 DNS 주소, 라우팅 모드를 한꺼번에 바꾸지 마세요.
설정을 켠 순서의 반대로 되돌리기
테스트를 끝낼 때는 가장 마지막에 켠 트래픽 처리 방식을 먼저 끄고, 앱에 임시로 입력한 프록시 진입점을 해제한 뒤 클라이언트를 종료하세요. TUN을 사용했다면 가상 인터페이스와 경로가 정리될 때까지 기다린 다음 네트워크를 전환하세요. 시스템 프록시를 사용했다면 시스템 설정에 루프백 주소가 남아 있지 않은지 확인하고 원래 업무용 설정이 있었다면 복원하세요. 종료 후에도 접속되지 않는다면 구독을 반복해서 초기화하지 말고 먼저 기본 연결을 복구하세요. 기기가 네트워크에 연결되어 있는지, 인증 페이지 로그인이 필요한지 확인한 뒤 프록시와 VPN 상태를 살펴보고 원래 직접 접속되던 대상으로 마지막 테스트를 진행하세요.
되돌린 뒤에도 확인이 필요합니다. 프록시를 끈 상태에서는 테스트 전과 같은 방식으로 동작해야 하며, 모든 대상에 같은 방식으로 접속할 수 있어야 하는 것은 아닙니다. 기존 사용자 지정 DNS, 회사 자동 프록시 스크립트, 앱별 규칙이 있었다면 이번에 변경한 부분만 복구하고 관계없는 설정까지 삭제하지 마세요. 테스트마다 ‘시스템 프록시만 켬, 브라우저 성공, 앱은 변화 없음’처럼 한 줄로 기록하면 다음 테스트를 비교하기 쉽습니다. 문제가 생겼을 때는 재설치보다 마지막으로 정상 작동했던 기록이 어떤 설정으로 인해 달라졌는지 파악하는 데 더 도움이 됩니다.
설정 관련 자주 묻는 질문: 증상별 문제 해결
구독을 저장했는데 목록이 비어 있는 이유는 무엇인가요?
먼저 로그에서 업데이트 요청이 실제로 전송되었는지 확인하세요. 요청이 없다면 저장만 완료한 것은 아닌지, 그룹이 활성화되어 있는지, 현재 그룹과 전체 그룹 중 무엇을 업데이트했는지 살펴보세요. 요청은 보냈지만 시간 초과가 발생했다면 기기의 기본 네트워크가 정상인지 확인하고, 구독 주소에 접속할 수 없는 문제와 설정에 들어 있는 원격 서버에 접속할 수 없는 문제를 구분하세요. 두 주소가 같은 서버일 필요는 없습니다. 응답은 받았지만 목록이 비어 있다면 링크가 만료되었거나 로그인 페이지를 반환했거나 형식이 잘못되었거나 클라이언트가 인식하지 못하는 설정을 필터링했을 수 있습니다. 빈 목록을 모든 노드의 접속 장애로 단정하지 말고 구독 출처와 서비스 안내를 확인하세요.
업데이트 경로에 작동하는 프록시가 필요하다는 것을 알고 있다면 기존의 작동하는 설정을 유지하고 실제 연결을 확인한 뒤 ‘전체 구독 업데이트(프록시 사용)’와 같은 항목을 선택할 수 있습니다. 사용할 설정이 없는데 업데이트해야 연결할 수 있고 연결해야 업데이트할 수 있다는 순환에 빠지지 마세요. 시간 초과, 인증서 오류, 빈 목록을 각각 확인하는 방법은 구독 업데이트 실패 문제 해결을 참고하세요. 인증서 오류가 발생하면 시스템 시간과 서버 인증서 안내를 먼저 확인하세요. 인증서 오류 무시는 일반적인 설정으로 사용하지 마세요.
브라우저는 되는데 다른 앱은 왜 달라지지 않나요?
가장 흔한 이유는 브라우저가 시스템 프록시를 사용하지만 다른 앱은 별도의 네트워크 스택이나 자체 프록시 설정을 이용하기 때문입니다. 해당 앱의 네트워크 또는 연결 설정에서 ‘시스템 프록시 사용’, ‘수동 프록시’와 같은 항목을 확인하세요. 수동 설정이 가능하다면 클라이언트의 실제 리스너 프로토콜과 포트로 테스트하세요. 실제로 TUN이 필요한 경우에는 원래 시스템 프록시 상태를 기록하고 이번에 설정한 값을 지운 뒤 TUN만 켜세요. Android에서는 시스템 VPN 상태와 앱별 포함·제외 목록을 확인하세요. 한 기기의 앱 문제를 해결하려고 데스크톱의 로컬 네트워크 수신을 다른 기기에 개방하지 마세요.
앱이 첫 화면은 열지만 로그인이나 동기화에 실패하더라도 적용 범위 문제가 아닐 수 있습니다. 로그인과 동기화는 서로 다른 도메인에 접속하는 경우가 많고 기존 연결을 재사용할 수도 있습니다. 앱을 종료한 뒤 다시 열고 재현 가능한 작업을 한 번 실행한 다음 해당 시간대의 연결 및 라우팅 일치 로그를 확인하세요. 동일한 설정을 사용하는 다른 요청은 정상인데 서비스 하나만 문제가 있다면 현재 작동하는 설정을 유지하고 해당 서비스의 연결 요구 사항, DNS 결과, 접속 제한을 먼저 확인하세요.
TUN을 켠 뒤 사내망이나 일부 웹사이트에 접속할 수 없는 이유는 무엇인가요?
먼저 Tun을 끄고 같은 대상이 기존 모드에서 접속되는지 확인하세요. 스위치를 켜고 끌 때마다 문제가 재현된다면 클라이언트 라우팅 정책이 로컬 주소와 내부 도메인을 포함하는지 확인한 다음 내부 이름 조회가 현재 네트워크의 DNS에 의존하는지 살펴보세요. 게이트웨이 주소에는 접속되지만 내부 이름으로는 접속되지 않는다면 DNS 조회가 주요 원인일 수 있으므로 모든 분기 규칙을 바로 삭제하지 마세요. 주소와 이름 모두 접속되지 않으면 라우팅을 변경하는 다른 도구가 함께 실행 중인지, 비활성화 후 실제로 복구되었는지 확인하세요. 회사 관리 정책이 적용되는 경우 네트워크 대역과 클라이언트 호환 범위를 관리자에게 문의하세요.
클라이언트를 종료한 뒤 인터넷이 안 됩니다. 다시 설치해야 하나요?
먼저 재설치할 필요는 없습니다. 시스템이나 앱의 프록시 진입점이 여전히 로컬 포트를 가리키는지 확인하세요. 클라이언트가 종료된 상태라면 해당 주소에 연결을 받을 프로그램이 없을 수 있습니다. 데스크톱에서는 클라이언트를 다시 열고 ‘시스템 프록시 지우기’를 실행한 뒤 정상적으로 종료하세요. 회사 프록시를 사용하던 기기라면 이전 설정을 복원해야 합니다. 특정 앱에서만 문제가 생기면 앱 자체의 수동 프록시 설정과 확장 프로그램을 확인하세요. Android 클라이언트를 중지한 경우 시스템 VPN 설정에서 VPN을 사용하지 않을 때 연결을 차단하는 옵션이 켜져 있는지 확인하고, 기기 관리자나 사용자가 기존 사용 정책에 따라 처리하세요.
도움을 요청하기 전에 어떤 정보를 기록해야 하나요?
운영체제 이름과 프로세서 아키텍처, 클라이언트 이름, 사용한 트래픽 처리 방식, 오류가 시작된 단계를 기록하세요. 로그는 문제 발생 전후에 필요한 몇 줄만 남기고 구독 링크, 계정 정보, 연결 인증 정보, 공개하면 안 되는 내부 주소는 삭제하는 것이 좋습니다. 클라이언트를 끈 상태에서 인터넷이 되는지, 특정 네트워크나 앱에서만 문제가 생기는지 적고 복구할 수 있는 방법도 덧붙이세요. 그러면 로그를 보는 사람이 설치, 구독, 진입점, 라우팅, 원격 서버 중 어디의 문제인지 구분하는 데 도움이 됩니다. 용어를 확인하려면 용어집을 참고하세요. 표준 절차를 다시 따라가고 싶다면 입문 가이드로 돌아가면 됩니다. 정상 작동을 확인한 설정까지 모두 처음부터 다시 구성하지 마세요.