V2Ray 플랫폼별 설치 및 설정

시스템 및 연결 정보 준비

운영체제, 아키텍처, 클라이언트 역할 확인

운영체제, 프로세서 아키텍처, 현재 계정의 권한을 확인한 뒤 설치 파일을 다운로드하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG 또는 v2flyNG를 사용합니다. 클라이언트는 서버 목록 표시, 구독 저장, 설정 생성, 프록시 연결 지점 관리를 담당하고, 코어는 프로토콜 연결과 트래픽 전달을 담당합니다. 클라이언트를 설치해도 사용할 수 있는 서버가 자동으로 제공되는 것은 아닙니다. 서버 정보는 별도로 준비해야 합니다. 다른 운영체제의 프로그램 폴더를 그대로 복사해서도 안 됩니다. 인터페이스 파일, 코어 실행 파일, 권한 부여 방식이 다를 수 있습니다.

기기 외관으로 판단하지 말고 시스템 정보에서 프로세서 아키텍처를 확인하세요. Apple 칩을 탑재한 Mac은 Apple Silicon, Intel Mac은 Intel을 선택합니다. Windows의 이 페이지 다운로드 항목은 x64용입니다. Linux는 아키텍처와 패키지 형식을 모두 확인하세요. Android 기기는 대부분 arm64를 사용하지만, 구형 기기는 지원 아키텍처를 확인해야 합니다. 비트 수나 아키텍처가 맞지 않아 설치되지 않는다면 패키지 선택 문제입니다. 네트워크, 구독, 서버 설정부터 변경하지 마세요.

구독 및 서버 정보 준비

서비스 제공업체에서 받은 구독 주소 또는 서버 공유 링크 전체를 준비하세요. 구독 주소는 서버 목록을 가져오는 데 쓰이며 일반 웹페이지 주소나 계정 로그인 페이지와는 다릅니다. 수동으로 설정하려면 서버 주소, 포트, 프로토콜, 인증 정보, 전송 매개변수가 필요합니다. 암호화된 전송을 사용하는 경우 서버 이름, 경로, 공개 키 또는 핑거프린트 등의 항목이 추가로 필요할 수 있습니다. 항목이 빠져 있다면 원래 안내를 다시 확인하세요. 비슷한 이름의 항목으로 대체하거나 코어를 바꿔 가며 값을 추측하지 마세요.

구독 주소는 접속 정보이므로 안전하게 관리하세요. 복사할 때 앞뒤 공백, 줄바꿈, 메신저에서 붙은 문장 부호나 설명이 포함되지 않도록 주의하세요. 전체 주소를 공개 게시판에 올리거나 주소 표시줄이 보이는 스크린샷을 업로드하지 마세요. 기기를 옮기기 전에 설정을 백업하고, ‘클라이언트 설정 백업’과 ‘서버 공유 링크’를 구분하세요. 전자에는 그룹, 라우팅, 인터페이스 설정이 포함될 수 있지만 후자는 단일 연결 정보만 담는 경우가 많습니다. 문제 로그를 공유하기 전에도 서버 도메인, 계정 식별 정보, 구독 매개변수를 확인하세요.

복구 가능한 초기 설정 구성

설치 전에 프록시를 사용하지 않는 상태에서 평소 이용하는 웹사이트에 접속할 수 있는지 확인하고, 현재 네트워크 인터페이스의 프록시 상태를 기록하세요. 시스템 프록시나 가상 네트워크 어댑터를 변경하는 다른 프로그램은 잠시 종료하되 삭제할 필요는 없습니다. 회사나 학교 기기에서는 관리 정책이 네트워크 설정을 제어할 수 있습니다. 변경할 수 없는 항목이 있다면 관리 권한을 확인하세요. 제한된 상태를 모두 클라이언트 문제로 단정해서는 안 됩니다. 시스템 날짜, 시간, 시간대도 정확히 맞추세요. 인증서 검증과 일부 프로토콜 인증에는 정확한 시간이 필요합니다.

처음 확인할 때는 클라이언트 하나, 서버 하나, 트래픽 처리 방식 하나만 사용하세요. 먼저 시스템 프록시로 브라우저를 확인한 뒤 TUN을 검토하세요. 한 번에 하나씩 변경하고 변경 전후의 증상을 기록하세요. 포트, 라우팅, DNS를 동시에 바꾸면 원인을 찾기 어렵습니다. 테스트를 마치면 프록시 설정을 복원해 종료된 프로그램의 로컬 포트가 남지 않도록 하세요. 이후 설치에 실패한다면 오류 전문과 작업 경로를 기록하세요. 단순히 ‘작동하지 않음’이라고 적는 것보다 다운로드, 권한, 연결 문제를 구분하기 쉽습니다.

Windows용 v2rayN 설치

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

Windows 다운로드로 이동해 먼저 시스템 아키텍처를 확인한 다음 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 최신 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 Windows 인터페이스를 제공합니다. 두 버전 모두 프록시 연결을 관리합니다. 인터페이스 차이를 서버 품질 차이로 해석하지 마세요. 처음에는 한 버전을 선택해 설정을 마치고, 인터페이스 호환성 문제가 있을 때만 다른 버전으로 바꾸세요. 두 버전을 동시에 실행하면 로컬 포트를 서로 점유할 수 있고, 시스템 프록시를 마지막으로 변경한 프로그램을 파악하기 어려워집니다.

