클라이언트 설치 안내서

V2Ray 설치 및 설정 가이드

플랫폼별로 설치 방법을 확인하고 단계별로 연결 문제를 점검하세요. 설치 패키지 선택, 구독 가져오기, 시스템 프록시, TUN 모드를 다룹니다.

처음 설정한다면 빠른 시작 가이드에 따라 가져오기, 모드 선택, 연결 확인을 먼저 진행하세요. 이 페이지는 필요한 내용을 찾아보는 안내서입니다. 설치 패키지를 고르기 어렵다면 해당 플랫폼으로 바로 이동하고, 노드는 연결되지만 앱에서 프록시가 작동하지 않는다면 연결 확인이나 자주 묻는 질문부터 살펴보세요.

01공통 준비

설치 전 준비: 클라이언트, 설치 패키지, 구독

클라이언트·코어·노드 구분하기

클라이언트는 구독을 저장하고 노드를 선택하거나 프록시 모드를 전환하는 그래픽 인터페이스입니다. 코어는 백그라운드에서 설정을 읽고 연결을 구성하며 라우팅 규칙을 적용합니다. 노드는 원격 연결 설정으로, 보통 서버 주소와 포트, 인증 정보, 전송 매개변수를 포함합니다. 클라이언트를 다운로드해 실행했다고 해서 사용할 수 있는 노드까지 준비된 것은 아닙니다. 노드를 성공적으로 가져와도 현재 앱의 인터넷 연결이 프록시를 통한다는 뜻은 아닙니다.

Project V를 시작점으로 삼으면 이 도구의 계보를 이해하기 쉽습니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 관련 생태계에서 갈라져 나온 별도의 코어입니다. 같은 이름의 프로토콜이라도 코어에 따라 지원하는 전송 방식이나 보안 옵션이 다를 수 있습니다. 이전할 때는 기존 설정에서 사용한 코어와 전송 조합을 먼저 확인한 다음, 대상 클라이언트가 이를 인식하는지 살펴보세요. 노드 이름이 같다는 이유만으로 두 설정이 호환된다고 판단하면 안 됩니다.

운영체제를 확인한 뒤 설치 패키지 선택

데스크톱에서는 v2rayN을 우선 추천합니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 먼저 고려하고, 기존 설정에 V2Fly 코어가 명시되어 있다면 v2flyNG를 확인하세요. 먼저 기기에서 운영체제와 프로세서 정보를 확인한 뒤 다운로드 페이지를 여세요. 겉모습이 비슷한 컴퓨터라도 아키텍처가 다를 수 있고, 아키텍처가 같아도 운영체제나 배포판에 따라 설치 패키지 형식이 다를 수 있습니다.

플랫폼별 설치 패키지 선택 기준
플랫폼클라이언트확인 항목
Windowsv2rayN시스템 아키텍처, Desktop 또는 WPF 인터페이스
macOSv2rayNApple 칩 또는 Intel 프로세서
Linuxv2rayN배포판의 패키지 형식, x64 또는 arm64
Androidv2rayNG, 대안은 v2flyNG필요한 코어, arm64 또는 범용 패키지

아키텍처 표시는 소프트웨어 패키지가 실행될 수 있는 시스템 환경을 나타내며 속도 등급이 아닙니다. 휴대폰 프로세서가 64비트를 지원해도 운영체제가 앱에 해당 실행 환경을 제공하지 않을 수 있습니다. 데스크톱에서는 설치 프로그램과 포터블 압축 파일도 구분해야 합니다. 설치 프로그램은 보통 앱 폴더와 바로가기를 준비하지만, 포터블 패키지는 압축을 푼 디렉터리 구조를 그대로 유지해야 합니다. 패키지를 바꾸기 전에 기존 패키지 유형을 확인하고, 이전 폴더의 실행 파일만 새 폴더에 따로 복사하지 마세요.

구독 주소와 단일 노드 링크 구분하기

구독 주소는 보통 웹 주소 형태이며, 클라이언트가 이를 통해 노드 목록을 가져옵니다. 주소를 추가하는 것은 구독 그룹을 만드는 단계일 뿐이며, 노드 목록을 가져오려면 직접 업데이트해야 합니다. vless:// 또는 vmess://로 시작하는 공유 링크는 대개 단일 노드 정보이므로 클립보드에서 노드를 가져오는 기능을 사용하세요. 웹 주소가 로그인 페이지나 도움말 페이지일 수도 있습니다. 주소를 받으면 용도를 먼저 확인하고, 형식만 보고 구독 링크라고 추측하지 마세요.

QR 코드를 스캔할 때도 단일 노드인지 구독인지 먼저 확인하세요. 스캔 후 클라이언트에 구독 추가 양식이 열렸는지, 노드 미리보기가 표시됐는지 살펴보세요. 목록에 같은 이름의 항목이 이미 있다면 그룹과 노드 유형을 비교해 새 항목을 확인할 수 있습니다. 가져온 내용을 확인하려고 목록을 비울 필요는 없습니다. 링크별 업데이트 방식은 공유 링크와 구독 주소의 차이를 참고하세요.

되돌릴 수 있도록 초기 상태 보존하기

설치 전에 시스템 프록시 사용 여부, 별도의 VPN 사용 여부, 업무 환경에서 프록시를 고정해야 하는지 기록해 두세요. 기존 설정이 직장이나 학교에서 관리하는 것이라면 임의로 덮어쓰지 마세요. 기존 클라이언트가 있다면 백업 또는 내보내기 기능으로 설정을 먼저 저장하세요. 클라이언트 간 이전을 고려하기 전에 구독 그룹과 직접 추가한 노드, 사용자 지정 라우팅을 보존하세요. 내보낸 파일도 민감 정보로 취급하고, 공용 컴퓨터의 다운로드 폴더에 오래 두지 마세요.

