v2rayN 플랫폼별 설치 및 설정

공통 준비: 설정과 네트워크 환경부터 확인

클라이언트, 커널, 서버 설정 구분하기

v2rayN은 서버 정보를 저장하고 실행 설정을 생성한 뒤, 사용 가능한 커널을 호출해 트래픽을 처리하는 GUI 클라이언트입니다. Xray와 V2Fly는 관련 프록시 생태계의 서로 다른 커널 구현체로, 지원 프로토콜과 확장 기능이 완전히 같지는 않습니다. 클라이언트를 설치해도 원격 서버가 자동으로 제공되지는 않습니다. 시작하기 전에 사용할 권한이 있는 구독 링크나 전체 연결 정보를 준비하고, 제공자가 안내한 호환 클라이언트와 전송 방식, 필수 인증 정보를 확인하세요.

구독 링크는 설정을 가져오는 경로이지 서버 주소 자체가 아닙니다. 수동으로 설정하려면 주소, 포트, 프로토콜 인증 정보와 전송 매개변수를 각각 입력해야 합니다. 정보를 받으면 먼저 구독 링크인지, 단일 공유 링크인지, 커널 설정 파일인지 확인한 다음 알맞은 가져오기 방법을 선택하세요. 전체 링크를 주소 입력란에 그대로 넣거나 웹페이지 안내문을 구독 내용으로 사용하지 마세요. 정보가 빠져 있다면 제공자에게 확인하세요. 필드를 추측해 채우면 문제 해결 범위만 넓어질 수 있습니다.

복구 가능한 로컬 기준 상태 만들기

네트워크를 제어 중인 다른 프록시나 가상 네트워크 도구를 먼저 끄고, 테스트에는 클라이언트 하나만 사용하세요. 일반 웹페이지를 열어 현재 네트워크가 정상인지 확인하고, 시스템 설정에서 날짜와 시간을 자동으로 맞춘 뒤 시간대도 확인하세요. 시스템 시간이 크게 어긋나면 인증서 검증이나 시간 확인이 필요한 프로토콜에 문제가 생길 수 있습니다. 조직에서 관리하는 컴퓨터라면 프록시, 인증서, 네트워크 확장 프로그램의 관리 정책을 먼저 확인하고 기존 정책을 덮어쓰지 마세요.

기존 시스템 프록시, 수동 DNS, 네트워크 인터페이스 설정을 기록하고, 화면을 캡처할 때는 계정과 링크를 가리세요. 설정은 한 번에 한 종류씩 바꾸세요. 먼저 서버 연결을 확인하고, 다음으로 시스템 프록시를 켠 뒤, 마지막으로 TUN을 검토합니다. 문제가 생기면 직전 상태로 되돌릴 수 있습니다. 첫 연결부터 복잡한 규칙을 가져오고 커널을 바꾸며 DNS까지 수정하는 것은 피하세요. 여러 변수를 동시에 바꾸면 연결이 복구되더라도 어떤 설정이 효과가 있었는지 알기 어렵습니다.

트래픽을 제어할 범위를 정한 뒤 검증하기

시스템 프록시는 시스템 프록시 설정을 따르는 앱에만 영향을 줍니다. 브라우저는 대체로 사용할 수 있지만, 명령줄 프로그램이나 게임, 자체 네트워크 스택을 사용하는 앱은 따르지 않을 수 있습니다. TUN은 가상 네트워크 인터페이스로 더 많은 트래픽을 받아 범위가 넓은 대신 권한, 라우팅, DNS가 올바르게 설정되어야 합니다. 처음에는 시스템 프록시부터 테스트하세요. 대상 앱이 시스템 프록시를 사용하지 않거나 기기 전체의 트래픽 분할이 꼭 필요한 경우에만 TUN 설정으로 넘어가세요.

검증할 때는 '설정 저장됨', '커널 시작됨', '웹페이지가 예상한 경로로 열림'을 서로 다른 상태로 구분하세요. 창에 서버 항목이 보여도 인증에 성공한 것은 아니며, 트레이에 실행 중이라고 표시되어도 브라우저 트래픽이 프록시로 전달된다는 뜻은 아닙니다. 원래 접속 가능한 페이지 하나와 지정한 출구를 사용해야 하는 대상 하나를 준비해 일반 연결, 프록시 연결, 직접 연결 규칙을 차례로 확인하세요. 로그와 함께 결과를 살펴보고 아이콘 하나나 한 번의 속도 측정만으로 결론 내리지 마세요.

다운로드 링크는 모두 클라이언트 다운로드 페이지에 있습니다. 사용 중인 플랫폼 영역을 열고 아키텍처와 패키지 유형을 확인하세요. 이 문서는 특정 메뉴 배치를 전제로 하지 않습니다. 같은 이름의 메뉴를 찾을 수 없다면 구독 그룹, 설정, 시스템 프록시 등 관련 기능 영역을 확인하세요. 우선 연결을 한 번 성공시키려면 빠른 시작을 진행한 뒤 백업과 문제 해결 항목을 읽어보세요.

macOS: 칩에 맞는 설치 파일, 설치 및 네트워크 권한

Apple Silicon과 Intel 설치 파일 구분

Apple 메뉴에서 '이 Mac에 관하여'를 열고 '칩' 또는 '프로세서' 항목을 확인하세요. Apple Silicon으로 표시되면 macOS 다운로드 영역에서 Apple Silicon 설치 파일을, Intel로 표시되면 Intel 설치 파일을 선택합니다. 두 파일은 서로 다른 프로세서 아키텍처용이므로 컴퓨터 외관만 보고 판단하면 안 됩니다. 변환 실행 환경이 있더라도 다른 아키텍처용 파일을 우선할 이유는 없습니다. 기본 아키텍처에 맞는 파일을 쓰면 커널, 보조 구성요소, 권한이 정상인지 확인하기 쉽습니다.