설치 프로그램을 실행하고 안내에 따라 쓰기 가능한 위치를 선택하세요. 시스템에서 출처나 권한 확인 메시지가 표시되면 파일 출처와 게시자 정보를 확인한 뒤 계속할지 결정하세요. 시스템 보안 기능을 전부 끄지 마세요. 실행에 필요한 환경이 없다는 메시지가 분명히 표시되면 해당 설치 파일에서 요구하는 실행 환경을 갖추세요. 프로그램 자체가 열리지 않으면 설치와 실행 환경을 먼저 확인하고, 프로그램은 열리지만 코어가 시작되지 않으면 로그를 살펴보세요. 두 문제는 같은 네트워크 설정으로 해결할 수 없습니다.

구독을 가져오고 서버 선택

메인 창에서 ‘구독 그룹’을 열고 ‘구독 그룹 설정’으로 이동해 그룹을 추가하세요. 메모와 주소를 입력한 뒤 저장합니다. 처음에는 필터 키워드를 비워 서버가 모두 제외되지 않도록 하세요. 메인 화면으로 돌아가 ‘구독 업데이트(프록시 사용 안 함)’를 실행합니다. 구독 서비스가 프록시 연결을 요구하고 이미 사용 가능한 연결이 있을 때만 ‘구독 업데이트(프록시 사용)’를 실행하세요. 프록시 업데이트에는 기존 연결 경로가 필요합니다. 아직 가져오지 못한 서버에 의존해 연결 경로를 만들 수는 없습니다.

업데이트 후 그룹에 서버가 표시되는지 확인하고 원하는 항목을 활성 서버로 지정하세요. 메뉴 위치는 인터페이스 버전에 따라 다를 수 있으므로 실제 화면에 표시되는 ‘활성 서버로 지정’ 작업을 사용하세요. 테스트 결과는 당시의 탐지 조건만 보여 줄 뿐, 웹페이지·동영상·다운로드가 모두 가능하다는 뜻은 아닙니다. 먼저 자주 사용하는 암호화 웹사이트를 열고 클라이언트 로그에 관련 연결이 표시되는지 확인하세요. 인증 실패라면 원래 서버 정보를 확인하고, 시간 초과라면 서버 연결 불가, 로컬 방화벽, 라우팅 선택 문제를 구분하세요.

시스템 프록시를 설정한 뒤 TUN 검토

트레이 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하면 Windows 시스템 프록시를 따르는 앱이 클라이언트의 로컬 연결 지점을 사용합니다. ‘시스템 프록시 지우기’를 선택하면 해당 연결 지점을 해제합니다. ‘시스템 프록시 변경 안 함’은 기존 상태를 유지할 뿐, 이전 주소를 정리하지 않습니다. 변경 후 ‘설정 → 네트워크 및 인터넷 → 프록시’에서 이미 종료된 프로그램을 가리키고 있지 않은지 확인하세요. 브라우저 확장 프로그램, 앱 자체 프록시, 조직의 관리 정책이 시스템 설정을 덮어쓸 수 있으므로 각각 확인해야 합니다.

시스템 프록시를 읽지 않는 앱까지 처리해야 할 때 TUN 모드를 켜세요. 클라이언트 안내에 따라 권한을 높이거나 관련 구성 요소를 설치하세요. 권한 창이 나타났다는 이유만으로 실패라고 판단하지 마세요. 켜기 전에 다른 가상 네트워크 트래픽 처리 도구를 종료하고 관리자 권한 요청의 오류 전문을 보관하세요. 켠 뒤 모든 네트워크가 끊기면 먼저 TUN을 끄고 시스템이 복구되는지 확인한 다음 가상 네트워크 어댑터, 라우팅, DNS를 살펴보세요. 문제가 있는 TUN을 켜 둔 채 브라우저 프록시를 계속 바꾸면 서로 다른 두 문제 경로가 겹칩니다.

포트 충돌 및 종료 후 남은 설정 처리

‘주소가 이미 사용 중’과 같은 시작 오류가 나타나면 먼저 중복 실행 중인 인스턴스를 종료하고 로컬 수신 포트를 확인하세요. 아래 명령은 프로세스 ID를 찾는 용도입니다. 포트 값은 클라이언트 설정의 실제 값으로 바꾸세요. 프로세스를 찾으면 작업 관리자에서 프로그램 이름을 확인하세요. 정체를 모르는 시스템 프로세스를 바로 종료하지 마세요. 클라이언트에서 사용되지 않는 다른 포트를 선택할 수도 있지만, 이전 포트에 의존하는 앱 설정도 함께 변경해야 합니다.

netstat -ano | findstr :10808

정상적으로 종료하기 전에 TUN을 끄고 이번에 설정한 시스템 프록시를 지우세요. 프로그램이 비정상 종료된 뒤 브라우저에서 인터넷을 사용할 수 없다면 클라이언트를 바로 재설치하지 말고 시스템 프록시가 루프백 주소를 가리키고 있는지 먼저 확인하세요. 업그레이드 전에 구독과 필요한 설정을 저장하세요. 업그레이드 후 이전 설정이 로드되는지 테스트한 뒤 사용자 지정 라우팅을 하나씩 복원합니다. 보안 소프트웨어가 차단했다면 구체적인 이벤트와 파일 경로를 확인하세요. 디스크 전체를 예외로 추가하거나 설치 폴더를 계속 옮겨 원인을 가리지 마세요.

macOS용 v2rayN 설치

칩에 맞는 설치 파일 선택

Apple 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’를 확인하세요. Apple 칩이면 Apple Silicon, Intel이면 Intel을 선택합니다. macOS 다운로드에서 해당 디스크 이미지를 받은 뒤 열고 설치 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮기세요. 복사가 끝나면 디스크 이미지를 추출하고 ‘응용 프로그램’에서 실행합니다. 디스크 이미지 안에서 계속 실행하면 앱 위치가 불안정해지고 이후 권한이 어느 앱 복사본에 적용되는지 혼동하기 쉽습니다.