처음 사용할 때는 가능한 한 짧은 검증 절차를 따르세요. 노드 하나 또는 구독 하나만 가져오고, 노드 하나를 선택한 다음, 트래픽을 처리하는 방식 하나만 켜고, 미리 정한 테스트 대상에 접속합니다. 도메인 해석, 분할 라우팅, 시작 시 자동 실행을 동시에 조정하지 마세요. 연결이 확인된 뒤 필요한 설정을 추가하면 됩니다. 처음부터 실패해도 변경 사항이 적으면 설치, 가져오기, 코어 실행, 앱 트래픽 처리 중 어디서 문제가 생겼는지 구분하기 쉽습니다.

02데스크톱 설정

Windows: v2rayN 설치 및 시스템 프록시

Desktop 또는 WPF 설치 패키지 선택

시스템 설정의 ‘시스템 → 정보’에서 시스템 유형을 확인하세요. Windows 다운로드에서 설치 패키지 표시를 확인하면 됩니다. Desktop은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 익숙한 Windows 레이아웃을 유지합니다. 선택 기준은 시스템 호환성과 사용 습관이지 노드 프로토콜이 아닙니다. 다운로드 페이지의 x64 패키지는 x64 환경용입니다. 기기가 다른 아키텍처라면 시스템에서 해당 패키지를 호환 모드로 실행할 수 있는지 먼저 확인하세요. 패키지 이름의 비트 수만 보고 호환 여부를 판단하지 마세요.

먼저 트레이에서 실행 중인 인스턴스까지 포함해 기존 클라이언트를 종료한 다음 설치 프로그램을 실행하세요. 설치 마법사를 마치고 새 바로가기로 시작합니다. 필요한 실행 환경이 없다는 메시지가 나오면 표시된 구성 요소 이름과 아키텍처를 기록한 뒤 해당 패키지의 안내를 확인하세요. 앱 실행이 제한되면 설치 출처와 시스템 알림, 기기 관리 정책을 확인하세요. 실행을 위해 시스템 보안 기능 전체를 끄거나 시스템 디렉터리에 설정을 저장하지 마세요.

구독을 가져와 사용할 노드 선택하기

구독 그룹 메뉴에서 새 그룹을 만들고 알아보기 쉬운 이름과 전체 구독 주소를 입력한 뒤 업데이트를 실행하세요. 컴퓨터에서 아직 사용할 수 있는 프록시가 없다면 프록시 없이 업데이트를 시도할 수 있지만, 이 방법은 현재 네트워크에서 구독 서버에 직접 접속할 수 있을 때만 가능합니다. 기존 연결을 통해서만 주소에 접속할 수 있다면 먼저 기존 연결을 사용할 수 있게 한 다음 프록시를 통해 업데이트하세요. ‘업데이트 성공’ 메시지만으로 노드가 사용 가능하다고 판단하지 말고, 해당 그룹으로 전환해 항목이 실제로 표시되는지 확인하세요.

공유 링크 하나만 있다면 전체 링크를 복사한 다음 클립보드에서 노드를 가져오세요. 가져온 항목을 선택해 현재 서버 또는 활성 노드로 지정합니다. 메뉴 이름은 현재 인터페이스에 따라 다를 수 있습니다. 목록에서 강조 표시된 행이 실제 사용 중인 항목이라고 단정할 수는 없습니다. 여러 번 가져온 같은 이름의 항목을 하나씩 시험하는 대신 클라이언트 상태나 현재 연결 로그에서 실제 선택된 노드를 확인하세요.

브라우저는 시스템 프록시로, 필요한 다른 앱은 TUN으로

먼저 트레이 메뉴에서 시스템 프록시를 ‘시스템 프록시 자동 설정’ 또는 이에 해당하는 옵션으로 전환한 다음, 시스템 프록시를 사용하는 브라우저에서 새 요청을 보내세요. 시스템 프록시는 앱에 로컬 프록시 주소를 알려줄 뿐 모든 프로세스의 트래픽을 직접 처리하지는 않습니다. 별도 네트워크 설정을 사용하는 도구는 계속 직접 연결할 수 있고, 브라우저도 기존 확장 프로그램이나 관리 정책, 별도 프록시 설정의 영향을 받을 수 있습니다. 대상 앱에서 프록시를 직접 지정할 수 있다면 컴퓨터 전체의 연결 방식을 바꾸지 않고 앱 하나만 먼저 확인해도 됩니다.

가상 네트워크 인터페이스로 처리해야 하는 앱이 있을 때만 TUN을 별도로 테스트하세요. 기존 모드를 기록하고 테스트 앱의 수동 프록시를 끈 다음, 현재 클라이언트 화면의 안내에 따라 권한을 처리합니다. 활성화 후 가상 인터페이스와 관련 라우팅이 설정됐는지 확인하고, 일반 웹 접속과 로컬 네트워크 접속, 유지해야 하는 업무 연결을 각각 테스트하세요. TUN 스위치가 켜져 있어도 라우팅 설치까지 성공했다는 뜻은 아닙니다. 실패하면 해당 모드를 먼저 끄고 시작 오류를 확인하세요. 반복해서 권한을 허용하거나 재시작하지 마세요.

트레이에 남은 프로세스와 포트 점유 확인하기