다운로드한 디스크 이미지를 열고 v2rayN을 '응용 프로그램'으로 드래그한 다음 해당 폴더에서 실행하세요. 디스크 이미지 안에서 계속 실행하면 업데이트, 설정 저장, 보조 구성요소 경로에 문제가 생길 수 있습니다. 시스템에서 앱을 열 수 없다고 표시되면 다운로드 페이지의 공식 경로에서 받은 파일인지, 아키텍처가 맞는지, 다운로드가 완료됐는지 먼저 확인한 뒤 '시스템 설정 → 개인정보 보호 및 보안'의 안내를 살펴보세요. 앱 하나를 실행하려고 시스템 전체의 보안 기능을 끄지 마세요.

가져오기와 시스템 프록시 확인

처음 실행한 뒤 구독 그룹 관리로 이동해 용도가 명확한 그룹을 추가하고 전체 구독 링크를 주소 입력란에 붙여 넣으세요. 저장 후 구독을 업데이트합니다. 업데이트 메뉴에서 프록시 사용 여부를 선택할 수 있는데 아직 연결 가능한 프록시가 없다면 우선 프록시 없이 시도하세요. 해당 주소에 프록시가 꼭 필요하다면 먼저 별도의 연결을 준비해야 합니다. 업데이트가 완료되면 그룹에 선택 가능한 서버가 표시되는지 확인하고 사용할 서버를 현재 활성 항목으로 지정하세요.

커널을 시작한 뒤 시스템 프록시 메뉴에서 '시스템 프록시 자동 설정'을 선택하세요. 여기서 '자동 설정'은 클라이언트가 제공하는 설정 작업이며 브라우저의 PAC 프록시 모드와 같은 의미가 아닙니다. '시스템 설정 → 네트워크'에서 현재 사용 중인 네트워크 서비스를 열고, 세부 정보의 프록시 영역에서 프록시 호스트와 포트가 클라이언트의 로컬 수신 설정과 일치하는지 확인하세요. Wi-Fi와 유선 연결은 서로 다른 서비스이므로 네트워크를 바꾼 뒤에는 실제로 적용된 인터페이스를 다시 확인해야 합니다.

먼저 브라우저로 확인한 다음 다른 앱을 점검하세요. 브라우저 확장 프로그램, 앱 자체의 프록시 옵션, 개발 도구의 환경 변수가 시스템 설정을 덮어쓸 수 있습니다. 브라우저는 정상인데 특정 앱이 직접 연결된다면 서버를 바꾸기 전에 해당 앱이 시스템 프록시를 읽는지 확인하세요. 테스트를 마칠 때는 '시스템 프록시 지우기'를 사용하세요. '시스템 프록시 변경 안 함'은 클라이언트가 설정을 더 이상 바꾸지 않는다는 뜻인 경우가 많으므로 초기화 동작으로 사용하지 마세요.

TUN 및 절전 모드 해제 후 복구 순서

시스템 프록시가 정상 작동하는 것을 확인한 뒤 TUN을 고려하세요. 설치 방식과 실행 환경에 따라 보조 서비스, 네트워크 확장 프로그램, 관리자 권한이 필요할 수 있습니다. 클라이언트와 시스템 안내에 따라 필요한 권한을 부여한 뒤 커널이 가상 인터페이스를 만들었는지 확인하세요. 권한 창이 반복해서 나타나더라도 계속 재시도하지 마세요. 불필요한 인스턴스를 종료하고 로그에서 권한, 서비스 설치, 인터페이스 생성 오류를 확인한 다음 해당 절차에 맞게 처리하세요. 회사 기기의 관리 제한은 관리자에게 확인해야 합니다.

덮개를 닫아 절전 모드에 진입했다가 깨어나거나 Wi-Fi에서 유선으로 전환한 뒤 연결이 끊기면 먼저 TUN을 끄고 일반 네트워크가 복구되는지 확인하세요. 그런 다음 커널을 재시작하고 트래픽 제어를 다시 활성화합니다. 클라이언트가 종료됐는데 시스템 프록시가 로컬 주소로 남아 있으면 웹페이지가 전혀 열리지 않을 수 있습니다. 클라이언트를 다시 실행해 프록시를 지우거나 해당 네트워크 서비스에서 기록해 둔 설정으로 복구하세요. 수신 중인 프로그램이 없는 포트를 가리키는 프록시 항목을 남기지 마세요.

업데이트 전 구독 그룹과 사용자 지정 규칙을 백업하고 기존 인스턴스를 종료한 뒤 앱을 교체하세요. 시스템에서 앱이 사용 중이라고 표시되면 메뉴 막대 아이콘과 백그라운드 프로세스를 확인하세요. 이전 버전과 새 버전을 동시에 실행한 상태로 설정을 가져오지 마세요. 교체 후에는 일반 프록시를 먼저 확인하고, 그다음 TUN과 자동 실행을 테스트하세요. 이 순서로 진행하면 업데이트 후 설정 호환 문제와 시스템 권한 문제를 구분할 수 있으며, 모든 연결 실패를 설치 파일 탓으로 돌리지 않아도 됩니다.

Windows: 데스크톱 버전, WPF, 시스템 프록시

인터페이스와 호환성에 맞는 버전 선택