처음 실행할 때 시스템 보안 기능이 차단하면 안내 내용을 먼저 확인하세요. 출처를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에서 해당 앱을 열 수 있는 옵션이 제공되는지 살펴보고 시스템 절차에 따라 승인하세요. 시스템에서 계속 진행해도 된다고 명확히 허용할 때만 실행하세요. 다른 파일의 보안 속성을 일괄 제거하지 마세요. ‘앱이 손상되었습니다’라는 메시지가 표시되어도 프록시 설정 문제라고 단정할 수 없습니다. 먼저 아키텍처에 맞는 설치 파일을 다시 받고, 복사가 완료되었는지와 시스템 호환 요구 사항을 확인하세요.

구독 추가 및 메뉴 막대 확인

v2rayN을 실행하고 메인 창에서 ‘구독 그룹 설정’을 열어 메모와 구독 주소를 추가하세요. 저장한 다음 ‘구독 업데이트(프록시 사용 안 함)’를 실행합니다. 서버가 목록에 표시되면 활성 서버로 지정하세요. 사용 가능한 연결이 있고 직접 업데이트가 실패한 경우에만 ‘구독 업데이트(프록시 사용)’를 시도하세요. Mac 메뉴 막대 아이콘으로 메인 창을 표시하거나 프록시 옵션을 전환할 수 있습니다. 아이콘이 보이는 것은 프로그램이 실행 중이라는 뜻일 뿐, 서버 인증이나 시스템 프록시 설정이 완료되었다는 뜻은 아닙니다.

메뉴 막대의 트레이 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. 네트워크 설정을 변경할 권한을 요청할 수 있습니다. 안내에 따라 해당 권한이 있는 Mac 계정 정보를 입력하세요. 구독 서비스 계정의 비밀번호를 입력하면 안 됩니다. 그런 다음 ‘시스템 설정 → 네트워크’에서 현재 사용하는 네트워크 서비스를 선택하고 ‘세부사항 → 프록시’에서 설정을 확인하세요. 무선 네트워크와 유선 네트워크는 서로 다른 서비스입니다. 연결 방식을 바꾼 뒤에는 현재 인터페이스의 프록시 상태를 다시 확인하세요.

시스템 프록시 권한과 TUN 권한 구분

시스템 프록시는 주로 시스템 설정을 참조하는 앱에 영향을 줍니다. 터미널 프로그램이나 독립 앱 하나가 프록시를 사용하지 않는다고 해서 브라우저의 시스템 프록시까지 작동하지 않는 것은 아닙니다. 먼저 해당 앱에 별도의 프록시 옵션이 있는지 확인한 다음 TUN 사용 여부를 결정하세요. TUN 모드를 켤 때 클라이언트가 네트워크 인터페이스를 만들거나 라우팅을 변경하기 위해 추가 관리자 권한을 요구할 수 있습니다. 시스템 프록시 권한을 승인했더라도 TUN에 필요한 권한까지 준비된 것은 아니므로 각각 확인해야 합니다.

요청을 승인하기 전에 요청한 앱이 방금 설치한 클라이언트인지 확인하고 필요한 절차를 따르세요. 관리자 암호가 맞는데도 실패한다면 현재 계정이 기기 관리 정책의 제한을 받는지, 다른 네트워크 소프트웨어가 트래픽을 처리 중인지 확인하세요. TUN을 끈 뒤 네트워크가 복구된다면 트래픽 처리 경로에 문제가 있는 것입니다. 이때 일반 시스템 프록시는 비교용으로 유지하고 서버 인증 항목은 동시에 변경하지 마세요. 업무용 네트워크 전용 연결이 이미 있다면 함께 사용하기 전에 라우팅 우선순위를 확인하세요.

잠자기에서 깨어난 뒤 네트워크 전환 문제 해결

Mac이 잠자기에서 깨어나거나 핫스팟을 바꾸고 무선 네트워크에 다시 연결한 뒤에는 기존 연결을 재설정해야 할 수 있습니다. 먼저 시스템 네트워크에 주소가 할당되었는지 확인하고 서버를 다시 선택하거나 클라이언트 연결 기능을 재시작하세요. 특정 앱만 실패하면 기존 연결을 계속 사용하지 않도록 앱을 완전히 종료한 뒤 다시 여세요. 모든 앱이 실패하면 TUN과 시스템 프록시를 끄고 직접 연결을 확인하세요. 트레이 아이콘이 그대로 보인다는 이유만으로 하위 네트워크가 복구되었는지 확인하는 절차를 건너뛰지 마세요.

클라이언트를 종료할 때는 먼저 TUN을 끄고 ‘시스템 프록시 지우기’를 선택한 다음 프로그램을 종료하세요. ‘시스템 프록시 변경 안 함’은 현재 상태를 유지할 뿐 남은 연결 지점을 자동으로 해제하지 않습니다. 비정상 종료 뒤 웹페이지가 열리지 않으면 현재 네트워크 서비스의 프록시 화면에서 루프백 주소와 포트를 확인하세요. 앱 복사본을 바꾸거나 업그레이드한 뒤 권한 요청이 다시 나타나면 실행 중인 경로를 확인하세요. ‘다운로드’ 폴더와 ‘응용 프로그램’ 폴더에 복사본이 각각 있으면 이전 복사본에 권한을 부여하고 새 복사본을 실행할 수 있습니다.

Linux용 v2rayN 설치

아키텍처 및 패키지 형식 확인