기본 창을 닫아도 v2rayN은 트레이에서 계속 실행될 수 있습니다. 업그레이드하거나 Desktop과 WPF 사이를 전환하기 전에 기존 인스턴스에서 종료를 선택한 다음 새 버전을 실행하세요. 로그에 로컬 포트를 바인딩할 수 없다는 오류가 나오면 설정에서 해당 포트를 확인하고, 기존 클라이언트나 다른 로컬 서비스가 사용 중인지 살펴보세요. 알 수 없는 프로세스를 종료하지 마세요. 포트를 바꿔야 한다면 브라우저나 도구에 저장된 수동 프록시 주소도 함께 수정해야 합니다.

클라이언트를 종료한 뒤 갑자기 인터넷이 끊겼다면 시스템 프록시가 여전히 로컬 주소를 가리키는지, 해당 포트를 계속 수신하는 프로그램이 있는지 확인하세요. 컴퓨터 전체가 오프라인인 것처럼 보여도 종료된 로컬 프록시에 앱이 계속 접속하려는 문제일 수 있습니다. 특정 프로그램만 복구되지 않는다면 프로그램을 다시 열고 재시험하세요. 이전 연결을 계속 사용하고 있을 수 있습니다. 로컬 설정을 복원한 뒤 원격 노드나 네트워크에 다른 문제가 있는지 판단하세요.

03데스크톱 설정

macOS: 칩에 맞는 패키지, 앱 설치 및 프록시

‘이 Mac에 관하여’에서 디스크 이미지 선택

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 기기 정보에 Apple 칩이 표시되면 macOS 다운로드에서 Apple Silicon용 arm64 패키지를 선택하세요. Intel 프로세서가 표시되면 x64 패키지를 선택하면 됩니다. 에뮬레이션 환경의 터미널 출력보다 시스템 정보를 우선해 칩을 확인하세요. 잘 모르겠더라도 두 패키지를 연달아 설치하지 마세요. 이름이 같은 앱이 두 개 있으면 이후 실행 경로와 프록시 상태를 구분하기 더 어려워질 수 있습니다.

다운로드한 디스크 이미지를 열고 창의 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 드래그하세요. 대상 폴더에서 앱을 실행한 뒤 디스크 이미지를 추출합니다. 이미지 창에서 앱을 계속 실행하거나 다운로드 폴더와 응용 프로그램 폴더에 같은 이름의 앱을 각각 두지 마세요. 기존 앱을 교체하기 전에 메뉴 막대나 앱 메뉴에서 완전히 종료하세요. 시스템에서 실행을 거부하면 안내에 따라 아키텍처 불일치, 시스템 버전 불일치, 관리 제한을 구분하세요. 앱 보호 기능을 일괄 해제하지 마세요.

그룹으로 구독을 관리하고 기기 권한 범위 확인하기

v2rayN을 실행한 뒤 구독 기능에서 새 그룹을 만들고 주소를 빠짐없이 붙여 넣으세요. 알아보기 쉬운 이름을 지정한 다음 직접 업데이트합니다. 데스크톱 공간이나 앱 창을 여러 개 사용한다면 현재 창에 새 그룹이 표시되는지, 전체 노드 목록이 표시되는지 먼저 확인하세요. 공유 링크 하나만 있다면 클립보드에서 명확한 로컬 그룹으로 가져오면 자동 업데이트 항목과 직접 관리해야 하는 항목을 나중에 구분하기 쉽습니다.

기존 컴퓨터의 구독을 옮길 때는 원래 구독 주소로 그룹을 다시 만든 다음, 보존이 필요한 수동 노드만 가져오는 방법을 우선하세요. 앱 설정 디렉터리 전체를 그대로 덮어쓰지 마세요. 이전 시스템의 로컬 경로와 포트, 권한, 코어 옵션이 새 기기에 맞지 않을 수 있습니다. 처음 실행할 때 특정 작업을 허용할지 묻는다면 네트워크 처리인지 로컬 파일 접근인지 확인하고, 현재 필요한 기능에만 권한을 부여하세요. 권한을 부여한 뒤 달라진 내용도 기록해 두세요.

네트워크 서비스를 기준으로 시스템 프록시 확인하기

클라이언트에서 시스템 프록시를 활성화한 뒤 ‘시스템 설정 → 네트워크’에서 현재 사용하는 네트워크 서비스를 열고 세부 정보의 프록시 설정을 확인하세요. 무선 네트워크와 유선 네트워크를 바꾸면 서비스가 달라질 수 있고 프록시 상태도 그대로 이어지지 않을 수 있습니다. 로컬 루프백 주소가 표시되면 포트가 클라이언트에서 현재 안내하는 로컬 수신 포트와 일치하는지 확인하세요. 오래된 포트가 시스템 설정에 남아 있어도 새 프로세스의 요청을 받을 수는 없습니다.

특정 앱만 연결되지 않으면 먼저 시스템 프록시를 사용하는 앱인지 확인한 다음 TUN 사용 여부를 결정하세요. 현재 빌드에서 제공하고 지원하는 TUN 기능이라면 인터페이스 안내에 따라 활성화하세요. 충돌할 수 있는 로컬 프록시 인스턴스를 먼저 종료한 뒤 일반 웹 접속과 내부 네트워크 접속, 잠자기 후 깨운 뒤의 상태를 확인합니다. 클라이언트에서 권한이나 라우팅 설정 오류가 표시되면 시스템 프록시로 되돌려 기본 연결을 확인하세요. 오류를 찾는 대신 스위치를 계속 껐다 켜지 마세요.

잠자기 후 연결, 네트워크 전환 및 프록시 잔류 문제 해결