Windows 다운로드 영역에서는 v2rayN 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하며, WPF 버전은 기존 사용 방식을 유지합니다. 처음 설치한다면 데스크톱 버전을 먼저 검토해 보세요. 기존 설정과 작업 흐름을 잘 사용하고 있다면 백업한 뒤 이전 여부를 결정하세요. 두 버전은 인터페이스와 설정 저장 위치가 다를 수 있으므로 설치 후 모든 데이터를 자동으로 공유한다고 가정하지 마세요. 두 프로그램을 서로 독립적인 프록시처럼 동시에 실행해서도 안 됩니다.

설치 전에 운영체제와 프로세서 아키텍처가 다운로드 카드의 안내와 맞는지 확인하고 사용자 폴더에 쓸 수 있는 권한을 확보하세요. 설치 마법사의 안내를 따라 설치합니다. 압축을 풀어야 하는 배포 파일이라면 전체 압축을 해제한 뒤 실행하고, 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요. 실행 환경이 없다는 안내가 나타나면 필요한 의존성과 시스템 지원 여부를 확인하세요. 출처가 불분명한 DLL 파일 하나를 프로그램 폴더에 복사해 해결하려고 하지 마세요.

구독 가져오기 및 로컬 포트 확인

v2rayN을 실행하고 구독 그룹을 만든 다음 구독 주소를 입력해 저장하고 업데이트하세요. 구독 정보를 가져올 수 있다는 것은 설정 주소에 접근할 수 있다는 뜻일 뿐입니다. 사용할 서버를 선택하고 커널도 시작해야 합니다. 공유 링크를 직접 가져올 때는 프로토콜, 주소, 포트, 전송 정보가 모두 있는지 확인한 다음 올바른 그룹에 저장됐는지 살펴보세요. 기존 설정이 있다면 용도를 분명히 한 그룹에서 먼저 테스트하세요. 기본 그룹과 구독 그룹에 이름이 같은 항목이 있으면 잘못 선택할 수 있습니다.

설정에서 로컬 수신 주소와 HTTP 또는 혼합 프록시 포트를 확인하세요. 포트는 클라이언트에서 실제로 활성화한 인바운드와 일치해야 하며, 다른 안내에서 흔히 쓰는 값을 그대로 가져오면 안 됩니다. 기본 설정이 로컬 기기 전용이라면 루프백 주소 수신을 유지하세요. LAN 연결 허용을 켜는 경우에는 인증, 방화벽, 접근 가능 범위를 추가로 고려해야 합니다. 포트가 사용 중이라면 점유 중인 프로그램을 먼저 찾은 뒤 기존 인스턴스를 종료할지 포트를 바꿀지 결정하세요. 변경한 경우 해당 포트를 수동으로 입력한 앱도 함께 수정해야 합니다.

시스템 프록시 메뉴에서 자동 설정을 켠 다음 '설정 → 네트워크 및 인터넷 → 프록시'를 열어 수동 프록시 설정이 클라이언트와 일치하는지 확인하세요. 브라우저에 별도의 프록시 확장 프로그램이 있다면 테스트 전에 잠시 끄세요. 일부 앱은 네트워크 설정을 캐시하므로 전환 후 재시작해야 할 수 있습니다. 시스템 설정에 로컬 프록시 주소가 표시되어도 커널이 실제로 수신 중이라는 뜻은 아닙니다. 클라이언트 로그에서 시작 실패나 포트 바인딩 오류가 없는지 확인하세요.

TUN, 권한, 백그라운드 인스턴스

TUN을 켜기 전에 서비스 또는 관리자 권한에 관한 현재 클라이언트의 안내를 확인하세요. 일부 실행 방식은 권한 상승이나 보조 서비스 설치가 필요하지만, 일반 시스템 프록시를 테스트할 때 무조건 관리자 권한으로 실행할 필요는 없습니다. 필요한 범위만 허용한 다음 가상 어댑터 생성, 라우팅 등록, DNS 제어가 완료됐는지 확인하세요. 보안 소프트웨어가 네트워크 구성요소를 차단한다면 차단 상세 정보와 파일 위치를 먼저 살펴보고 조직 정책에 따라 처리하세요. 문제 해결을 위해 보안 기능 전체를 끄지 마세요.

Windows에서는 여러 트레이 인스턴스, 시작 프로그램, 이전 서비스가 문제를 일으키는 경우가 많습니다. 기본 창을 닫아도 프로그램이 종료되지 않을 수 있으니 트레이 메뉴에서 종료를 선택하세요. 컴퓨터를 재시작한 뒤 프록시가 다시 바뀐다면 시작 앱과 기존 네트워크 도구를 확인해 로그인 시 누가 시스템 프록시를 제어하는지 찾으세요. 클라이언트를 이전할 때는 기존 프로그램을 종료하고 해당 프로그램의 네트워크 제어를 중지한 다음 새 프로그램을 실행하세요. 그렇지 않으면 두 인스턴스가 시스템 설정을 번갈아 수정해 연결이 불안정해질 수 있습니다.

브라우저는 되는데 터미널 프로그램이 실패한다면 해당 프로그램이 시스템 프록시를 사용하는지, 자체 프록시 환경 변수가 설정되어 있는지 확인하세요. 필요한 프로토콜과 수신 유형을 확인한 뒤에만 주소를 직접 입력하세요. 모든 웹페이지가 열리지 않는다면 로컬 포트, 커널 실행, 시스템 프록시를 하나씩 다시 확인하세요. 자세한 브라우저 문제 해결 절차는 연결됐지만 웹페이지가 열리지 않을 때 확인할 항목을 참고하세요. 처음부터 클라이언트를 전부 다시 설치할 필요는 없습니다.

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

배포판과 프로세서 아키텍처를 함께 확인