Linux 다운로드로 이동하기 전에 프로세서 아키텍처와 배포판의 패키지 체계를 확인하세요. x64와 arm64는 서로 다른 프로그램 파일을 사용합니다. deb와 rpm도 패키지 관리 방식이 다르므로 파일 이름에 Linux가 있다는 이유로 혼용하면 안 됩니다. Debian 계열 배포판에서는 deb를, RPM 패키지 체계를 사용하는 배포판에서는 rpm을 선택하세요. 확실하지 않다면 시스템 정보와 소프트웨어 관리자를 열어 배포판 이름을 확인하고 아래 명령으로 시스템 아키텍처를 확인하세요.

uname -m
cat /etc/os-release

출력에서 x86_64는 일반적으로 x64, aarch64는 일반적으로 arm64에 해당합니다. 다른 아키텍처에는 이 페이지의 설치 파일을 그대로 사용할 수 없습니다. 데스크톱 클라이언트에는 사용 가능한 그래픽 세션이 필요하므로 명령줄만 있는 서버 환경은 이 그래픽 설치 절차에 해당하지 않습니다. 원격 데스크톱, 경량 데스크톱, 컨테이너의 그래픽 환경에는 트레이나 권한 서비스가 없을 수도 있습니다. 패키지 관리자가 설치 파일을 받아들인다고 해서 데스크톱 통합 조건이 모두 충족된 것은 아닙니다.

소프트웨어 관리자로 설치

아키텍처에 맞는 패키지를 다운로드한 뒤 먼저 배포판의 소프트웨어 관리자로 열어 의존성, 설치 위치, 권한 안내를 확인하고 설치하세요. 의존성 누락이 발생하면 패키지 관리자의 전체 오류 메시지를 보관하고 현재 배포판의 방법으로 해결하세요. 다른 배포판에서 공유 라이브러리를 복사하거나 아키텍처가 다른 라이브러리를 심볼릭 링크로 연결하지 마세요. 설치 후 앱 메뉴에서 클라이언트를 실행하고 그래픽 인터페이스는 일반 사용자로 사용하세요. 필요한 네트워크 작업에 대해서만 안내에 따라 권한을 높이세요.

앱 메뉴에 항목이 생겼지만 창이 열리지 않는다면 먼저 트레이로 최소화되었는지, 현재 데스크톱에서 트레이 아이콘을 표시하는지 확인하세요. 일부 데스크톱 환경에서는 이런 아이콘이 기본적으로 표시되지 않습니다. 데스크톱 설정이나 호환 구성 요소를 사용해 해결하고 아이콘이 보이지 않는다는 이유로 여러 프로세스를 반복 실행하지 마세요. 터미널에서 실행 오류를 확인해야 한다면 실제 설치된 실행 파일 경로를 사용하세요. 다른 배포판의 경로를 추측해 사용하지 마세요. 로그의 그래픽 라이브러리 오류와 구독 업데이트 오류는 서로 다른 단계의 문제입니다.

구독 가져오기 및 데스크톱 프록시 범위 확인

‘구독 그룹 설정’에서 주소를 추가하고 저장한 뒤 구독을 업데이트해 활성 서버를 지정하세요. 원래 구독이 정상적으로 해석되는지 확인할 수 있도록 처음에는 서버 필터를 추가하지 마세요. 그런 다음 ‘시스템 프록시 자동 설정’을 시도하고 데스크톱 네트워크 설정에서 프록시 연결 지점을 확인하세요. Linux는 데스크톱 환경에 따라 프록시 설정을 저장하고 읽는 방식이 다릅니다. 일부 앱은 자체 설정만 읽고, 일부 명령줄 프로그램은 환경 변수만 읽을 수 있으므로 ‘데스크톱 프록시가 설정됨’이 ‘모든 프로그램이 프록시를 사용함’을 뜻하지는 않습니다.

브라우저에서는 연결되지만 소프트웨어 관리자에서는 연결되지 않는다면 소프트웨어 관리자에 별도의 프록시 설정이 필요한지, 백그라운드 서비스가 사용자 세션 설정을 상속하는지 확인하세요. 로컬 앱 문제를 해결하려고 로컬 수신 주소를 모든 네트워크 인터페이스에서 접속할 수 있도록 바꾸지 마세요. 접근 범위만 넓어질 뿐 앱이 프록시를 사용하는지는 달라지지 않습니다. 명령줄 프록시가 필요하다면 앱에서 지원하는 프로토콜로 설정하고 같은 터미널 세션에서 테스트하세요. 터미널을 닫거나 변수를 해제하면 적용 범위도 달라집니다.

TUN 설정 및 권한 문제 해결

더 넓은 범위의 트래픽 처리가 필요할 때만 클라이언트에서 TUN을 켜고 현재 배포판과 클라이언트 안내에 따라 권한을 설정하세요. 가상 네트워크 인터페이스, 라우팅, DNS 작업에는 추가 권한이 필요한 경우가 많습니다. 데스크톱 세션 전체를 항상 관리자 권한으로 실행해 대체하지 마세요. 켜지지 않으면 로그에 권한 부족, 인터페이스 생성 실패, 보조 구성 요소 사용 불가 중 어떤 오류가 명확히 표시되는지 확인하고 해당 문제에 맞춰 조치하세요. 오류가 요구할 때만 커널에서 제공하는 TUN 장치를 확인하세요.

정상적으로 켜진 뒤에는 같은 웹사이트와 앱으로 전후를 비교하세요. 로컬 네트워크 접속이 끊기면 라우팅이 로컬 네트워크 대역을 잘못 처리하는지 확인하세요. 도메인 접속만 실패한다면 시스템 이름 확인 서비스와 클라이언트 DNS가 함께 작동하는지 살펴보세요. 업무 네트워크, 컨테이너 네트워크, 가상 머신 브리지가 이미 있다면 기존 라우팅 정보를 먼저 저장하세요. 종료하기 전 TUN을 끄고 데스크톱 프록시 설정을 복원하세요. 업그레이드할 때는 사용자 설정을 백업하고 이전 실행 파일과 새 설치 폴더의 구성 요소를 섞어 실행하지 마세요.