컴퓨터가 잠자기 상태일 때 기존 연결이 네트워크 장비에 의해 종료됐을 수 있고, 깨어난 뒤에는 다른 네트워크 서비스에 연결됐을 수 있습니다. 페이지 로딩이 오래 걸리면 먼저 현재 네트워크가 정상적으로 연결되는지 확인하고, 클라이언트에서 연결을 다시 만든 뒤 새 요청을 보내세요. 오래 열린 탭이나 장시간 다운로드, 백그라운드 동기화 프로세스는 이전 연결을 계속 사용할 수 있으므로 새 요청까지 실패한다는 증거는 아닙니다. 문제가 반복되면 네트워크 전환이나 잠자기 후에만 발생하는지 기록하세요.

클라이언트의 시스템 프록시를 해제한 뒤에도 내부 네트워크에 접속할 수 없다면 현재 네트워크 서비스에 프록시 스크립트, 수동 프록시, 특수 제외 항목이 설정되어 있는지 확인하고 다른 네트워크 도구가 실행 중인지 살펴보세요. 회사나 학교에서 설정한 항목은 그대로 두세요. 이번 설치에서 새로 추가한 항목만 기존 기록에 따라 되돌리세요. 복원 후에는 로컬 서비스를 먼저 테스트하고 인터넷을 확인하세요. 로컬 서비스에 접속할 수 없다면 원격 노드를 바꾸지 말고 로컬 네트워크 경로부터 점검하세요.

04데스크톱 설정

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

배포판과 아키텍처를 모두 확인하세요

Linux 다운로드에서 v2rayN을 선택하세요. 보통 Debian 계열 배포판은 deb 패키지를, 해당 패키지 관리 체계를 사용하는 Fedora 등의 배포판은 rpm 패키지를 선택합니다. 형식이 일치하는 것은 첫 단계일 뿐입니다. 배포판 버전과 의존성, 데스크톱 환경도 확인하세요. 두 형식을 파일 확장자만 다른 것으로 취급하거나 변환 도구로 패키지를 강제로 바꾸지 마세요. 터미널만 사용할 수 있다면 다음 읽기 전용 명령으로 현재 시스템을 확인할 수 있습니다.

cat /etc/os-release
uname -m

/etc/os-release에는 배포판 정보가 있으며, uname -m은 현재 커널에서 인식하는 시스템 아키텍처를 표시합니다. 일반적으로 x86_64는 x64, aarch64는 arm64에 해당합니다. 컨테이너나 가상 머신, 아키텍처가 혼합된 환경이라면 실제 설치 대상의 패키지 관리자가 사용하는 아키텍처도 확인하세요. 예를 들어 Debian 계열 시스템에서는 dpkg --print-architecture를 확인할 수 있습니다. 호스트 시스템의 결과를 게스트 시스템 결과로 간주하지 마세요.

현재 데스크톱 세션에서 실행한 뒤 구독 가져오기

시스템 소프트웨어 설치 프로그램에서 호환되는 로컬 패키지를 열고 의존성 안내를 확인한 뒤 설치하세요. 설치에 실패하면 누락된 패키지 이름, 아키텍처 충돌, 배포판 버전 제한부터 확인하세요. ‘설치 완료’ 메시지가 떴는데 창을 찾을 수 없다면 앱 메뉴에서 실행하고 그래픽 세션을 사용할 수 있는 상태인지 확인하세요. 원격 터미널에서 그래픽 앱을 호출하는 것과 로그인한 사용자의 데스크톱에서 실행하는 것은 인터페이스와 프록시 설정이 다를 수 있습니다.

정상적으로 시작되면 구독 메뉴에서 그룹을 만들고 업데이트한 뒤 노드 목록이 표시되는지 확인하세요. 단일 공유 링크는 클립보드에서 가져옵니다. 평소 데스크톱에 로그인하는 사용자 계정으로 앱을 실행하세요. 창을 열기 위해 관리자 권한으로 실행하면 설정이 다른 사용자 디렉터리에 저장되어 일반 계정으로 열 때 데이터가 사라진 것처럼 보일 수 있습니다. 네트워크 기능에 권한 상승이 꼭 필요하다면 클라이언트가 지원하는 권한 부여 방식을 사용하고 그래픽 프로그램 전체에 장기간 관리자 권한을 부여하지 마세요.

데스크톱 프록시와 터미널 프록시의 차이 확인하기

데스크톱 환경의 시스템 프록시는 앱이 읽어 사용하는 설정이며 모든 데스크톱이나 프로그램이 같은 인터페이스를 따르는 것은 아닙니다. 브라우저는 데스크톱 설정을 따를 수 있지만 터미널 명령은 자체 옵션이나 환경 변수만 사용할 수 있습니다. 먼저 클라이언트의 로컬 HTTP 또는 혼합 프록시가 수신 대기 중인지 확인한 다음, 한 번만 실행하는 명령에 프록시를 명시하세요. 테스트를 위해 터미널 시작 파일에 프록시를 저장할 필요는 없습니다. 아래 명령을 실행하면 클라이언트 설정에 표시된 로컬 HTTP 또는 혼합 프록시 포트를 입력하라는 안내가 나옵니다.

printf '로컬 HTTP 또는 혼합 프록시 포트: '
read -r proxy_port
curl --noproxy '' --proxy "http://127.0.0.1:${proxy_port}" \
  --max-time 15 --head https://example.com/

이 명령은 로컬 프록시가 루프백 주소에서 HTTP 연결을 제공할 때 사용할 수 있습니다. 설정에 SOCKS 전용 수신으로 표시된다면 포트를 이 명령에 그대로 넣지 말고 해당 프로토콜에 맞는 옵션을 선택하세요. 명시적 프록시 요청은 성공하지만 일반 프로그램이 실패한다면 프로그램의 트래픽 처리 방식과 자체 프록시 설정을 확인하세요. 명령이 대상의 응답을 받았다는 것은 해당 요청에 사용할 수 있는 경로가 있었다는 뜻일 뿐입니다. 원격 노드를 통과했는지는 클라이언트 로그의 라우팅 결과와 비교해야 합니다.