Linux 설치 파일은 배포판의 패키지 형식과 기기의 프로세서 아키텍처, 두 조건에 맞아야 합니다. Debian, Ubuntu 계열은 보통 deb를, Fedora 계열은 보통 rpm을 선택하지만 실제로는 배포판의 패키지 관리 방식을 따르세요. 일반 PC는 대체로 x64이며 일부 개발 보드와 데스크톱 기기는 arm64를 사용합니다. Linux 다운로드 영역에서 먼저 패키지 형식을 확인하고 아키텍처를 확인하세요. 패키지 형식을 프로세서 유형으로 혼동하지 마세요.

터미널에서 아래 읽기 전용 명령 두 개를 실행해 정보를 확인할 수 있습니다. 출력의 x86_64는 보통 x64, aarch64는 보통 arm64에 해당하며, 배포판 정보는 패키지 관리 체계를 파악하는 데 사용됩니다. 이 명령은 기기 정보만 확인하며 클라이언트를 설치하거나 변경하지 않습니다. 다른 아키텍처의 기기라면 호환되지 않는 패키지를 억지로 설치하지 말고 다운로드 페이지에 해당 환경용 파일이 있는지 확인하세요.

uname -m
cat /etc/os-release

배포판의 소프트웨어 설치 프로그램으로 다운로드한 패키지를 열고 의존성 및 설치 안내를 확인한 뒤 설치하세요. 의존성이 누락됐다면 시스템 패키지 관리자가 해결하도록 하세요. 다른 배포판의 라이브러리 파일을 복사하지 마세요. 설치 후 앱 메뉴에서 v2rayN을 실행해 일반 사용자 권한으로 설정을 저장할 수 있는지 확인하세요. 과거에 관리자 권한으로 클라이언트를 실행했다면 사용자 설정 폴더의 소유권이 잘못됐을 수 있습니다. 해당 폴더와 권한을 확인한 뒤 필요한 부분만 수정하고 홈 디렉터리 전체의 권한을 재귀적으로 바꾸지 마세요.

설정 가져오기와 데스크톱 프록시의 차이

구독 그룹에 링크를 저장하고 업데이트한 뒤 서버를 선택해 커널을 시작하고 로컬 수신이 정상인지 확인하세요. Linux 데스크톱 환경마다 시스템 프록시 구현 방식은 다릅니다. 클라이언트가 데스크톱 프록시 설정을 변경할 수도 있고, 네트워크 설정 패널에서 직접 입력해야 하는 환경도 있습니다. GNOME, KDE와 각 앱이 설정을 읽는 방식도 다를 수 있습니다. 클라이언트에 프록시 설정 완료로 표시되더라도 현재 데스크톱의 네트워크 설정에서 주소와 포트를 확인하세요.

명령줄 프로그램은 데스크톱 프록시가 켜져 있다고 해서 자동으로 프록시를 사용하지 않는 경우가 많습니다. 환경 변수, 명령줄 옵션, 자체 설정 파일을 사용할 수 있습니다. 대상 프로그램의 프록시 안내를 확인하고 클라이언트의 수신 유형에 맞는 설정을 선택하세요. HTTP 프록시와 SOCKS 프록시는 이름만 바꿔 모든 문법을 공용으로 사용할 수 없으며, 도메인의 원격 해석 방식도 프로그램마다 다릅니다. 테스트하는 동안 프록시 변수를 여러 시작 파일에 전역으로 추가하지 마세요. 나중에 오래된 포트 설정이 어디서 적용됐는지 확인하기 어려워집니다.

최소 권한 및 가상 인터페이스 확인

TUN을 사용하려면 커널 가상 네트워크 인터페이스와 적절한 네트워크 관리 권한이 필요합니다. GUI 프로그램이 실행된다고 해서 이 조건까지 갖춰진 것은 아닙니다. 클라이언트가 지원하는 방식으로 서비스나 권한을 설정하고, 데스크톱 프로그램 전체를 장기간 높은 권한으로 실행하지 마세요. 로그에 인터페이스가 없음, 작업이 허용되지 않음, 라우팅 등록 실패가 표시되면 먼저 시스템에 TUN 장치가 있는지, 컨테이너나 제한된 세션에서 해당 작업이 허용되는지 확인한 다음 권한 문제인지 커널 시작 문제인지 판단하세요.

아래 읽기 전용 명령으로 주소와 라우팅을 확인할 수 있습니다. 활성화 전후를 비교할 때는 추가된 인터페이스와 기본 경로의 목적지를 살펴보세요. 인터페이스 이름만으로 연결 성공 여부를 판단하지 마세요. 다른 가상 네트워크 도구도 함께 실행 중이면 라우팅 우선순위가 서로 영향을 줄 수 있습니다. 트래픽을 제어하는 도구 하나만 남기고 일반 프록시가 작동하는지 확인한 뒤 TUN을 켜세요. TUN을 끈 뒤에도 클라이언트 스위치만 볼 것이 아니라 시스템 라우팅이 복구됐는지 확인해야 합니다.

ip address show
ip route show

Linux에서 직접 연결은 되는데 프록시가 실패한다면 먼저 로컬 수신과 커널 로그를 확인하세요. 도메인만 실패한다면 DNS 해석 경로를 이어서 확인합니다. 시스템 DNS는 네트워크 관리 서비스, 해석 서비스, 연결 설정에서 각각 관리될 수 있으므로 해결을 기대하며 해석 파일을 바로 덮어쓰지 마세요. 업데이트 전 사용자 설정을 백업하고 패키지 관리자 절차에 따라 프로그램을 교체한 다음 데스크톱 프록시, 백그라운드 서비스, 자동 시작을 차례로 확인하세요. 이전 서비스가 바뀐 프로그램 경로를 계속 가리키지 않도록 주의하세요.