Android 클라이언트 설치

v2rayNG 또는 v2flyNG 선택

Android 다운로드를 열고 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly용 설정이 있거나 동작을 비교해야 하는 경우 v2flyNG를 검토할 수 있습니다. 두 앱은 사용하는 코어가 다르므로 모든 설정을 그대로 서로 바꿔 쓸 수 있는 것은 아닙니다. 특히 REALITY, XTLS Vision처럼 특정 코어 기능이 필요한 연결은 클라이언트가 지원하는지 먼저 확인하세요. 공유 링크를 가져오는 데 성공했다는 이유만으로 하위 매개변수가 모두 인식되었다고 판단하지 마세요.

일반적으로 arm64 설치 파일을 먼저 선택하세요. 기기 아키텍처가 불확실하거나 호환되지 않는다는 안내가 표시되면 기기 정보를 확인한 뒤 범용 버전을 검토하세요. 시스템 파일 관리자에서 설치 파일을 열고 안내에 따라 현재 출처의 설치를 허용하세요. 설치가 끝난 뒤 해당 출처의 설치 권한을 해제해 임시 권한을 계속 유지하지 않도록 할 수 있습니다. 서명 충돌이 표시되면 같은 이름의 앱이 다른 출처에서 이미 설치되어 있는지 먼저 확인하세요. 원래 설정을 저장한 뒤 조치하고 구독과 라우팅을 모두 잃을 수 있으므로 바로 삭제하지 마세요.

연결 정보를 가져오고 구독 업데이트

클라이언트를 열고 ‘구독 그룹 설정’ 또는 현재 인터페이스의 구독 관리 메뉴에서 메모와 구독 주소 전체를 추가한 뒤 업데이트하세요. 단일 공유 링크만 있다면 클립보드에서 가져오기 기능을 사용할 수 있습니다. QR 코드 가져오기에 카메라 권한이 필요하다면 해당 기능을 사용할 때만 승인하세요. 구독 가져오기에 실패하면 입력기가 주소에 공백을 넣었는지, 웹페이지 제목까지 복사했는지, 링크가 만료되었는지 확인하세요. 무선 네트워크와 모바일 네트워크를 바꿔 보면 구독 주소에 직접 접속할 수 있는지 판단하는 데 도움이 됩니다.

목록이 업데이트되면 서버 하나를 선택하고 연결을 시작하세요. 지연 시간 테스트와 실제 인터넷 접속은 따로 확인해야 합니다. 일부 테스트는 현재 활성 연결에 의존하고, 일부는 서버 포트만 확인하므로 결과를 서로 대신할 수 없습니다. 먼저 자주 사용하는 웹페이지를 열고 일상적으로 사용하는 앱도 테스트하세요. 한 클라이언트에서는 정상인데 다른 클라이언트에서 실패한다면 서버 메모만 비교하지 말고 코어 지원, 전송 매개변수, 라우팅 설정을 비교하세요. 메모가 같아도 포트, 프로토콜, 구독 필터 결과가 다를 수 있습니다.

네트워크 트래픽 처리 승인 및 앱 범위 설정

Android에서 처음 연결하면 시스템이 VPN 연결 요청을 표시하는 경우가 많습니다. 이는 앱에 네트워크 트래픽 처리 권한을 부여하는 시스템 절차입니다. 요청한 앱 이름을 확인한 뒤 승인하고 시스템 연결 표시와 클라이언트 로그를 확인하세요. 데스크톱의 ‘시스템 프록시 자동 설정’ 메뉴와는 다르며, 휴대폰 무선 네트워크의 수동 프록시를 데스크톱 포트로 지정할 필요도 없습니다. 시스템 VPN 통신 경로를 사용하는 다른 앱이 이미 있다면 보통 두 연결을 동시에 유지할 수 없습니다. 충돌하는 앱을 먼저 중지하세요.

앱별 분할 설정을 사용하려면 먼저 화면의 앱 목록이 어떤 의미인지 확인하세요. 선택한 앱이 ‘프록시 사용’ 대상일 수도 있고, 우회 옵션을 켜면 ‘프록시를 사용하지 않음’ 대상일 수도 있습니다. 설정한 뒤 목록에 포함된 앱 하나와 포함되지 않은 앱 하나를 각각 테스트하세요. 앱 목록과 도메인 라우팅을 동시에 변경하면 어느 계층에서 경로가 결정되었는지 파악하기 어렵습니다. 브라우저의 암호화 DNS, 앱 자체 프록시, 시스템 네트워크 설정도 추가 경로를 만들 수 있으므로 따로 기록하세요.

백그라운드 제한 및 네트워크 전환 문제 해결

연결 직후에는 정상인데 화면을 잠근 뒤 끊긴다면 시스템이 백그라운드 활동을 제한하는지 확인하세요. 기기 설정에서 클라이언트가 필요한 백그라운드 실행을 유지하도록 허용하고 연결 알림을 유지하세요. 제조사마다 배터리 관리 메뉴 이름이 다르므로 현재 시스템 안내를 따르세요. 모든 앱의 백그라운드 권한을 한꺼번에 허용할 필요는 없습니다. 항상 켜진 연결 또는 연결 해제 시 차단 옵션을 켰다면 그 영향을 확인하세요. 클라이언트가 중지되었을 때 서버가 갑자기 고장 난 것이 아니라 시스템이 다른 네트워크 연결을 차단할 수 있습니다.