TUN 사용 전 권한, 인터페이스 및 기존 설정 확인하기

TUN을 사용하려면 실행 환경에서 가상 네트워크 인터페이스를 지원하고 현재 빌드에서도 해당 모드를 지원하는지 확인하세요. 클라이언트를 실행할 수 있는 컨테이너나 관리형 환경이라도 인터페이스 생성 또는 라우팅 수정이 허용되지 않을 수 있습니다. 클라이언트에서 권한이나 인터페이스 오류가 발생하면 검증된 시스템 프록시로 되돌린 다음 배포 환경에서 허용하는 권한을 확인하세요. 시스템 권한을 변경하는 명령을 무작정 복사하지 말고 방화벽을 끄는 것을 첫 번째 해결 방법으로 삼지 마세요.

활성화는 성공했지만 특정 터미널이나 서비스가 계속 이상하다면 이전 프록시 환경 변수가 남아 있거나 자체 네트워크 네임스페이스에서 실행 중인지 확인하세요. TUN을 끈 뒤 새 터미널과 새 브라우저 창에서 각각 다시 테스트합니다. 새 세션은 되지만 기존 세션만 실패한다면 프로세스가 상속한 환경이 원인일 수 있습니다. 같은 데스크톱의 앱이 전반적으로 작동하지 않는다면 현재 인터페이스와 라우팅, 이름 해석 설정이 예상대로 복구됐는지 확인하세요.

05모바일 설정

Android: v2rayNG 설치 및 VPN 트래픽 처리

필요에 맞는 클라이언트와 설치 패키지 선택

Android 다운로드를 여세요. 일반적인 사용에는 Xray 코어를 사용하는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요한 설정에 한해 v2flyNG를 확인하세요. arm64 앱을 지원하는 기기라면 arm64 패키지를 선택합니다. 시스템이 지원하는 앱 아키텍처를 확인할 수 없다면 같은 클라이언트의 범용 패키지를 고려할 수 있습니다. 범용 패키지는 더 많은 아키텍처를 지원하지만 시스템 버전 제한을 없애지는 않으며, 기존 앱의 서명 충돌도 해결하지 못합니다.

다운로드가 끝나면 파일 관리자나 브라우저에서 설치 패키지를 열고, 시스템 안내에 따라 이번 설치에 필요한 출처에만 권한을 부여하세요. 이후에는 권한을 취소할 수 있습니다. 업데이트할 때는 기존 앱과 같은 배포 경로의 패키지를 우선 사용하세요. 시스템에서 덮어쓰기를 거부하면 서명 불일치, 덮어쓰기할 수 없는 버전, 저장 공간 부족, 기기 관리 정책 중 무엇이 원인인지 먼저 확인하세요. 기존 앱을 바로 삭제하지 마세요. 삭제하면 구독과 수동 노드, 앱별 설정까지 지워질 수 있으므로 필요한 데이터를 먼저 백업하세요.

구독을 추가하거나 단일 노드 QR 코드 스캔하기

클라이언트를 열고 구독 그룹 설정에서 새 항목을 만든 다음 메모와 주소를 입력하고 저장하세요. 노드 목록으로 돌아가 구독 업데이트를 실행합니다. 업데이트가 끝나면 대상 그룹을 보고 있는지 확인해 다른 그룹의 오래된 노드와 혼동하지 않도록 하세요. 처음 가져올 때는 기본 설정을 유지하고 테스트 기준을 만들기 위해 노드 하나만 선택하세요. 데스크톱에서는 주소를 업데이트할 수 있는데 휴대폰에서는 안 된다면 휴대폰이 무선 네트워크와 모바일 데이터 중 무엇을 사용 중인지 기록하세요. 데스크톱에서 정상적으로 가져온 구독을 먼저 삭제하지 마세요.

단일 노드 링크를 받았다면 복사한 뒤 클립보드에서 가져오세요. QR 코드를 받았다면 클라이언트에서 지원하는 스캔 또는 이미지 가져오기 기능을 사용합니다. QR 코드에도 설정 텍스트처럼 인증 정보가 포함될 수 있으므로 공유 앨범에 보관하지 마세요. 인식되지 않으면 이미지가 잘렸거나 압축됐는지, 빛이 반사되는지 먼저 확인한 다음 코드의 용도를 확인하세요. 구독 그룹 업데이트와 QR 스캔 가져오기는 별개의 작업입니다. 노드 하나를 스캔해도 자동으로 구독이 생성되지는 않습니다.

시스템 VPN 권한 및 앱 적용 범위 이해하기

노드를 선택하고 연결을 시작하면 시스템에서 보통 VPN 연결 확인 창이 표시됩니다. 이 권한은 지정한 트래픽을 클라이언트가 처리하도록 허용하는 것으로, 컴퓨터에 시스템 프록시 주소를 입력하는 것과는 다릅니다. 확인한 뒤 클라이언트 상태와 시스템의 VPN 표시를 살펴보고 브라우저에서 새 요청을 보내세요. 시스템 표시는 트래픽 처리 서비스가 만들어졌다는 뜻이지 원격 연결이 반드시 작동한다거나 모든 앱의 트래픽이 처리된다는 뜻은 아닙니다. 표시가 잠깐 나타났다가 사라진다면 다른 VPN이나 시스템 정책이 서비스를 대체했는지 확인하세요.