Android: v2rayNG와 v2flyNG 설정

클라이언트를 먼저 선택하고 설치 파일 아키텍처 확인

Android에서는 Xray 커널을 사용하는 v2rayNG를 우선 권장합니다. V2Fly 커널과의 호환 경로가 필요하다면 v2flyNG를 검토하세요. 두 클라이언트가 시스템 네트워크를 동시에 제어하게 해서는 안 됩니다. 먼저 연결 정보에서 요구하는 프로토콜과 커널 기능을 확인하세요. Android 다운로드 영역에서 알맞은 파일을 선택합니다. 최신 주력 스마트폰은 대체로 arm64에 적합하지만 최종 기준은 실제 시스템 아키텍처입니다. 확실하지 않다면 범용 버전을 고려하고 프로세서의 홍보용 이름만으로 시스템 아키텍처를 판단하지 마세요.

설치 파일을 열면 시스템에서 현재 브라우저나 파일 관리자의 앱 설치를 허용하라고 요청할 수 있습니다. 이번에 사용할 출처에만 권한을 주고 설치 후 필요하다면 회수하세요. 설치할 수 없다면 시스템 요구 사항, 설치 파일 다운로드 완료 여부, 아키텍처 호환성, 서명이 다른 동명 앱의 설치 여부를 먼저 확인하세요. 업데이트가 실패했다고 기존 앱을 바로 삭제하지 마세요. 앱을 제거하면 앱 내부 데이터도 함께 삭제되는 경우가 많으므로 먼저 설정을 백업하세요.

구독, 공유 링크, 활성 설정

클라이언트의 구독 설정이나 그룹 관리에서 구독 이름과 전체 주소를 추가하고 저장한 뒤 메인 화면으로 돌아가 업데이트하세요. 화면에 따라 메뉴 이름은 조금 다를 수 있지만 순서는 출처를 저장하고, 내용을 가져온 뒤, 사용할 설정을 선택하는 것입니다. 단일 공유 링크는 해당 클립보드 가져오기 메뉴로 추가할 수 있습니다. QR 코드를 가져오기 전에 출처를 확인하고, 인증 정보가 든 코드를 공개 QR 인식 서비스에 올리지 마세요.

가져온 뒤 설정 상세 정보에서 프로토콜, 원격 주소, 포트, 전송 및 보안 매개변수를 확인하세요. 구독에서 가져온 항목은 보통 제공자가 관리하므로 로컬에서 수정해도 업데이트 후 사라질 수 있습니다. 임시로 문제를 확인해야 한다면 독립 설정으로 복사하고 변경 사항을 기록하세요. 대상 항목을 선택한 다음 연결을 눌러 이전에 선택한 설정을 잘못 사용하는 일을 방지하세요. 목록이 표시되고 연결 버튼을 누를 수 있다는 사실만으로 커널이 실제로 시작됐다고 볼 수는 없습니다.

VPN 권한 및 앱별 프록시

처음 연결할 때 Android에서 VPN 연결을 만들도록 시스템 권한을 요청합니다. 허용하면 클라이언트가 시스템 가상 네트워크 인터페이스를 통해 트래픽을 받을 수 있습니다. 여기서 VPN은 네트워크 트래픽을 제어하는 시스템 기능을 뜻하며 원격 서비스가 반드시 기존 VPN 프로토콜을 사용한다는 의미는 아닙니다. 연결 중 시스템 상태와 클라이언트 로그를 살펴 서비스가 시작 직후 종료되지 않았는지 확인하세요. 다른 VPN 앱이 연결되어 있다면 먼저 기존 연결을 끊고 테스트하세요.

앱별 프록시에서는 선택한 앱만 제어하거나 선택한 앱을 우회할 수 있습니다. 두 목록의 의미는 서로 반대입니다. 저장하기 전에 현재 모드를 확인하고 대상 앱 하나로 검증하세요. 목록에 앱 이름이 있다고 해서 그 앱이 반드시 프록시를 사용한다고 단정하지 마세요. 업무용 프로필 앱, 별도 사용자 공간, 일부 시스템 구성요소는 서로 다른 환경에 있을 수 있습니다. 관리 정책이 있다면 기기에 허용된 범위를 따르고 조직의 제한을 권한 전환을 반복해 우회하지 마세요.

라우팅 모드는 클라이언트로 들어온 트래픽의 출구를 결정하고, 앱별 프록시는 어떤 앱의 트래픽을 먼저 클라이언트로 보낼지 결정합니다. 둘은 서로 다른 단계입니다. 브라우저가 제외된 상태라면 전역 라우팅으로 바꿔도 자동으로 프록시에 들어오지 않습니다. 문제 해결 중에는 우선 제어 범위를 쉽게 이해할 수 있는 설정으로 바꾸고 라우팅을 확인하세요. 확인을 마친 뒤 앱별 분할을 단계적으로 복원해 의미가 불분명한 허용 목록과 우회 규칙을 동시에 관리하지 않도록 하세요.

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

화면을 끈 뒤 연결이 자주 끊기면 앱의 배터리 최적화, 백그라운드 실행, 제조사 절전 제한을 확인하세요. 연결을 계속 유지해야 하는 클라이언트에만 필요한 설정을 조정하고 화면 잠금과 해제 후 동작을 관찰하세요. 절전 기능을 전역으로 끌 필요는 없습니다. Wi-Fi와 모바일 네트워크를 전환하면 기존 연결을 다시 설정해야 할 수 있습니다. 휴대전화 자체의 인터넷 연결을 먼저 확인한 뒤 서버에 다시 연결하세요. 구독 업데이트와 연결 서비스는 별개로 판단해야 합니다. 백그라운드 업데이트 실패가 현재 서버를 사용할 수 없다는 뜻은 아닙니다.