무선 네트워크에서 모바일 네트워크로 전환한 뒤 시스템 네트워크가 준비될 때까지 기다렸다가 클라이언트 연결을 다시 설정하세요. 모바일 네트워크에서만 실패하면 현재 네트워크의 도메인 이름 확인과 서버 포트 연결 가능성을 비교하세요. 모든 네트워크에서 실패하면 구독 상태와 인증 정보를 먼저 확인하세요. 종료할 때는 클라이언트의 중지 버튼을 사용하고 시스템 연결 표시가 사라졌는지 확인하세요. 새 기기로 옮길 때는 시스템 권한을 다시 승인하고 이전 기기의 권한 상태를 복사하지 마세요. 코어 차이가 있는 마이그레이션은 Xray와 V2Fly 코어의 차이를 참고해 항목별로 확인할 수 있습니다.

구독 그룹 및 설정 마이그레이션 관리

구독 업데이트와 서버 연결 구분

구독 업데이트는 서버 목록을 다운로드하고 해석하며, 서버 연결은 선택한 원격 서버로 트래픽을 전달합니다. 두 작업은 서로 다른 주소에 접속할 수 있습니다. 업데이트 성공은 서버 목록을 가져올 수 있다는 뜻일 뿐, 각 서버에 연결할 수 있다는 뜻은 아닙니다. 특정 서버를 계속 사용할 수 있어도 구독 주소가 만료되지 않았다는 보장은 없습니다. 문제를 확인할 때 ‘구독 업데이트 오류’와 ‘서버 연결 오류’를 따로 저장하세요. 페이지에서 반환한 오류 문구를 프로토콜 인증 실패로 오해하거나 로컬 포트 점유 문제를 해결하려고 구독을 계속 새로고침하지 마세요.

‘구독 그룹 설정’에서 출처별로 그룹을 나누고 메모에는 용도나 출처를 짧게 적으세요. 주소는 원문 그대로 유지합니다. 처음 가져올 때는 필터 키워드를 설정하지 말고 목록이 완전한지 확인한 다음 범위를 줄이세요. 필터의 일치 방식은 인터페이스 구현에 따라 다르므로 사용 전에 항목 설명을 확인하세요. 일반 텍스트가 정규식이라고 가정하면 안 됩니다. 업데이트 후 목록이 비어 있으면 먼저 필터를 해제하고 다시 업데이트한 뒤 서버가 실제로 빈 목록을 반환했는지 확인하세요. 그룹 전체를 바로 삭제하지 마세요.

업데이트 경로 및 시점 선택

‘구독 업데이트(프록시 사용 안 함)’는 구독 서비스에 직접 접속할 수 있을 때 사용합니다. ‘구독 업데이트(프록시 사용)’는 직접 가져오기에 실패했지만 현재 프록시는 정상 작동할 때 사용합니다. 활성 서버가 없는 새 기기에서는 프록시 업데이트 경로를 자체적으로 만들 수 없습니다. 이 경우 서비스 제공업체에서 직접 가져오는 방법을 제공하는지 확인하거나 안내에 따라 유효한 연결 하나를 가져온 뒤 업데이트하세요. 이 조건을 우회하려고 출처가 불분명한 임시 정보를 가져오지 마세요.

자동 업데이트 간격은 서비스 제공업체의 제한과 실제 변경 빈도에 맞춰 설정하세요. 요청을 자주 보낸다고 목록이 더 정확해지는 것은 아닙니다. 요청 제한 응답이 나타나면 반복해서 클릭하지 말고 허용된 시간만큼 기다렸다가 다시 시도하세요. 주소가 만료되거나 계정이 정지되거나 구독 형식이 바뀌었다면 계정 페이지에서 확인해야 합니다. DNS 변경으로 해결되는 문제가 아닙니다. 업데이트 후 현재 활성 서버가 여전히 있는지 확인하세요. 기존 서버가 삭제되거나 이름이 바뀌었다면 다시 선택해야 합니다. 상태 영역에 이전 메모가 보인다는 사실만으로는 확인할 수 없습니다.

수동 서버 및 필요한 백업 보관

수동으로 추가한 연결과 구독에서 생성된 연결은 따로 관리하세요. 구독 항목의 주소, 포트, 메모를 직접 수정해 사용자 설정을 저장하면 다음 업데이트에서 덮어쓸 수 있으므로 장기적으로 이렇게 사용하지 마세요. 일시적으로 조정해야 한다면 별도의 수동 그룹에 복사하고 변경 이유를 기록하세요. 서버 이름은 고유하고 안정적인 식별자가 아닙니다. 이름이 같아도 전송 매개변수가 다를 수 있으므로 마이그레이션할 때는 이름이 아니라 전체 항목을 기준으로 하세요. 그룹을 삭제하기 전에 유일하게 보관 중인 수동 정보가 포함되어 있는지 확인하세요.

업그레이드하거나 기기를 바꾸기 전에 구독 주소, 수동 연결, 라우팅 규칙, 필요한 클라이언트 설정을 저장하세요. 백업에는 인증 정보가 포함되는 경우가 많으므로 보호된 위치에 보관하고 공개 동기화 폴더에 두지 마세요. 운영체제 간에는 공통으로 사용할 수 있는 서버 정보부터 옮긴 다음 시스템 프록시와 TUN 권한을 새로 설정하세요. 새 시스템의 실행 파일 경로, 네트워크 어댑터 이름, 권한 상승 설정을 덮어쓰지 마세요. 복원 후 연결 하나만 활성화해 정상 작동을 확인한 다음 자동 업데이트, 앱별 분할, 기타 사용자 지정 옵션을 복원하세요.

