v2rayN 7.x를 처음 사용한다면 운영체제와 프로세서 아키텍처에 맞는 패키지를 선택한 뒤 설정을 가져오고, 노드를 활성화해 로컬 프록시를 확인하세요. Windows와 macOS는 설치 및 권한 설정 위치가 다르지만 연결 점검 순서는 같습니다. 애플리케이션이 프록시를 통해 접속되는지 확인한 다음 로그인 시 자동 실행을 설정하세요. 문제가 생기면 설치, 구독, 코어, 애플리케이션 순서로 원인을 찾으면 되며 처음부터 재설치할 필요는 없습니다.
패키지 선택과 첫 실행: 운영체제와 아키텍처 확인
메인 창이 열렸다는 것은 클라이언트 화면이 실행됐다는 뜻일 뿐, 연결을 처리하는 코어까지 실행된다는 의미는 아닙니다. 다운로드할 때는 운영체제와 아키텍처뿐 아니라 패키지에 코어가 포함되어 있는지도 확인하세요. 처음 설정한다면 필요한 코어가 포함된다고 명시된 배포 패키지를 우선 선택하는 것이 좋습니다. 노드를 가져온 뒤 실행 파일이 없어 막히는 일을 예방할 수 있습니다.
Windows 패키지 선택
- 아키텍처 확인
- 「설정」→「시스템」→「정보」→「시스템 종류」
- 패키지 표기
- x64 기반 프로세서는 x64를 선택하고, ARM 기기는 시스템에 맞는 arm64 패키지를 선택하세요.
- 압축 파일
- 현재 계정에서 쓰기 가능하고 이후 이동하지 않을 폴더에 압축을 모두 풉니다.
- 첫 실행
- 압축 파일은 압축을 푼 폴더에서
v2rayN.exe를 실행하고, 설치 파일은 안내에 따라 설치하세요.
압축 프로그램의 미리보기 창에서 실행 파일을 바로 두 번 클릭하지 마세요. 주변 코어 파일이 함께 압축 해제되지 않을 수 있습니다.
macOS 패키지 선택
- 아키텍처 확인
- Apple 메뉴 →「이 Mac에 관하여」에서「칩」또는「프로세서」를 확인하세요.
- 패키지 표기
- Apple 칩은 arm64, Intel 프로세서는 x64를 선택하세요.
- 앱 위치
- 패키지 안내에 따라 압축을 풀거나 디스크 이미지를 연 뒤 앱을「응용 프로그램」폴더에 넣으세요.
- 첫 실행
- 「응용 프로그램」에서 실행하고, 디스크 이미지를 장기적인 실행 위치로 사용하지 마세요.
설치 후 앱을 한 번 직접 실행하세요. 로그인 항목에서 앱을 참조할 때 임시로 마운트된 위치가 경로로 지정되는 일을 막을 수 있습니다.
- Windows에서 런타임이 없다는 오류가 표시되는 경우: 오류에 나온 런타임 이름과 주 버전을 확인한 뒤 배포 패키지 안내와 대조하세요. 시스템 런타임에 의존하는 패키지라면 안내에 따라 해당 아키텍처의 .NET 데스크톱 런타임을 설치하세요. 관리자 권한으로 실행해도 런타임이 설치되는 것은 아닙니다.
- macOS에서 개발자를 확인할 수 없다는 안내가 표시되는 경우: 먼저 패키지 출처와 아키텍처를 확인하세요. 개발자 확인 안내가 표시되고 앱을 신뢰할 수 있다고 판단했다면, 한 번 실행을 시도한 뒤「시스템 설정」→「개인정보 보호 및 보안」에서「그래도 열기」옵션이 있는지 확인하세요. 시스템에서 앱이 컴퓨터를 손상시킨다고 알리면 실행을 계속하거나 시스템 전체 보안 기능을 끄지 마세요.
구독 가져오기: 저장, 업데이트, 활성화는 별도 단계
구독 주소는 여러 노드 목록을 가져오는 데 사용하며, 주소를 저장하는 것만으로 바로 연결할 수 있는 것은 아닙니다. 아래는 v2rayN 7.x 중국어 인터페이스를 기준으로 메뉴 기능을 안내합니다. 세부 버전에 따라 메뉴 문구가 조금 다를 수 있습니다. vmess:// 또는 vless://로 시작하는 단일 노드 공유 링크를 받았다면 구독 주소란에 입력하지 말고 클립보드에서 서버를 가져오는 기능을 사용하세요.
구독 그룹 만들기
「구독 그룹」→「구독 그룹 설정」을 열고 항목을 추가하세요. 알아보기 쉬운 별칭과 전체 구독 주소를 입력한 뒤 저장하고 메인 화면으로 돌아갑니다. 주소에 액세스 토큰이 포함될 수 있으므로 공개 스크린샷이나 로그에 노출하지 마세요.
구독 목록 업데이트
새로 만든 그룹을 선택하고「구독 그룹」메뉴에서「현재 구독 업데이트(프록시 미사용)」를 실행하세요. 처음 설치한 상태에는 사용할 수 있는 노드가 없으므로 프록시를 통한 업데이트는 선택하지 마세요. 업데이트가 끝나면 그룹 이름만 만들어졌는지 볼 것이 아니라 노드가 그룹에 표시되는지 확인하세요.
활성 노드로 설정
목록에서 사용 가능한 노드를 선택한 뒤 마우스 오른쪽 버튼을 눌러「활성 서버로 설정」을 실행하세요. 행을 한 번 클릭하는 것은 선택일 뿐 연결 전환이 아닙니다. 전환 후 메인 화면의 활성 항목과 로그를 확인해 코어가 바로 종료되지 않았는지 살펴보세요.
애플리케이션 연결 확인
먼저 로컬 프록시 포트를 확인한 다음 트레이 또는 메뉴 막대 아이콘의「시스템 프록시」메뉴에서「시스템 프록시 자동 설정」을 선택하세요. 브라우저에서 시스템 설정을 덮어쓰는 별도 프록시 규칙은 해제하고, 접속 가능한 것으로 확인된 HTTPS 페이지를 열어 정상적으로 표시되는지 확인하세요.
코어 선택: 기존 설정을 확인한 뒤 코어 매핑 변경
노드에는 프로토콜, 원격 주소, 전송 방식 등 연결 매개변수가 저장되고, 코어는 이 매개변수에 따라 연결을 처리합니다.「설정」→「매개변수 설정」→「Core 유형」(일부 버전에서는「Core 유형 설정」)으로 이동하면 내장 노드 프로토콜에 연결된 코어 옵션을 확인할 수 있습니다. 이 설정은 VMess 노드를 VLESS로 바꾸는 기능이 아닙니다. 완전한 설정이 포함된 사용자 지정 노드에도 여기서 설명하는 일반적인 기준을 그대로 적용하지 마세요.
현재 노드의 코어 유지
권장먼저 클라이언트의 현재 프로토콜 매핑을 그대로 두고 노드를 활성화한 뒤 로그를 확인하세요. 서버 설정이 VLESS + REALITY이고 현재 사용하는 Xray가 설정을 정상적으로 불러온다면, 문제를 확인한다는 이유로 코어와 전송 방식, 보안 매개변수를 한꺼번에 바꾸지 마세요.
적합한 경우: 처음 설치했거나 가져올 수 있는 일반 구독이 있는 경우
서버 요구사항에 맞춰 코어 조정
서버에서 호환성 요구사항을 명확히 안내했거나 로그에 현재 코어가 설정 필드를 인식하지 못한다고 표시될 때만 해당 조합을 지원하는 설치된 코어를 선택하세요. 저장한 뒤 같은 노드를 다시 활성화하고 변경 전후 로그를 비교하세요. 서버까지 동시에 바꾸면 어떤 변경이 효과가 있었는지 알기 어렵습니다.
적합한 경우: 확인된 설정을 이전하거나 특정 필드의 호환성 문제를 점검할 때
로그에 코어 파일을 찾을 수 없다고 나오면 패키지 내용과 플랫폼 아키텍처부터 확인하세요. 코어는 실행되지만 연결 로그에 TLS 또는 인증 오류가 나타난다면 구독의 주소, 서버 이름, 인증 매개변수가 동일한 설정에서 나온 것인지 확인하세요. 매개변수 불일치를 감추려고 인증서 검증을 끄지 마세요.
로컬 리스닝과 시스템 프록시: 각각 확인
「설정」→「매개변수 설정」에서 로컬 리스닝 포트를 확인하세요. 아래에서는 혼합 인바운드 포트 10808을 예로 들며, HTTP 프록시 방식으로 연결을 확인할 수 있습니다. 화면에 SOCKS와 HTTP 포트가 각각 표시된다면 명령에 HTTP 인바운드 포트를 입력하세요. 명령이 로컬 프록시에 직접 연결하므로 시스템 프록시는 일단 켜지 않아도 됩니다.
curl -I --max-time 10 --proxy http://127.0.0.1:10808 https://example.com/
Windows PowerShell에서는 명령 앞부분의 curl을 curl.exe로 바꿀 수 있습니다. 명령은 최대 10초 동안 기다립니다. 프록시 터널 연결 시 표시될 수 있는 200 Connection established만 보지 말고 대상 사이트가 최종적으로 반환한 HTTP 상태 줄을 확인하세요. 이 명령은 해당 애플리케이션에서 대상 사이트까지의 연결 경로를 확인하는 용도이며 속도 측정용이 아닙니다.
| 확인된 현상 | 다음 점검 항목 |
|---|---|
127.0.0.1:10808 연결이 거부됨 | 코어가 실행 중인지, 포트와 인바운드 유형을 올바르게 입력했는지 확인한 뒤 로그에 리스닝 실패나 포트 사용 중이라는 안내가 있는지 살펴보세요. |
| 터널 연결 안내가 표시된 뒤 시간 초과 또는 TLS 오류가 발생함 | 로컬 포트가 요청을 받았습니다. 코어 로그를 확인해 현재 아웃바운드, 서버 접속 가능 여부, TLS 매개변수를 점검하세요. 브라우저 설정부터 바꾸지는 마세요. |
| 명령에서는 대상 사이트 응답을 받지만 브라우저에서는 접속되지 않음 | 브라우저가 시스템 프록시를 사용하는지, 확장 프로그램이나 앱 내 프록시 설정이 이를 덮어쓰는지 확인하세요. 브라우저를 다시 열고 같은 주소로 재확인하세요. |
시스템 프록시는 시스템 설정을 따르는 앱의 연결을 로컬 리스너로 전달하고, 라우팅 규칙은 코어에 들어온 연결을 프록시 아웃바운드로 보낼지 직접 연결할지 결정합니다. 명령이 성공했다는 것은 요청이 로컬 인바운드를 거쳐 응답을 받았다는 뜻일 뿐입니다. 해당 요청이 프록시 아웃바운드를 선택했는지까지 확인하려면 현재 라우팅 규칙과 연결 로그를 대조해야 합니다. 페이지가 열렸다는 사실만으로는 판단할 수 없습니다.
로그인 시 자동 실행 및 자주 발생하는 문제
브라우저 연결을 확인한 다음 자동 실행을 설정하세요. 자동 실행은 보통 사용자 로그인 시 시작되며, 시스템에 로그인하기 전부터 실행되는 것은 아닙니다. 클라이언트가 자동으로 열리는 것과 시스템 프록시가 복원되는 것은 별개이므로 설정 후 각각 확인하세요.
- Windows:「설정」→「매개변수 설정」에서「시작 시 자동 실행」옵션을 확인하세요. 설정하기 전에 프로그램 폴더 위치를 확정하세요. 압축 해제한 프로그램 폴더를 나중에 옮겼다면 로그인 시 이전 경로를 참조하지 않도록 자동 실행을 다시 설정하세요.
- macOS:「시스템 설정」→「일반」→「로그인 항목」에서「응용 프로그램」폴더의 v2rayN을 로그인 시 열기 목록에 추가할 수 있습니다. 일부 시스템 버전에서는 해당 페이지가「로그인 항목 및 확장 프로그램」으로 표시됩니다. 클라이언트 자동 실행을 이미 설정했다면 같은 앱을 중복으로 추가하지 마세요.
- 로그아웃 후 다시 로그인하여 확인: 먼저 클라이언트가 열렸는지 확인한 다음 활성 노드, 코어 로그, 시스템 프록시 상태를 점검하세요. 사용을 중단하려면 클라이언트를 종료하기 전에 시스템 프록시를 해제하세요. 앱이 종료된 로컬 포트로 계속 요청을 보내는 일을 막을 수 있습니다.
구독 그룹은 보이는데 왜 비어 있나요?
해당 그룹을 선택하고「현재 구독 업데이트(프록시 미사용)」를 직접 실행한 뒤 업데이트 로그를 확인하세요. 로그에 HTTP 401 또는 403이 표시되면 주소가 완전한지, 액세스 토큰이 유효한지 확인하세요. 연결 시간 초과라면 먼저 이 기기에서 구독 서비스에 접속할 수 있는지 확인하세요. 사용할 수 있는 프록시가 있을 때만 프록시를 통한 업데이트를 시도하는 것이 좋습니다.
노드 속도 측정 결과는 나오는데 웹페이지가 열리지 않는 이유는 무엇인가요?
속도 측정 결과만으로 브라우저가 해당 노드를 사용한다고 볼 수는 없습니다. 먼저 해당 노드가 활성 서버인지 확인하고 로컬 프록시를 명시한 명령으로 같은 대상에 접속해 보세요. 명령은 성공하지만 브라우저에서 실패한다면 지연 시간 순으로 다른 노드를 고르기보다 브라우저 프록시 설정을 먼저 확인하세요.
창을 닫았는데 프록시가 계속 작동하는 이유는 무엇인가요?
트레이 또는 메뉴 막대에 v2rayN 아이콘이 남아 있는지 확인하세요. 창을 닫은 뒤에도 앱이 트레이에 남도록 설정했다면 창이 사라져도 클라이언트는 종료되지 않습니다. 중지하려면 먼저「시스템 프록시」메뉴에서 시스템 프록시를 해제한 다음 클라이언트 메뉴에서「종료」를 선택하세요.
로그인 후 클라이언트는 실행됐는데 터미널 명령에는 프록시가 적용되지 않는 이유는 무엇인가요?
많은 명령줄 프로그램은 데스크톱 시스템 프록시 설정을 따르지 않습니다. 먼저 위에서 설명한 curl --proxy처럼 로컬 인바운드를 지정하는 프록시 옵션으로 테스트하세요. 장기간 설정이 필요할 때만 해당 도구의 문서에 따라 지원되는 프록시 옵션이나 환경 변수를 설정하세요. 명령 하나에 프록시를 적용하려고 전역 설정을 바꿀 필요는 없습니다.