클라이언트에서 앱별 프록시를 지원한다면 이를 노드 선택이 아닌 트래픽 적용 범위로 이해하세요. 먼저 설정이 ‘선택한 앱만 포함’인지 ‘선택한 앱 제외’인지 확인한 뒤 설정합니다. 브라우저가 목록에 있어도 다운로드 관리자나 별도 프로세스로 실행되는 앱까지 목록에 포함된 것은 아닙니다. 문제를 확인할 때는 적용 범위를 명확하게 설정하고 브라우저 하나로 테스트하세요. 설정이 올바른지 확인한 다음 기존 앱 목록을 다시 추가합니다. 상시 VPN 또는 VPN을 통하지 않는 연결 차단은 테스트를 위해 되돌리는 데 영향을 줄 수 있으니 설정을 바꾸기 전에 원래 상태를 기록하세요.

네트워크 전환, 백그라운드 제한 및 기기 정책 구분하기

화면이 꺼진 뒤에만 연결이 끊긴다면 화면을 다시 켠 뒤 VPN 서비스가 계속 실행 중인지 확인하고, 시스템의 백그라운드 제한이나 절전 정책을 사용 중인지 살펴보세요. 같은 문제가 반복되어 실제 사용에 지장을 줄 때만 기기 설정에서 해당 클라이언트의 관련 권한을 조정하세요. 기기 전체의 절전 기능을 끌 필요는 없습니다. 연결된 상태에서 모바일 데이터로 전환되지 않는다면 기존 연결을 끊고 한 번 다시 연결한 다음 새 요청을 보내 연결 복구 문제인지 현재 네트워크 문제인지 확인하세요.

학교나 직장, 관리형 기기에서는 설치와 백그라운드 실행, VPN 사용이 제한될 수 있습니다. 이러한 제한은 구독의 유효 여부와는 관계없으므로 기기 관리 규정에 따라 처리하세요. 무선 네트워크와 모바일 데이터를 바꿔도 특정 앱만 실패한다면 앱별 목록과 앱 자체의 프록시 설정, 라우팅 규칙을 다시 확인하세요. VPN 서비스조차 설정되지 않는다면 노드를 확인하기 전에 로컬 권한이나 다른 VPN과의 충돌을 해결하세요.

06설정 확인

연결 확인: 로컬 수신부터 라우팅 적용까지

한 번의 인터넷 연결을 네 단계로 점검하기

첫째, 코어가 시작되는지 확인합니다. 데스크톱에서는 로컬 프록시 포트가 수신 대기하는지, 모바일에서는 시스템 트래픽 처리 서비스가 설정됐는지 살펴보세요. 둘째, 테스트 앱의 요청이 클라이언트에 들어오는지 확인합니다. 새 요청을 보내고 로그를 살펴보세요. 화면의 연결 버튼이나 노드 목록에 표시되는 단일 테스트 결과만으로 판단하지 마세요. 클라이언트가 요청을 받지 못했다면 원격 노드를 바꿔도 결과가 달라지지 않을 수 있습니다. 먼저 앱의 트래픽 처리 설정을 바로잡으세요.

셋째, 요청에 어떤 라우팅 규칙이 적용되어 실제로 프록시, 직접 연결, 차단 중 무엇을 사용했는지 확인합니다. 넷째로 대상의 응답 여부를 확인하세요. 웹페이지 하나가 여러 도메인에 요청할 수 있으며, 기본 문서와 이미지, 스크립트, 로그인 API에 서로 다른 규칙이 적용될 수 있습니다. 먼저 요청 경로가 명확하고 여러 타사 사이트에 의존하지 않는 대상으로 테스트한 뒤 원래 앱을 확인하세요. 테스트 대상은 일상적인 사용 환경과 비교할 수 있어야 하지만 본인의 계정 페이지나 실제 구독 주소를 예시로 사용할 필요는 없습니다.

확인 근거를 바탕으로 문제 범위 좁히기
점검 단계관찰되는 현상우선 확인할 항목
시작코어가 종료되거나 인터페이스가 설정되지 않음설정 오류, 포트, 권한
트래픽 처리테스트 앱 요청이 기록되지 않음로그 수준, 프록시 모드, 앱 적용 범위
라우팅요청은 들어왔지만 잘못된 경로로 전송됨매칭 조건, 규칙 순서, 기본 경로
출구예상한 출구를 사용했지만 응답이 없음노드 연결, 이름 해석, 전송 및 보안 설정

시스템 프록시, 전역 라우팅, TUN 구분하기

‘시스템 프록시’는 앱이 로컬 프록시를 찾는 방법을 의미하고, ‘전역’은 보통 클라이언트에 들어온 트래픽이 어떤 경로를 사용하는지 나타냅니다. 두 설정은 같은 스위치가 아닙니다. 전역 라우팅을 선택해도 시스템 프록시를 사용하지 않는 프로세스는 클라이언트에 들어오지 않을 수 있습니다. TUN은 시스템 가상 네트워크 인터페이스를 통해 라우팅 조건에 맞는 트래픽을 받습니다. 적용 범위는 대체로 더 넓지만 제외 규칙과 시스템 기능, 다른 네트워크 서비스의 영향을 받을 수 있습니다.

처음 확인할 때는 세 가지를 동시에 변경하지 마세요. 먼저 시스템 프록시 설정 방법에 따라 프록시를 사용하는 것이 명확한 앱 하나를 테스트하세요. 실제 필요에 따라 TUN으로 전환할지 결정합니다. 전환할 때는 기존 트래픽 처리 방식이 예상한 상태로 돌아왔는지 먼저 확인하세요. 가상 인터페이스를 활성화한 뒤 앱이 이전 포트에 수동으로 연결된 상태로 남지 않도록 해야 합니다. 비교할 때 같은 노드와 대상, 네트워크를 유지하고 트래픽 처리 방식만 바꾸면 차이를 파악하기 쉽습니다.

