V2Ray 설치 및 설정 가이드
빠른 시작에서는 첫 연결까지 따라 할 수 있습니다. 이 페이지는 운영체제별 참고 안내서입니다. 먼저 공통 준비 사항을 확인한 뒤 기기에 맞는 항목으로 이동하세요. 클라이언트를 이미 설치했다면 연결 확인 및 문제 해결 항목부터 살펴보면 됩니다.
공통 준비: 설치 파일, 구독, 트래픽 처리 방식
먼저 운영체제와 클라이언트를 확인하세요
데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. 설정 제공자가 V2Fly 코어를 명시적으로 요구하고 프로토콜, 전송 방식, 보안 계층이 모두 지원되는 것을 확인한 경우에만 v2flyNG를 고려하세요. 클라이언트는 설정을 저장하고 연결을 시작하며 실행 상태를 관리하는 인터페이스이고, 코어는 프록시 프로토콜과 라우팅을 처리합니다. 두 클라이언트가 같은 공유 형식을 읽을 수 있다고 해서 그 형식의 모든 옵션을 모두 실행할 수 있는 것은 아닙니다. 특히 Android 클라이언트를 데스크톱 클라이언트의 단순한 이식판으로 생각하지 마세요. 트래픽을 처리하는 방식과 대상 앱 범위가 다릅니다.
클라이언트 다운로드 페이지에서 현재 운영체제와 프로세서 아키텍처에 맞는 설치 파일을 선택하세요. 아키텍처는 시스템 정보나 기기에서 지원하는 앱 아키텍처를 확인하고, 출시 시기만으로 추측하지 마세요. 새 파일을 테스트하기 전에 기존 클라이언트와 설정을 백업해 두세요. 이전 클라이언트가 백그라운드에서 실행 중이면 창만 닫지 말고 테스트 전에 시스템 트레이나 상태 메뉴에서 완전히 종료하세요. 두 인스턴스가 같은 로컬 포트를 사용하거나 시스템 프록시 설정을 번갈아 변경할 수 있습니다.
| 운영체제 | 클라이언트 | 설치 파일 선택 기준 |
|---|---|---|
| Windows | v2rayN | 이 사이트에서는 x64 데스크톱 버전과 클래식 WPF 버전을 제공합니다 |
| macOS | v2rayN | Apple Silicon은 arm64, Intel은 x64 선택 |
| Linux | v2rayN | deb 또는 rpm을 선택한 뒤 x64 또는 arm64 확인 |
| Android | v2rayNG、v2flyNG | arm64 지원 여부를 확인한 뒤 해당 파일 선택. 아키텍처를 모르면 범용 패키지 확인 |
구독 주소, 개별 공유 링크, 백업 구분하기
구독 주소는 목록을 다시 가져올 수 있는 경로입니다. 보통 구독 그룹에 등록한 뒤 업데이트해야 합니다. 주소를 붙여넣고 저장하는 것만으로는 목록이 다운로드되지 않습니다. 개별 공유 링크나 QR 코드는 대개 설정 한 개만 가져오며 원래 구독처럼 자동 업데이트되지 않습니다. 클라이언트 백업에는 그룹, 라우팅, 로컬 옵션이 포함될 수 있으며, 주로 같은 종류의 클라이언트에서 복원할 때 사용합니다. 범용 교환 형식은 아닙니다. 기기를 옮길 때는 필요한 구독이나 개별 설정을 복사한 다음 각 기기에서 트래픽 처리 방식을 확인하세요. 한 플랫폼에서 내보낸 전체 백업을 다른 플랫폼에 그대로 덮어쓰지 마세요. 자세한 비교는 여러 기기 간 설정 동기화 방법을 참고하세요.
구독 주소에는 접근 인증 정보가 포함될 수 있습니다. 공개 문의 게시판, 온라인 디코딩 도구, 채팅 스크린샷에 주소를 올리지 마세요. 문제를 확인할 때는 실패 시각, 오류 유형, 응답 상태만 기록하면 됩니다. 로그를 공유하기 전에는 주소의 쿼리 매개변수, 계정 식별 정보, 서버 정보를 삭제하세요. 업데이트 결과가 로그인 페이지나 안내 페이지라면 대개 구독 제공자가 클라이언트에서 읽을 수 있는 설정을 반환하지 않은 것입니다. 가져오기 메뉴만 바꿔서는 해결되지 않습니다.
첫 설정에서는 연결 경로 하나만 확인하세요
가져온 뒤 정상 작동하는 것으로 확인된 설정 하나를 선택하고 기본 라우팅을 유지하세요. 먼저 로컬 프록시가 요청을 처리하는지 확인한 다음 트래픽 처리 범위를 넓히세요. 데스크톱의 시스템 프록시는 시스템 설정을 참조하는 앱에 프록시 경로를 제공합니다. TUN은 가상 인터페이스와 라우팅을 통해 선택한 범위의 트래픽을 처리합니다. Android 클라이언트는 시스템 VPN 인터페이스로 앱 트래픽을 가져오는 경우가 많으며, 권한 승인은 연결 과정의 일부입니다. 어떤 경로가 작동하는지 먼저 구분한 뒤 앱을 테스트하세요. 여러 트래픽 처리 방식을 동시에 켜면 요청은 성공하더라도 어느 계층이 작동했는지 파악하기 어렵습니다.
Windows: v2rayN 설치 및 시스템 프록시
다운로드, 설치, 첫 실행
Windows 다운로드 페이지에서 데스크톱 버전이나 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 크로스 플랫폼 UI 프레임워크를 사용하고, WPF 버전은 Windows 전용 인터페이스입니다. 창 배치와 설정 메뉴가 완전히 같지 않을 수 있으므로 하나를 골라 테스트하면 됩니다. 시스템 설정의 '시스템 → 정보'에서 시스템 종류와 프로세서 정보를 확인하세요. x64 파일이 모든 Windows 기기에 맞는 설치 파일은 아닙니다. 이미 WPF 버전을 사용 중이고 설정만 업데이트하려는 경우, 구독을 가져오기 위해 인터페이스 버전을 바꿀 필요는 없습니다.
설치 프로그램은 화면 안내에 따라 진행하세요. 프로그램 파일이 들어 있는 압축 파일을 받았다면 현재 사용자에게 읽기·쓰기 권한이 있는 고정 폴더에 모두 압축을 푼 뒤 실행하세요. 압축 파일 미리보기에서 바로 실행하거나 실행 파일 하나만 복사하지 마세요. 첫 실행에서 런타임이 없다는 안내가 명확히 표시되면 필요한 런타임 종류와 아키텍처를 확인하세요. 인터페이스가 열렸다는 것은 그래픽 프로그램이 실행되었다는 뜻일 뿐, 코어가 시작되었다는 의미는 아닙니다. 설정을 선택한 뒤 로그에 파일을 찾을 수 없다는 오류가 나오면 관련 파일과 폴더 구조가 온전한지 확인한 다음 현재 코어 유형을 점검하세요.
구독을 업데이트하고 사용할 설정 선택하기
메인 창의 '구독 그룹' 메뉴에서 '구독 그룹 설정'을 열고 그룹을 추가한 뒤 '별칭'과 '주소(url)(선택 사항)'를 입력하세요. 해당 그룹에서 업데이트가 허용되어 있는지도 확인하세요. 첫 확인에서는 '필터'를 비워 두세요. 목록이 다운로드됐어도 키워드 필터 때문에 결과가 모두 사라질 수 있습니다. 저장한 뒤 '구독 그룹'으로 돌아가 프록시를 사용하지 않고 현재 구독을 업데이트하는 항목을 선택하세요. 구독 제공자가 기존 연결을 실제로 요구한다면 해당 연결이 작동하는지 별도로 확인하세요. 아직 사용할 설정이 없는데 새 구독이 그 설정에 의존하지 않도록 주의하세요. 여러 제공자의 구독 필터링 방법은 구독 그룹과 서버 필터링을 참고하세요.
업데이트 후 목록에 새 그룹이 표시되는지 확인하세요. 이전 그룹이나 현재 검색 결과와 혼동하지 마세요. 서버 하나를 선택해 활성 서버로 지정하고, 클라이언트 로그에 설정 파싱 오류, 포트 충돌, 시작 실패가 있는지 확인하세요. 활성 항목을 바꾼 뒤에는 테스트 페이지를 다시 열거나 새 연결을 만드세요. 이미 연결된 세션은 서버를 바꿔도 전환되지 않을 수 있습니다. 서버 목록에 항목이 있다는 사실만으로는 가져오기 성공 이후 단계를 확인할 수 없습니다.
먼저 시스템 프록시를 테스트한 뒤 TUN 사용 여부를 결정하세요
시스템 프록시를 읽는 브라우저를 테스트할 때는 v2rayN의 '시스템 프록시' 메뉴에서 '시스템 프록시 자동 설정'을 선택하세요. '시스템 프록시 변경 안 함'은 클라이언트가 시스템 설정을 직접 바꾸지 않는다는 뜻이지, 기존 프록시를 끈다는 뜻은 아닙니다. v2rayN이 설정한 프록시를 해제하려면 '시스템 프록시 해제'를 사용한 뒤 Windows의 '네트워크 및 인터넷 → 프록시'에서 다시 확인하세요. 원래 수동 프록시나 스크립트를 사용하던 기기라면 해제 후 시스템이 자동으로 복원된다고 생각하지 말고 기존 기록을 바탕으로 설정을 복구하세요.
브라우저는 작동하지만 특정 데스크톱 앱이 직접 연결된다면 먼저 앱 자체에 프록시 설정이 있는지 확인하세요. 시스템 설정을 읽지 않는 프로그램까지 처리해야 할 때만 v2rayN의 'TUN 활성화'를 테스트하세요. 전환 전에 이번 테스트에서 설정한 시스템 프록시를 해제해 중복 처리를 줄이세요. TUN은 가상 인터페이스를 만들고 라우팅을 변경하므로 클라이언트나 시스템 안내에 따라 필요한 권한을 부여하세요. 테스트를 위해 모든 프로그램을 관리자 권한으로 계속 실행하지 마세요. 활성화한 뒤 로컬 네트워크 접근도 달라졌다면 먼저 TUN을 끄고 기존 경로를 복구한 다음 별도 라우팅이 필요한지 판단하세요.
트레이에 남은 프로세스, 포트 충돌, 종료 후 연결 끊김 해결
창을 닫은 뒤에도 포트가 사용 중이라고 표시되면 시스템 트레이에 이전 인스턴스가 남아 있는지, 같은 클라이언트를 다른 경로에서 실행했는지 확인하세요. 어떤 프로세스가 포트를 사용하는지 확인한 뒤 이전 인스턴스를 종료할지, 클라이언트에서 다른 포트를 사용할지 결정하세요. 포트를 바꾼 뒤 수동으로 설정한 브라우저, 개발 도구, 터미널도 함께 변경해야 합니다. 시스템 프록시는 새 포트가 적용된 뒤 다시 설정하세요. 종료 후 브라우저가 연결되지 않다가 시스템 프록시를 끄면 복구된다면 시스템이 더 이상 대기하지 않는 로컬 포트를 가리키고 있을 가능성이 큽니다. 특정 앱만 실패한다면 앱에 별도 프록시 주소가 저장되어 있는지도 확인하세요.
macOS: 칩에 맞는 설치 파일, 네트워크 서비스, 권한
디스크 이미지 열기 및 앱 실행
Apple 메뉴에서 '이 Mac에 관하여'를 여세요. Apple 칩 기기는 macOS 다운로드 페이지에서 arm64를, Intel 프로세서 기기는 x64를 선택하세요. 호환성 계층이 설치되어 있다고 해서 다른 아키텍처를 우선 설치해야 하는 것은 아닙니다. 데스크톱 프로그램이 열리더라도 함께 제공되는 코어 런타임에는 별도의 아키텍처 요구 사항이 있을 수 있습니다. 설치 파일을 바꾸기 전에 실행 중인 앱을 종료하세요. 이전 폴더와 새 폴더에서 v2rayN을 동시에 실행하지 마세요.
디스크 이미지를 열고 안내에 따라 앱을 '응용 프로그램' 폴더로 복사한 뒤 대상 폴더에서 실행하고, 마지막으로 이미지를 추출하세요. 이렇게 하면 실행 위치가 고정되어 현재 실행 중인 앱이 어느 버전인지 쉽게 확인할 수 있습니다. 시스템에 보안 안내가 표시되면 앱 출처와 칩 아키텍처를 먼저 확인하고, 정상적인 첫 실행 확인인지, 조직 정책에 의한 차단인지, 파일 실행 오류인지 구분하세요. 앱 하나를 실행하려고 시스템 전체 보안 기능을 끄지 마세요. 창이 비어 있거나 실행 직후 종료된다면 먼저 앱 자체가 실행되었는지 확인한 뒤 연결 설정을 점검하세요. 실행 문제를 구독 오류로 잘못 판단하지 않도록 주의하세요.
v2rayN에서 구독 등록 및 업데이트
메인 창에서 '구독 그룹 설정'을 열고 별칭을 추가한 뒤 '주소(url)(선택 사항)'에 제공자가 안내한 전체 주소를 입력하세요. 저장한 다음 구독을 업데이트하고 해당 그룹으로 전환해 결과를 확인하세요. 받은 내용이 개별 공유 링크라면 클립보드에서 공유 링크를 가져오는 메뉴를 사용하세요. 공유 텍스트를 구독 주소 칸에 입력하지 마세요. 붙여넣은 뒤 주소 오류가 발생하면 이해하기 어려운 쿼리 매개변수를 삭제하지 말고, 안내 문구나 줄바꿈, 따옴표까지 함께 복사했는지 먼저 확인하세요.
목록이 표시되면 활성 서버를 선택하고 로그에 뚜렷한 코어 시작 오류가 없는지 확인하세요. Windows에서 옮겨 온 경우 구독 주소는 재사용할 수 있지만 시스템 프록시 상태나 로컬 파일을 가리키는 경로까지 그대로 복사하지 마세요. 두 기기에서 같은 구독을 사용하더라도 활성 서버, 라우팅 그룹, 로컬 네트워크 접근 요구 사항은 다를 수 있습니다. 설정 하나가 작동하는지 먼저 확인한 뒤 추가 옵션을 하나씩 복원하면 차이가 구독 내용에서 비롯됐는지 로컬 설정 때문인지 파악하기 쉽습니다.
현재 네트워크 서비스의 프록시 상태 확인
먼저 v2rayN에서 '시스템 프록시 자동 설정'을 사용한 뒤 '시스템 설정 → 네트워크'로 이동하세요. 현재 연결된 네트워크 서비스를 선택하고 '세부사항 → 프록시'에서 활성 항목과 로컬 주소를 확인하세요. 프록시 설정은 네트워크 서비스별로 적용됩니다. Wi-Fi와 유선 연결을 오갈 때는 실제로 트래픽을 처리하는 서비스가 무엇인지 먼저 확인하세요. 브라우저가 접속된다고 터미널도 시스템 프록시를 사용한다는 뜻은 아닙니다. 일부 명령줄 프로그램은 자체 옵션이나 환경 변수만 참조합니다. 터미널과 브라우저의 결과가 다르다고 해서 브라우저 테스트를 곧바로 무효로 판단하지 마세요.
기기에서 원래 자동 프록시 구성 파일을 사용했다면 먼저 활성화 상태를 기록하세요. 테스트가 끝나면 이번에 변경한 설정을 해제하고 기존 상태로 복원하세요. 두 자동 구성을 장시간 함께 사용하지 마세요. 시스템 프록시를 변경하려면 클라이언트에서 권한 승인을 요구할 수 있습니다. 안내가 현재 작업에서 나온 것인지 확인하세요. 관리 대상 기기에서 변경이 허용되지 않는다면 기존 설정을 유지하고 앱 자체의 로컬 프록시 기능으로 테스트하세요. 로컬 프록시 테스트 성공은 클라이언트 경로가 작동한다는 뜻일 뿐, 시스템 수준 설정 권한이 있다는 뜻은 아닙니다.
TUN과 네트워크 전환을 별도로 확인하세요
시스템 프록시 설정을 읽지 않는 앱까지 처리해야 할 때만 현재 v2rayN 빌드와 선택한 코어가 TUN을 지원하는지 확인하고 필요한 권한을 부여하세요. 인터페이스 스위치가 켜진 것과 가상 인터페이스가 실제로 트래픽을 처리하는 것은 다릅니다. 클라이언트 로그와 새 연결을 함께 확인하세요. 활성화 후 사내 도메인이나 로컬 네트워크 서비스에 연결되지 않으면 먼저 TUN을 끄고 같은 네트워크에서 기존 경로가 작동하는지 확인하세요. 절전 모드에서 복귀하거나 다른 네트워크로 전환한 뒤 문제가 생겼다면 활성 네트워크 서비스와 클라이언트 상태부터 확인하세요. 전환 뒤에만 발생한 문제라면 같은 구독을 다시 가져올 필요는 없는 경우가 많습니다.
Linux: 배포판별 설치 파일, 데스크톱 프록시, 라우팅
패키지 관리 방식과 아키텍처에 맞게 선택
Linux 다운로드 페이지를 여세요. Debian, Ubuntu 등은 deb를, Fedora 등은 rpm을 사용합니다. 패키지 형식이 맞는 것은 첫 단계일 뿐입니다. 배포판에 패키지가 요구하는 종속성이 설치되어 있고 그래픽 세션을 사용할 수 있어야 합니다. 데스크톱 클라이언트는 그래픽 환경이 없는 곳에서 바로 실행하는 서비스가 아닙니다. 다른 형식의 패키지가 우연히 압축 해제된다고 해서 다른 패키지 관리 체계에 설치하지 마세요.
아래의 읽기 전용 명령 두 개로 시스템 아키텍처와 배포판 식별 정보를 확인하세요. 일반적인 출력값 x86_64는 다운로드 페이지의 x64에, aarch64는 arm64에 해당합니다. 컨테이너나 원격 터미널에서 명령을 실행한다면, 데스크톱 클라이언트를 설치할 시스템을 확인하고 있는지 먼저 살펴보세요.
uname -m
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
다운로드한 패키지는 배포판의 소프트웨어 설치 도구로 열 수 있습니다. 터미널을 사용할 경우 sudo apt install 또는 sudo dnf install 을 입력하고 다운로드한 파일의 절대 경로를 뒤에 붙이세요. 경로에 공백이 있으면 전체 경로를 따옴표로 감싸세요. 패키지 관리자가 종속성을 처리하도록 두고, 충돌이 발생하면 구체적인 패키지 이름을 확인하세요. 강제로 무시하지 마세요. 설치가 끝나면 앱 실행기에서 일반 사용자 권한으로 v2rayN을 여세요. 그래픽 프로그램 전체를 관리자 권한으로 실행하면 설정 소유자가 달라져 일반 사용자가 저장된 그룹이나 설정을 읽지 못할 수 있습니다.
구독 업데이트 및 로컬 수신 상태 확인
'구독 그룹 설정'에 별칭과 구독 주소를 등록하고 저장한 뒤 해당 그룹을 업데이트하세요. 업데이트 결과가 있는데 항목이 보이지 않는다면 메인 창의 검색어를 지우고 그룹 필터 조건을 확인하세요. 활성 서버를 선택한 뒤 코어가 정상적으로 시작됐는지 확인하세요. 로그에 시작 실패가 표시되면 종속성 누락, 파일 아키텍처 불일치, 포트 충돌 등 로컬 문제부터 해결해야 합니다. 이 단계에서 구독을 반복 업데이트해도 로컬 수신 대기가 시작되지는 않습니다.
ss -ltn으로 현재 TCP 대기 주소와 포트를 확인한 뒤 v2rayN 설정의 로컬 대기 값과 비교할 수 있습니다. 포트가 대기 중이라는 사실은 어떤 프로그램이 해당 포트를 사용한다는 뜻일 뿐, 그 프로그램이 v2rayN이라는 뜻도 원격 연결이 수립됐다는 뜻도 아닙니다. 클라이언트를 실행하지 않았는데도 같은 포트가 대기 중이라면 다른 프록시 프로그램이 있는지 확인하세요. 정체를 모르는 프로세스를 바로 종료하지 마세요. 같은 기기의 앱을 연결하기 위해 로컬 대기 주소를 모든 네트워크 인터페이스로 바꿀 필요도 없습니다.
데스크톱 시스템 프록시, 터미널 옵션, TUN을 각각 테스트하세요
먼저 v2rayN의 '시스템 프록시 자동 설정'을 사용하고 데스크톱 환경의 네트워크 프록시 페이지를 확인하세요. GNOME, KDE 등의 메뉴 위치와 지원 범위는 서로 다르며, 일부 앱은 자체 설정만 읽습니다. 터미널 창 하나에 프록시 환경 변수를 설정해도 데스크톱 앱에 적용되는 것은 아닙니다. 반대로 그래픽 설정을 바꿔도 이미 실행 중인 명령줄 프로그램이 변경 내용을 다시 읽는다고 보장할 수 없습니다. 차이가 있다면 같은 대상에 명시적 프록시와 데스크톱 앱을 각각 사용해 테스트하세요. 한 결과로 모든 프로그램을 판단하지 마세요.
TUN이 필요하다면 먼저 클라이언트 로그에서 선택한 코어가 해당 모드를 지원하는지 확인하세요. 시스템에 가상 네트워크 장치가 있고 필요한 라우팅 작업이 허용되어야 합니다. 아래 읽기 전용 점검은 '장치 경로가 없음'과 '장치는 있지만 앱에 권한이 없음'을 구분하는 데 도움이 됩니다. 정상 출력이 나와도 권한이 충족됐다는 뜻은 아닙니다. 컨테이너나 관리 대상 기기에서는 상위 환경의 제한이 적용될 수 있으므로 용도에 맞게 관리자가 권한을 부여해야 합니다. 장치 전체 권한을 완화하는 방법을 일반적인 해결책으로 사용하지 마세요.
ls -l /dev/net/tun
ip route show default
라우팅 변경으로 원격 관리 연결이 끊기지 않도록 주의하세요
원격 데스크톱이나 원격 터미널에서 TUN을 켜기 전에 로컬 콘솔 등 복구 수단이 있는지 확인하세요. 기본 경로가 바뀌지 않았더라도 정책 라우팅에 따라 트래픽 경로가 변경될 수 있습니다. 설치 성공 여부만 확인하려면 로컬 프록시를 명시적으로 사용해도 충분합니다. 전역 네트워크를 먼저 변경할 필요는 없습니다. TUN이 아닌 모드로 돌아온 뒤 데스크톱 프록시가 유효한 포트를 가리키는지 확인하고 계속 비교하세요. Wi-Fi 전환이나 절전 모드 복귀 후에만 문제가 생긴다면 패키지를 재설치하기 전에 트래픽 처리 상태부터 확인하세요.
Android: 설치 파일, 구독, VPN 트래픽 처리
클라이언트와 앱 아키텍처 선택
Android 다운로드 페이지에서 v2rayNG를 우선 선택하세요. V2Fly 코어가 꼭 필요하고 설정도 호환되는 경우에만 v2flyNG를 선택하세요. 두 앱 모두 arm64와 범용 버전을 제공합니다. 프로세서 이름에 '64비트'가 포함되어 있어도 시스템 환경에서 arm64 앱을 지원한다고 단정할 수 없습니다. 기기에서 지원하는 앱 아키텍처를 확인하세요. arm64 지원이 확인되면 해당 파일을 선택하고, 확실하지 않다면 범용 패키지를 확인하세요. 다만 범용 패키지로도 시스템 버전 요구 사항을 충족할 수는 없습니다.
다운로드 파일을 열면 시스템에서 현재 파일을 연 브라우저나 파일 관리자에 설치 권한을 요청할 수 있습니다. 이 권한은 설치 출처에 대한 것으로 연결 권한과는 다릅니다. 실제로 필요한 경우에만 일시적으로 허용하고 설치가 끝난 뒤 해제할 수 있습니다. 기존 앱과 충돌한다는 안내가 나와도 바로 삭제하지 마세요. 서명이 다른 동명의 앱을 덮어쓰려는 것인지, 기기에 업무 프로필로 설치된 앱이 있는지 먼저 확인하세요. 앱을 삭제하면 로컬 그룹과 라우팅 설정이 사라질 수 있으므로 신뢰할 수 있는 위치에 먼저 백업한 뒤 이전 여부를 결정하세요.
구독 추가 및 개별 설정 가져오기
v2rayNG에서 사이드 메뉴의 '구독 그룹 설정'을 열고 그룹을 추가한 뒤 별칭과 주소를 입력하세요. 저장하고 서버 목록으로 돌아와 오른쪽 위 메뉴에서 구독을 업데이트하세요. v2flyNG에서도 사이드 메뉴의 구독 설정과 목록의 업데이트 동작을 구분해야 합니다. 인터페이스에 따라 메뉴 이름이 조금 다를 수 있습니다. 공유 링크를 받았다면 메인 화면의 추가 메뉴에서 클립보드 가져오기를 사용하세요. QR 코드는 스캔 메뉴를 이용하고, 카메라 권한은 실제로 코드를 스캔할 때만 허용하세요.
업데이트 후 해당 그룹으로 전환해 항목이 있는지 확인하고 활성 서버를 선택하세요. 휴대전화에서 복사할 때 안내 문구까지 주소에 포함하기 쉽습니다. 업데이트에 실패하면 제공처에서 전체 주소를 다시 복사하고 앞뒤 공백을 제거하세요. 매개변수를 직접 잘라내거나 수정하지 마세요. 개별 공유 링크만 사용한다면 기기를 바꾸기 전에 해당 링크나 지원되는 백업을 따로 보관해야 합니다. 원래 구독에 포함되지 않은 항목은 구독 업데이트로 복구할 수 없습니다.
연결을 시작하고 앱 적용 범위 확인
메인 화면의 연결 버튼을 누르고 VPN 모드를 처음 사용할 때 시스템 연결 요청을 승인한 뒤 클라이언트 실행 상태와 시스템 VPN 표시를 확인하세요. 이 기능은 Android VPN 인터페이스로 기기 트래픽을 가져옵니다. 데스크톱의 '시스템 프록시 자동 설정' 메뉴를 그대로 따라 할 필요는 없습니다. 시스템에서 다른 VPN이 이미 활성화되어 있다면 업무 프로필, 관리 대상 연결, 상시 연결 VPN인지 먼저 확인하세요. 용도를 확인하기 전에는 기존 VPN을 교체하지 마세요. 시스템 아이콘이 표시된다는 것은 인터페이스가 만들어졌다는 뜻일 뿐입니다. 새 요청으로 실제 연결 경로를 확인하세요.
v2rayNG에서 '앱별 프록시'를 사용한다면 테스트 앱이 선택 범위에 포함되는지 확인하고, 목록이 포함 목록인지 제외 목록인지도 살펴보세요. 앱을 선택했다고 해서 항상 해당 앱의 트래픽이 처리되는 것은 아닙니다. 현재 목록 모드에 따라 달라집니다. 브라우저로 테스트하더라도 브라우저가 제외되어 있다면 모든 앱의 상태를 대표하지 않습니다. 범위를 바꾼 뒤 클라이언트 안내에 따라 다시 연결하고 대상 앱에서 새 요청을 보내세요. 기존에 열린 세션만 확인하지 마세요.
화면 잠금 후 연결 끊김, 네트워크 전환, 시스템 차단 구분하기
앱이 화면이 켜져 있을 때는 작동하지만 잠금 후 끊긴다면 시스템의 앱 배터리 관리, 백그라운드 제한, VPN 상태를 먼저 확인하세요. 문제가 발생한 앱만 조정하면 되며 기기 전체의 절전 설정을 끌 필요는 없습니다. Wi-Fi에서는 되지만 모바일 데이터에서 실패하면 모바일 데이터 권한과 클라이언트 로그를 확인한 뒤 같은 활성 서버로 비교하세요. VPN 연결을 끊은 뒤에도 기기 전체에서 인터넷이 되지 않으면 시스템 VPN 설정의 상시 연결 옵션과 VPN 없이 연결 차단 정책을 확인하세요. 관리 대상 기기의 설정은 관리자에게 확인해야 합니다. 이런 시스템 제한을 구독 오류와 혼동하지 마세요.
연결 확인: 요청이 실패한 단계를 구분하세요
먼저 클라이언트를 거치지 않는 비교 결과를 확보하세요
연결하기 전에 접근 권한이 있고 평소 안정적인 HTTPS 페이지를 하나 선택해 현재 네트워크에서 새 연결을 만들 수 있는지 기록하세요. 먼저 로그인이 필요한 네트워크라면 시스템 로그인 페이지에서 로그인한 뒤 클라이언트를 켜세요. 테스트할 때는 같은 네트워크, 주소, 앱을 유지하고 서버, 프로토콜, 프록시 모드를 동시에 바꾸지 마세요. 직접 연결도 실패한다면 기본 네트워크 문제부터 해결해야 합니다. 그렇지 않으면 이후 결과 차이가 클라이언트 때문인지 테스트 대상에 원래 접근할 수 없는 것인지 판단하기 어렵습니다.
그다음 활성 서버를 선택하고 로그를 살펴본 뒤 로컬 대기 포트나 Android VPN 상태를 확인하세요. 결과는 세 단계로 나눠 보세요. 클라이언트가 설정을 가져왔는지, 코어가 작동을 시작했는지, 요청이 의도한 경로로 전달됐는지 확인합니다. 목록에 항목이 있다는 것은 첫 번째 단계에 해당합니다. 녹색 스위치나 시스템 아이콘은 주로 두 번째 단계를 나타냅니다. 세 번째 단계는 새 연결과 관련 로그로 확인해야 합니다. 브라우저가 이전 연결을 재사용하거나 캐시를 사용할 수 있으므로 이미 열려 있는 탭이 표시되는지만 보지 마세요.
데스크톱에서 명시적 프록시로 재현 가능한 테스트 실행
아래 명령은 curl이 설치되어 있고 클라이언트가 로컬 주소의 10808 포트에서 실제로 SOCKS 서비스를 제공하는 데스크톱 기기에서 사용할 수 있습니다. 먼저 v2rayN 설정이나 로그에서 프로토콜, 주소, 포트를 확인하세요. 대기 값이 다르면 명령의 값을 실제 설정에 맞게 바꾸세요. Windows에서는 curl.exe를 명시적으로 사용해 일부 명령 환경에서 짧은 이름이 다른 도구로 해석되는 일을 피할 수 있습니다. 예시는 공개된 테스트 사이트로 요청을 보내며 계정 정보를 포함하지 않고 시스템 프록시도 켤 필요가 없습니다.
curl --max-time 15 --socks5-hostname 127.0.0.1:10808 --head https://example.com/
--socks5-hostname은 curl이 먼저 로컬에서 도메인을 해석한 뒤 요청을 보내는 방식과 달리 대상 도메인 처리를 SOCKS 서비스에 맡깁니다. 명시적 프록시 경로를 확인하는 데 사용할 수 있지만 브라우저의 DNS 처리 경로나 모든 앱의 트래픽이 처리되는지까지 알 수는 없습니다. 로컬 포트에 연결할 수 없다는 오류가 나오면 대기 주소와 프로토콜을 먼저 확인하세요. 로컬 포트에 연결된 뒤 시간 초과가 발생하면 해당 요청 전후의 로그에서 아웃바운드, 도메인 해석, 원격 핸드셰이크를 확인하세요. HTTP 응답을 받았다는 것은 이번 요청에 어떤 응답 가능한 서비스가 응답했다는 뜻입니다. 일부 상태 코드는 대상이 요청을 거부했다는 의미일 수 있으므로 모두 네트워크 실패로 처리하지 마세요.
트래픽 진입 경로, 라우팅, 도메인 해석을 따로 확인하세요
명시적 프록시 테스트는 성공하지만 브라우저가 연결되지 않는다면 브라우저가 시스템 프록시를 읽는지, 별도 설정이 이를 덮어쓰는지 먼저 확인하세요. TUN에서만 실패한다면 TUN 시작 로그와 영향을 받는 앱을 확인하고 로컬 네트워크 및 네트워크 전환 상황과 비교하세요. 도메인별 라우팅이 예상과 다르면 요청이 클라이언트에서 처리되고 있는지부터 확인한 다음 도메인 규칙과 규칙 순서를 살펴보세요. 트래픽이 진입 경로에서 처리되지 않는다면 라우팅 규칙을 수십 개 바꿔도 요청에는 영향을 주지 않습니다.
같은 도메인이 여러 IP 주소로 해석될 수 있으며 도메인 규칙과 IP 규칙은 서로 다른 계층입니다. 앱이 먼저 도메인을 해석해 IP를 클라이언트로 전달하면 원하는 도메인 규칙과 일치하지 않을 수 있습니다. IP 주소를 직접 입력했을 때 HTTPS 인증서나 가상 호스트 설정 때문에 실패할 수도 있으므로 이를 DNS 문제의 반증으로 단정하지 마세요. 로그에서 규칙이나 아웃바운드 정보를 확인할 수 있다면 실제로 적용된 결과를 우선하세요. 규칙 데이터베이스 확인이 필요하면 GeoIP 및 GeoSite 규칙 데이터베이스 업데이트 방법을 참고하세요. 한 번의 비교에서 데이터베이스와 라우팅 순서를 동시에 바꾸지 마세요.
자주 발생하는 설정 문제: 증상별 다음 점검 항목
구독 업데이트 실패 또는 업데이트 후 목록이 비어 있음
업데이트 요청이 실패했다면 먼저 어떤 그룹을 테스트했는지, 이번 요청이 기존 프록시를 통과하도록 설정되었는지 확인하세요. 첫 구독을 가져올 때 자주 발생하는 실수는 아직 연결되지 않는 프록시를 통해 새 설정을 가져오려는 것입니다. 업데이트 결과를 요청 전송 여부, 제공자의 응답 여부, 응답 내용을 클라이언트가 읽을 수 있는지로 나누어 확인하세요. 시간 초과라면 네트워크 경로를 확인하세요. 접근이 명확히 거부되었다면 제공자에게 권한과 접속 경로를 확인하세요. 응답을 읽을 수 없다면 호환되는 구독인지, 로그인 페이지인지, 다른 종류의 설정 파일인지 확인하세요. 불필요한 제3자 서비스에 구독 원문을 붙여넣어 확인하지 마세요.
성공 안내가 떴는데 항목이 보이지 않으면 해당 그룹으로 전환하고 검색어를 지운 뒤 그룹 키워드 필터를 잠시 해제하고 다시 업데이트하세요. 다른 그룹에 항목이 남아 있다면 모든 설정을 지울 필요는 없습니다. 삭제하고 다시 만들기 전에 로컬에서 수정한 항목이 있는지, 업데이트할 때 클라이언트가 기존 항목을 덮어쓰는지 확인하세요. 공유 링크 하나만 호환되지 않는다면 그 항목만 따로 테스트하세요. 모든 출처를 한 그룹에 섞지 마세요. 인터페이스 관련 추가 답변은 FAQ를 참고하세요.
목록은 있지만 활성 설정을 시작하면 오류가 발생함
활성 서버가 선택되어 있는지 확인한 다음 실질적인 내용이 담긴 첫 오류 메시지를 살펴보세요. 주소, 프로토콜, 전송 방식, 보안 계층이 서로 일치해야 합니다. 예를 들어 가져온 뒤 서버 주소는 표시되지만 전송 매개변수가 올바르게 인식되지 않으면 목록은 정상처럼 보여도 시작이나 핸드셰이크 단계에서 실패할 수 있습니다. 지원하지 않는 설정 필드나 프로토콜이 오류에 표시되면 실제로 사용하는 코어를 확인한 뒤 설정 제공자에게 호환되는 형식을 요청하세요. 핸드셰이크 문제를 확인할 때 TLS 검증을 끄는 것을 일반적인 해결책으로 사용하지 마세요. 먼저 시스템 시간, 연결 주소, 서버 이름 등 일치해야 하는 매개변수를 확인하세요.
포트 사용 중, 파일 경로 없음, 권한 부족, 아키텍처 오류가 발생하면 로컬 환경부터 해결하세요. 이런 문제는 서버에 연결하기 전에 발생하므로 목록에서 서버를 계속 바꿔도 도움이 되지 않습니다. 로컬 코어는 시작되지만 특정 설정 하나에서만 핸드셰이크가 반복해서 실패한다면 같은 네트워크에서 정상 작동이 확인된 다른 설정과 비교하세요. 둘 다 실패한다면 공통 연결 경로와 라우팅을 다시 확인하고 모든 증상을 단일 설정 문제로 돌리지 마세요.
브라우저는 되지만 다른 앱은 연결되지 않거나 종료 후 인터넷이 끊김
앱마다 사용하는 연결 경로가 다를 수 있습니다. 데스크톱에서는 앱별 프록시, 시스템 프록시, 터미널 환경 변수를 먼저 확인하세요. Android에서는 앱별 처리 범위와 시스템 VPN 상태를 확인하세요. 일부 앱은 프록시 환경에서 실행되지 않으며, 특정 사내 네트워크에 접근해야 하는 앱도 있습니다. 트래픽 처리 범위를 무조건 넓히는 것이 항상 적절한 해결책은 아닙니다. 클라이언트를 종료한 뒤 데스크톱 브라우저만 연결되지 않는다면 시스템이나 브라우저가 여전히 로컬 프록시를 가리키는지 확인하세요. Android에서 연결을 끊은 뒤 모든 앱이 영향을 받는다면 VPN이 없을 때의 연결을 차단하는 시스템 설정을 확인하세요.
복구할 때는 변경한 순서의 역순으로 처리하세요. 이번에 켠 TUN을 비활성화하거나 VPN 연결을 끊고, 이번에 변경한 시스템 프록시와 앱별 설정을 확인한 다음 기본 네트워크를 다시 테스트하세요. 조직에서 배포한 프록시나 VPN 정책을 지우지 말고 재설치를 첫 번째 방법으로 선택하지 마세요. 재설치로 프로그램 파일은 교체할 수 있지만 시스템 프록시, 기존 설정 폴더, 기기 관리 정책까지 제거되지는 않을 수 있습니다. 설치 파일 손상, 아키텍처 오류, 업데이트 충돌이 확인된 경우에만 재설치를 해결책으로 고려하세요.
'연결 안 됨'에 그치지 말고 확인 결과를 기록하세요
운영체제와 아키텍처, 클라이언트 이름, 트래픽 처리 방식, 활성 항목 선택 여부, 실패 단계가 업데이트·시작·새 연결 중 어디인지 기록하세요. 같은 네트워크에서 명시적 프록시는 되지만 시스템 프록시는 실패하는 경우, 또는 네트워크를 바꾼 뒤에만 실패하는 경우처럼 비교 결과도 함께 남기면 유용합니다. 로그에는 재현 시각 주변의 필요한 부분만 남기고 구독 주소와 계정 정보는 삭제하세요. 처음부터 다시 설정해야 한다면 빠른 시작으로 돌아가 가져오기, 선택, 트래픽 처리, 확인 순서만 먼저 진행하세요. 연결을 확인한 다음 이 페이지의 해당 플랫폼 항목을 참고해 추가 설정을 복원하세요.