v2rayNG와 v2flyNG 사이를 이전할 때는 같은 유효 구독을 다시 가져온 뒤 라우팅, DNS, 앱별 설정을 비교해 복원하세요. 한 클라이언트의 데이터 디렉터리를 다른 클라이언트에 그대로 덮어쓰지 마세요. 도움을 요청할 때는 민감 정보를 가린 로그, 시스템 환경, 실패 단계를 제공하고 구독, 인증 정보, 전체 QR 코드는 숨기세요. 프로토콜 선택은 4가지 프록시 프로토콜 비교를 참고하세요. 클라이언트 변경만으로 모든 원격 문제를 해결할 수는 없습니다.

구독 관리: 업데이트, 이전, 설정 백업

구독 출처와 서버 항목을 구분해 관리

구독 그룹에는 출처 주소와 업데이트 방식이 저장되고, 서버 목록에는 가져온 연결 정보가 저장됩니다. 둘은 별개입니다. 서버 하나를 삭제해도 구독 출처가 삭제되지 않을 수 있고, 다시 업데이트하면 해당 서버가 다시 나타날 수 있습니다. 용도나 출처별로 그룹을 만들고 업무, 테스트, 예비 등 실제 용도를 이름에 표시하세요. 그룹 이름에 전체 주소를 넣을 필요는 없습니다. 그룹을 명확히 구분해 두면 업데이트 실패 시 해당 출처를 찾기 쉽습니다.

구독을 처음 가져올 때 링크를 붙여 넣은 뒤 앞뒤 공백, 줄바꿈, 잘린 부분이 없는지 확인하세요. 메신저가 긴 링크를 접어서 표시할 수 있어 보이는 텍스트를 복사해도 전체 주소가 복사되지 않을 수 있습니다. 구독 내용이 제공자가 지정한 형식이나 클라이언트 지원 범위를 요구할 수도 있습니다. 목록이 비어 있다면 반환된 내용이 설정인지 로그인 페이지인지 오류 안내인지 먼저 확인하고 같은 가져오기를 반복하지 마세요. 주소가 만료됐다면 제공자에게 새 주소를 요청하세요. 무작위로 문자를 바꿔 복구하려 하지 마세요.

업데이트 경로와 자동 업데이트 간격 선택

'프록시 없이 구독 업데이트'는 현재 네트워크에서 출처에 직접 접속할 수 있을 때 적합하며, 사용 가능한 연결이 구독에 의존하고 구독 업데이트가 다시 해당 연결에 의존하는 순환도 피할 수 있습니다. 프록시를 통한 업데이트는 프록시가 이미 작동 중이어야 합니다. 두 방식의 차이는 요청 경로이지 구독 내용의 형식이 아닙니다. 문제를 확인할 때 두 방식을 각각 한 번씩 시험하고 오류를 살펴본 뒤 사용할 방법을 정하세요. 쓸 수 있는 서버가 전혀 없는데 프록시를 통한 업데이트만 반복하지 마세요.

자동 업데이트 간격은 출처 변경 빈도, 사용 습관, 요청 제한을 고려해 정하세요. 자주 바뀌지 않는 출처를 지나치게 자주 가져올 필요는 없습니다. 모바일 기기에서는 데이터 사용량과 백그라운드 실행 제한도 고려하세요. 화면에 분 단위로 표시된다면 실제 단위에 맞춰 입력하고 시간을 분으로 착각하지 마세요. 간격을 설정한 뒤 먼저 수동 업데이트에 성공하고 자동 업데이트가 한 번 실행될 때까지 기다리세요. 기기가 절전 중이거나 앱이 시스템에 의해 중지됐거나 네트워크가 제한되면 자동 작업은 늦어질 수 있으며 정해진 시각에 정확히 실행된다는 보장은 없습니다.

구독 업데이트로 철회된 항목이 삭제되거나 출처에서 관리하는 일부 매개변수가 덮어써질 수 있습니다. 유지할 임시 설정은 별도 그룹에 복사한 뒤 별칭, 라우팅 연결, 전송 설정을 수정하세요. 서버 목록의 행 번호를 오래 쓸 식별자로 삼지 마세요. 업데이트 후 순서가 바뀔 수 있습니다. 자동 선택이나 그룹 정책을 사용한다면 업데이트 뒤 활성 서버가 여전히 적절한지 확인하고 일반 접속과 라우팅 동작도 검증하세요. 업데이트 성공 메시지만 보고 점검을 끝내지 마세요.

백업 범위와 민감 정보 처리

백업에는 최소한 구독 출처, 독립 설정, 사용자 지정 라우팅, DNS, 수신 포트, 앱별 설정이 포함되어야 합니다. 우선 클라이언트가 제공하는 내보내기 또는 백업 기능을 사용하세요. 데이터 파일을 복사해야 한다면 클라이언트를 완전히 종료하고 파일 위치가 현재 실행 인스턴스와 일치하는지 확인하세요. 프로그램 파일만 복사하면 사용자 설정을 저장할 수 없는 경우가 많습니다. 반대로 사용자 데이터를 통째로 복사하면 다른 기기에서 사용할 수 없는 경로, 서비스 상태, 인터페이스 이름까지 따라올 수 있습니다.