규칙 순서, 도메인 및 주소 확인하기

인터페이스에서 제공하는 방법으로 라우팅 규칙과 기본 경로를 확인하세요. 순서가 있는 규칙 목록은 보통 처음 일치하는 항목을 적용합니다. 범위가 넓은 조건을 앞에 두면 뒤의 세부 규칙에 전달되어야 할 요청이 먼저 처리될 수 있습니다. 규칙이 직접 연결과 프록시 중 무엇을 선택하는지는 규칙에 연결된 출구에 따라서도 달라집니다. 문제를 확인할 때 모든 항목을 먼저 삭제하지 마세요. 명확한 테스트 요청 하나로 적용 조건을 확인한 뒤 실제로 영향을 주는 규칙만 조정하세요.

도메인 규칙은 호스트 이름을 기준으로 트래픽을 분류하고, 주소 규칙은 특정 주소나 네트워크 대역을 대상으로 합니다. 도메인을 가져올 수 있는지, 도메인이 주소로 먼저 해석되는지는 앱이 전달한 대상과 코어 정책에 따라 달라집니다. 같은 서비스라도 도메인으로 접속할 때와 주소로 직접 연결할 때 서로 다른 규칙이 적용될 수 있습니다. 일부 사이트에만 문제가 생기면 브라우저 탭 제목만 보지 말고 실제 요청 대상부터 확인하세요. 규칙을 수정하기 전에 현재 라우팅 설정을 내보내 두면 기존 순서를 복원하기 쉽습니다.

데이터베이스, 이름 해석, 노드 업데이트 구분하기

GeoSite는 도메인 분류 데이터이고 GeoIP는 주소 분류 데이터입니다. 이러한 분류를 사용하는 규칙은 코어가 실제로 불러온 데이터베이스와 현재 항목을 기반으로 작동합니다. 데이터베이스 업데이트와 구독 업데이트는 서로 대체할 수 없습니다. 전자는 규칙 매칭에 사용하는 데이터를 바꾸고, 후자는 노드 목록을 갱신합니다. 규칙은 있지만 분류 항목을 찾지 못하면 올바른 데이터베이스를 사용 중인지, 현재 코어가 해당 데이터베이스를 읽을 수 있는지 먼저 확인하세요. 업데이트한 데이터 파일을 아무 예전 디렉터리에나 넣지 마세요.

도메인을 해석할 수 없다고 해서 모든 이름 해석 설정을 바로 바꿀 필요는 없습니다. 구독 서버와 노드 서버, 테스트 대상 중 어디에서 실패하는지 먼저 구분한 다음 앱과 시스템, 코어 중 어느 쪽에서 문제가 발생했는지 살펴보세요. 앱에 자체 이름 해석 방식이 있으면 시스템의 이름 해석이 정상이어도 해당 앱은 제대로 작동하지 않을 수 있습니다. 증상을 기록하고 한 번에 한 가지만 변경해 다시 확인하세요. 라우팅 데이터 형식이 궁금하다면 GeoIP·GeoSite 데이터베이스 업데이트 안내를 참고하세요.

07문제 해결

자주 발생하는 설정 문제와 복구 방법

가장 최근 변경 사항부터 확인하기

마지막으로 정상 작동했던 시점부터 되짚어 보세요. 클라이언트를 업그레이드했는지, 코어를 교체했는지, 구독을 수정했는지, 무선 네트워크를 전환했는지, 시스템 프록시를 변경했는지 확인합니다. 마지막 변경 시점과 처음 실패한 시점을 구분해 기록하세요. 복구할 수 있다면 가장 최근 변경 하나만 되돌린 뒤 기존 노드와 테스트 대상으로 다시 확인하세요. 앱을 삭제하고 이름 해석과 라우팅까지 한꺼번에 바꾸면 우연히 문제가 해결되더라도 다음에 같은 문제가 생겼을 때 대응하기 어렵습니다.

증상에 맞는 점검 항목 선택하기

구독 업데이트에 실패하면 주소와 노드 중 무엇을 먼저 확인해야 하나요?

먼저 구독 주소와 가져오기 경로를 확인하세요. 원래 주소 전체가 정확한지 살펴보고, 복사 과정에서 공백이나 줄바꿈, 끝의 문장부호가 들어가지 않았는지 확인합니다. 로그인 페이지나 오류 페이지, 빈 응답도 다운로드는 성공할 수 있지만 설정으로 해석되지 않습니다. 클라이언트에서 확인할 수 있는 오류를 바탕으로 요청이 전달되지 않았는지, 서버가 접근을 거부했는지, 응답 형식이 맞지 않는지 구분한 뒤 업데이트 경로를 바꾸세요.

기존 그룹에 노드가 남아 있다면 그대로 보존하세요. 기존 노드가 연결된다고 구독을 업데이트할 수 있다는 뜻은 아니며, 구독 업데이트 실패가 모든 기존 노드의 만료를 의미하지도 않습니다. 현재 네트워크에서 구독 서버에 직접 접속할 수 있을 때만 프록시 없이 업데이트하는 것이 유효합니다. 기존 연결을 이용해야 한다면 사용 가능한 노드를 보존해 프록시를 복구한 뒤 업데이트를 시도하세요. 두 경로 모두 거부되면 주소의 유효 기간과 접근 조건을 확인하세요. 주소를 반복해서 붙여 넣거나 공개된 곳에 올려 도움을 요청하지 마세요.