민감한 정보의 노출 범위 제한

구독 스크린샷에는 오류 유형, 시간, 작업 이름만 남기세요. 공유 링크의 전체 문자열에는 인증 정보가 인코딩되어 있을 수 있습니다. 겉으로 암호처럼 보이지 않더라도 비밀로 관리해야 합니다. 도움을 요청하기 전에 내보내기 파일, 로그, QR 코드를 확인하고 설정 전체를 게시판에 그대로 올리지 마세요. 이미 노출되었다면 서비스 제공업체가 안내하는 방법으로 구독 자격 정보를 갱신하세요. 공개 게시물을 삭제해도 이미 복사된 주소를 무효화할 수는 없습니다. 여러 출처를 정리하려면 여러 구독 그룹 및 서버 필터링 방법을 참고해 필터 조건을 조금씩 추가하세요.

시스템 프록시, 라우팅 및 TUN 설정

먼저 트래픽이 클라이언트에 들어오는지 확인

시스템 프록시는 앱이 요청을 전달할 로컬 진입점을 결정하고, 라우팅은 코어에 들어온 연결을 어느 출구로 보낼지 결정합니다. 연속된 두 단계입니다. 앱이 시스템 프록시를 사용하지 않는다면 라우팅 규칙을 변경해도 동작이 달라지지 않는 경우가 많습니다. 트래픽이 이미 코어에 들어왔지만 규칙에 따라 직접 연결로 분류되었다면 시스템 프록시를 반복해서 켜도 원격 서버로 자동 전환되지 않습니다. 먼저 로그에서 요청이 클라이언트에 도착했는지 확인한 다음 대상 도메인, 일치한 규칙, 출구를 살펴보세요. 관련 없는 옵션을 번갈아 시험하는 일을 줄일 수 있습니다.

‘시스템 프록시 지우기’는 시스템 프록시 진입점을 해제하고, ‘시스템 프록시 자동 설정’은 현재 클라이언트의 진입점을 설정하며, ‘시스템 프록시 변경 안 함’은 기존 설정을 유지합니다. 마지막 옵션은 자동 복원도 아니고 별도의 전역 모드도 아닙니다. 프로그램을 종료한 뒤에도 시스템이 로컬 포트를 가리키면 시스템 프록시를 사용하는 앱은 인터넷에 연결되지 않을 수 있습니다. 다른 네트워크 도구와 장기간 함께 사용해야 한다면 어느 프로그램이 시스템 설정을 변경하고 복원할지 명확히 하세요. 두 프로그램이 같은 시스템 설정을 번갈아 바꾸지 않도록 하세요.

프리셋 및 규칙 일치 순서 이해

트레이의 라우팅 메뉴에서 ‘중국 본토 우회’, ‘블랙리스트’, ‘전역’을 선택해 프리셋 정책을 바꿀 수 있습니다. 어떤 대상에 적용되는지는 현재 규칙 내용에 따라 달라지므로 프리셋 이름만으로 판단하지 마세요. 전역 정책은 일반적으로 프록시 경로에 들어온 트래픽을 프록시 출구로 보낸다는 뜻이지, 모든 앱을 클라이언트에 강제로 연결한다는 뜻은 아닙니다. 로컬 네트워크 기기에 계속 접속해야 한다면 사설 네트워크 대역과 로컬 도메인이 어떻게 처리되는지 확인하세요. 업무 네트워크에서는 내부 도메인 확인과 전용 주소 대역도 고려하고 공개 규칙을 그대로 복사하지 마세요.

라우팅 규칙은 일반적으로 순서대로 일치 여부를 확인합니다. 범위가 넓은 조건을 앞에 두면 뒤의 구체적인 조건을 가릴 수 있습니다. 아래는 도메인과 사설 주소 분기 형태를 보여 주는 라우팅 객체 일부입니다. 완전한 클라이언트 설정이 아니며 규칙 배열만 받는 입력란에 그대로 붙여 넣으면 안 됩니다. 병합하기 전에 현재 코어의 문법, 편집 메뉴의 입력 형식, 전체 설정에 같은 이름의 출구가 정의되어 있는지 확인하세요. 존재하지 않는 출구 태그를 사용하면 규칙이 무효가 되거나 설정을 시작할 수 없습니다.

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "proxy"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

예시에서 domain은 도메인으로 일치 여부를 확인하고, ip는 주소 또는 주소 집합으로 확인하며, outboundTag는 정의된 출구를 가리킵니다. domain:example.com은 설명용 도메인 조건입니다. geoip:private는 코어에서 해당 규칙 데이터를 읽을 수 있어야 합니다. AsIs는 라우팅을 일치시킬 때마다 모든 도메인을 능동적으로 확인하지 않습니다. 따라서 주소 규칙만 있으면 도메인 형태로 전달된 대상과 일치하지 않을 수 있습니다. 특정 규칙을 적용하려고 모든 DNS 정책을 바꾸지 마세요.

DNS 및 앱 내부 설정을 따로 확인

다른 연결은 정상인데 도메인으로 웹사이트에 접속할 수 없다면 이름 확인을 살펴보세요. 공개 DNS 주소 하나로 바꾸는 것만으로 문제 해결을 끝내지 마세요. 시스템, 브라우저, 앱, 코어가 각각 DNS를 처리할 수 있습니다. 브라우저에서 암호화 DNS를 사용하면 시스템과 다른 경로로 요청할 수 있고, TUN이 DNS를 처리하면 도메인과 대상 주소의 연결 방식이 달라질 수 있습니다. 테스트할 때는 경로를 명확하게 하나로 유지하고 요청이 클라이언트에 들어오는지 기록한 뒤 시스템 이름 확인, 앱 옵션, 코어 설정 중 무엇을 바꿀지 결정하세요.