플랫폼 간 이전에는 구독 링크와 범용 공유 형식을 우선 사용하고, 시스템 프록시, TUN 서비스, 프로그램 경로는 대상 기기에서 다시 설정하세요. 설정을 가져올 수 있다고 해서 다른 커널이 모든 확장 필드를 지원하는 것은 아닙니다. 먼저 기본 연결을 복원해 확인한 다음 라우팅과 DNS를 복원하세요. 원본 기기에 사용자 지정 규칙이 많다면 전체 설정을 덮어쓰기보다 변경 내역을 글로 남기는 편이 플랫폼 차이와 비호환 필드를 찾기 쉽습니다.

구독을 바꾼 뒤에는 이전 출처의 자동 업데이트를 중지하고 더 이상 필요하지 않은 항목을 정리하세요. 링크가 공개된 적이 있다면 로컬 기록을 삭제하는 것만으로 다른 사람의 접근을 취소할 수 없습니다. 출처 측에서 링크를 교체하거나 철회해야 합니다. 업데이트 오류는 구독 업데이트 실패 및 간격 설정을 참고해 네트워크 경로, 시간, 인증서, 응답 내용을 확인하세요. 먼저 실패 지점을 찾은 뒤 다시 가져오기를 검토하세요.

라우팅 및 DNS: 트래픽 제어 이후의 출구 결정

시스템 프록시, TUN, 라우팅 모드 구분

시스템 프록시와 TUN은 트래픽을 클라이언트로 보내고, 라우팅 규칙은 들어온 트래픽이 어디로 나갈지 정합니다. 전역 라우팅을 선택하면 일반적으로 이미 제어된 트래픽을 지정한 프록시 출구로 보낸다는 뜻이지 모든 앱의 트래픽을 자동으로 가져온다는 뜻은 아닙니다. 중국 본토 우회 등 분할 라우팅 모드에서는 도메인, 주소, 규칙 세트에 따라 직접 연결과 프록시를 결정합니다. 앱이 예상한 경로로 연결되지 않는다면 먼저 클라이언트에 진입했는지 확인한 다음 어떤 규칙과 일치했는지 살펴보세요.

대부분의 라우팅 시스템은 규칙을 순서대로 확인하므로 앞의 포괄적인 규칙이 뒤의 세부 규칙을 가릴 수 있습니다. 규칙을 수정할 때는 도메인, 앱, 대상 범위를 구체적으로 지정한 규칙을 먼저 두고 마지막에 기본 정책을 배치하세요. 사용 중인 커널이 해당 필드를 실제로 지원하는지도 확인해야 합니다. 서로 다른 커널의 설정 문법을 섞지 마세요. 클라이언트의 기본 라우팅은 기준 설정으로 활용할 수 있습니다. 사용자 지정 전에 기존 설정을 내보내고 추가한 규칙의 위치와 목적을 기록해 복구하기 쉽게 하세요.

실제 규칙 조각의 맥락 이해하기

아래는 Xray/V2Ray 형식의 라우팅 객체에서 도메인과 일치하는 트래픽을 direct라는 아웃바운드로 보내는 규칙 조각입니다. 전체 클라이언트 설정이 아니므로 해당 routing.rules 안에 넣어야 하며, 같은 이름의 아웃바운드와 사용할 수 있는 도메인 규칙 데이터가 이미 있어야 합니다. GUI 클라이언트에 규칙 편집기가 있다면 우선 해당 인터페이스를 사용하세요. 이 조각으로 실행 설정 전체를 덮어쓰거나 모든 커널에서 같은 필드를 사용한다고 가정하지 마세요.

{
  "type": "field",
  "domain": [
    "geosite:cn"
  ],
  "outboundTag": "direct"
}

type은 규칙 유형, domain은 도메인 일치 조건, outboundTag는 아웃바운드 태그를 지정합니다. 태그는 설정 내부에서 참조하는 값이므로 기존 아웃바운드의 표기와 정확히 일치해야 합니다. 규칙 데이터 누락, 존재하지 않는 태그, 앞선 규칙에 가려지는 상황은 모두 예상한 동작이 나타나지 않는 원인이 될 수 있습니다. 변경한 뒤에는 커널이 설정을 받아들였는지 확인하고 대상 요청의 일치 로그를 살펴보세요. 저장 버튼이 성공했다는 것만으로 규칙이 유효하다고 판단하지 마세요.

DNS 해석 경로와 도메인 일치

DNS는 도메인을 주소로 변환하지만 프록시 연결에는 앱, 운영체제, 커널 각각의 이름 해석 동작도 관여합니다. 브라우저가 자체 암호화 DNS를 사용하거나 운영체제가 이전 결과를 캐시할 수 있습니다. 클라이언트에서 원격 DNS를 설정했더라도 클라이언트에 진입하지 않은 요청은 다른 해석기를 사용할 수 있습니다. 문제를 확인하기 전에 누가 조회를 시작하고 어떤 출구로 요청을 보내며 어떤 구성요소가 결과를 연결에 사용하는지 경로를 정리하세요. DNS 주소 하나만 바꿔서는 모든 해석 문제가 해결되지 않는 경우가 많습니다.

직접 연결 DNS와 원격 DNS는 라우팅 설계에 맞게 구성해야 합니다. 직접 연결할 도메인에는 도달 가능한 해석 경로가 필요하고, 프록시를 사용할 대상도 아직 연결되지 않은 프록시에 DNS 요청이 의존하지 않도록 해야 합니다. DoH는 암호화된 방식으로 DNS 요청을 전송하지만 서비스 주소 자체에 접속할 수 있어야 하며, 초기 해석이 필요할 수 있습니다. DoH 사용만으로 결과가 반드시 올바르다고 간주하지 말고 시간 초과, 인증서, 반환 결과를 함께 확인하세요.

