01 · 공통 준비
설치 전 확인: 기기, 구독, 트래픽 진입점
클라이언트를 정한 뒤 설치 패키지를 선택하세요
데스크톱에서는 v2rayN을 우선 고려하세요. Windows에서는 데스크톱 버전과 클래식 WPF 버전을 구분하고 시스템 아키텍처도 확인해야 합니다. macOS는 Apple Silicon인지 Intel인지 확인하고, Linux는 배포판에서 지원하는 패키지 형식과 프로세서 아키텍처를 살펴보세요. Android에서는 Xray 코어를 사용하는 v2rayNG를 우선 권장합니다. 기존 설정에서 V2Fly 코어를 명시적으로 요구하는 경우에만 v2flyNG를 고려하세요. 클라이언트는 화면과 설정을 관리하고, 코어는 실제 연결을 처리합니다. 둘은 같은 것이 아닙니다. 데스크톱에서 코어를 선택할 수 있더라도 코어를 바꾸면 기존 전송 및 보안 설정이 그대로 작동한다고 단정할 수 없습니다.
압축 파일 이름만 보고 시스템 아키텍처를 추측하지 말고, 다른 기기의 다운로드 기록을 이 기기의 확인 절차 대신 사용하지 마세요. 같은 구독을 컴퓨터와 휴대폰에 각각 가져올 수 있지만, 컴퓨터의 시스템 프록시 주소는 해당 컴퓨터의 주소이므로 휴대폰에 그대로 복사할 수 없습니다. 각 기기에서 클라이언트 이름, 시스템 아키텍처, 사용할 트래픽 처리 방식을 먼저 기록하세요. 조직에서 관리하는 기기라면 소프트웨어 설치, 가상 네트워크 인터페이스 생성, 프록시 변경이 허용되는지도 미리 확인하세요. 권한을 높여 정책을 우회해서는 안 됩니다.
| 플랫폼 | 패키지 선택 기준 | 트래픽 처리 테스트 시작점 |
|---|---|---|
| Windows | 시스템 아키텍처, 데스크톱 버전 또는 클래식 WPF 버전 | 먼저 시스템 프록시를 따르는 브라우저로 확인 |
| macOS | Apple Silicon 또는 Intel | 현재 네트워크 서비스의 프록시 설정 확인 |
| Linux | 배포판, deb 또는 rpm, 프로세서 아키텍처 | 먼저 앱 하나에 로컬 프록시 지정 |
| Android | 앱에서 지원하는 아키텍처와 코어 요구 사항 | 시스템 VPN을 허용한 뒤 앱별 연결 범위 확인 |
구독 주소와 단일 공유 링크 구분하기
구독 주소를 등록하면 클라이언트가 원격 서버에서 여러 항목을 가져옵니다. 보통 구독을 저장한 뒤 직접 업데이트를 실행하는 두 단계가 필요합니다. 그룹이 표시된다는 것은 주소가 저장됐다는 뜻일 뿐, 노드까지 가져왔다는 의미는 아닙니다. vmess:// 또는 vless://로 시작하는 문자열은 대개 단일 공유 링크이므로 클립보드나 공유 링크 가져오기를 사용하세요. 구독 주소 입력란에 넣으면 안 됩니다. 반대로 구독 주소를 수동 설정의 서버 호스트 이름으로 입력해도 연결 가능한 노드가 되지 않습니다. QR 코드로 가져오기 전에도 코드에 어떤 종류의 정보가 담겼는지 확인하세요.
제공된 주소가 계정 관리 페이지, 결제 페이지 또는 브라우저 로그인 세션이 있어야 열리는 페이지가 아니라 V2Ray 클라이언트에서 읽을 수 있는 설정인지 확인하세요. 구독 업데이트와 노드 연결은 서로 다른 요청 경로입니다. 업데이트 성공은 클라이언트가 목록을 가져왔다는 뜻이고, 노드 연결에는 서버, 전송 방식, 보안 설정도 영향을 줍니다. 구독 그룹 이름에는 용도와 출처를 함께 적고, 처음에는 항목 하나만 선택해 테스트하세요. 정상 작동이 확인된 설정도 하나 남겨 비교 기준으로 삼으세요. 문제를 확인할 때 기존 그룹부터 삭제하지 마세요. 업데이트로 현재 항목이 바뀔 수 있고, 임시로 수정한 설정이 유지되지 않을 수도 있습니다.
기준 상태를 기록한 뒤 TUN 사용 여부를 결정하세요
클라이언트가 아직 트래픽을 처리하지 않을 때 평소 직접 접속되는 사이트에 연결되는지 먼저 확인하세요. 현재 네트워크, 다른 프록시 앱, 조직 VPN, 사용자 지정 DNS 설정도 기록합니다. 공용 네트워크에 로그인 페이지가 있다면 기존 네트워크 인증을 먼저 완료하세요. 이후 프록시를 켠 뒤 원래 접속되던 사이트까지 열리지 않을 경우 비교할 기준이 생깁니다. 데스크톱에서는 클라이언트에 표시된 실제 수신 주소, 포트, 프로토콜도 적어 두세요. 같은 로컬 포트라도 HTTP와 SOCKS는 서로 바꿔 쓸 수 없습니다.
처음 설정할 때는 트래픽 처리 방식을 하나만 켜세요. 시스템 프록시는 해당 설정을 따르는 앱에 진입점을 제공하고, TUN은 가상 인터페이스와 라우팅을 통해 더 많은 트래픽을 처리합니다. TUN은 권한, DNS 동작, 다른 네트워크 도구와의 충돌을 더 세심하게 확인해야 합니다. 브라우저만 확인한다면 먼저 시스템 프록시나 브라우저 자체의 프록시 설정을 사용하세요. 노드 하나와 앱 하나가 정상 작동하는 것을 확인한 다음 시스템 프록시를 따르지 않는 프로그램을 살펴보세요. 그러면 노드 연결 자체의 문제인지, 처리 범위를 바꾼 뒤 생긴 문제인지 구분하기 쉽습니다.
02 · 데스크톱 클라이언트
Windows: v2rayN 설치, 시스템 프록시 및 TUN 설정
데스크톱 버전과 클래식 WPF 버전 선택
Windows의 「설정 → 시스템 → 정보」에서 시스템 종류를 확인한 다음 Windows 다운로드에서 설치 패키지를 확인하세요. 이 페이지의 다운로드 센터에 있는 두 패키지는 모두 x64입니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하며 처음 설정한다면 우선 선택할 수 있습니다. 클래식 인터페이스, 이전 화면을 사용하는 안내서 또는 기존 사용 방식에 익숙하다면 WPF 버전을 선택하세요. 두 버전은 함께 설치해야 하는 구성 요소가 아니며, 처음 설정할 때 둘을 동시에 실행하는 것도 권장하지 않습니다. 포트가 충돌하거나 한 클라이언트를 종료할 때 다른 클라이언트가 설정한 시스템 프록시까지 지워질 수 있습니다.
압축 파일을 받았다면 먼저 현재 사용자에게 쓰기 권한이 있고 쉽게 찾을 수 있는 폴더에 전체 압축을 푼 뒤, 압축 해제된 폴더에서 실행하세요. 압축 프로그램의 미리보기에서 실행 파일을 더블 클릭하거나 주 프로그램 파일만 꺼내 실행하지 마세요. 설치 프로그램을 받은 경우에는 설치 프로그램의 안내를 따르고 압축 해제 버전의 폴더 이동 방법을 적용하지 마세요. 시작할 때 실행 환경이 필요하다는 메시지가 표시되면 팝업에 적힌 구성 요소 종류, 아키텍처, 현재 버전 안내를 확인한 뒤 해당 구성 요소 제공처에서 필요한 실행 환경을 받으세요. 보안 소프트웨어가 차단하거나 조직 정책이 제한한다면 알림 내용을 확인하고 보호 기능을 전체적으로 끄지 마세요. 패키지 선택은 Windows 데스크톱 버전과 WPF 버전 설치 참고 사항을 확인하세요.
구독을 가져온 뒤 코어가 실제로 실행되는지 확인
구독 그룹 설정에서 항목을 추가하고 구독 주소와 메모를 입력해 저장한 뒤 해당 그룹을 업데이트하세요. 화면에 직접 연결 업데이트와 프록시를 통한 업데이트가 함께 표시된다면, 사용할 수 있는 프록시가 없는 첫 설정에서는 직접 연결을 먼저 시도하세요. 구독 출처가 기존 프록시를 명시적으로 요구하고 사용 가능한 설정이 이미 있을 때만 프록시를 통한 업데이트를 시험하세요. 항목이 표시되면 하나를 선택해 활성 서버로 지정하고 코어 상태와 로그를 확인하세요. 목록에서 강조 표시된다고 코어가 정상적으로 수신 대기 중인 것은 아닙니다. 특히 오래된 클라이언트나 개발 도구가 같은 포트를 사용하고 있는지 확인하세요.
단일 링크만 있다면 클립보드 가져오기를 사용하세요. 가져온 뒤 출처의 안내와 프로토콜, 주소, 포트, 전송 방식, 보안 설정이 일치하는지 확인하세요. 클라이언트의 로컬 수신 포트를 원격 서버 포트로 입력하면 안 됩니다. 데스크톱 버전과 WPF 버전은 메뉴 위치가 다를 수 있습니다. 해당 메뉴를 찾지 못했다면 이전 안내서 화면의 위치를 무작정 누르지 말고 「구독 그룹」, 「활성 서버」, 「시스템 프록시」처럼 기능 이름을 찾아보세요. 코어 설정 생성에 실패했다면 노드를 반복해서 바꾸기보다 로그의 첫 번째 구체적인 오류부터 해결하세요.
먼저 시스템 프록시를 확인하고, 프록시 적용이 필요한 앱은 그다음에 살펴보세요
v2rayN의 시스템 프록시를 켠 뒤 Windows의 「설정 → 네트워크 및 인터넷 → 프록시」에서 실제 상태를 확인하세요. 시스템 프록시를 따르며 프록시 확장 프로그램이 별도로 제어하지 않는 브라우저로 테스트합니다. 시스템 프록시가 현재 클라이언트를 가리키는데 코어가 수신 대기 중이지 않으면 브라우저는 보통 로컬 연결 오류를 표시합니다. 브라우저는 되지만 터미널이 안 된다고 해서 연결 경로가 불안정하다고 단정할 수는 없습니다. 터미널 도구는 자체 설정이나 환경 변수를 사용할 수 있고, 다른 계정으로 실행되는 서비스도 있습니다. 브라우저와 터미널을 따로 점검하는 방법을 참고해 각각의 진입점을 확인하세요.
시스템 프록시를 따르지 않는 앱까지 처리해야 한다면 다른 프록시나 가상 네트워크 어댑터 도구를 종료한 뒤 TUN을 따로 시험하세요. 클라이언트 안내에 따라 권한과 드라이버 상태를 확인하고, 활성화 전후로 평소 이용하는 사이트, 대상 앱, 로컬 네트워크 리소스를 테스트하세요. 켠 뒤 회사 인트라넷이나 공유 기기에 연결할 수 없다면 기존 모드로 돌아가 TUN이 내부 네트워크 대역, 도메인 조회, 기본 경로를 처리하고 있는지 확인하세요. GUI의 권한을 높이는 것은 모든 네트워크 오류를 해결하는 방법이 아닙니다. 노드 핸드셰이크 실패나 포트 충돌은 권한을 높인다고 해결되지 않습니다.
03 · 데스크톱 클라이언트
macOS: 칩에 맞는 v2rayN 설치 및 네트워크 서비스 확인
시스템 정보를 확인해 올바른 디스크 이미지 선택
Apple 메뉴에서 「이 Mac에 관하여」를 여세요. Apple 칩이 표시되는 기기는 macOS 다운로드에서 Apple Silicon 패키지를, Intel 프로세서가 표시되는 기기는 Intel 패키지를 선택하세요. 터미널 프로세스가 보고하는 아키텍처만으로 판단하지 마세요. 터미널이 변환 환경에서 실행 중이라면 확인하려는 기기의 아키텍처와 다른 결과가 나올 수 있습니다. 디스크 이미지를 열고 이미지 안의 안내에 따라 설치하세요. 일반적으로 앱을 「응용 프로그램」 폴더로 드래그한 뒤 그곳에서 실행합니다. 마운트된 볼륨 안의 사본을 매번 열지 마세요.
처음 실행할 때 권한이나 시스템 보안 알림이 표시되면 앱 이름, 다운로드 출처, 시스템 정보를 먼저 확인하세요. 손상, 악성 소프트웨어, 조직 정책 제한과 관련된 알림이라면 내용에 따라 점검하고 실행을 위해 시스템 보호 기능을 전체적으로 끄지 마세요. 업데이트 후에는 다운로드 폴더나 디스크 이미지에 남아 있는 이전 사본이 아니라 새로 설치한 앱을 실행하는지 확인하세요. 앱이 갑자기 종료되면 구독이나 노드를 살펴보기 전에 인터페이스가 안정적으로 열리는지부터 확인하세요. 화면조차 열리지 않는 상황에서는 라우팅 규칙을 바꿔도 도움이 되지 않습니다. 데스크톱 첫 설치 체크리스트에서 시작 단계의 문제를 구분하는 방법을 확인하세요.
구독을 가져오고 테스트 범위를 최소화하세요
구독 관리에서 그룹을 만들고 업데이트한 다음 서버 하나를 현재 항목으로 선택해 코어가 실행되는지 확인하세요. 클립보드로 가져오기 전에는 채팅 앱에서 안내 문구와 링크를 함께 복사하지 않았는지 확인하세요. 양쪽 끝의 불필요한 공백만 제거하고 주소의 경로, 쿼리 매개변수, 이스케이프 문자는 직접 수정하지 마세요. 웹에서 로그인은 되지만 클라이언트 업데이트에 실패한다면 클라이언트용 구독 주소를 가져왔는지 확인하세요. 브라우저에서 관리 페이지가 열린다고 같은 링크를 구독 API에서 사용할 수 있다는 뜻은 아닙니다.
첫 테스트는 이 설정 그룹 하나만 사용하고 다른 컴퓨터의 앱 데이터를 통째로 옮기지 마세요. 이전 설정에는 더 이상 존재하지 않는 코어 경로, 수신 포트, 분할 라우팅 파일이 포함될 수 있습니다. 구독 이전과 앱 설정 이전을 따로 진행하세요. 새 기기에서 기존 구독을 가져와 노드가 작동하는지 확인한 뒤 실제로 필요한 규칙만 하나씩 복원합니다. 변경 전 값을 기록해 두면 새 규칙으로 특정 도메인에 문제가 생겼을 때 처음부터 다시 설치하는 대신 정상 작동하던 설정으로 돌아갈 수 있습니다.
현재 네트워크 서비스, 앱 프록시, TUN을 구분하세요
시스템 프록시를 켠 뒤 「시스템 설정 → 네트워크」에서 현재 사용하는 네트워크 서비스를 선택하고 상세 정보의 프록시 페이지를 여세요. 시스템 버전에 따라 메뉴 이름이 조금 다를 수 있습니다. 현재 Wi-Fi와 유선 서비스 중 무엇을 쓰는지, 활성화된 프록시 유형과 주소, 포트가 클라이언트 설정과 일치하는지 확인하세요. 네트워크 서비스를 바꾼 뒤에는 다시 확인해야 합니다. 유선 연결에서 적용되던 설정이 Wi-Fi로 전환해도 예상대로 적용된다는 보장은 없습니다. 자동 설정 스크립트나 다른 관리 도구가 설정을 되돌리는지도 살펴보세요.
터미널에서 시스템이 현재 보고하는 프록시 설정을 확인할 수 있습니다. 아래 명령은 정보를 읽기만 하며 설정을 변경하지 않습니다. 출력에 표시된 활성화 여부, 프록시 호스트, 포트를 화면의 설정과 함께 확인하세요. 시스템 프록시가 활성화됐다고 표시되어도 시스템 설정이 존재한다는 뜻일 뿐, 특정 명령줄 도구가 해당 설정을 읽는다는 뜻은 아닙니다. 브라우저와 터미널의 동작이 다르면 터미널 도구 자체의 네트워크 옵션부터 확인하세요. 앱에 프록시를 직접 지정했다면 그 결과만으로 시스템 프록시가 작동하는지 판단하면 안 됩니다.
scutil --proxy
TUN을 사용하려면 현재 버전에서 해당 옵션을 제공하는지 확인하고 클라이언트 안내에 따라 필요한 권한을 설정하세요. 코어와 노드를 확인하기도 전에 시스템 프록시, 라우팅 규칙, DNS를 한꺼번에 바꾸지 마세요. Wi-Fi 전환, 절전 모드 해제, 도킹 스테이션에서 유선 케이블 분리 후 연결이 끊긴다면 시스템이 먼저 네트워크에 다시 연결됐는지 확인한 다음 「추가 트래픽 처리 끄기, 코어 재확인, TUN 다시 켜기」 순으로 점검하세요. 회사 사이트나 로컬 기기만 영향을 받는다면 정상 작동이 확인된 트래픽 처리 방식으로 돌아간 뒤 내부 네트워크에 필요한 라우팅과 이름 확인 조건을 살펴보세요.
04 · 데스크톱 클라이언트
Linux: v2rayN 설치, 데스크톱 프록시 및 가상 인터페이스 설정
배포판과 프로세서 아키텍처부터 확인하세요
Linux 다운로드에서 v2rayN을 선택하세요. 일반적으로 Debian, Ubuntu 및 해당 파생 배포판은 deb를, Fedora 등 RPM을 사용하는 배포판은 rpm을 선택합니다. 패키지 형식뿐 아니라 아키텍처도 확인하세요. 명령 출력의 x86_64는 x64에 해당하고 aarch64는 arm64에 해당합니다. 일부 시스템 도구에서는 같은 x64 아키텍처를 amd64로 표시합니다. 배포판이 해당 패키지의 대상 환경이 아니라면 확장자 이름을 바꾸거나 강제로 설치해 의존성 문제를 해결하려 하지 말고 배포판 호환성부터 확인하세요.
uname -m
cat /etc/os-release
데스크톱 환경에서는 소프트웨어 설치 프로그램으로 해당 패키지를 열 수 있습니다. 명령줄을 선호한다면 다운로드 폴더의 실제 파일을 선택해 의존성을 처리할 수 있는 배포판 기본 패키지 관리자를 사용하세요. 설치에 실패하면 아키텍처 미지원, 의존성 누락, 소프트웨어 저장소 사용 불가 중 무엇이 원인인지 메시지를 확인하세요. 시스템 라이브러리에 같은 이름의 링크를 임의로 만들거나 GUI를 계속 관리자 계정으로 실행하지 마세요. 앱이 다른 계정에 설정과 캐시를 저장하면 일반 사용자로 실행했을 때 새로 설치한 것처럼 보일 수 있고 권한 문제와 클라이언트 문제를 혼동하게 됩니다.
구독을 가져온 뒤 앱 하나로 연결을 확인하세요
현재 데스크톱 세션의 일반 사용자로 v2rayN을 실행하고 구독 그룹을 추가해 업데이트한 다음 활성 서버를 선택하세요. 코어가 실행되면 실제 수신 포트를 기록합니다. 브라우저에서 자체 프록시 설정을 사용할 수 있다면 우선 해당 브라우저에만 프록시를 지정하세요. 데스크톱 환경에서 시스템 프록시를 적용하지 않아도 별도로 비교 테스트를 할 수 있습니다. 같은 포트를 이전 프로세스, 컨테이너, 개발 프로그램이 사용하고 있다면 먼저 수신 프로세스를 확인하세요. 이전 프로세스를 종료하거나 사용 중이지 않은 포트로 바꾼 뒤 테스트 앱의 포트도 함께 변경합니다.
일반적인 Linux 데스크톱 환경에서는 데스크톱 프록시 설정과 명령줄 프로그램의 트래픽 처리 방식이 일치한다고 보장할 수 없습니다. 데스크톱 앱은 GNOME이나 KDE의 네트워크 프록시를 따를 수도 있고 자체 프록시를 관리할 수도 있습니다. 터미널에서 실행한 프로그램은 자체 설정이나 환경 변수에 따라 동작합니다. 임시로 확인할 때는 전역 환경 파일에 프록시 변수를 바로 추가하지 말고 명령 한 번에 적용하는 옵션이나 앱 하나의 설정을 우선 사용하세요. 전역 프록시를 오래 유지하면 나중에 실행한 패키지 관리자, 빌드 프로세스, 백그라운드 작업이 클라이언트를 종료한 뒤에도 닫힌 포트에 연결을 시도할 수 있습니다.
TUN, 라우팅, 이름 확인 차이 점검
앱 프록시를 따르지 않는 트래픽도 클라이언트로 보내려면 설치된 버전에서 TUN을 지원하는지, 현재 환경에서 가상 인터페이스 생성이 허용되는지 확인하세요. 기기를 사용할 수 없거나 세션 권한이 부족한 경우, 가상 머신이나 컨테이너에 필요한 네트워크 권한이 없는 경우 등이 흔한 제약입니다. 이런 메시지는 인터페이스가 만들어지지 않았다는 뜻이지 구독을 바꾸면 해결된다는 뜻이 아닙니다. 먼저 일반 앱 프록시가 작동하는지 다시 확인한 뒤 오류와 배포판 문서에 따라 원인을 찾으세요. 다른 사람이 관리하는 환경이라면 관리자에게 권한 범위를 확인하고 모든 사용자에게 기기 접근 권한을 열어 주지 마세요.
활성화 전후에 현재 세션에서 보이는 인터페이스와 IPv4 라우팅을 비교할 수 있습니다. 아래 명령은 읽기 전용입니다. 기본 경로가 바뀌지 않았다고 TUN이 작동하지 않는 것은 아닙니다. 클라이언트가 정책 라우팅을 사용할 수도 있습니다. 문제를 확인할 때는 출력, 클라이언트 로그, 요청이 실제로 코어에 들어왔는지를 함께 살펴보세요. 원격 세션이 유일한 관리 경로라면 복구 방법을 마련하지 않은 상태에서 트래픽 처리 설정을 바꾸지 마세요. 라우팅을 변경한 뒤 연결이 끊길 수 있습니다.
ip -brief address
ip -4 route show
ip -4 rule show
특정 도메인만 실패하고 다른 요청은 정상이라면 TUN에서만 발생하는지, 앱과 시스템의 이름 확인 결과가 다른지 먼저 확인하세요. 예를 들어 브라우저가 자체 암호화 DNS를 사용한다면 시스템 조회 결과만으로 해당 브라우저의 동작을 판단할 수 없습니다. 작동하는 앱 프록시 모드로 돌아가 비교하고, DNS 리졸버, 라우팅 테이블, 방화벽을 한꺼번에 바꾸지 마세요. 앱 요청이 코어에 들어오지 않는다면 진입점을 확인하고, 요청은 들어왔지만 잘못된 아웃바운드로 전달된다면 분할 라우팅 규칙과 도메인 이름 확인을 살펴보세요.
05 · 모바일 클라이언트
Android: v2rayNG 설치, 구독 가져오기 및 VPN 허용
설치 아키텍처와 사용할 코어 확인
Android 다운로드에서 Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. 비교적 최신 휴대폰은 대개 arm64를 선택할 수 있지만, 설치 가능 여부는 기기 시스템에서 해당 아키텍처를 지원하는지도 고려해야 합니다. 프로세서 사양만 보지 마세요. 아키텍처를 모르겠다면 범용 버전을 선택하세요. 범용 버전은 더 다양한 아키텍처를 지원하지만 시스템 버전 미충족, 저장 공간 부족, 조직 정책 제한까지 해결하지는 않습니다. 기존 V2Fly 설정과 호환성을 맞춰야 한다면 v2flyNG를 선택할 수 있습니다. 설치와 가져오기 방법은 비슷하지만, 프로토콜과 전송 방식의 지원 여부는 실제 코어 기능을 확인하세요.
설치 중 현재 설치 파일을 연 앱을 신뢰하도록 허용하라는 메시지가 표시될 수 있습니다. 파일이 다운로드 페이지에서 받은 것인지 확인하고 시스템 화면에 따라 이번 설치에 사용하는 출처만 허용하세요. 설치가 끝나면 출처 허용을 취소할 수 있습니다. 이미 설치된 앱과 충돌한다는 메시지가 표시되면 백업 없이 바로 삭제하지 마세요. 구독과 사용자 지정 항목을 기록하고 다른 출처에서 만든 빌드를 덮어쓰려는 것은 아닌지 확인하세요. 앱 데이터를 지우면 기존 설정도 삭제되므로 우선 적용할 문제 해결 방법으로 삼지 마세요.
구독을 업데이트하고 현재 항목을 확인하세요
클라이언트의 구독 그룹 설정에 주소와 메모를 추가한 뒤 목록으로 돌아가 업데이트를 실행하세요. 항목이 표시되면 해당 그룹으로 들어가 하나를 현재 설정으로 선택하고 화면의 연결 버튼을 눌러 시작합니다. 단일 공유 링크만 있다면 클립보드 가져오기를 사용하세요. 구독 주소는 구독 설정에 입력해야 합니다. 휴대폰에서는 안내 문구까지 함께 복사하기 쉽습니다. 형식 오류가 발생하면 클립보드에 주소나 링크 하나만 들어 있는지 확인하세요. 텍스트 종류를 자동으로 알아서 처리할 거라 기대하며 업데이트를 반복해서 누르지 마세요.
처음에는 앱 하나만 테스트하세요. 별도 프록시 설정이 없고 특별한 네트워크 권한 제한도 없는 브라우저가 적합합니다. 같은 네트워크에서 전에 열렸던 사이트에 먼저 접속한 다음 설정한 경로로 연결해야 하는 대상을 테스트하세요. 항목 하나만 연결되지 않는다면 현재 그룹에서 정상 작동이 확인된 항목을 비교에 사용해 단일 설정의 만료와 휴대폰 설치 문제를 구분하세요. 업데이트 후 선택한 항목이 사라졌다면 올바른 그룹을 보고 있는지, 구독 내용이 바뀌었는지, 새 활성 항목을 선택했는지 확인하세요.
시스템 VPN 허용, 앱별 프록시, 백그라운드 연결 끊김 점검
Android에서는 일반적으로 시스템 VPN 인터페이스를 통해 클라이언트로 트래픽을 전달합니다. 데스크톱의 「시스템 프록시 쓰기」 절차를 그대로 적용할 수 없습니다. 처음 실행할 때 시스템에 VPN 연결 요청이 표시되면 방금 실행한 클라이언트가 맞는지 확인하고 허용하세요. 상태 표시줄에 VPN 아이콘이 보여도 시스템 연결 경로가 만들어졌다는 뜻일 뿐 원격 핸드셰이크 성공을 의미하지는 않습니다. 다른 VPN 앱이 이미 실행 중이거나 항상 켜짐 VPN이 지정되어 있다면 어떤 앱이 트래픽을 처리하는지 확인하세요. 업무 프로필이나 관리 기기의 조직 설정을 임의로 변경하지 마세요.
앱별 프록시를 설정한 뒤에는 현재 목록이 「선택한 앱만 연결」인지 「선택한 앱 제외」인지 구분하세요. 같은 브라우저를 선택해도 두 설정의 결과는 정반대입니다. 앱 하나만 계속 연결되지 않는다면 라우팅 규칙보다 현재 트래픽 처리 범위에 해당 앱이 포함되는지 먼저 확인하세요. 테스트 중 범위를 변경하려면 기존 설정을 기록하고 한 번에 한 항목씩만 바꾸세요. 클라이언트가 요구하는 경우 다시 연결한 뒤 테스트해 이전 연결의 결과를 새 규칙의 결과로 착각하지 않도록 하세요.
연결은 되지만 화면을 끈 뒤 끊긴다면 같은 Wi-Fi에서 화면을 켰을 때와 껐을 때를 비교하고, 시스템이 백그라운드 프로세스를 중단하거나 백그라운드 네트워크를 제한하는지 확인하세요. 필요한 경우에만 해당 클라이언트의 배터리 설정을 조정하세요. 모바일 데이터로 전환할 때만 실패한다면 앱의 모바일 데이터 사용이 제한됐는지, 데이터 절약 모드가 켜졌는지, 구독과 노드가 해당 네트워크에서 각각 연결되는지 확인하세요. 배터리 설정, 앱별 범위, DNS를 한꺼번에 바꾸지 마세요. 연결이 복구돼도 원인이 무엇인지 알기 어려워집니다.
06 · 플랫폼 공통 연결 확인
라우팅 규칙 및 연결 확인: 진입점부터 아웃바운드까지
진입점, 코어, 대상 연결을 따로 확인하세요
한 번의 접속을 세 가지로 나눠 확인하세요. 앱이 요청을 클라이언트에 전달했는지, 코어가 요청을 의도한 아웃바운드로 보냈는지, 대상 연결이 성공했는지 살펴봅니다. 시스템 프록시, 앱에 직접 지정한 프록시, TUN은 첫 번째 단계를 담당합니다. 라우팅 규칙은 두 번째 단계를 결정합니다. 노드 전송, 인증, 대상의 응답 등이 세 번째 단계에 영향을 줍니다. 트래픽 처리 스위치를 켰다고 라우팅에서 프록시가 선택된다는 보장은 없고, 넓은 범위의 프록시 라우팅 모드를 선택해도 모든 앱이 클라이언트로 들어가는 것은 아닙니다. 개념이 헷갈린다면 시스템 프록시와 라우팅 모드 비교를 참고하세요.
데스크톱 클라이언트에서 HTTP 프록시 수신을 제공한다면 명령줄 도구에 프록시를 직접 지정해 테스트할 수 있습니다. 아래 예시의 127.0.0.1:10809를 실행 전에 화면에 표시된 실제 HTTP 수신 주소와 포트로 바꾸세요. Windows PowerShell에서 curl이 다른 명령으로 연결되어 있다면 curl.exe를 사용하세요. 예시는 진입점을 직접 지정하므로 시스템 프록시가 설정됐는지 확인하는 테스트와는 다릅니다. 로컬 수신기가 요청을 받아들이는지, 요청을 전달한 뒤 어떤 오류가 발생하는지 확인할 때 적합합니다. 정상 응답이 와도 요청이 원격 노드를 거쳤다고 단정할 수는 없습니다. 라우팅 로그도 확인하세요.
curl -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10809 https://example.com/
로컬에서 연결을 거부하면 수신 주소, 포트, 코어 상태부터 확인하세요. 로컬 프록시가 응답한 뒤 연결 시간 초과가 발생한다면 해당 요청이 일치한 아웃바운드와 원격 연결 기록을 살펴보세요. 대상 사이트에서 애플리케이션 계층 응답을 받았다면 오류 페이지가 표시되더라도 대상에 전혀 연결되지 않은 것과는 다릅니다. Android에서 같은 테스트를 하려고 터미널 앱을 설치할 필요는 없습니다. VPN 처리 범위에 확실히 포함되는 앱을 하나 선택하고 요청 시간을 기록한 뒤 클라이언트 로그와 대조하세요.
규칙의 우선순위와 태그 이해하기
일반적인 Xray 및 V2Fly 라우팅 설정은 규칙 목록 순서대로 확인하며, 처음 일치한 규칙이 아웃바운드를 결정합니다. 지정된 사설 주소를 직접 연결하려면 같은 주소를 포괄적으로 처리할 수 있는 규칙보다 앞에 규칙을 배치해야 합니다. 아래 내용은 호환되는 코어의 routing.rules 배열에 넣을 항목이며 독립 설정 파일이 아닙니다. 기존 아웃바운드에 direct 태그가 있고 실제로 직접 연결을 가리킨다는 전제가 필요합니다. 클라이언트의 그래픽 규칙 편집기를 사용한다면 화면에 표시되는 아웃바운드 이름이 실제 생성된 태그와 일치하는지도 확인하세요.
{
"type": "field",
"ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
"outboundTag": "direct"
}
이 규칙은 나열된 사설 IPv4 대역만 일치시키며 일반적인 로컬 네트워크 검색 방법이 아니고 IPv6도 포함하지 않습니다. 앱이 도메인 이름으로 요청을 전달하면 라우팅 단계에서 규칙과 비교할 IP를 얻지 못할 수도 있습니다. 이는 코어의 도메인 처리 방식과 당시 이름 확인 조건에 따라 달라집니다. 특정 내부 도메인을 처리하려면 기존 규칙 체계에 맞춰 도메인 일치 규칙을 설정하고 어떤 리졸버를 사용하는지 확인하세요. 새 규칙 하나를 위해 DNS 동작을 전역 변경하면 내부 DNS를 사용하는 다른 앱에 영향을 줄 수 있으므로 권장하지 않습니다.
간단한 기록으로 변경 결과 확인
변경 전후에 평소 직접 연결되는 사이트, 선택한 아웃바운드를 거쳐야 하는 대상 하나, 기존 로컬 네트워크 접속에 의존하는 리소스 하나를 각각 테스트하세요. 규칙 순서를 먼저 바꾸고 DNS는 따로 검토하는 식으로 한 번에 하나의 변수만 변경합니다. 앱 이름, 트래픽 처리 모드, 대상에 도메인과 IP 중 무엇을 사용했는지, 요청 시간, 로그의 아웃바운드 결과를 기록하면 「연결됨」 또는 「연결 안 됨」만 적는 것보다 재현하기 쉽습니다. 속도 측정 도구마다 확인하는 단계가 다르므로 지연 시간이 낮다고 실제 앱 테스트를 대신할 수 없습니다. 한 번의 시간 초과만으로 노드를 사용할 수 없다고 단정할 수도 없습니다.
노드나 규칙을 바꿨는데 같은 앱의 동작이 달라지지 않는다면 재사용 중인 연결을 끊거나 테스트 앱을 다시 시작한 뒤 새 요청으로 확인하세요. 캐시에서 페이지가 열렸다고 네트워크가 복구된 것은 아닙니다. 연결을 오래 유지하는 앱은 재연결 시점도 확인해야 합니다. 테스트 결과가 예상대로라면 정상 작동하는 규칙을 별도 설정으로 저장하거나 변경 내역을 남겨 두세요. 나중에 구독을 업데이트하거나 코어를 바꿨을 때 같은 대상을 다시 테스트할 수 있어 이전 설정의 이유를 추측할 필요가 없습니다.
07 · 문제 해결
자주 발생하는 설정 문제: 업데이트 실패, 핸드셰이크 오류, 종료 후 복원
구독 업데이트 실패인가요, 업데이트는 됐지만 사용할 항목이 없나요?
화면에 요청 실패, 구문 분석 실패, 업데이트 완료 후 빈 그룹 중 어떤 상태가 표시되는지 먼저 확인하세요. 요청에 실패했다면 기본 네트워크, 기기 시간, 업데이트가 직접 연결인지 프록시 경유인지 살펴보세요. 구독 업데이트가 로컬 프록시를 사용하도록 설정됐는데 사용할 수 있는 로컬 설정이 없다면 필요한 전제 조건이 충족되지 않아 막힐 수 있습니다. 구문 분석에 실패했다면 받은 내용이 로그인 페이지, 만료 안내, 재인증이 필요한 응답이 아니라 구독 API가 반환한 설정인지 확인하세요. 웹페이지가 열린다고 API에도 접속할 수 있는 것은 아닙니다. 인증서 오류를 피하려고 보안 검사를 계속 꺼 두지 마세요.
업데이트 완료 후 목록이 비어 있다면 올바른 그룹을 열었는지 확인하고 이름 검색을 지운 뒤 특정 조건에 맞는 서버만 표시하도록 설정돼 있는지 살펴보세요. 구독 그룹이 여러 개라면 문제가 생긴 그룹 하나만 업데이트해 오류를 확인하기 쉽게 하세요. 업데이트 후 기존 항목이 사라졌다면 제공처에서 항목을 제거했거나 그룹 필터 조건이 달라졌을 수 있습니다. 원인에 따라 해결 방법이 다릅니다. 여러 출처를 관리한다면 구독 그룹과 서버 필터 사용 방법을 참고해 출처별로 그룹을 나누세요. 업데이트 시 이름이 같은 항목을 혼동하는 일을 줄일 수 있습니다.
시간 초과나 핸드셰이크 실패가 발생하면 어떻게 범위를 좁히나요?
로그에 로컬 포트 충돌이 명확히 표시되면 중복 실행된 클라이언트나 포트 충돌부터 해결하세요. 이 단계에서는 코어가 앱 요청을 받을 준비조차 되지 않았을 수 있습니다. 원격 핸드셰이크 기록이 있다면 원본 설정의 프로토콜, 전송 방식, 보안 유형을 비교하세요. 도메인 인증서 오류가 발생하면 기기 날짜와 시간대, 서버 이름 설정이 설정 출처의 안내와 일치하는지 먼저 확인하세요. 인증서 오류 무시는 해결 방법이 아닙니다. 클라이언트의 코어 전환 기능을 사용했다면 새 코어가 해당 항목의 필드와 전송 방식을 지원하는지도 확인하세요.
시간 초과는 원인이 매우 다양합니다. 원격 서버에 도달할 수 없거나 이름 확인에 실패했을 수도 있고, 대상 사이트가 응답하지 않는 것일 수도 있습니다. 같은 네트워크에서 정상 작동을 확인한 대상 두 곳을 시험하고, 같은 설정으로 허용된 다른 네트워크에서도 확인하세요. 어느 설정을 선택해도 특정 앱만 실패한다면 앱의 진입점과 자체 네트워크 설정부터 살펴보세요. 같은 앱에서 항목 하나만 실패한다면 해당 항목의 원격 설정을 다시 확인합니다. 다른 사람에게 도움을 요청할 때는 처음 발생한 구체적인 오류, 오류가 난 단계, 비교를 위해 확인한 사항을 함께 전달하세요. 마지막에 표시된 일반 오류가 앞선 원인을 덮어버리게 두지 마세요.
클라이언트를 종료한 뒤 인터넷이 끊기면 어떻게 원래 상태로 복구하나요?
데스크톱에서는 시스템 프록시가 아직 로컬 프록시 포트를 가리키는지 먼저 확인하세요. 코어를 종료한 뒤 수동 프록시 설정이 남아 있으면 시스템 설정을 따르는 앱에서 수신기를 찾지 못합니다. 설치 전에 기록한 내용을 참고해 시스템 설정을 복원하세요. 자동 프록시 스크립트나 관리 정책이 있는 기기에서는 기존 값을 함부로 삭제하지 마세요. 브라우저나 터미널 하나만 영향을 받는다면 해당 앱의 프록시 옵션과 현재 터미널 세션에 프록시 환경 변수를 설정했는지 확인하세요. 새 터미널에서는 정상인데 기존 터미널에서만 연결되지 않는다면 기록해 둘 만한 단서입니다. 바로 소프트웨어를 다시 설치할 필요는 없습니다.
TUN이나 Android VPN 설정이 원인이라면 먼저 클라이언트 또는 시스템 화면에서 정상적으로 연결을 해제하고 인터페이스와 연결 상태가 복구되는지 확인하세요. 문제가 계속되면 활성화 전에 사용하던 VPN, 내부 DNS, 앱별 제한을 다시 확인하고 하나씩 복원합니다. 네트워크 전환, 이전 프로세스, 캐시가 판단을 방해할 수 있지만 처음부터 전체 네트워크 설정을 초기화하지 마세요. 원래 정상 작동하던 Wi-Fi, 조직 프록시, 접속 규칙까지 함께 지워질 수 있습니다. 복구 후 기존 네트워크로 일반 사이트에 접속되는지 확인한 다음 클라이언트를 다시 켤지 결정하세요.