TUN은 트래픽 처리 범위를 넓힐 뿐 잘못된 인증, 만료된 구독, 연결할 수 없는 원격 서버를 해결하지 않습니다. 켜기 전에 관리자 권한을 확인하고 유사한 트래픽 처리 프로그램을 종료하세요. 켠 뒤에는 도메인 접속, 로컬 네트워크 접속, 시스템 프록시를 읽지 않는 앱을 각각 테스트하세요. 문제가 발생하면 최근 추가한 설정부터 해제하고 시스템 프록시에서 작동하는 상태로 되돌린 뒤 계층별로 다시 추가하세요. 프린터, 네트워크 저장 장치, 업무 서비스가 다른 출구로 인해 연결되지 않도록 필요한 로컬 네트워크 예외를 유지하세요.

설정 관련 자주 묻는 문제 해결

문제 발생 단계별로 범위 좁히기

먼저 문제가 설치, 실행, 구독 업데이트, 웹페이지 접속 중 어느 단계에서 발생했는지 판단하세요. 설치 실패는 아키텍처, 시스템 호환성, 권한을 확인하고, 창이 열리지 않으면 실행 환경과 그래픽 세션을 확인하세요. 코어 시작 실패는 설정 문법, 구성 요소 경로, 포트 충돌을 살펴봅니다. 구독 업데이트 실패는 주소와 가져오기 경로를 확인하세요. 프로그램과 코어가 모두 정상적으로 시작된 뒤에 웹페이지 연결 문제를 확인해야 합니다. 네 단계를 구분하지 않고 계속 재설치하면 서버 측 문제는 해결되지 않고 비교에 필요한 원래 설정까지 잃을 수 있습니다.

‘연결됨’으로 표시되지만 웹페이지가 열리지 않는다면 먼저 TUN을 끄고 시스템 프록시를 지워 기본 네트워크가 정상인지 확인하세요. 직접 연결도 실패하면 무선 네트워크, 게이트웨이, 시스템 이름 확인, 로그인 인증 페이지를 먼저 확인하세요. 직접 연결이 정상이면 클라이언트를 다시 켜고 시스템 프록시만 사용해 정보가 완전한 서버 하나를 선택하세요. 실패가 즉시 발생하는지 시간 초과까지 기다린 뒤 발생하는지, 모든 웹사이트에서 발생하는지, 다른 앱에도 영향을 주는지 확인하세요. 결과마다 다음 단계가 달라지므로 연결 아이콘 하나만 보고 판단할 수 없습니다.

로그로 포트, 인증, 시간 초과 구분

로컬 수신 실패는 대개 코어 시작 단계에서 발생합니다. 중복 실행과 포트 충돌을 확인하세요. 인증 거부는 계정 정보, 프로토콜 매개변수, 서비스 상태와 관련된 경우가 많습니다. 연결 시간 초과는 주소 확인, 네트워크 연결 가능 여부, 원격 응답을 차례로 구분해야 합니다. 인증서 오류가 있으면 시스템 시간, 서버 이름, 전송 매개변수를 먼저 확인하세요. 인증서 검증 해제를 일반적인 해결책으로 사용하지 마세요. 영어 단어 하나만 잘라 기록하는 것보다 오류 문장 전체와 발생 시간을 보관하면 변경 전후를 비교하는 데 도움이 됩니다.

같은 구독의 일부 서버만 실패한다면 프로토콜, 전송, 포트, 출구 지역을 비교해 같은 유형의 설정인지 확인하세요. 모든 서버가 실패하고 코어에 연결 기록도 없다면 앱 진입점이나 로컬 트래픽 처리 문제일 가능성이 높습니다. 특정 웹사이트만 실패한다면 라우팅, 도메인 이름 확인, 대상 서비스 상태를 확인하세요. 클라이언트 전체를 바로 초기화하지 마세요. 테스트 서버는 같은 네트워크와 방법으로 비교해야 합니다. 탐지 방식이 다르면 결과를 직접 비교할 수 없습니다. 선택 순서는 서버 지연 시간·배율·지역·프로토콜 비교를 참고하세요.

정상 작동하는 기본 설정 복원

여러 차례 설정을 변경했다면 먼저 현재 설정을 백업하고 최소 구성부터 다시 만드세요. 구독 그룹 하나, 서버 하나, 기본 라우팅, 트래픽 처리 방식 하나만 남깁니다. 사용자 지정 규칙, 앱 목록, 자동 전환은 잠시 끄세요. 기본 구성이 작동하면 한 번에 하나씩 복원하고 같은 웹페이지와 앱으로 다시 테스트하세요. 특정 항목을 복원한 직후 실패하면 변경 전후의 설정 차이를 보관하세요. 프로그램 전체를 다시 설치할 필요는 없습니다. 초기화는 첫 단계가 아니라 정보를 저장하고 복원 범위를 명확히 파악한 뒤 원인을 찾는 데 사용하는 방법입니다.

도움을 요청할 때 운영체제, 아키텍처, 클라이언트 이름, 실제 작업 경로, 오류 전문, 완료한 비교 테스트를 적으세요. 로그에서 연결 단계 정보를 확인할 수 있지만 업로드하기 전에 구독 주소, 인증 항목, 개인 식별 정보를 삭제하세요. 백업 파일 전체를 공개하지 마세요. 웹페이지 접속 문제의 자세한 해결 절차는 v2rayN 연결됨 표시 후 웹페이지가 열리지 않을 때 확인 목록을 참고하세요. 처음 설정에서 단계를 놓쳤다면 사용 가이드로 돌아가 순서대로 다시 진행하세요.