FakeDNS는 합성 주소를 사용해 커널이 도메인 정보를 보존하도록 돕습니다. 특정 트래픽 제어 방식에 유용하지만 주소 매핑, 라우팅, DNS 흐름이 함께 작동해야 합니다. 앱이 합성 주소를 받은 뒤 커널을 우회해 접속하면 연결이 실패할 수 있습니다. 일반 시스템 프록시로 충분하다면 모든 기능을 갖추기 위해 굳이 활성화하지 마세요. 테스트 전에 현재 DNS 설정을 저장하고 커널 지원과 제어 범위를 확인한 뒤 직접 연결 앱, LAN 서비스, 종료 후 복구를 점검하세요.

분할 라우팅을 검증하려면 직접 연결할 대상 하나와 프록시를 사용할 대상 하나를 확인하고 로그에서 출구를 살펴보세요. 캐시가 방해한다면 앱이나 시스템에서 제공하는 방법으로 캐시를 갱신하고 연결을 다시 연 뒤 테스트하세요. 모든 네트워크 설정을 한꺼번에 초기화하지 마세요. 각 필드의 역할과 DNS 구성은 v2rayN DNS 분할 해석 안내를 참고하세요. 규칙은 단순하고 이해하기 쉽게 유지한 뒤 세부 정책을 단계적으로 추가하세요.

자주 발생하는 설정 문제: 실패 단계별 확인

시작 실패와 연결 실패를 구분해 해결

먼저 실패 단계가 프로그램 실행, 커널 시작, 로컬 포트 연결, 원격 연결, 웹페이지 열기 중 어디인지 파악하세요. 프로그램이 시작되지 않으면 아키텍처, 시스템 요구 사항, 실행 의존성, 설정 디렉터리 권한을 확인하세요. 커널 시작 오류가 나면 설정 해석, 실행 구성요소, 포트 바인딩을 먼저 살펴보고 구독부터 바꾸지 마세요. 로컬에서 정상적으로 실행된 뒤에야 원격 시간 초과와 인증 문제가 주요 점검 대상이 됩니다.

로그를 열고 실패 동작을 다시 한 번 실행한 다음 인접한 오류 몇 개와 시간 순서를 기록하세요. 시간 초과 한 줄만으로 근본 원인을 단정할 수 없습니다. 그 전에 DNS 실패, 연결 거부, 지원되지 않는 설정이 있었는지 확인하세요. 로그를 공유하기 전에 주소, 인증 정보, 구독 내용을 가리되 오류 유형, 프로토콜 이름, 호출 순서는 남기세요. 자격 증명이 포함된 설정 전체를 공개하면 문제 해결에도 도움이 되지 않고 정보 노출 위험만 커집니다.

연결 시간 초과, 인증, 전송 매개변수

원격 연결이 시간 초과되면 먼저 현재 네트워크와 시스템 시간이 정상인지 확인하고 주소와 포트를 잘못 복사하지 않았는지 살펴보세요. 모든 설정이 동시에 실패한다면 로컬 네트워크, 커널 시작, 트래픽 제어 방식을 먼저 확인하세요. 특정 항목만 실패한다면 해당 서버의 유효 상태와 매개변수를 점검합니다. 속도 테스트 결과는 방법과 대상에 따라 달라집니다. 테스트 하나의 실패가 모든 실제 트래픽의 실패를 뜻하지는 않으므로 실제 접속도 확인하세요.

인증에 실패하면 프로토콜에서 요구하는 식별자나 비밀번호를 확인해야 합니다. TLS 오류는 서버 이름, 인증서 체인, 시스템 시간, 전송 매개변수도 점검해야 합니다. 연결 주소와 검증에 사용하는 서버 이름은 다를 수 있으므로 필드를 줄이려고 임의로 비우지 마세요. 전송 경로, Host, 기타 확장 매개변수도 서버 설정과 일치해야 합니다. 인증서 검증을 건너뛰어 설정 오류를 숨기지 말고 정보가 만료됐는지, 서버 이름을 잘못 입력했는지 먼저 확인하세요.

커널을 바꾼 뒤 문제가 생겼다면 해당 커널이 프로토콜과 확장 기능을 지원하는지, 구독 변환 중 필드가 누락되지 않았는지 확인하세요. Xray와 V2Fly의 모든 기능을 서로 바꿔 쓸 수는 없습니다. 이전에 작동하던 커널과 기본 설정으로 돌아간 다음 차이를 단계별로 확인하세요. 원격 문제의 더 자세한 점검 순서는 노드 시간 초과 및 연결 실패 해결 순서를 참고하세요. 잘못된 매개변수는 그대로 둔 채 클라이언트만 계속 바꾸지 마세요.

자주 묻는 질문: 네트워크 복구와 문제 범위 좁히기

마지막으로 이해하기 쉬운 설정 상태로 복구

문제 해결을 마치면 임시 테스트 항목을 삭제하고 필요한 자동 시작 및 분할 라우팅 규칙을 복구한 뒤 클라이언트 종료 후 일반 네트워크도 확인하세요. 검증을 마친 설정을 백업하고 운영체제, 아키텍처, 프록시 모드, 주요 변경 사항을 함께 기록하세요. 다음에 문제가 생기면 처음부터 재설치하기보다 최근 변경 사항부터 비교하세요. 전체 설정 절차는 빠른 시작 가이드를 참고하고, 플랫폼에 맞는 설치 파일이 필요하면 다운로드 페이지에서 확인하세요.