노드를 가져왔는데도 연결되지 않는 이유는 무엇인가요?

노드가 현재 선택되어 있고 클라이언트에서 연결을 시작했는지 먼저 확인하세요. 코어가 시작하자마자 종료된다면 오류를 바탕으로 설정 필드와 파일 경로, 로컬 포트를 점검하세요. 요청을 보낼 때만 시간이 초과된다면 노드 주소 이름 해석과 원격 포트 연결, 핸드셰이크 실패를 차례로 확인합니다. 목록의 연결 테스트와 실제 앱 요청은 서로 다른 경로를 사용할 수 있으므로 테스트 아이콘만으로 판단하지 마세요.

특정 노드에서만 핸드셰이크 오류가 발생하면 원래 설정에 지정된 프로토콜과 전송 방식, 보안 설정, 서버 이름을 확인하고 시스템 시간이 정확한지 살펴보세요. 포트만 바꾸거나 인증서 오류 무시 옵션을 켜는 것만으로는 원인을 확인할 수 없으며 문제를 더 파악하기 어려워질 수 있습니다. 같은 구독의 다른 노드가 동일한 네트워크와 모드에서 작동한다면 비교 기준으로 남겨 두고 해당 노드만 점검하세요. 클라이언트를 다시 설치할 필요는 없습니다.

브라우저는 접속되는데 다른 앱은 왜 안 되나요?

문제가 생긴 앱이 시스템 프록시를 사용하는지, 자체 프록시를 설정했는지 먼저 확인하세요. 데스크톱 앱은 별도의 네트워크 설정을 사용할 수 있고 터미널에는 이전 세션에서 설정된 환경 변수가 남아 있을 수 있습니다. 모바일에서는 해당 앱이 트래픽 처리 대상에서 제외되지 않았는지도 확인하세요. 앱을 완전히 종료한 뒤 요청을 새로 보내고 클라이언트가 해당 요청을 받았는지 살펴보세요.

로그에 요청이 보이면 적용된 라우팅 규칙과 대상의 응답을 확인하세요. 기록이 없다면 로그 수준을 확인한 다음 트래픽 처리 범위를 점검합니다. 앱에 프록시를 직접 설정할 수 있다면 되돌릴 수 있는 방식으로 로컬 주소를 지정해 테스트하세요. 꼭 필요한 경우에만 TUN으로 전환하고 이전 설정을 언제든 복원할 수 있도록 기록해 두세요. 앱 하나의 실패만으로 시스템 프록시가 잘못됐다고 단정할 필요는 없으며 정상 작동하는 앱까지 다른 모드로 바꿀 필요도 없습니다.

업그레이드하거나 기기를 바꾼 뒤 그룹과 라우팅을 복구하려면 어떻게 해야 하나요?

백업을 열어 먼저 세 가지 항목을 구분하세요. 구독에서 다시 가져올 수 있는 노드, 별도로 저장한 수동 링크, 이 기기에 관련된 인바운드 및 라우팅 설정입니다. 새 기기에서는 최소한의 설정으로 연결을 확인한 다음 단계별로 이전하세요. 구독 그룹은 기존 주소로 다시 만들고, 수동 노드는 하나씩 가져옵니다. 로컬 포트와 가상 인터페이스, 특정 코어에 관련된 라우팅은 현재 기기에 맞게 다시 설정해야 합니다.

기존 설정 전체를 다른 클라이언트에 그대로 덮어쓰지 마세요. 양쪽에서 일부 노드를 인식하더라도 기본 출구와 앱별 목록, 데이터 파일 경로에 대한 기대가 다를 수 있습니다. 구독이 여러 개라면 출처별로 먼저 정리한 뒤 구독 그룹 및 노드 필터링 가이드를 참고해 중복 항목을 정리하세요. 확인이 끝나면 정상적으로 시작되는 백업을 하나 보존한 뒤 기존 설정을 제거하세요.

종료 후 인터넷이 끊겼다면 로컬 설정 복원하기

클라이언트를 종료한 뒤 모든 브라우저에서 접속할 수 없다면 프록시가 여전히 로컬 포트를 가리키는지 먼저 확인하세요. 이번 작업에서 새로 설정한 프록시만 해제하고 원래 사용하던 수동 프록시나 자동 설정 스크립트, 직접 연결 상태를 복원합니다. TUN을 사용했던 기기라면 가상 인터페이스가 이전 프로세스에서 계속 사용 중인지 확인하세요. 휴대폰에서는 시스템 VPN이 여전히 연결된 것으로 표시되는지, VPN이 아닌 연결을 차단하는 옵션이 켜져 있는지, 해당 설정을 기기 관리자가 제어하는지 살펴보세요.

복구 후 서로 다른 두 대상을 테스트하세요. 평소 접속되는 로컬 서비스 하나와 안정적인 인터넷 대상 하나입니다. 네트워크 계층이 복구됐는지 확인한 뒤 클라이언트를 다시 실행하세요. 여러 플랫폼에서 같은 네트워크를 사용할 때 모두 실패하지만 정상적인 다른 네트워크로 바꾸면 작동한다면 네트워크 전환 전후의 결과를 기록하세요. 기기마다 설치 패키지를 의심할 필요는 없습니다. 도움을 요청할 때는 플랫폼과 아키텍처, 클라이언트 및 인터페이스 유형, 트래픽 처리 방식, 오류 유형, 이미 수행한 비교 결과를 제공하고 전체 로그는 게시하지 마세요.

클라이언트 다운로드